From 694f6671d078c45800a9af888ddce2cc3431a1e9 Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 16 Oct 2024 09:53:35 +0000 Subject: [PATCH] gcloud: Wed Oct 16 09:53:34 UTC 2024 --- gcloud/_version | 10 +- gcloud/alpha/asset/query | 2 +- gcloud/alpha/bigtable/app-profiles/create | 37 ++- gcloud/alpha/bigtable/app-profiles/update | 37 ++- .../compute/backend-services/add-backend | 4 +- gcloud/alpha/compute/backend-services/create | 86 ++++++- gcloud/alpha/compute/backend-services/update | 89 ++++++- .../compute/backend-services/update-backend | 4 +- gcloud/alpha/compute/disks/create | 11 + .../compute/instance-groups/managed/create | 16 ++ .../compute/instances/network-interfaces/add | 6 +- .../compute/public-delegated-prefixes/create | 5 +- .../delegated-sub-prefixes/create | 5 +- gcloud/alpha/compute/snapshots/create | 54 +++++ gcloud/alpha/config/get | 4 + gcloud/alpha/config/help | 4 + gcloud/alpha/config/list | 4 + gcloud/alpha/config/set | 4 + gcloud/alpha/config/unset | 4 + gcloud/alpha/container/fleet/mesh/update | 4 +- gcloud/alpha/container/hub/mesh/update | 4 +- gcloud/alpha/dataproc/clusters/create | 17 +- .../workflow-templates/set-managed-cluster | 17 +- gcloud/alpha/datastore/indexes/create | 2 +- gcloud/alpha/iap/web/disable | 6 +- gcloud/alpha/iap/web/enable | 6 +- gcloud/alpha/looker/instances/create | 34 ++- gcloud/alpha/managed-flink/deployments/create | 3 +- gcloud/alpha/managed-flink/deployments/delete | 3 +- .../alpha/managed-flink/deployments/describe | 3 +- gcloud/alpha/managed-flink/deployments/list | 3 +- gcloud/alpha/managed-flink/deployments/update | 3 +- gcloud/alpha/managed-flink/jobs/delete | 3 +- gcloud/alpha/managed-flink/jobs/describe | 3 +- gcloud/alpha/managed-flink/jobs/list | 3 +- .../internal-ranges/create | 7 +- .../security-profile-groups/create | 44 ++++ gcloud/alpha/network-services/help | 6 + .../describe | 8 +- .../multicast-group-consumer-activations/help | 2 +- .../create | 101 ++++++++ .../delete | 77 ++++++ .../describe | 72 ++++++ .../multicast-group-producer-activations/help | 37 +++ .../multicast-group-producer-activations/list | 90 +++++++ .../multicast-producer-associations/create | 99 ++++++++ .../multicast-producer-associations/delete | 75 ++++++ .../multicast-producer-associations/describe | 71 ++++++ .../multicast-producer-associations/help | 37 +++ .../multicast-producer-associations/list | 90 +++++++ gcloud/alpha/sql/instances/create | 30 +++ gcloud/alpha/sql/instances/patch | 39 +++ gcloud/alpha/storage/buckets/create | 19 +- gcloud/alpha/storage/buckets/update | 23 ++ gcloud/alpha/storage/folders/create | 4 +- gcloud/alpha/storage/folders/delete | 4 +- gcloud/alpha/storage/folders/describe | 4 +- gcloud/alpha/storage/folders/help | 4 +- gcloud/alpha/storage/folders/list | 4 +- gcloud/apphub/applications/create | 5 +- gcloud/artifacts/docker/images/scan | 44 +++- gcloud/asset/query | 2 +- gcloud/beta/artifacts/docker/images/scan | 44 +++- gcloud/beta/asset/query | 2 +- gcloud/beta/bigtable/app-profiles/create | 37 ++- gcloud/beta/bigtable/app-profiles/update | 37 ++- gcloud/beta/colab-enterprise/help | 8 +- .../colab-enterprise/runtime-templates/help | 4 +- gcloud/beta/colab-enterprise/runtimes/help | 3 +- gcloud/beta/colab/help | 26 ++ .../runtime-templates/add-iam-policy-binding | 88 +++++++ gcloud/beta/colab/runtime-templates/create | 226 ++++++++++++++++++ gcloud/beta/colab/runtime-templates/delete | 67 ++++++ gcloud/beta/colab/runtime-templates/describe | 62 +++++ .../colab/runtime-templates/get-iam-policy | 93 +++++++ gcloud/beta/colab/runtime-templates/help | 49 ++++ gcloud/beta/colab/runtime-templates/list | 81 +++++++ .../remove-iam-policy-binding | 90 +++++++ .../colab/runtime-templates/set-iam-policy | 74 ++++++ gcloud/beta/colab/runtimes/assign | 108 +++++++++ gcloud/beta/colab/runtimes/delete | 63 +++++ gcloud/beta/colab/runtimes/describe | 58 +++++ gcloud/beta/colab/runtimes/help | 39 +++ gcloud/beta/colab/runtimes/list | 80 +++++++ gcloud/beta/colab/runtimes/start | 63 +++++ gcloud/beta/colab/runtimes/upgrade | 63 +++++ gcloud/beta/compute/backend-services/create | 18 +- gcloud/beta/compute/backend-services/update | 18 +- .../managed/resize-requests/cancel | 37 +-- .../managed/resize-requests/create | 39 +-- .../managed/resize-requests/delete | 37 +-- gcloud/beta/compute/instance-templates/create | 5 +- gcloud/beta/compute/instances/bulk/create | 7 + gcloud/beta/compute/instances/create | 5 +- gcloud/beta/compute/networks/subnets/create | 2 + .../compute/public-delegated-prefixes/create | 4 +- .../delegated-sub-prefixes/create | 4 +- gcloud/beta/config/get | 4 + gcloud/beta/config/help | 4 + gcloud/beta/config/list | 4 + gcloud/beta/config/set | 4 + gcloud/beta/config/unset | 4 + gcloud/beta/container/fleet/mesh/help | 3 + gcloud/beta/container/fleet/mesh/update | 99 ++++++++ gcloud/beta/container/hub/mesh/help | 3 + gcloud/beta/container/hub/mesh/update | 99 ++++++++ gcloud/beta/dataproc/clusters/create | 24 +- .../workflow-templates/set-managed-cluster | 24 +- gcloud/beta/datastore/indexes/cleanup | 12 +- gcloud/beta/datastore/indexes/create | 2 +- .../hubs/route-tables/routes/list | 16 +- gcloud/beta/sql/instances/create | 30 +++ gcloud/beta/sql/instances/patch | 39 +++ gcloud/bigtable/app-profiles/create | 73 +----- gcloud/bigtable/app-profiles/update | 72 +----- gcloud/compute/backend-services/create | 45 +++- gcloud/compute/backend-services/update | 45 +++- gcloud/compute/instance-templates/create | 5 +- gcloud/compute/instances/bulk/create | 7 + gcloud/compute/instances/create | 5 +- gcloud/compute/networks/subnets/create | 2 + .../compute/public-delegated-prefixes/create | 4 +- .../delegated-sub-prefixes/create | 4 +- gcloud/config/get | 4 + gcloud/config/help | 4 + gcloud/config/list | 4 + gcloud/config/set | 4 + gcloud/config/unset | 4 + gcloud/container/fleet/mesh/update | 4 +- gcloud/container/hub/mesh/update | 4 +- .../connection-profiles/create/cloudsql | 27 ++- gcloud/dataproc/clusters/create | 24 +- .../workflow-templates/set-managed-cluster | 24 +- gcloud/datastore/indexes/create | 2 +- gcloud/looker/instances/create | 15 +- .../hubs/route-tables/routes/list | 16 +- .../internal-ranges/create | 7 +- gcloud/network-connectivity/spokes/help | 3 + .../spokes/linked-producer-vpc-network/create | 96 ++++++++ .../spokes/linked-producer-vpc-network/help | 24 ++ .../spokes/linked-producer-vpc-network/update | 96 ++++++++ gcloud/sql/flags/list | 2 +- gcloud/sql/instances/create | 32 ++- gcloud/sql/instances/patch | 2 +- gcloud/storage/buckets/create | 7 +- gcloud/storage/folders/create | 52 ++++ gcloud/storage/folders/delete | 40 ++++ gcloud/storage/folders/describe | 45 ++++ gcloud/storage/folders/help | 34 +++ gcloud/storage/folders/list | 94 ++++++++ gcloud/storage/help | 3 + 151 files changed, 4031 insertions(+), 414 deletions(-) create mode 100644 gcloud/alpha/network-services/multicast-group-producer-activations/create create mode 100644 gcloud/alpha/network-services/multicast-group-producer-activations/delete create mode 100644 gcloud/alpha/network-services/multicast-group-producer-activations/describe create mode 100644 gcloud/alpha/network-services/multicast-group-producer-activations/help create mode 100644 gcloud/alpha/network-services/multicast-group-producer-activations/list create mode 100644 gcloud/alpha/network-services/multicast-producer-associations/create create mode 100644 gcloud/alpha/network-services/multicast-producer-associations/delete create mode 100644 gcloud/alpha/network-services/multicast-producer-associations/describe create mode 100644 gcloud/alpha/network-services/multicast-producer-associations/help create mode 100644 gcloud/alpha/network-services/multicast-producer-associations/list create mode 100644 gcloud/beta/colab/help create mode 100644 gcloud/beta/colab/runtime-templates/add-iam-policy-binding create mode 100644 gcloud/beta/colab/runtime-templates/create create mode 100644 gcloud/beta/colab/runtime-templates/delete create mode 100644 gcloud/beta/colab/runtime-templates/describe create mode 100644 gcloud/beta/colab/runtime-templates/get-iam-policy create mode 100644 gcloud/beta/colab/runtime-templates/help create mode 100644 gcloud/beta/colab/runtime-templates/list create mode 100644 gcloud/beta/colab/runtime-templates/remove-iam-policy-binding create mode 100644 gcloud/beta/colab/runtime-templates/set-iam-policy create mode 100644 gcloud/beta/colab/runtimes/assign create mode 100644 gcloud/beta/colab/runtimes/delete create mode 100644 gcloud/beta/colab/runtimes/describe create mode 100644 gcloud/beta/colab/runtimes/help create mode 100644 gcloud/beta/colab/runtimes/list create mode 100644 gcloud/beta/colab/runtimes/start create mode 100644 gcloud/beta/colab/runtimes/upgrade create mode 100644 gcloud/beta/container/fleet/mesh/update create mode 100644 gcloud/beta/container/hub/mesh/update create mode 100644 gcloud/network-connectivity/spokes/linked-producer-vpc-network/create create mode 100644 gcloud/network-connectivity/spokes/linked-producer-vpc-network/help create mode 100644 gcloud/network-connectivity/spokes/linked-producer-vpc-network/update create mode 100644 gcloud/storage/folders/create create mode 100644 gcloud/storage/folders/delete create mode 100644 gcloud/storage/folders/describe create mode 100644 gcloud/storage/folders/help create mode 100644 gcloud/storage/folders/list diff --git a/gcloud/_version b/gcloud/_version index 0b5d0b408..c5cda48ad 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 496.0.0 -alpha 2024.10.04 -beta 2024.10.04 +Google Cloud SDK 497.0.0 +alpha 2024.10.11 +beta 2024.10.11 bq 2.1.9 bundled-python3-unix 3.11.9 -core 2024.10.04 +core 2024.10.11 gcloud-crc32c 1.0.0 -gsutil 5.30 +gsutil 5.31 diff --git a/gcloud/alpha/asset/query b/gcloud/alpha/asset/query index 6fca97819..33f8ef5a9 100644 --- a/gcloud/alpha/asset/query +++ b/gcloud/alpha/asset/query @@ -62,7 +62,7 @@ REQUIRED FLAGS A BigQuery Standard SQL compatible statement. If the query execution finishes within timeout and there is no pagination, the full query results will be returned. Otherwise, pass job_reference from previous - call as --job-referrence to obtain the full results. + call as --job-reference to obtain the full results. OPTIONAL FLAGS --page-size=PAGE_SIZE diff --git a/gcloud/alpha/bigtable/app-profiles/create b/gcloud/alpha/bigtable/app-profiles/create index 3f03e6455..5d8275a29 100644 --- a/gcloud/alpha/bigtable/app-profiles/create +++ b/gcloud/alpha/bigtable/app-profiles/create @@ -116,23 +116,23 @@ OPTIONAL FLAGS Data Boost Read-only Isolation --data-boost - Use Data Boost serverless compute option, rather than standard - provisioned node compute. If specified, - --data-boost-compute-billing-owner is required. Specifying Data - Boost compute on an app profile that uses standard provisioned node - compute may cause unexpected behavior for running applications. + Use Data Boost Read-only Isolation, rather than Standard Isolation. + If specified, --data-boost-compute-billing-owner is required. + Specifying Data Boost Read-only Isolation on an app profile which + has Standard Isolation enabled may cause unexpected behavior for + running applications. This flag argument must be specified if any of the other arguments in this group are specified. --data-boost-compute-billing-owner=DATA_BOOST_COMPUTE_BILLING_OWNER - Specify the Data Boost compute billing owner, required if + Specify the Data Boost Compute Billing Owner, required if --data-boost is passed. DATA_BOOST_COMPUTE_BILLING_OWNER must be (only one value is supported): HOST_PAYS - Compute billing should be accounted towards the host Cloud - project (containing the targeted Bigtable instance / table). + Compute Billing should be accounted towards the host Cloud + Project (containing the targeted Bigtable Instance / Table). This flag argument must be specified if any of the other arguments in this group are specified. @@ -140,15 +140,14 @@ OPTIONAL FLAGS Standard Isolation --priority=PRIORITY - Specify the request priority under standard provisioned node - compute capabilities. Passing this option implies standard - provisioned node compute, e.g. the --standard option. If not - specified, the app profile uses standard provisioned node compute - with PRIORITY_HIGH by default. Specifying request priority on an - app profile that has Data Boost serverless compute enabled changes - the compute option to standard and uses the specified priority, - which might cause unexpected behavior for running applications. - PRIORITY must be one of: + Specify the request priority under Standard Isolation. Passing this + option implies Standard Isolation, e.g. the --standard option. If + not specified, the app profile uses Standard Isolation with + PRIORITY_HIGH by default. Specifying request priority on an app + profile that has Data Boost Read-Only Isolation enabled will change + the isolation to Standard and use the specified priority, which may + cause unexpected behavior for running applications. PRIORITY must + be one of: PRIORITY_HIGH Requests are treated with high priority. @@ -161,8 +160,8 @@ OPTIONAL FLAGS in this group are specified. --standard - Use standard provisioned node compute option, rather than Data - Boost compute option. If specified, --priority is required. + Use Standard Isolation, rather than Data Boost Read-only Isolation. + If specified, --priority is required. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/bigtable/app-profiles/update b/gcloud/alpha/bigtable/app-profiles/update index 5771d7ff7..503b4942d 100644 --- a/gcloud/alpha/bigtable/app-profiles/update +++ b/gcloud/alpha/bigtable/app-profiles/update @@ -93,23 +93,23 @@ FLAGS Data Boost Read-only Isolation --data-boost - Use Data Boost serverless compute option, rather than standard - provisioned node compute. If specified, - --data-boost-compute-billing-owner is required. Specifying Data - Boost compute on an app profile that uses standard provisioned node - compute may cause unexpected behavior for running applications. + Use Data Boost Read-only Isolation, rather than Standard Isolation. + If specified, --data-boost-compute-billing-owner is required. + Specifying Data Boost Read-only Isolation on an app profile which + has Standard Isolation enabled may cause unexpected behavior for + running applications. This flag argument must be specified if any of the other arguments in this group are specified. --data-boost-compute-billing-owner=DATA_BOOST_COMPUTE_BILLING_OWNER - Specify the Data Boost compute billing owner, required if + Specify the Data Boost Compute Billing Owner, required if --data-boost is passed. DATA_BOOST_COMPUTE_BILLING_OWNER must be (only one value is supported): HOST_PAYS - Compute billing should be accounted towards the host Cloud - project (containing the targeted Bigtable instance / table). + Compute Billing should be accounted towards the host Cloud + Project (containing the targeted Bigtable Instance / Table). This flag argument must be specified if any of the other arguments in this group are specified. @@ -117,15 +117,14 @@ FLAGS Standard Isolation --priority=PRIORITY - Specify the request priority under standard provisioned node - compute capabilities. Passing this option implies standard - provisioned node compute, e.g. the --standard option. If not - specified, the app profile uses standard provisioned node compute - with PRIORITY_HIGH by default. Specifying request priority on an - app profile that has Data Boost serverless compute enabled changes - the compute option to standard and uses the specified priority, - which might cause unexpected behavior for running applications. - PRIORITY must be one of: + Specify the request priority under Standard Isolation. Passing this + option implies Standard Isolation, e.g. the --standard option. If + not specified, the app profile uses Standard Isolation with + PRIORITY_HIGH by default. Specifying request priority on an app + profile that has Data Boost Read-Only Isolation enabled will change + the isolation to Standard and use the specified priority, which may + cause unexpected behavior for running applications. PRIORITY must + be one of: PRIORITY_HIGH Requests are treated with high priority. @@ -138,8 +137,8 @@ FLAGS in this group are specified. --standard - Use standard provisioned node compute option, rather than Data - Boost compute option. If specified, --priority is required. + Use Standard Isolation, rather than Data Boost Read-only Isolation. + If specified, --priority is required. At most one of these can be specified: diff --git a/gcloud/alpha/compute/backend-services/add-backend b/gcloud/alpha/compute/backend-services/add-backend index 291dd6bd8..6bcfbfaf0 100644 --- a/gcloud/alpha/compute/backend-services/add-backend +++ b/gcloud/alpha/compute/backend-services/add-backend @@ -280,7 +280,7 @@ OPTIONAL FLAGS Sets dryRun value. maxUtilization - Required, Sets maxUtilization value. + Sets maxUtilization value. name Required, Sets name value. @@ -313,7 +313,7 @@ OPTIONAL FLAGS Sets dryRun value. maxUtilization - Required, Sets maxUtilization value. + Sets maxUtilization value. name Required, Sets name value. diff --git a/gcloud/alpha/compute/backend-services/create b/gcloud/alpha/compute/backend-services/create index fd39e9d4c..751a59686 100644 --- a/gcloud/alpha/compute/backend-services/create +++ b/gcloud/alpha/compute/backend-services/create @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud alpha compute backend-services create BACKEND_SERVICE_NAME [--affinity-cookie-name=AFFINITY_COOKIE_NAME] + [--affinity-cookie-path=AFFINITY_COOKIE_PATH] [--affinity-cookie-ttl=AFFINITY_COOKIE_TTL] [--bypass-cache-on-request-headers=BYPASS_CACHE_ON_REQUEST_HEADERS] [--no-cache-key-include-host] @@ -43,6 +44,8 @@ SYNOPSIS [--timeout=TIMEOUT; default="30s"] [--tracking-mode=TRACKING_MODE] [--cache-key-query-string-blacklist=[QUERY_STRING,...] | --cache-key-query-string-whitelist=QUERY_STRING,[...]] + [--custom-metrics=[CUSTOM_METRICS,...] + | --custom-metrics-file=[CUSTOM_METRICS,...]] [--global | --region=REGION] [--global-health-checks | --health-checks-region=HEALTH_CHECKS_REGION] [GCLOUD_WIDE_FLAG ...] @@ -69,14 +72,19 @@ POSITIONAL ARGUMENTS FLAGS --affinity-cookie-name=AFFINITY_COOKIE_NAME - If --session-affinity is set to HTTP_COOKIE, this flag sets the name of - the cookie. + If --session-affinity is set to HTTP_COOKIE or STRONG_COOKIE_AFFINITY, + this flag sets the name of the cookie. + + --affinity-cookie-path=AFFINITY_COOKIE_PATH + If --session-affinity is set to HTTP_COOKIE or STRONG_COOKIE_AFFINITY, + this flag sets the path of the cookie. --affinity-cookie-ttl=AFFINITY_COOKIE_TTL - If --session-affinity is set to GENERATED_COOKIE or HTTP_COOKIE, this - flag sets the TTL, in seconds, of the resulting cookie. A setting of 0 - indicates that the cookie should be a session cookie. See $ gcloud - topic datetimes for information on duration formats. + If --session-affinity is set to GENERATED_COOKIE, HTTP_COOKIE, or + STRONG_COOKIE_AFFINITY, this flag sets the TTL, in seconds, of the + resulting cookie. A setting of 0 indicates that the cookie should be a + session cookie. See $ gcloud topic datetimes for information on + duration formats. --bypass-cache-on-request-headers=BYPASS_CACHE_ON_REQUEST_HEADERS Bypass the cache when the specified request headers are matched - e.g. @@ -749,6 +757,72 @@ FLAGS percent encoded and not treated as delimiters. Can only be applied for global resources. + At most one of these can be specified: + + --custom-metrics=[CUSTOM_METRICS,...] + List of custom metrics that are used for WEIGHTED_ROUND_ROBIN + BackendService locality_lb_policy. + + Example: + + $ gcloud alpha compute backend-services create \ + --custom-metrics='name=my-signal,dryRun=true' + $ gcloud alpha compute backend-services create \ + --custom-metrics='name=my-signal,dryRun=true' \ + --custom-metrics='name=my-signal2' + $ gcloud alpha compute backend-services create \ + --custom-metrics='[{"name" : "my-signal", "dryRun" : true}, + {"name" : "my-signal2"}]' + + Sets custom_metrics value. + + dryRun + Sets dryRun value. + + name + Required, Sets name value. + + Shorthand Example: + + --custom-metrics=dryRun=boolean,name=string --custom-metrics=dryRun=boolean,name=string + + JSON Example: + + --custom-metrics='[{"dryRun": boolean, "name": "string"}]' + + File Example: + + --custom-metrics=path_to_file.(yaml|json) + + --custom-metrics-file=[CUSTOM_METRICS,...] + File path to json file with custom metrics that are used for + WEIGHTED_ROUND_ROBIN BackendService locality_lb_policy. + + Example: + + $ gcloud alpha compute backend-services create \ + --custom-metrics-file='customMetric.json' + + Sets custom_metrics_file value. + + dryRun + Sets dryRun value. + + name + Required, Sets name value. + + Shorthand Example: + + --custom-metrics-file=dryRun=boolean,name=string --custom-metrics-file=dryRun=boolean,name=string + + JSON Example: + + --custom-metrics-file='[{"dryRun": boolean, "name": "string"}]' + + File Example: + + --custom-metrics-file=path_to_file.(yaml|json) + At most one of these can be specified: --global diff --git a/gcloud/alpha/compute/backend-services/update b/gcloud/alpha/compute/backend-services/update index ea5714790..2ab2e7e87 100644 --- a/gcloud/alpha/compute/backend-services/update +++ b/gcloud/alpha/compute/backend-services/update @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud alpha compute backend-services update BACKEND_SERVICE_NAME [--affinity-cookie-name=AFFINITY_COOKIE_NAME] + [--affinity-cookie-path=AFFINITY_COOKIE_PATH] [--affinity-cookie-ttl=AFFINITY_COOKIE_TTL] [--cache-key-include-host] [--cache-key-include-http-header=[HEADER_FIELD_NAME,...]] [--cache-key-include-named-cookie=[NAMED_COOKIE,...]] @@ -39,6 +40,8 @@ SYNOPSIS | --no-bypass-cache-on-request-headers] [--cache-key-query-string-blacklist=[QUERY_STRING,...] | --cache-key-query-string-whitelist=QUERY_STRING,[...]] + [--clear-custom-metrics | --custom-metrics=[CUSTOM_METRICS,...] + | --custom-metrics-file=[CUSTOM_METRICS,...]] [--clear-external-managed-migration-state | --external-managed-migration-state=EXTERNAL_MANAGED_MIGRATION_STATE] [--client-ttl=CLIENT_TTL | --no-client-ttl] @@ -67,14 +70,19 @@ POSITIONAL ARGUMENTS FLAGS --affinity-cookie-name=AFFINITY_COOKIE_NAME - If --session-affinity is set to HTTP_COOKIE, this flag sets the name of - the cookie. + If --session-affinity is set to HTTP_COOKIE or STRONG_COOKIE_AFFINITY, + this flag sets the name of the cookie. + + --affinity-cookie-path=AFFINITY_COOKIE_PATH + If --session-affinity is set to HTTP_COOKIE or STRONG_COOKIE_AFFINITY, + this flag sets the path of the cookie. --affinity-cookie-ttl=AFFINITY_COOKIE_TTL - If --session-affinity is set to GENERATED_COOKIE or HTTP_COOKIE, this - flag sets the TTL, in seconds, of the resulting cookie. A setting of 0 - indicates that the cookie should be a session cookie. See $ gcloud - topic datetimes for information on duration formats. + If --session-affinity is set to GENERATED_COOKIE, HTTP_COOKIE, or + STRONG_COOKIE_AFFINITY, this flag sets the TTL, in seconds, of the + resulting cookie. A setting of 0 indicates that the cookie should be a + session cookie. See $ gcloud topic datetimes for information on + duration formats. --cache-key-include-host Enable including host in cache key. If enabled, requests to different @@ -590,6 +598,75 @@ FLAGS percent encoded and not treated as delimiters. Can only be applied for global resources. + At most one of these can be specified: + + --clear-custom-metrics + Clears current list of CUSTOM_METRICS. + + --custom-metrics=[CUSTOM_METRICS,...] + List of custom metrics that are used for WEIGHTED_ROUND_ROBIN + BackendService locality_lb_policy. + + Example: + + $ gcloud alpha compute backend-services update \ + --custom-metrics='name=my-signal,dryRun=true' + $ gcloud alpha compute backend-services update \ + --custom-metrics='name=my-signal,dryRun=true' \ + --custom-metrics='name=my-signal2' + $ gcloud alpha compute backend-services update \ + --custom-metrics='[{"name" : "my-signal", "dryRun" : true}, + {"name" : "my-signal2"}]' + + Sets custom_metrics value. + + dryRun + Sets dryRun value. + + name + Required, Sets name value. + + Shorthand Example: + + --custom-metrics=dryRun=boolean,name=string --custom-metrics=dryRun=boolean,name=string + + JSON Example: + + --custom-metrics='[{"dryRun": boolean, "name": "string"}]' + + File Example: + + --custom-metrics=path_to_file.(yaml|json) + + --custom-metrics-file=[CUSTOM_METRICS,...] + File path to json file with custom metrics that are used for + WEIGHTED_ROUND_ROBIN BackendService locality_lb_policy. + + Example: + + $ gcloud alpha compute backend-services update \ + --custom-metrics-file='customMetric.json' + + Sets custom_metrics_file value. + + dryRun + Sets dryRun value. + + name + Required, Sets name value. + + Shorthand Example: + + --custom-metrics-file=dryRun=boolean,name=string --custom-metrics-file=dryRun=boolean,name=string + + JSON Example: + + --custom-metrics-file='[{"dryRun": boolean, "name": "string"}]' + + File Example: + + --custom-metrics-file=path_to_file.(yaml|json) + At most one of these can be specified: --clear-external-managed-migration-state diff --git a/gcloud/alpha/compute/backend-services/update-backend b/gcloud/alpha/compute/backend-services/update-backend index d67787ba7..473bad8f3 100644 --- a/gcloud/alpha/compute/backend-services/update-backend +++ b/gcloud/alpha/compute/backend-services/update-backend @@ -252,7 +252,7 @@ OPTIONAL FLAGS Sets dryRun value. maxUtilization - Required, Sets maxUtilization value. + Sets maxUtilization value. name Required, Sets name value. @@ -285,7 +285,7 @@ OPTIONAL FLAGS Sets dryRun value. maxUtilization - Required, Sets maxUtilization value. + Sets maxUtilization value. name Required, Sets name value. diff --git a/gcloud/alpha/compute/disks/create b/gcloud/alpha/compute/disks/create index d2b44a308..1f1a1a434 100644 --- a/gcloud/alpha/compute/disks/create +++ b/gcloud/alpha/compute/disks/create @@ -16,6 +16,8 @@ SYNOPSIS [--resource-policies=[RESOURCE_POLICY,...]] [--size=SIZE] [--storage-pool=STORAGE_POOL] [--type=TYPE] [--user-licenses=[LICENSE,...]] + [--global-source-snapshot + | --source-snapshot-region=SOURCE_SNAPSHOT_REGION] [--image-family-scope=IMAGE_FAMILY_SCOPE --image-project=IMAGE_PROJECT --image=IMAGE | --image-family=IMAGE_FAMILY | --primary-disk=PRIMARY_DISK @@ -189,6 +191,15 @@ FLAGS List of URIs to license resources. User-provided licenses can be edited after disk is created. + At most one of these can be specified: + + --global-source-snapshot + If set, the snapshot is global. + + --source-snapshot-region=SOURCE_SNAPSHOT_REGION + Region of the snapshot to operate on. Overrides the default + compute/region property value for this command invocation. + --image-family-scope=IMAGE_FAMILY_SCOPE Sets the scope for the --image-family flag. By default, when specifying an image family in a public image project, the zonal image family scope diff --git a/gcloud/alpha/compute/instance-groups/managed/create b/gcloud/alpha/compute/instance-groups/managed/create index e972d3e3d..17b3c18b5 100644 --- a/gcloud/alpha/compute/instance-groups/managed/create +++ b/gcloud/alpha/compute/instance-groups/managed/create @@ -22,6 +22,7 @@ SYNOPSIS [auto-delete=AUTO-DELETE],[interface-name=INTERFACE-NAME]] [--stopped-size=STOPPED_SIZE] [--suspended-size=SUSPENDED_SIZE] [--target-distribution-shape=SHAPE] [--target-pool=[TARGET_POOL,...]] + [--target-size-policy-mode=TARGET_SIZE_POLICY_MODE] [--zones=ZONE,[ZONE,...]] [--health-check=HEALTH_CHECK | --http-health-check=HTTP_HEALTH_CHECK | --https-health-check=HTTPS_HEALTH_CHECK] @@ -309,6 +310,21 @@ OPTIONAL FLAGS Specifies any target pools you want the instances of this managed instance group to be part of. + --target-size-policy-mode=TARGET_SIZE_POLICY_MODE + Specifies mode in which operations on size are processed. + TARGET_SIZE_POLICY_MODE must be one of: + + bulk + Mode in which MIG creates and starts VMs in all-or-nothing manner. + If any VM from the request cannot be provisioned, the whole request + waits for conditions that allow for provisioning whole capacity in + bulk. + individual + Default mode in which MIG creates and starts VMs individually + without cross-dependency between VMs. This means that in case of + something blocking part of VMs to be provisioned, the other part + will be created. + --zones=ZONE,[ZONE,...] If this flag is specified a regional managed instance group will be created. The managed instance group will be in the same region as diff --git a/gcloud/alpha/compute/instances/network-interfaces/add b/gcloud/alpha/compute/instances/network-interfaces/add index 0f8cbd522..52f92e226 100644 --- a/gcloud/alpha/compute/instances/network-interfaces/add +++ b/gcloud/alpha/compute/instances/network-interfaces/add @@ -10,7 +10,8 @@ SYNOPSIS [--internal-ipv6-prefix-length=INTERNAL_IPV6_PREFIX_LENGTH] [--ipv6-address=IPV6_ADDRESS] [--ipv6-network-tier=IPV6_NETWORK_TIER] [--ipv6-prefix-length=IPV6_PREFIX_LENGTH] [--network=NETWORK] - [--network-tier=NETWORK_TIER] [--parent-nic-name=PARENT_NIC_NAME] + [--network-attachment=NETWORK_ATTACHMENT] [--network-tier=NETWORK_TIER] + [--parent-nic-name=PARENT_NIC_NAME] [--private-network-ip=PRIVATE_NETWORK_IP] [--stack-type=STACK_TYPE] [--subnetwork=SUBNETWORK] [--vlan=VLAN] [--zone=ZONE] [--address=ADDRESS | --no-address] [GCLOUD_WIDE_FLAG ...] @@ -91,6 +92,9 @@ FLAGS --network=NETWORK Specifies the network this network interface belongs to. + --network-attachment=NETWORK_ATTACHMENT + The network attachment URL this network interface should connect to. + --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance network interface. NETWORK_TIER must be one of: PREMIUM, STANDARD, diff --git a/gcloud/alpha/compute/public-delegated-prefixes/create b/gcloud/alpha/compute/public-delegated-prefixes/create index 38394ed3a..51c1638d6 100644 --- a/gcloud/alpha/compute/public-delegated-prefixes/create +++ b/gcloud/alpha/compute/public-delegated-prefixes/create @@ -47,8 +47,9 @@ OPTIONAL FLAGS Specify if this public delegated prefix is meant to be live migrated. --mode=MODE - Specifies the mode of this IPv6 PDP. MODE must be one of: - EXTERNAL_IPV6_FORWARDING_RULE_CREATION, DELEGATION. + Specifies the mode of this IPv6 PDP. MODE must be one of: delegation, + external-ipv6-forwarding-rule-creation, + external-ipv6-subnetwork-creation. At most one of these can be specified: diff --git a/gcloud/alpha/compute/public-delegated-prefixes/delegated-sub-prefixes/create b/gcloud/alpha/compute/public-delegated-prefixes/delegated-sub-prefixes/create index de30a1c81..2db0e8b7b 100644 --- a/gcloud/alpha/compute/public-delegated-prefixes/delegated-sub-prefixes/create +++ b/gcloud/alpha/compute/public-delegated-prefixes/delegated-sub-prefixes/create @@ -56,8 +56,9 @@ OPTIONAL FLAGS Description of the delegated sub prefix to create. --mode=MODE - Specify mode for the sub prefix. MODE must be one of: DELEGATION, - EXTERNAL_IPV6_FORWARDING_RULE_CREATION. + Specifies the mode of this IPv6 PDP. MODE must be one of: delegation, + external-ipv6-forwarding-rule-creation, + external-ipv6-subnetwork-creation. --range=RANGE IPv4 range from this public delegated prefix that should be delegated, diff --git a/gcloud/alpha/compute/snapshots/create b/gcloud/alpha/compute/snapshots/create index d064509ba..823a16e36 100644 --- a/gcloud/alpha/compute/snapshots/create +++ b/gcloud/alpha/compute/snapshots/create @@ -12,6 +12,9 @@ SYNOPSIS [--source-disk-key-file=FILE] [--source-instant-snapshot=SOURCE_INSTANT_SNAPSHOT] [--source-instant-snapshot-key-file=FILE] [--storage-location=LOCATION] + [--global | --region=REGION] + [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING + --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] [--source-disk-region=SOURCE_DISK_REGION | --source-disk-zone=SOURCE_DISK_ZONE] [--source-instant-snapshot-region=SOURCE_INSTANT_SNAPSHOT_REGION @@ -123,6 +126,57 @@ FLAGS snapshot content is to be stored. If absent, a nearby regional or multi-regional location is chosen automatically. + Scope for snapshot. + + At most one of these can be specified: + + --global + If set, the snapshot will be created in the global scope + + --region=REGION + If set, the snapshot will be created in the regional scope + + Key resource - The Cloud KMS (Key Management Service) cryptokey that will + be used to protect the snapshot. The 'Compute Engine Service Agent' + service account must hold permission 'Cloud KMS CryptoKey + Encrypter/Decrypter'. The arguments in this group can be used to specify + the attributes of this resource. + + --kms-key=KMS_KEY + ID of the key or fully qualified identifier for the key. + + To set the kms-key attribute: + ▸ provide the argument --kms-key on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --kms-keyring=KMS_KEYRING + The KMS keyring of the key. + + To set the kms-keyring attribute: + ▸ provide the argument --kms-key on the command line with a fully + specified name; + ▸ provide the argument --kms-keyring on the command line. + + --kms-location=KMS_LOCATION + The Google Cloud location for the key. + + To set the kms-location attribute: + ▸ provide the argument --kms-key on the command line with a fully + specified name; + ▸ provide the argument --kms-location on the command line; + ▸ provide the argument --region on the command line. + + --kms-project=KMS_PROJECT + The Google Cloud project for the key. + + To set the kms-project attribute: + ▸ provide the argument --kms-key on the command line with a fully + specified name; + ▸ provide the argument --kms-project on the command line; + ▸ set the property core/project. + At most one of these can be specified: --source-disk-region=SOURCE_DISK_REGION diff --git a/gcloud/alpha/config/get b/gcloud/alpha/config/get index 63c4b4206..598b25dea 100644 --- a/gcloud/alpha/config/get +++ b/gcloud/alpha/config/get @@ -374,6 +374,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud filestore command group. Defaults to https://file.googleapis.com/ + firebasedataconnect + Overrides API endpoint for gcloud firebase-data-connect command + group. Defaults to https://firebasedataconnect.googleapis.com/ + firestore Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ diff --git a/gcloud/alpha/config/help b/gcloud/alpha/config/help index 151ebcc51..1a0d93699 100644 --- a/gcloud/alpha/config/help +++ b/gcloud/alpha/config/help @@ -406,6 +406,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud filestore command group. Defaults to https://file.googleapis.com/ + firebasedataconnect + Overrides API endpoint for gcloud firebase-data-connect command + group. Defaults to https://firebasedataconnect.googleapis.com/ + firestore Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ diff --git a/gcloud/alpha/config/list b/gcloud/alpha/config/list index 4d7314e8e..c4f820ecb 100644 --- a/gcloud/alpha/config/list +++ b/gcloud/alpha/config/list @@ -418,6 +418,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud filestore command group. Defaults to https://file.googleapis.com/ + firebasedataconnect + Overrides API endpoint for gcloud firebase-data-connect command + group. Defaults to https://firebasedataconnect.googleapis.com/ + firestore Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ diff --git a/gcloud/alpha/config/set b/gcloud/alpha/config/set index 25f9f2dab..34194f8e1 100644 --- a/gcloud/alpha/config/set +++ b/gcloud/alpha/config/set @@ -421,6 +421,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud filestore command group. Defaults to https://file.googleapis.com/ + firebasedataconnect + Overrides API endpoint for gcloud firebase-data-connect command + group. Defaults to https://firebasedataconnect.googleapis.com/ + firestore Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ diff --git a/gcloud/alpha/config/unset b/gcloud/alpha/config/unset index 09a633bb8..619bdadd6 100644 --- a/gcloud/alpha/config/unset +++ b/gcloud/alpha/config/unset @@ -382,6 +382,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud filestore command group. Defaults to https://file.googleapis.com/ + firebasedataconnect + Overrides API endpoint for gcloud firebase-data-connect command + group. Defaults to https://firebasedataconnect.googleapis.com/ + firestore Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ diff --git a/gcloud/alpha/container/fleet/mesh/update b/gcloud/alpha/container/fleet/mesh/update index e1bfb7fa4..12e3e1291 100644 --- a/gcloud/alpha/container/fleet/mesh/update +++ b/gcloud/alpha/container/fleet/mesh/update @@ -110,7 +110,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: $ gcloud container fleet mesh update + $ gcloud beta container fleet mesh update + diff --git a/gcloud/alpha/container/hub/mesh/update b/gcloud/alpha/container/hub/mesh/update index 0f1154688..5bbbb678d 100644 --- a/gcloud/alpha/container/hub/mesh/update +++ b/gcloud/alpha/container/hub/mesh/update @@ -110,7 +110,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: $ gcloud container hub mesh update + $ gcloud beta container hub mesh update + diff --git a/gcloud/alpha/dataproc/clusters/create b/gcloud/alpha/dataproc/clusters/create index fd1f9708e..302a6919f 100644 --- a/gcloud/alpha/dataproc/clusters/create +++ b/gcloud/alpha/dataproc/clusters/create @@ -39,6 +39,7 @@ SYNOPSIS [--secondary-worker-machine-types=type=MACHINE_TYPE[, type=MACHINE_TYPE...][,rank=RANK]] [--secondary-worker-standard-capacity-base=SECONDARY_WORKER_STANDARD_CAPACITY_BASE] + [--secondary-worker-standard-capacity-percent-above-base=SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--shielded-vtpm] [--temp-bucket=TEMP_BUCKET] [--worker-accelerator=[type=TYPE,[count=COUNT],...]] @@ -364,7 +365,21 @@ FLAGS --secondary-worker-machine-types="type=e2-standard-8,type=t2d-standard-8,rank=0" --secondary-worker-standard-capacity-base=SECONDARY_WORKER_STANDARD_CAPACITY_BASE - The number of standard VMs in the Spot and Standard Mix feature. + This flag sets the base number of Standard VMs to use for secondary + workers + (https://cloud.google.com/dataproc/docs/concepts/compute/secondary-vms#preemptible_and_non-preemptible_secondary_workers). + Dataproc will create only standard VMs until it reaches this number, + then it will mix Spot and Standard VMs according to + SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE. + + --secondary-worker-standard-capacity-percent-above-base=SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE + When combining Standard and Spot VMs for secondary-workers + (https://cloud.google.com/dataproc/docs/concepts/compute/secondary-vms#preemptible_and_non-preemptible_secondary_workers) + once the number of Standard VMs specified by + SECONDARY_WORKER_STANDARD_CAPACITY_BASE has been used, this flag + specifies the percentage of the total number of additional Standard VMs + secondary workers will use. Spot VMs will be used for the remaining + percentage. --shielded-integrity-monitoring Enables monitoring and attestation of the boot integrity of the diff --git a/gcloud/alpha/dataproc/workflow-templates/set-managed-cluster b/gcloud/alpha/dataproc/workflow-templates/set-managed-cluster index 33d53d395..9dd5afd0d 100644 --- a/gcloud/alpha/dataproc/workflow-templates/set-managed-cluster +++ b/gcloud/alpha/dataproc/workflow-templates/set-managed-cluster @@ -32,6 +32,7 @@ SYNOPSIS [--secondary-worker-machine-types=type=MACHINE_TYPE[, type=MACHINE_TYPE...][,rank=RANK]] [--secondary-worker-standard-capacity-base=SECONDARY_WORKER_STANDARD_CAPACITY_BASE] + [--secondary-worker-standard-capacity-percent-above-base=SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--shielded-vtpm] [--temp-bucket=TEMP_BUCKET] [--worker-accelerator=[type=TYPE,[count=COUNT],...]] @@ -296,7 +297,21 @@ FLAGS --secondary-worker-machine-types="type=e2-standard-8,type=t2d-standard-8,rank=0" --secondary-worker-standard-capacity-base=SECONDARY_WORKER_STANDARD_CAPACITY_BASE - The number of standard VMs in the Spot and Standard Mix feature. + This flag sets the base number of Standard VMs to use for secondary + workers + (https://cloud.google.com/dataproc/docs/concepts/compute/secondary-vms#preemptible_and_non-preemptible_secondary_workers). + Dataproc will create only standard VMs until it reaches this number, + then it will mix Spot and Standard VMs according to + SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE. + + --secondary-worker-standard-capacity-percent-above-base=SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE + When combining Standard and Spot VMs for secondary-workers + (https://cloud.google.com/dataproc/docs/concepts/compute/secondary-vms#preemptible_and_non-preemptible_secondary_workers) + once the number of Standard VMs specified by + SECONDARY_WORKER_STANDARD_CAPACITY_BASE has been used, this flag + specifies the percentage of the total number of additional Standard VMs + secondary workers will use. Spot VMs will be used for the remaining + percentage. --shielded-integrity-monitoring Enables monitoring and attestation of the boot integrity of the diff --git a/gcloud/alpha/datastore/indexes/create b/gcloud/alpha/datastore/indexes/create index fac8f0fbe..165ab45b0 100644 --- a/gcloud/alpha/datastore/indexes/create +++ b/gcloud/alpha/datastore/indexes/create @@ -18,7 +18,7 @@ EXAMPLES Detailed information about index configuration can be found at the index.yaml reference - (https://cloud.google.com/appengine/docs/standard/python/config/indexref). + (https://cloud.google.com/datastore/docs/tools/indexconfig). POSITIONAL ARGUMENTS INDEX_FILE diff --git a/gcloud/alpha/iap/web/disable b/gcloud/alpha/iap/web/disable index 107cf6541..ee47a4838 100644 --- a/gcloud/alpha/iap/web/disable +++ b/gcloud/alpha/iap/web/disable @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha iap web disable - [--resource-type=RESOURCE_TYPE : --service=SERVICE] + [--resource-type=RESOURCE_TYPE : --region=REGION --service=SERVICE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -26,6 +26,10 @@ FLAGS Resource type of the IAP resource. RESOURCE_TYPE must be one of: app-engine, backend-services. + --region=REGION + Region name. Not applicable for app-engine. Optional when resource-type + is compute. + --service=SERVICE Service name. Required with --resource-type=backend-services. diff --git a/gcloud/alpha/iap/web/enable b/gcloud/alpha/iap/web/enable index cb4aead0b..6f660dbf9 100644 --- a/gcloud/alpha/iap/web/enable +++ b/gcloud/alpha/iap/web/enable @@ -6,7 +6,7 @@ SYNOPSIS gcloud alpha iap web enable [--oauth2-client-id=OAUTH2_CLIENT_ID --oauth2-client-secret=OAUTH2_CLIENT_SECRET] - [--resource-type=RESOURCE_TYPE : --service=SERVICE] + [--resource-type=RESOURCE_TYPE : --region=REGION --service=SERVICE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -37,6 +37,10 @@ FLAGS Resource type of the IAP resource. RESOURCE_TYPE must be one of: app-engine, backend-services. + --region=REGION + Region name. Not applicable for app-engine. Optional when resource-type + is compute. + --service=SERVICE Service name. Required with --resource-type=backend-services. diff --git a/gcloud/alpha/looker/instances/create b/gcloud/alpha/looker/instances/create index ea19f05dd..530c936af 100644 --- a/gcloud/alpha/looker/instances/create +++ b/gcloud/alpha/looker/instances/create @@ -10,6 +10,8 @@ SYNOPSIS : --reserved-range=RESERVED_RANGE] [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE --deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE --deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] + [--gemini-enabled + : --gemini-preview-tester-enabled --gemini-prompt-log-enabled] [--maintenance-window-day=MAINTENANCE_WINDOW_DAY --maintenance-window-time=MAINTENANCE_WINDOW_TIME] [--psc-enabled : --psc-allowed-vpcs=[PSC_ALLOWED_VPCS,...]] @@ -25,7 +27,7 @@ DESCRIPTION EXAMPLES To create a basic tier instance with the name my-looker-instance in region - us-central-1 with an edition of "LOOKER_CORE_STANDARD", run: + us-central-1 with an edition of LOOKER_CORE_STANDARD, run: $ gcloud alpha looker instances create my-looker-instance \ --region=us-central1 --edition="core-standard" \ @@ -182,16 +184,31 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + Gemini AI - Gemini AI is a powerful AI model that can be used to answer + questions, generate content, and perform a variety of other tasks. + + --gemini-enabled + This specifies whether Gemini AI is enabled on the Looker instance. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --gemini-preview-tester-enabled + This specifies whether user opts in for Gemini AI public preview for + the Looker instance. + + --gemini-prompt-log-enabled + This specifies whether Gemini AI prompt logging is enabled for the + Looker instance. + Maintenance Window - Maintenance typically only takes place once every few months, and requires your instance to be restarted while updates are made, which disrupts service briefly. --maintenance-window-day=MAINTENANCE_WINDOW_DAY - Day of week for maintenance window, in UTC time zone. To set the - maintenance-window-day attribute: - ▸ provide the argument --maintenance-window-day on the command - line. MAINTENANCE_WINDOW_DAY must be one of: friday, monday, - saturday, sunday, thursday, tuesday, wednesday. + Day of week for maintenance window, in UTC time zone. + MAINTENANCE_WINDOW_DAY must be one of: friday, monday, saturday, + sunday, thursday, tuesday, wednesday. This flag argument must be specified if any of the other arguments in this group are specified. @@ -199,10 +216,7 @@ OPTIONAL FLAGS --maintenance-window-time=MAINTENANCE_WINDOW_TIME Hour of day for maintenance window, in UTC time zone. A valid time of day must be specified in 24hr format (ex: 13:00, 17:30, 23:45). - Maintenance will be scheduled within 60 minutes. To set the - maintenance-window-time attribute: - ▸ provide the argument --maintenance-window-time on the command - line. + Maintenance will be scheduled within 60 minutes. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/alpha/managed-flink/deployments/create b/gcloud/alpha/managed-flink/deployments/create index 3ea1d5875..1a7ae028d 100644 --- a/gcloud/alpha/managed-flink/deployments/create +++ b/gcloud/alpha/managed-flink/deployments/create @@ -89,7 +89,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedflink/v1alpha API. The full documentation for - this API can be found at: go/managed-flink-design + this API can be found at: + https://cloud.google.com/managed-flink/docs/overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-flink/deployments/delete b/gcloud/alpha/managed-flink/deployments/delete index d433d8776..a252ca3fe 100644 --- a/gcloud/alpha/managed-flink/deployments/delete +++ b/gcloud/alpha/managed-flink/deployments/delete @@ -65,7 +65,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedflink/v1alpha API. The full documentation for - this API can be found at: go/managed-flink-design + this API can be found at: + https://cloud.google.com/managed-flink/docs/overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-flink/deployments/describe b/gcloud/alpha/managed-flink/deployments/describe index 49ba1b741..bccfdec75 100644 --- a/gcloud/alpha/managed-flink/deployments/describe +++ b/gcloud/alpha/managed-flink/deployments/describe @@ -60,7 +60,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedflink/v1alpha API. The full documentation for - this API can be found at: go/managed-flink-design + this API can be found at: + https://cloud.google.com/managed-flink/docs/overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-flink/deployments/list b/gcloud/alpha/managed-flink/deployments/list index 3e2a6f6e0..6a413aafa 100644 --- a/gcloud/alpha/managed-flink/deployments/list +++ b/gcloud/alpha/managed-flink/deployments/list @@ -72,7 +72,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedflink/v1alpha API. The full documentation for - this API can be found at: go/managed-flink-design + this API can be found at: + https://cloud.google.com/managed-flink/docs/overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-flink/deployments/update b/gcloud/alpha/managed-flink/deployments/update index 2796b7320..c55b5b083 100644 --- a/gcloud/alpha/managed-flink/deployments/update +++ b/gcloud/alpha/managed-flink/deployments/update @@ -69,7 +69,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedflink/v1alpha API. The full documentation for - this API can be found at: go/managed-flink-design + this API can be found at: + https://cloud.google.com/managed-flink/docs/overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-flink/jobs/delete b/gcloud/alpha/managed-flink/jobs/delete index 583e7a517..84be146c7 100644 --- a/gcloud/alpha/managed-flink/jobs/delete +++ b/gcloud/alpha/managed-flink/jobs/delete @@ -63,7 +63,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedflink/v1alpha API. The full documentation for - this API can be found at: go/managed-flink-design + this API can be found at: + https://cloud.google.com/managed-flink/docs/overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-flink/jobs/describe b/gcloud/alpha/managed-flink/jobs/describe index 48011a64a..beff06c70 100644 --- a/gcloud/alpha/managed-flink/jobs/describe +++ b/gcloud/alpha/managed-flink/jobs/describe @@ -59,7 +59,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedflink/v1alpha API. The full documentation for - this API can be found at: go/managed-flink-design + this API can be found at: + https://cloud.google.com/managed-flink/docs/overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-flink/jobs/list b/gcloud/alpha/managed-flink/jobs/list index fefb2a616..be99e2fb2 100644 --- a/gcloud/alpha/managed-flink/jobs/list +++ b/gcloud/alpha/managed-flink/jobs/list @@ -70,7 +70,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedflink/v1alpha API. The full documentation for - this API can be found at: go/managed-flink-design + this API can be found at: + https://cloud.google.com/managed-flink/docs/overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/network-connectivity/internal-ranges/create b/gcloud/alpha/network-connectivity/internal-ranges/create index 2fe6b1a86..0df95310b 100644 --- a/gcloud/alpha/network-connectivity/internal-ranges/create +++ b/gcloud/alpha/network-connectivity/internal-ranges/create @@ -156,7 +156,8 @@ OPTIONAL FLAGS for-migration Ranges created with FOR_MIGRATION are used as locks for migrating - subnetworks between peered VPC networks. + subnetworks between peered VPC networks. This value is for internal + use. for-vpc A cloud resource can use the reserved CIDR block by associating it @@ -173,14 +174,14 @@ OPTIONAL FLAGS --migration-source=MIGRATION_SOURCE The migration source subnetwork (of a for-migration internal range) - resource URI or resource ID. + resource URI or resource ID. This value is for internal use. This flag argument must be specified if any of the other arguments in this group are specified. --migration-target=MIGRATION_TARGET The migration target subnetwork (of a for-migration internal range) - resource URI or resource ID. + resource URI or resource ID. This value is for internal use. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/alpha/network-security/security-profile-groups/create b/gcloud/alpha/network-security/security-profile-groups/create index 575a162a2..3c6483936 100644 --- a/gcloud/alpha/network-security/security-profile-groups/create +++ b/gcloud/alpha/network-security/security-profile-groups/create @@ -7,6 +7,8 @@ SYNOPSIS (SECURITY_PROFILE_GROUP : --location=LOCATION --organization=ORGANIZATION) [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--custom-intercept-profile=CUSTOM_INTERCEPT_PROFILE + : --custom-intercept-profile-location=CUSTOM_INTERCEPT_PROFILE_LOCATION --custom-intercept-profile-organization=CUSTOM_INTERCEPT_PROFILE_ORGANIZATION] [--custom-mirroring-profile=CUSTOM_MIRRORING_PROFILE : --custom-mirroring-profile-location=CUSTOM_MIRRORING_PROFILE_LOCATION --custom-mirroring-profile-organization=CUSTOM_MIRRORING_PROFILE_ORGANIZATION] [--threat-prevention-profile=THREAT_PREVENTION_PROFILE @@ -77,6 +79,48 @@ FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + Security Profile resource - Path to Security Profile resource. The + arguments in this group can be used to specify the attributes of this + resource. + + --custom-intercept-profile=CUSTOM_INTERCEPT_PROFILE + ID of the Security Profile or fully qualified identifier for the + Security Profile. + + To set the custom-intercept-profile-profile attribute: + ▸ provide the argument --custom-intercept-profile on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --custom-intercept-profile-location=CUSTOM_INTERCEPT_PROFILE_LOCATION + Location of the Security Profile. NOTE: Only global security profiles + are supported. + + To set the custom-intercept-profile-location attribute: + ▸ provide the argument --custom-intercept-profile on the command + line with a fully specified name; + ▸ provide the argument --custom-intercept-profile-location on the + command line; + ▸ provide the argument --location on the command line; + ▸ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + --custom-intercept-profile-organization=CUSTOM_INTERCEPT_PROFILE_ORGANIZATION + Organization ID of the Security Profile. + + To set the custom-intercept-profile-organization attribute: + ▸ provide the argument --custom-intercept-profile on the command + line with a fully specified name; + ▸ provide the argument --custom-intercept-profile-organization on + the command line; + ▸ provide the argument --organization on the command line; + ▸ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + Security Profile resource - Path to Security Profile resource. The arguments in this group can be used to specify the attributes of this resource. diff --git a/gcloud/alpha/network-services/help b/gcloud/alpha/network-services/help index 21f697c98..41ede16e2 100644 --- a/gcloud/alpha/network-services/help +++ b/gcloud/alpha/network-services/help @@ -48,9 +48,15 @@ GROUPS multicast-group-definitions (ALPHA) Manage Network Services MulticastGroupDefinitions. + multicast-group-producer-activations + (ALPHA) Manage Network Services MulticastGroupProducerActivations. + multicast-groups (ALPHA) Manage Network Services MulticastGroups. + multicast-producer-associations + (ALPHA) Manage Network Services MulticastProducerAssociations. + observability-policies (ALPHA) Manage Network Services ObservabilityPolicies. diff --git a/gcloud/alpha/network-services/multicast-group-consumer-activations/describe b/gcloud/alpha/network-services/multicast-group-consumer-activations/describe index 0e593dc3a..cceb795f0 100644 --- a/gcloud/alpha/network-services/multicast-group-consumer-activations/describe +++ b/gcloud/alpha/network-services/multicast-group-consumer-activations/describe @@ -1,6 +1,6 @@ NAME gcloud alpha network-services multicast-group-consumer-activations describe - - describe a multicast group consumer activations + - describe a multicast group consumer activation SYNOPSIS gcloud alpha network-services multicast-group-consumer-activations describe @@ -8,12 +8,12 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Show details of a multicastgroup consumer activations in the + (ALPHA) Show details of a multicast group consumer activation in the specified location of the current project. EXAMPLES - To describe details of a multicast group consumer activations in the - current project and location, run: + To describe details of a multicast group consumer activation in the current + project and location, run: $ gcloud alpha network-services \ multicast-group-consumer-activations describe \ diff --git a/gcloud/alpha/network-services/multicast-group-consumer-activations/help b/gcloud/alpha/network-services/multicast-group-consumer-activations/help index 4fa39af77..a4c6c3b82 100644 --- a/gcloud/alpha/network-services/multicast-group-consumer-activations/help +++ b/gcloud/alpha/network-services/multicast-group-consumer-activations/help @@ -24,7 +24,7 @@ COMMANDS (ALPHA) Delete a multicast group consumer activation. describe - (ALPHA) Describe a multicast group consumer activations. + (ALPHA) Describe a multicast group consumer activation. list (ALPHA) List multicast group consumer activations. diff --git a/gcloud/alpha/network-services/multicast-group-producer-activations/create b/gcloud/alpha/network-services/multicast-group-producer-activations/create new file mode 100644 index 000000000..34810d7e7 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-group-producer-activations/create @@ -0,0 +1,101 @@ +NAME + gcloud alpha network-services multicast-group-producer-activations create - + create a multicast group producer activation + +SYNOPSIS + gcloud alpha network-services multicast-group-producer-activations create + (MULTICAST_GROUP_PRODUCER_ACTIVATION : --location=LOCATION) + --multicast-group=MULTICAST_GROUP + --multicast-producer-association=MULTICAST_PRODUCER_ASSOCIATION + [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a multicast group producer activation in the specified + location of the current project. + +EXAMPLES + Create a multicast group producer activation with the name + 'my-multicast-group-producer-activation', multicast-producer-association + 'path-to-mpa', multicast-group 'path-to-mg', and location 'zone'. + + $ gcloud alpha network-services \ + multicast-group-producer-activations create \ + my-multicast-group-producer-activation \ + --multicast-producer-association=path-to-mpa \ + --multicast-group=path-to-mg --location=zone + +POSITIONAL ARGUMENTS + Multicast group producer activation resource - Name of the multicast group + producer activation to be created. The arguments in this group can be used + to specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_producer_activation on the + command line with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + MULTICAST_GROUP_PRODUCER_ACTIVATION + ID of the multicast group producer activation or fully qualified + identifier for the multicast group producer activation. + + To set the multicast_group_producer_activation attribute: + ▸ provide the argument multicast_group_producer_activation on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_producer_activation on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --multicast-group=MULTICAST_GROUP + The multicast group to be used. + + --multicast-producer-association=MULTICAST_PRODUCER_ASSOCIATION + The multicast producer association to be used. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description for the multicast group producer activation. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/network-services/multicast-group-producer-activations/delete b/gcloud/alpha/network-services/multicast-group-producer-activations/delete new file mode 100644 index 000000000..909f5ee8c --- /dev/null +++ b/gcloud/alpha/network-services/multicast-group-producer-activations/delete @@ -0,0 +1,77 @@ +NAME + gcloud alpha network-services multicast-group-producer-activations delete - + delete a multicast group producer activation + +SYNOPSIS + gcloud alpha network-services multicast-group-producer-activations delete + (MULTICAST_GROUP_PRODUCER_ACTIVATION : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a multicast group producer activation in the specified + location of the current project. + +EXAMPLES + To delete a multicast group producer activation in the current project, + run: + + $ gcloud alpha network-services \ + multicast-group-producer-activations delete \ + my-multicast-group-producer-activation --location=zone + +POSITIONAL ARGUMENTS + Multicast group producer activation resource - The multicast group + producer activation to delete. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_producer_activation on the + command line with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + MULTICAST_GROUP_PRODUCER_ACTIVATION + ID of the multicast group producer activation or fully qualified + identifier for the multicast group producer activation. + + To set the multicast_group_producer_activation attribute: + ▸ provide the argument multicast_group_producer_activation on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_producer_activation on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/network-services/multicast-group-producer-activations/describe b/gcloud/alpha/network-services/multicast-group-producer-activations/describe new file mode 100644 index 000000000..6e138294b --- /dev/null +++ b/gcloud/alpha/network-services/multicast-group-producer-activations/describe @@ -0,0 +1,72 @@ +NAME + gcloud alpha network-services multicast-group-producer-activations describe + - describe a multicast group producer activation + +SYNOPSIS + gcloud alpha network-services multicast-group-producer-activations describe + (MULTICAST_GROUP_PRODUCER_ACTIVATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show details of a multicastgroup producer activation in the + specified location of the current project. + +EXAMPLES + To describe details of a multicast group producer activation in the current + project and location, run: + + $ gcloud alpha network-services \ + multicast-group-producer-activations describe \ + my-multicast-group-producer-activation --location=zone + +POSITIONAL ARGUMENTS + Multicast group producer activation resource - The multicast group + producer activation to display. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_producer_activation on the + command line with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + MULTICAST_GROUP_PRODUCER_ACTIVATION + ID of the multicast group producer activation or fully qualified + identifier for the multicast group producer activation. + + To set the multicast_group_producer_activation attribute: + ▸ provide the argument multicast_group_producer_activation on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_producer_activation on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/network-services/multicast-group-producer-activations/help b/gcloud/alpha/network-services/multicast-group-producer-activations/help new file mode 100644 index 000000000..805ba0c53 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-group-producer-activations/help @@ -0,0 +1,37 @@ +NAME + gcloud alpha network-services multicast-group-producer-activations - manage + Network Services MulticastGroupProducerActivations + +SYNOPSIS + gcloud alpha network-services multicast-group-producer-activations COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Network Services MulticastGroupProducerActivations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a multicast group producer activation. + + delete + (ALPHA) Delete a multicast group producer activation. + + describe + (ALPHA) Describe a multicast group producer activation. + + list + (ALPHA) List multicast group producer activations. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/network-services/multicast-group-producer-activations/list b/gcloud/alpha/network-services/multicast-group-producer-activations/list new file mode 100644 index 000000000..c5023edc4 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-group-producer-activations/list @@ -0,0 +1,90 @@ +NAME + gcloud alpha network-services multicast-group-producer-activations list - + list multicast group producer activations + +SYNOPSIS + gcloud alpha network-services multicast-group-producer-activations list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List all multicast group producer activations in the specified + location of the current project. + +EXAMPLES + To list multicast group producer activations in the current project and + location, run: + + $ gcloud alpha network-services \ + multicast-group-producer-activations list --location=zone + +REQUIRED FLAGS + Location resource - The location of the multicast producer associations to + display. This represents a Cloud resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/network-services/multicast-producer-associations/create b/gcloud/alpha/network-services/multicast-producer-associations/create new file mode 100644 index 000000000..331f990e8 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-producer-associations/create @@ -0,0 +1,99 @@ +NAME + gcloud alpha network-services multicast-producer-associations create - + create a multicast producer association + +SYNOPSIS + gcloud alpha network-services multicast-producer-associations create + (MULTICAST_PRODUCER_ASSOCIATION : --location=LOCATION) + --multicast-domain-activation=MULTICAST_DOMAIN_ACTIVATION + --network=NETWORK [--async] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a multicast producer association in the specified location + of the current project. + +EXAMPLES + Create a multicast producer association with the name + 'my-multicast-producer-association', multicast-domain-activation + 'path-to-mda', network 'path-to-network', and location 'zone'. + + $ gcloud alpha network-services multicast-producer-associations \ + create my-multicast-producer-association \ + --multicast-domain-activation=path-to-mda \ + --network=path-to-network --location=zone + +POSITIONAL ARGUMENTS + Multicast producer association resource - Name of the multicast producer + association to be created. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_producer_association on the command + line with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + MULTICAST_PRODUCER_ASSOCIATION + ID of the multicast producer association or fully qualified + identifier for the multicast producer association. + + To set the multicast_producer_association attribute: + ▸ provide the argument multicast_producer_association on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_producer_association on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --multicast-domain-activation=MULTICAST_DOMAIN_ACTIVATION + The multicast domain activation to be used. + + --network=NETWORK + The path of the multicast producer VPC network. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description for the multicast producer association. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/network-services/multicast-producer-associations/delete b/gcloud/alpha/network-services/multicast-producer-associations/delete new file mode 100644 index 000000000..86cfc79af --- /dev/null +++ b/gcloud/alpha/network-services/multicast-producer-associations/delete @@ -0,0 +1,75 @@ +NAME + gcloud alpha network-services multicast-producer-associations delete - + delete a multicast producer association + +SYNOPSIS + gcloud alpha network-services multicast-producer-associations delete + (MULTICAST_PRODUCER_ASSOCIATION : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a multicast producer association in the specified location + of the current project. + +EXAMPLES + To delete a multicast producer association in the current project, run: + + $ gcloud alpha network-services multicast-producer-associations \ + delete my-multicast-producer-association --location=zone + +POSITIONAL ARGUMENTS + Multicast producer association resource - The multicast producer + association to delete. The arguments in this group can be used to specify + the attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_producer_association on the command + line with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + MULTICAST_PRODUCER_ASSOCIATION + ID of the multicast producer association or fully qualified + identifier for the multicast producer association. + + To set the multicast_producer_association attribute: + ▸ provide the argument multicast_producer_association on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_producer_association on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/network-services/multicast-producer-associations/describe b/gcloud/alpha/network-services/multicast-producer-associations/describe new file mode 100644 index 000000000..566e3890c --- /dev/null +++ b/gcloud/alpha/network-services/multicast-producer-associations/describe @@ -0,0 +1,71 @@ +NAME + gcloud alpha network-services multicast-producer-associations describe - + describe a multicast producer associations + +SYNOPSIS + gcloud alpha network-services multicast-producer-associations describe + (MULTICAST_PRODUCER_ASSOCIATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show details of a multicast producer association in the specified + location of the current project. + +EXAMPLES + To describe details of a multicast producer association in the current + project and location, run: + + $ gcloud alpha network-services multicast-producer-associations \ + describe my-multicast-producer-association --location=zone + +POSITIONAL ARGUMENTS + Multicast producer association resource - The multicast producer + association to display. The arguments in this group can be used to specify + the attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_producer_association on the command + line with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + MULTICAST_PRODUCER_ASSOCIATION + ID of the multicast producer association or fully qualified + identifier for the multicast producer association. + + To set the multicast_producer_association attribute: + ▸ provide the argument multicast_producer_association on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_producer_association on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/network-services/multicast-producer-associations/help b/gcloud/alpha/network-services/multicast-producer-associations/help new file mode 100644 index 000000000..7f6edfefc --- /dev/null +++ b/gcloud/alpha/network-services/multicast-producer-associations/help @@ -0,0 +1,37 @@ +NAME + gcloud alpha network-services multicast-producer-associations - manage + Network Services MulticastProducerAssociations + +SYNOPSIS + gcloud alpha network-services multicast-producer-associations COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Network Services MulticastProducerAssociations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a multicast producer association. + + delete + (ALPHA) Delete a multicast producer association. + + describe + (ALPHA) Describe a multicast producer associations. + + list + (ALPHA) List multicast producer associations. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/network-services/multicast-producer-associations/list b/gcloud/alpha/network-services/multicast-producer-associations/list new file mode 100644 index 000000000..4d8d5eae5 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-producer-associations/list @@ -0,0 +1,90 @@ +NAME + gcloud alpha network-services multicast-producer-associations list - list + multicast producer associations + +SYNOPSIS + gcloud alpha network-services multicast-producer-associations list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List all multicast producer associations in the specified location + of the current project. + +EXAMPLES + To list multicast producer associations in the current project and + location, run: + + $ gcloud alpha network-services multicast-producer-associations \ + list --location=zone + +REQUIRED FLAGS + Location resource - The location of the multicast producer associations to + display. This represents a Cloud resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/sql/instances/create b/gcloud/alpha/sql/instances/create index e12c408a4..34fedc2fc 100644 --- a/gcloud/alpha/sql/instances/create +++ b/gcloud/alpha/sql/instances/create @@ -41,6 +41,7 @@ SYNOPSIS [--password-policy-min-length=PASSWORD_POLICY_MIN_LENGTH] [--password-policy-password-change-interval=PASSWORD_POLICY_PASSWORD_CHANGE_INTERVAL] [--password-policy-reuse-interval=PASSWORD_POLICY_REUSE_INTERVAL] + [--psc-auto-connections=[network=NETWORK],[project=PROJECT]] [--[no-]recreate-replicas-on-primary-crash] [--replica-type=REPLICA_TYPE] [--replication=REPLICATION] [--require-ssl] [--retained-backups-count=RETAINED_BACKUPS_COUNT] @@ -381,6 +382,35 @@ FLAGS Number of previous passwords that cannot be reused. The valid range is 0 to 100. + --psc-auto-connections=[network=NETWORK],[project=PROJECT] + A comma-separated list of networks or a comma-separated list of + network-project pairs. Each project in this list is represented by a + project number (numeric) or by a project ID (alphanumeric). This allows + Private Service Connect connections to be created automatically for the + specified networks. For example, this connection uses "the form + psc-auto-connections=network=projects/testproject1/global/networks/testnetwork1" + or "the form + psc-auto-connections=project=testproject1,network=projects/testproject1/global/networks/testnetwork1". + Sets psc_auto_connections value. + + network + Required, Sets network value. + + project + Sets project value. + + Shorthand Example: + + --psc-auto-connections=network=string,project=string + + JSON Example: + + --psc-auto-connections='{"network": "string", "project": "string"}' + + File Example: + + --psc-auto-connections=path_to_file.(yaml|json) + --[no-]recreate-replicas-on-primary-crash Allow/Disallow replica recreation when a primary MySQL instance operating in reduced durability mode crashes. Not recreating the diff --git a/gcloud/alpha/sql/instances/patch b/gcloud/alpha/sql/instances/patch index 9e6e47b1f..a344d2f77 100644 --- a/gcloud/alpha/sql/instances/patch +++ b/gcloud/alpha/sql/instances/patch @@ -58,6 +58,8 @@ SYNOPSIS | --clear-authorized-networks] [--clear-database-flags | --database-flags=FLAG=VALUE,[FLAG=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] + [--clear-psc-auto-connections + | --psc-auto-connections=[network=NETWORK],[project=PROJECT]] [--gce-zone=GCE_ZONE | --secondary-zone=SECONDARY_ZONE --zone=ZONE] [--no-backup | --backup-location=BACKUP_LOCATION --backup-start-time=BACKUP_START_TIME @@ -503,6 +505,43 @@ FLAGS silently ignored. If --update-labels is also specified then --update-labels is applied first. + At most one of these can be specified: + + --clear-psc-auto-connections + This removes all connections created automatically. Cloud SQL uses + these connections to connect to an instance using Private Service + Connect. + + --psc-auto-connections=[network=NETWORK],[project=PROJECT] + A comma-separated list of networks or a comma-separated list of + network-project pairs. Each project in this list is represented by a + project number (numeric) or by a project ID (alphanumeric). This + allows Private Service Connect connections to be created + automatically for the specified networks. For example, this + connection uses "the form + psc-auto-connections=network=projects/testproject1/global/networks/testnetwork1" + or "the form + psc-auto-connections=project=testproject1,network=projects/testproject1/global/networks/testnetwork1". + Sets psc_auto_connections value. + + network + Required, Sets network value. + + project + Sets project value. + + Shorthand Example: + + --psc-auto-connections=network=string,project=string + + JSON Example: + + --psc-auto-connections='{"network": "string", "project": "string"}' + + File Example: + + --psc-auto-connections=path_to_file.(yaml|json) + At most one of these can be specified: --gce-zone=GCE_ZONE diff --git a/gcloud/alpha/storage/buckets/create b/gcloud/alpha/storage/buckets/create index 5a4fad5f1..5910746d9 100644 --- a/gcloud/alpha/storage/buckets/create +++ b/gcloud/alpha/storage/buckets/create @@ -9,7 +9,7 @@ SYNOPSIS [--default-storage-class=DEFAULT_STORAGE_CLASS, -c DEFAULT_STORAGE_CLASS, -s DEFAULT_STORAGE_CLASS] [--enable-hierarchical-namespace] [--enable-per-object-retention] - [--location=LOCATION, -l LOCATION] + [--ip-filter-file=IP_FILTER_FILE] [--location=LOCATION, -l LOCATION] [--[no-]pap, --[no-]public-access-prevention] [--placement=REGION,REGION] [--recovery-point-objective=SETTING, --rpo=SETTING] @@ -66,6 +66,23 @@ FLAGS Enables each object in the bucket to have its own retention settings, which prevents deletion until stored for a specific length of time. + --ip-filter-file=IP_FILTER_FILE + Sets the IP filter for the bucket. The IP filter is a list of ip ranges + that are allowed to access the bucket. For example, The following JSON + document shows the IP filter configuration with mode enabled and list + of public network sources and vpc network sources: + + { + "mode": "Enabled", + "publicNetworkSource": { "allowedIpCidrRanges": ["0.0.0.0/0"] }, + "vpcNetworkSources": [ + { + "network": "projects/PROJECT_NAME/global/networks/NETWORK_NAME", + "allowedIpCidrRanges": ["0.0.0.0/0"] + }, + ] + } + --location=LOCATION, -l LOCATION Location (https://cloud.google.com/storage/docs/locations) for the bucket. If not specified, the location used by Cloud Storage is us. A diff --git a/gcloud/alpha/storage/buckets/update b/gcloud/alpha/storage/buckets/update index cd3a9b840..4c9509d53 100644 --- a/gcloud/alpha/storage/buckets/update +++ b/gcloud/alpha/storage/buckets/update @@ -20,6 +20,7 @@ SYNOPSIS [--clear-cors | --cors-file=CORS_FILE] [--clear-default-encryption-key | --default-encryption-key=DEFAULT_ENCRYPTION_KEY] + [--clear-ip-filter | --ip-filter-file=IP_FILTER_FILE] [--clear-labels | --labels-file=LABELS_FILE | --remove-labels=[LABEL_KEYS,...] --update-labels=[LABEL_KEYS_AND_VALUES,...]] @@ -189,6 +190,28 @@ FLAGS --default-encryption-key=DEFAULT_ENCRYPTION_KEY Set the default KMS key for the bucket. + At most one of these can be specified: + + --clear-ip-filter + Disables and clears IP filter configuration of the bucket. + + --ip-filter-file=IP_FILTER_FILE + Sets the IP filter for the bucket. The IP filter is a list of ip + ranges that are allowed to access the bucket. For example, The + following JSON document shows the IP filter configuration with mode + enabled and list of public network sources and vpc network sources: + + { + "mode": "Enabled", + "publicNetworkSource": { "allowedIpCidrRanges": ["0.0.0.0/0"] }, + "vpcNetworkSources": [ + { + "network": "projects/PROJECT_NAME/global/networks/NETWORK_NAME", + "allowedIpCidrRanges": ["0.0.0.0/0"] + }, + ] + } + At most one of these can be specified: --clear-labels diff --git a/gcloud/alpha/storage/folders/create b/gcloud/alpha/storage/folders/create index 1be20a233..c3e6cd2ef 100644 --- a/gcloud/alpha/storage/folders/create +++ b/gcloud/alpha/storage/folders/create @@ -49,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 storage folders create diff --git a/gcloud/alpha/storage/folders/delete b/gcloud/alpha/storage/folders/delete index 430cda7a5..227507cac 100644 --- a/gcloud/alpha/storage/folders/delete +++ b/gcloud/alpha/storage/folders/delete @@ -37,5 +37,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 storage folders delete diff --git a/gcloud/alpha/storage/folders/describe b/gcloud/alpha/storage/folders/describe index a4fa1d9ac..e163502b7 100644 --- a/gcloud/alpha/storage/folders/describe +++ b/gcloud/alpha/storage/folders/describe @@ -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 storage folders describe diff --git a/gcloud/alpha/storage/folders/help b/gcloud/alpha/storage/folders/help index aa81591ee..62245682f 100644 --- a/gcloud/alpha/storage/folders/help +++ b/gcloud/alpha/storage/folders/help @@ -31,5 +31,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 storage folders diff --git a/gcloud/alpha/storage/folders/list b/gcloud/alpha/storage/folders/list index 72568fdf1..d86a7cfb3 100644 --- a/gcloud/alpha/storage/folders/list +++ b/gcloud/alpha/storage/folders/list @@ -91,5 +91,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 storage folders list diff --git a/gcloud/apphub/applications/create b/gcloud/apphub/applications/create index 1d6d3fc2c..f614ba31b 100644 --- a/gcloud/apphub/applications/create +++ b/gcloud/apphub/applications/create @@ -54,9 +54,10 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --scope-type=SCOPE_TYPE - Scope of the Application. SCOPE_TYPE must be (only one value is - supported): + Scope of the Application. SCOPE_TYPE must be one of: + GLOBAL + Represents a global application REGIONAL Represents a regional application diff --git a/gcloud/artifacts/docker/images/scan b/gcloud/artifacts/docker/images/scan index 5925b507f..f3fbbb52b 100644 --- a/gcloud/artifacts/docker/images/scan +++ b/gcloud/artifacts/docker/images/scan @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud artifacts docker images scan RESOURCE_URI [--additional-package-types=[ADDITIONAL_PACKAGE_TYPES,...]] [--async] - [--location=LOCATION; default="us"] [--remote] [GCLOUD_WIDE_FLAG ...] + [--location=LOCATION; default="us"] [--remote] + [--skip-package-types=[SKIP_PACKAGE_TYPES,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION You can scan a container image in a Google Cloud registry (Artifact @@ -50,13 +51,29 @@ POSITIONAL ARGUMENTS FLAGS --additional-package-types=[ADDITIONAL_PACKAGE_TYPES,...] - A comma-separated list of package types to scan in addition to OS - packages. ADDITIONAL_PACKAGE_TYPES must be one of: + (DEPRECATED) A comma-separated list of package types to scan in + addition to OS packages. + This flag is deprecated as scanning for all package types is now the + default. To skip scanning for specific package types, use + --skip-package-types. ADDITIONAL_PACKAGE_TYPES must be one of: + + COMPOSER + PHP Composer package. GO Go standard library and third party packages. MAVEN Maven package. + NPM + NPM package. + NUGET + NuGet package. + PYTHON + Python package. + RUBYGEMS + RubyGems package. + RUST + Rust package. --async Return immediately, without waiting for the operation in progress to @@ -78,6 +95,27 @@ FLAGS Whether the container image is located remotely or on your local machine. + --skip-package-types=[SKIP_PACKAGE_TYPES,...] + A comma-separated list of package types to skip when scanning. + SKIP_PACKAGE_TYPES must be one of: + + COMPOSER + PHP Composer package. + GO + Go standard library and third party packages. + MAVEN + Maven package. + NPM + NPM package. + NUGET + NuGet package. + PYTHON + Python package. + RUBYGEMS + RubyGems package. + RUST + Rust package. + 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/asset/query b/gcloud/asset/query index 908e9153c..f9711ebec 100644 --- a/gcloud/asset/query +++ b/gcloud/asset/query @@ -62,7 +62,7 @@ REQUIRED FLAGS A BigQuery Standard SQL compatible statement. If the query execution finishes within timeout and there is no pagination, the full query results will be returned. Otherwise, pass job_reference from previous - call as --job-referrence to obtain the full results. + call as --job-reference to obtain the full results. OPTIONAL FLAGS --page-size=PAGE_SIZE diff --git a/gcloud/beta/artifacts/docker/images/scan b/gcloud/beta/artifacts/docker/images/scan index 499cb108b..f602ddffe 100644 --- a/gcloud/beta/artifacts/docker/images/scan +++ b/gcloud/beta/artifacts/docker/images/scan @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud beta artifacts docker images scan RESOURCE_URI [--additional-package-types=[ADDITIONAL_PACKAGE_TYPES,...]] [--async] - [--location=LOCATION; default="us"] [--remote] [GCLOUD_WIDE_FLAG ...] + [--location=LOCATION; default="us"] [--remote] + [--skip-package-types=[SKIP_PACKAGE_TYPES,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) You can scan a container image in a Google Cloud registry (Artifact @@ -51,13 +52,29 @@ POSITIONAL ARGUMENTS FLAGS --additional-package-types=[ADDITIONAL_PACKAGE_TYPES,...] - A comma-separated list of package types to scan in addition to OS - packages. ADDITIONAL_PACKAGE_TYPES must be one of: + (DEPRECATED) A comma-separated list of package types to scan in + addition to OS packages. + This flag is deprecated as scanning for all package types is now the + default. To skip scanning for specific package types, use + --skip-package-types. ADDITIONAL_PACKAGE_TYPES must be one of: + + COMPOSER + PHP Composer package. GO Go standard library and third party packages. MAVEN Maven package. + NPM + NPM package. + NUGET + NuGet package. + PYTHON + Python package. + RUBYGEMS + RubyGems package. + RUST + Rust package. --async Return immediately, without waiting for the operation in progress to @@ -79,6 +96,27 @@ FLAGS Whether the container image is located remotely or on your local machine. + --skip-package-types=[SKIP_PACKAGE_TYPES,...] + A comma-separated list of package types to skip when scanning. + SKIP_PACKAGE_TYPES must be one of: + + COMPOSER + PHP Composer package. + GO + Go standard library and third party packages. + MAVEN + Maven package. + NPM + NPM package. + NUGET + NuGet package. + PYTHON + Python package. + RUBYGEMS + RubyGems package. + RUST + Rust package. + 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/asset/query b/gcloud/beta/asset/query index 3ef3d1ca4..f95886e9a 100644 --- a/gcloud/beta/asset/query +++ b/gcloud/beta/asset/query @@ -62,7 +62,7 @@ REQUIRED FLAGS A BigQuery Standard SQL compatible statement. If the query execution finishes within timeout and there is no pagination, the full query results will be returned. Otherwise, pass job_reference from previous - call as --job-referrence to obtain the full results. + call as --job-reference to obtain the full results. OPTIONAL FLAGS --page-size=PAGE_SIZE diff --git a/gcloud/beta/bigtable/app-profiles/create b/gcloud/beta/bigtable/app-profiles/create index c170f9400..87cc572eb 100644 --- a/gcloud/beta/bigtable/app-profiles/create +++ b/gcloud/beta/bigtable/app-profiles/create @@ -116,23 +116,23 @@ OPTIONAL FLAGS Data Boost Read-only Isolation --data-boost - Use Data Boost serverless compute option, rather than standard - provisioned node compute. If specified, - --data-boost-compute-billing-owner is required. Specifying Data - Boost compute on an app profile that uses standard provisioned node - compute may cause unexpected behavior for running applications. + Use Data Boost Read-only Isolation, rather than Standard Isolation. + If specified, --data-boost-compute-billing-owner is required. + Specifying Data Boost Read-only Isolation on an app profile which + has Standard Isolation enabled may cause unexpected behavior for + running applications. This flag argument must be specified if any of the other arguments in this group are specified. --data-boost-compute-billing-owner=DATA_BOOST_COMPUTE_BILLING_OWNER - Specify the Data Boost compute billing owner, required if + Specify the Data Boost Compute Billing Owner, required if --data-boost is passed. DATA_BOOST_COMPUTE_BILLING_OWNER must be (only one value is supported): HOST_PAYS - Compute billing should be accounted towards the host Cloud - project (containing the targeted Bigtable instance / table). + Compute Billing should be accounted towards the host Cloud + Project (containing the targeted Bigtable Instance / Table). This flag argument must be specified if any of the other arguments in this group are specified. @@ -140,15 +140,14 @@ OPTIONAL FLAGS Standard Isolation --priority=PRIORITY - Specify the request priority under standard provisioned node - compute capabilities. Passing this option implies standard - provisioned node compute, e.g. the --standard option. If not - specified, the app profile uses standard provisioned node compute - with PRIORITY_HIGH by default. Specifying request priority on an - app profile that has Data Boost serverless compute enabled changes - the compute option to standard and uses the specified priority, - which might cause unexpected behavior for running applications. - PRIORITY must be one of: + Specify the request priority under Standard Isolation. Passing this + option implies Standard Isolation, e.g. the --standard option. If + not specified, the app profile uses Standard Isolation with + PRIORITY_HIGH by default. Specifying request priority on an app + profile that has Data Boost Read-Only Isolation enabled will change + the isolation to Standard and use the specified priority, which may + cause unexpected behavior for running applications. PRIORITY must + be one of: PRIORITY_HIGH Requests are treated with high priority. @@ -161,8 +160,8 @@ OPTIONAL FLAGS in this group are specified. --standard - Use standard provisioned node compute option, rather than Data - Boost compute option. If specified, --priority is required. + Use Standard Isolation, rather than Data Boost Read-only Isolation. + If specified, --priority is required. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/bigtable/app-profiles/update b/gcloud/beta/bigtable/app-profiles/update index ab39962c6..fd0a6e906 100644 --- a/gcloud/beta/bigtable/app-profiles/update +++ b/gcloud/beta/bigtable/app-profiles/update @@ -93,23 +93,23 @@ FLAGS Data Boost Read-only Isolation --data-boost - Use Data Boost serverless compute option, rather than standard - provisioned node compute. If specified, - --data-boost-compute-billing-owner is required. Specifying Data - Boost compute on an app profile that uses standard provisioned node - compute may cause unexpected behavior for running applications. + Use Data Boost Read-only Isolation, rather than Standard Isolation. + If specified, --data-boost-compute-billing-owner is required. + Specifying Data Boost Read-only Isolation on an app profile which + has Standard Isolation enabled may cause unexpected behavior for + running applications. This flag argument must be specified if any of the other arguments in this group are specified. --data-boost-compute-billing-owner=DATA_BOOST_COMPUTE_BILLING_OWNER - Specify the Data Boost compute billing owner, required if + Specify the Data Boost Compute Billing Owner, required if --data-boost is passed. DATA_BOOST_COMPUTE_BILLING_OWNER must be (only one value is supported): HOST_PAYS - Compute billing should be accounted towards the host Cloud - project (containing the targeted Bigtable instance / table). + Compute Billing should be accounted towards the host Cloud + Project (containing the targeted Bigtable Instance / Table). This flag argument must be specified if any of the other arguments in this group are specified. @@ -117,15 +117,14 @@ FLAGS Standard Isolation --priority=PRIORITY - Specify the request priority under standard provisioned node - compute capabilities. Passing this option implies standard - provisioned node compute, e.g. the --standard option. If not - specified, the app profile uses standard provisioned node compute - with PRIORITY_HIGH by default. Specifying request priority on an - app profile that has Data Boost serverless compute enabled changes - the compute option to standard and uses the specified priority, - which might cause unexpected behavior for running applications. - PRIORITY must be one of: + Specify the request priority under Standard Isolation. Passing this + option implies Standard Isolation, e.g. the --standard option. If + not specified, the app profile uses Standard Isolation with + PRIORITY_HIGH by default. Specifying request priority on an app + profile that has Data Boost Read-Only Isolation enabled will change + the isolation to Standard and use the specified priority, which may + cause unexpected behavior for running applications. PRIORITY must + be one of: PRIORITY_HIGH Requests are treated with high priority. @@ -138,8 +137,8 @@ FLAGS in this group are specified. --standard - Use standard provisioned node compute option, rather than Data - Boost compute option. If specified, --priority is required. + Use Standard Isolation, rather than Data Boost Read-only Isolation. + If specified, --priority is required. At most one of these can be specified: diff --git a/gcloud/beta/colab-enterprise/help b/gcloud/beta/colab-enterprise/help index 89c0ee3ff..2d5dbd5d3 100644 --- a/gcloud/beta/colab-enterprise/help +++ b/gcloud/beta/colab-enterprise/help @@ -1,11 +1,11 @@ NAME - gcloud beta colab-enterprise - colab Enterprise Command Group + gcloud beta colab-enterprise - manage Colab Enterprise resources SYNOPSIS gcloud beta colab-enterprise GROUP [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Colab Enterprise Command Group. + (BETA) Manage Colab Enterprise resources. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -16,10 +16,10 @@ GROUPS GROUP is one of the following: runtime-templates - (BETA) Colab Enterprise Runtime Templates command group. + (BETA) Manage Colab Enterprise runtime templates. runtimes - (BETA) Colab Enterprise Runtimes command group. + (BETA) Manage Colab Enterprise runtimes. NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/colab-enterprise/runtime-templates/help b/gcloud/beta/colab-enterprise/runtime-templates/help index 4b885cb4a..dc7399e33 100644 --- a/gcloud/beta/colab-enterprise/runtime-templates/help +++ b/gcloud/beta/colab-enterprise/runtime-templates/help @@ -1,6 +1,6 @@ NAME - gcloud beta colab-enterprise runtime-templates - colab Enterprise Runtime - Templates command group + gcloud beta colab-enterprise runtime-templates - manage Colab Enterprise + runtime templates SYNOPSIS gcloud beta colab-enterprise runtime-templates COMMAND diff --git a/gcloud/beta/colab-enterprise/runtimes/help b/gcloud/beta/colab-enterprise/runtimes/help index 9cb41d8a6..5c5c6b9ce 100644 --- a/gcloud/beta/colab-enterprise/runtimes/help +++ b/gcloud/beta/colab-enterprise/runtimes/help @@ -1,6 +1,5 @@ NAME - gcloud beta colab-enterprise runtimes - colab Enterprise Runtimes command - group + gcloud beta colab-enterprise runtimes - manage Colab Enterprise runtimes SYNOPSIS gcloud beta colab-enterprise runtimes COMMAND [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/beta/colab/help b/gcloud/beta/colab/help new file mode 100644 index 000000000..374f999d9 --- /dev/null +++ b/gcloud/beta/colab/help @@ -0,0 +1,26 @@ +NAME + gcloud beta colab - manage Colab Enterprise resources + +SYNOPSIS + gcloud beta colab GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Colab Enterprise resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + runtime-templates + (BETA) Manage Colab Enterprise runtime templates. + + runtimes + (BETA) Manage Colab Enterprise runtimes. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/colab/runtime-templates/add-iam-policy-binding b/gcloud/beta/colab/runtime-templates/add-iam-policy-binding new file mode 100644 index 000000000..846dad321 --- /dev/null +++ b/gcloud/beta/colab/runtime-templates/add-iam-policy-binding @@ -0,0 +1,88 @@ +NAME + gcloud beta colab runtime-templates add-iam-policy-binding - add an IAM + policy binding to a Colab Enterprise runtime template + +SYNOPSIS + gcloud beta colab runtime-templates add-iam-policy-binding + (RUNTIME_TEMPLATE : --region=REGION) --member=PRINCIPAL --role=ROLE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Adds an IAM policy binding to a Colab Enterprise runtime template. + +EXAMPLES + To set someone@example.com to have the roles/aiplatform.notebookRuntimeUser + role for a runtime template with id my-runtime-template in region + us-central1, run: + + $ gcloud beta colab runtime-templates add-iam-policy-binding \ + my-runtime-template --region=us-central1 \ + --member=user:someone@example.com \ + --role=roles/aiplatform.notebookRuntimeUser + +POSITIONAL ARGUMENTS + Runtime template resource - Unique name of the runtime template to add IAM + policy binding to. This was optionally provided by setting + --runtime-template-id in the create runtime-template command, or was + system-generated if unspecified. 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 runtime_template 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. + + RUNTIME_TEMPLATE + ID of the runtime template or fully qualified identifier for the + runtime template. + + To set the name attribute: + ▸ provide the argument runtime_template on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the runtime template. + + To set the region attribute: + ▸ provide the argument runtime_template 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. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/colab/runtime-templates/create b/gcloud/beta/colab/runtime-templates/create new file mode 100644 index 000000000..1f0f7e72b --- /dev/null +++ b/gcloud/beta/colab/runtime-templates/create @@ -0,0 +1,226 @@ +NAME + gcloud beta colab runtime-templates create - create a runtime template + +SYNOPSIS + gcloud beta colab runtime-templates create --display-name=DISPLAY_NAME + --region=REGION [--async] [--runtime-template-id=RUNTIME_TEMPLATE_ID] + [--description=DESCRIPTION --no-enable-euc --enable-secure-boot + --idle-shutdown-timeout=IDLE_SHUTDOWN_TIMEOUT; default="3h" + --labels=[KEY=VALUE,...] --network-tags=[TAGS,...] + --accelerator-count=ACCELERATOR_COUNT + --accelerator-type=ACCELERATOR_TYPE --machine-type=MACHINE_TYPE; + default="e2-standard-4" --disk-size-gb=DISK_SIZE_GB; default=100 + --disk-type=DISK_TYPE; default="PD_STANDARD" [--kms-key=KMS_KEY + : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION + --kms-project=KMS_PROJECT] --no-enable-internet-access + --network=NETWORK [--subnetwork=SUBNETWORK + : --subnetwork-region=SUBNETWORK_REGION]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Creates a Colab Enterprise runtime template, a VM configuration for + your notebook runtimes. + +EXAMPLES + To create a runtime template in region 'us-central1' with the display name + 'my-runtime-template', run: + + $ gcloud beta colab runtime-templates create --region=us-central1 \ + --display-name=my-runtime-template + + To create a runtime template for a VM with machine type n1-standard-2 and + one NVIDIA_TESLA_V100 accelerator, run: + + $ gcloud beta colab runtime-templates create \ + --machine-type=n1-standard-2 \ + --accelerator-type=NVIDIA_TESLA_V100 --accelerator-count=1 \ + --region=us-central1 --display-name=my-runtime-template + + To create a runtime template that disables end user credential access, run: + + $ gcloud beta colab runtime-templates create --no-enable-euc \ + --region=us-central1 --display-name=my-runtime-template + +REQUIRED FLAGS + --display-name=DISPLAY_NAME + The display name of the runtime template. + + Region resource - Cloud region to create runtime template. Please see + https://cloud.google.com/colab/docs/locations for a list of supported + regions. 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 region or fully qualified identifier for the region. + + To set the region attribute: + ▸ provide the argument --region on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --runtime-template-id=RUNTIME_TEMPLATE_ID + The id of the runtime template. If not specified, a random id will be + generated. + + Configuration of the runtime template + + --description=DESCRIPTION + The description of the runtime template. + + --enable-euc + Enable end user credential access for the runtime. Enabled by + default, use --no-enable-euc to disable. + + --enable-secure-boot + Enables secure boot for the runtime. Disabled by default. + + --idle-shutdown-timeout=IDLE_SHUTDOWN_TIMEOUT; default="3h" + The duration after which the runtime is automatically shut down. An + input of 0s disables the idle shutdown feature, and a valid range is + [10m, 24h]. See '$ gcloud topic datetimes' for details on formatting + the input duration. + + --labels=[KEY=VALUE,...] + Add labels to identify and group the runtime template. + + --network-tags=[TAGS,...] + Applies the given Compute Engine tags to the runtime. + + The machine configuration of the runtime provisioned from this template. + + --accelerator-count=ACCELERATOR_COUNT + The number of accelerators used by the runtime. + + --accelerator-type=ACCELERATOR_TYPE + The type of hardware accelerator used by the runtime. If specified, + --accelerator-count must also be specified. ACCELERATOR_TYPE must + be one of: NVIDIA_TESLA_V100, NVIDIA_TESLA_T4, NVIDIA_TESLA_A100, + NVIDIA_A100_80GB, NVIDIA_L4. + + --machine-type=MACHINE_TYPE; default="e2-standard-4" + The Compute Engine machine type selected for the runtime. + + The configuration for the data disk of the runtime provisioned from this + template. + + --disk-size-gb=DISK_SIZE_GB; default=100 + The disk size of the runtime in GB. If specified, the --disk-type + must also be specified. The minimum size is 10GB and the maximum is + 65536GB. + + --disk-type=DISK_TYPE; default="PD_STANDARD" + The type of the persistent disk. DISK_TYPE must be one of: + PD_STANDARD, PD_SSD, PD_BALANCED, PD_EXTREME. + + Key resource - The Cloud KMS encryption key (customer-managed encryption + key) used to protect the runtime. The key must be in the same region as + the runtime. If not specified, Google-managed encryption keys will be + used. The arguments in this group can be used to specify the attributes + of this resource. + + --kms-key=KMS_KEY + ID of the key or fully qualified identifier for the key. + + To set the kms-key attribute: + ▫ provide the argument --kms-key on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --kms-keyring=KMS_KEYRING + KMS keyring id of the key. + + To set the kms-keyring attribute: + ▫ provide the argument --kms-key on the command line with a fully + specified name; + ▫ provide the argument --kms-keyring on the command line. + + --kms-location=KMS_LOCATION + Cloud location for the key. + + To set the kms-location attribute: + ▫ provide the argument --kms-key on the command line with a fully + specified name; + ▫ provide the argument --kms-location on the command line. + + --kms-project=KMS_PROJECT + Cloud project id for the key. + + To set the kms-project attribute: + ▫ provide the argument --kms-key on the command line with a fully + specified name; + ▫ provide the argument --kms-project on the command line. + + The network configuration for the runtime. + + --enable-internet-access + Enable public internet access for the runtime. Enabled by default, + use --no-enable-internet-access to disable. + + Network resource - The name of the VPC that this runtime is in. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▫ provide the argument --network on the command line with a fully + specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --network=NETWORK + ID of the network or fully qualified identifier for the network. + + To set the network attribute: + ◇ provide the argument --network on the command line. + + Subnetwork resource - The name of the subnetwork that this runtime is + in. 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 --subnetwork on the command line with a + fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --subnetwork=SUBNETWORK + ID of the subnetwork or fully qualified identifier for the + subnetwork. + + To set the subnetwork attribute: + ◇ provide the argument --subnetwork on the command line. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --subnetwork-region=SUBNETWORK_REGION + Google Cloud region of this subnetwork + https://cloud.google.com/compute/docs/regions-zones/#locations. + + To set the subnetwork-region attribute: + ◇ provide the argument --subnetwork on the command line with a + fully specified name; + ◇ provide the argument --subnetwork-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. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/colab/runtime-templates/delete b/gcloud/beta/colab/runtime-templates/delete new file mode 100644 index 000000000..bec060399 --- /dev/null +++ b/gcloud/beta/colab/runtime-templates/delete @@ -0,0 +1,67 @@ +NAME + gcloud beta colab runtime-templates delete - delete a runtime template + +SYNOPSIS + gcloud beta colab runtime-templates delete + (RUNTIME_TEMPLATE : --region=REGION) [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Deletes a Colab Enterprise notebook runtime template. + +EXAMPLES + To delete a runtime template with id 'my-runtime-template' in region + 'us-central1', run: + + $ gcloud beta colab runtime-templates delete my-runtime-template \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Runtime template resource - Unique name of the runtime template to delete. + This was optionally provided by setting --runtime-template-id in the + create runtime-template command, or was system-generated if unspecified. + 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 runtime_template 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. + + RUNTIME_TEMPLATE + ID of the runtime template or fully qualified identifier for the + runtime template. + + To set the name attribute: + ▸ provide the argument runtime_template on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the runtime template. + + To set the region attribute: + ▸ provide the argument runtime_template on the command line with a + fully specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/colab/runtime-templates/describe b/gcloud/beta/colab/runtime-templates/describe new file mode 100644 index 000000000..1504b543f --- /dev/null +++ b/gcloud/beta/colab/runtime-templates/describe @@ -0,0 +1,62 @@ +NAME + gcloud beta colab runtime-templates describe - describe a runtime template + +SYNOPSIS + gcloud beta colab runtime-templates describe + (RUNTIME_TEMPLATE : --region=REGION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describes a Colab Enterprise notebook runtime template. + +EXAMPLES + To describe a runtime template with id 'my-runtime-template' in region + 'us-central1', run: + + $ gcloud beta colab runtime-templates describe my-runtime-template \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Runtime template resource - Unique name of the runtime template to + describe. This was optionally provided by setting --runtime-template-id in + the create runtime-template command, or was system-generated if + unspecified. 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 runtime_template 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. + + RUNTIME_TEMPLATE + ID of the runtime template or fully qualified identifier for the + runtime template. + + To set the name attribute: + ▸ provide the argument runtime_template on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the runtime template. + + To set the region attribute: + ▸ provide the argument runtime_template 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. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/colab/runtime-templates/get-iam-policy b/gcloud/beta/colab/runtime-templates/get-iam-policy new file mode 100644 index 000000000..3acde5604 --- /dev/null +++ b/gcloud/beta/colab/runtime-templates/get-iam-policy @@ -0,0 +1,93 @@ +NAME + gcloud beta colab runtime-templates get-iam-policy - get IAM policy for a + Colab Enterprise runtime template + +SYNOPSIS + gcloud beta colab runtime-templates get-iam-policy + (RUNTIME_TEMPLATE : --region=REGION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Gets the IAM policy for a Colab Enterprise runtime template. + +EXAMPLES + To get the IAM policy for a runtime template with id my-runtime-template in + region us-central1, run: + + $ gcloud beta colab runtime-templates get-iam-policy \ + my-runtime-template --location=us-central1 \ + --member=user:someone@example.com \ + --role=roles/aiplatform.notebookRuntimeUser + +POSITIONAL ARGUMENTS + Runtime template resource - Unique name of the runtime template to get IAM + policy for. This was optionally provided by setting --runtime-template-id + in the create runtime-template command, or was system-generated if + unspecified. 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 runtime_template 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. + + RUNTIME_TEMPLATE + ID of the runtime template or fully qualified identifier for the + runtime template. + + To set the name attribute: + ▸ provide the argument runtime_template on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the runtime template. + + To set the region attribute: + ▸ provide the argument runtime_template 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. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/colab/runtime-templates/help b/gcloud/beta/colab/runtime-templates/help new file mode 100644 index 000000000..437eb0f52 --- /dev/null +++ b/gcloud/beta/colab/runtime-templates/help @@ -0,0 +1,49 @@ +NAME + gcloud beta colab runtime-templates - manage Colab Enterprise runtime + templates + +SYNOPSIS + gcloud beta colab runtime-templates COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) For more information about runtime templates, see + https://cloud.google.com/colab/docs/runtimes#runtime-templates + +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 Colab Enterprise runtime + template. + + create + (BETA) Create a runtime template. + + delete + (BETA) Delete a runtime template. + + describe + (BETA) Describe a runtime template. + + get-iam-policy + (BETA) Get IAM policy for a Colab Enterprise runtime template. + + list + (BETA) List your runtime templates. + + remove-iam-policy-binding + (BETA) Remove an IAM policy binding from a Colab Enterprise runtime + template. + + set-iam-policy + (BETA) Set IAM policy for a Colab Enterprise runtime template as + defined in a JSON or YAML file. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/colab/runtime-templates/list b/gcloud/beta/colab/runtime-templates/list new file mode 100644 index 000000000..bc6bc4512 --- /dev/null +++ b/gcloud/beta/colab/runtime-templates/list @@ -0,0 +1,81 @@ +NAME + gcloud beta colab runtime-templates list - list your runtime templates + +SYNOPSIS + gcloud beta colab runtime-templates list --region=REGION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Lists your project's Colab Enterprise notebook runtime templates in + a given region. + +EXAMPLES + To list your runtime templates in region 'us-central1', run: + + $ gcloud beta colab runtime-templates list --region=us-central1 + +REQUIRED FLAGS + Region resource - Cloud region for which to list all runtime templates. + Please see https://cloud.google.com/colab/docs/locations for a list of + supported regions. 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 region or fully qualified identifier for the region. + + To set the region attribute: + ▸ 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. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/colab/runtime-templates/remove-iam-policy-binding b/gcloud/beta/colab/runtime-templates/remove-iam-policy-binding new file mode 100644 index 000000000..89edf9f61 --- /dev/null +++ b/gcloud/beta/colab/runtime-templates/remove-iam-policy-binding @@ -0,0 +1,90 @@ +NAME + gcloud beta colab runtime-templates remove-iam-policy-binding - remove an + IAM policy binding from a Colab Enterprise runtime template + +SYNOPSIS + gcloud beta colab runtime-templates remove-iam-policy-binding + (RUNTIME_TEMPLATE : --region=REGION) --member=PRINCIPAL --role=ROLE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Removes an IAM policy binding from a Colab Enterprise runtime + template. + +EXAMPLES + To remove an IAM policy binding of roles/aiplatform.notebookRuntimeUser for + someone@example.com, from the runtime template with id my-runtime-template + in region us-central1, run: + + $ gcloud beta colab runtime-templates remove-iam-policy-binding \ + my-runtime-template --region=us-central1 \ + --member=user:someone@example.com \ + --role=roles/aiplatform.notebookRuntimeUser + +POSITIONAL ARGUMENTS + Runtime template resource - Unique name of the runtime template to remove + IAM policy from. This was optionally provided by setting + --runtime-template-id in the create runtime-template command, or was + system-generated if unspecified. 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 runtime_template 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. + + RUNTIME_TEMPLATE + ID of the runtime template or fully qualified identifier for the + runtime template. + + To set the name attribute: + ▸ provide the argument runtime_template on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the runtime template. + + To set the region attribute: + ▸ provide the argument runtime_template 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. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/colab/runtime-templates/set-iam-policy b/gcloud/beta/colab/runtime-templates/set-iam-policy new file mode 100644 index 000000000..6fd059df4 --- /dev/null +++ b/gcloud/beta/colab/runtime-templates/set-iam-policy @@ -0,0 +1,74 @@ +NAME + gcloud beta colab runtime-templates set-iam-policy - set IAM policy for a + Colab Enterprise runtime template as defined in a JSON or YAML file + +SYNOPSIS + gcloud beta colab runtime-templates set-iam-policy + (RUNTIME_TEMPLATE : --region=REGION) POLICY_FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Sets the IAM policy for a Colab Enterprise runtime template as + defined in a JSON or YAML file. + + See https://cloud.google.com/iam/docs/managing-policies for details of the + policy file format and contents. + +EXAMPLES + To set the IAM policy for a runtime template with id my-runtime-template in + region us-central1 to the policy defined in policy.json, run: + + $ gcloud beta colab runtime-templates set-iam-policy \ + my-runtime-template policy.json --region=us-central1 + +POSITIONAL ARGUMENTS + Runtime template resource - Unique name of the runtime template to set IAM + policy for. This was optionally provided by setting --runtime-template-id + in the create runtime-template command, or was system-generated if + unspecified. 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 runtime_template 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. + + RUNTIME_TEMPLATE + ID of the runtime template or fully qualified identifier for the + runtime template. + + To set the name attribute: + ▸ provide the argument runtime_template on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the runtime template. + + To set the region attribute: + ▸ provide the argument runtime_template 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. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/colab/runtimes/assign b/gcloud/beta/colab/runtimes/assign new file mode 100644 index 000000000..51783a4b1 --- /dev/null +++ b/gcloud/beta/colab/runtimes/assign @@ -0,0 +1,108 @@ +NAME + gcloud beta colab runtimes assign - assign a notebook runtime + +SYNOPSIS + gcloud beta colab runtimes assign --display-name=DISPLAY_NAME + --region=REGION --runtime-template=RUNTIME_TEMPLATE [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--runtime-id=RUNTIME_ID] [--runtime-user=RUNTIME_USER] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Assign a notebook runtime to run code from your notebook (IPYNB + file). + +EXAMPLES + To create a runtime in region 'us-central1' with the display name + 'my-runtime' and template with id 'my-template', run: + + $ gcloud beta colab runtimes assign --region=us-central1 \ + --display-name=my-runtime --runtime-template=my-template + + To create a runtime for user 'USER@DOMAIN.COM', run: + + $ gcloud beta colab runtimes assign --runtime-user=USER@DOMAIN.COM \ + --region=us-central1 --display-name=my-runtime \ + --runtime-template=my-template + +REQUIRED FLAGS + --display-name=DISPLAY_NAME + The display name of the runtime to assign. + + Region resource - Cloud region to assign runtime. Please see + https://cloud.google.com/colab/docs/locations for a list of supported + regions. 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 region or fully qualified identifier for the region. + + To set the region attribute: + ▸ provide the argument --region on the command line. + + Runtime template resource - Unique name of the runtime template to + configure the runtime with. This was optionally provided by setting + --runtime-template-id in the create runtime-template command, or was + system-generated if unspecified. 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 --runtime-template on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the region attribute: + ◆ provide the argument --runtime-template on the command line with a + fully specified name; + ◆ provide the argument --region on the command line. + + This must be specified. + + --runtime-template=RUNTIME_TEMPLATE + ID of the runtime template or fully qualified identifier for the + runtime template. + + To set the name attribute: + ▸ provide the argument --runtime-template on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description + + --labels=[KEY=VALUE,...] + Add labels to identify and group the runtime template. + + --runtime-id=RUNTIME_ID + The id of the runtime to assign. If not specified, a random id will be + generated. + + --runtime-user=RUNTIME_USER + User email for the runtime owner. Runtimes can only be used by the + owner. If a user is not provided, the gcloud user will be assumed to be + the owner. The user cannot be a service account. + +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/colab/runtimes/delete b/gcloud/beta/colab/runtimes/delete new file mode 100644 index 000000000..d89f5e9ca --- /dev/null +++ b/gcloud/beta/colab/runtimes/delete @@ -0,0 +1,63 @@ +NAME + gcloud beta colab runtimes delete - delete a runtime + +SYNOPSIS + gcloud beta colab runtimes delete (RUNTIME : --region=REGION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Deletes a Colab Enterprise notebook runtime. + +EXAMPLES + To delete a runtime with id 'my-runtime' in region 'us-central1', run: + + $ gcloud beta colab runtimes delete my-runtime --region=us-central1 + +POSITIONAL ARGUMENTS + Runtime resource - Unique name of the runtime to delete. This was + optionally provided by setting --runtime-id in the assign runtime command, + or was system-generated if unspecified. 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 runtime 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. + + RUNTIME + ID of the runtime or fully qualified identifier for the runtime. + + To set the name attribute: + ▸ provide the argument runtime on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the runtime. + + To set the region attribute: + ▸ provide the argument runtime on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/colab/runtimes/describe b/gcloud/beta/colab/runtimes/describe new file mode 100644 index 000000000..6c964d9f2 --- /dev/null +++ b/gcloud/beta/colab/runtimes/describe @@ -0,0 +1,58 @@ +NAME + gcloud beta colab runtimes describe - describe a runtime + +SYNOPSIS + gcloud beta colab runtimes describe (RUNTIME : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describes a Colab Enterprise notebook runtime. + +EXAMPLES + To describe a runtime with id 'my-runtime' in region 'us-central1', run: + + $ gcloud beta colab runtimes describe my-runtime --region=us-central1 + +POSITIONAL ARGUMENTS + Runtime resource - Unique name of the runtime to describe. This was + optionally provided by setting --runtime-id in the assign runtime command, + or was system-generated if unspecified. 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 runtime 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. + + RUNTIME + ID of the runtime or fully qualified identifier for the runtime. + + To set the name attribute: + ▸ provide the argument runtime on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the runtime. + + To set the region attribute: + ▸ provide the argument runtime 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. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/colab/runtimes/help b/gcloud/beta/colab/runtimes/help new file mode 100644 index 000000000..6b579b5be --- /dev/null +++ b/gcloud/beta/colab/runtimes/help @@ -0,0 +1,39 @@ +NAME + gcloud beta colab runtimes - manage Colab Enterprise runtimes + +SYNOPSIS + gcloud beta colab runtimes COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) For more information about runtimes, see + https://cloud.google.com/colab/docs/runtimes#runtimes + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + assign + (BETA) Assign a notebook runtime. + + delete + (BETA) Delete a runtime. + + describe + (BETA) Describe a runtime. + + list + (BETA) List your project's runtimes. + + start + (BETA) Start a stopped runtime. + + upgrade + (BETA) Upgrade a runtime. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/colab/runtimes/list b/gcloud/beta/colab/runtimes/list new file mode 100644 index 000000000..ce632b8d8 --- /dev/null +++ b/gcloud/beta/colab/runtimes/list @@ -0,0 +1,80 @@ +NAME + gcloud beta colab runtimes list - list your project's runtimes + +SYNOPSIS + gcloud beta colab runtimes list --region=REGION [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Lists your project's Colab Enterprise notebook runtimes in a given + region. + +EXAMPLES + To list your runtimes in region 'us-central1', run: + + $ gcloud beta colab runtimes list --region=us-central1 + +REQUIRED FLAGS + Region resource - Cloud region for which to list all runtimes. Please see + https://cloud.google.com/colab/docs/locations for a list of supported + regions. 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 region or fully qualified identifier for the region. + + To set the region attribute: + ▸ 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. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/colab/runtimes/start b/gcloud/beta/colab/runtimes/start new file mode 100644 index 000000000..f7b095895 --- /dev/null +++ b/gcloud/beta/colab/runtimes/start @@ -0,0 +1,63 @@ +NAME + gcloud beta colab runtimes start - start a stopped runtime + +SYNOPSIS + gcloud beta colab runtimes start (RUNTIME : --region=REGION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Starts a stopped Colab Enterprise notebook runtime. + +EXAMPLES + To start a runtime with id 'my-runtime' in region 'us-central1', run: + + $ gcloud beta colab runtimes start my-runtime --region=us-central1 + +POSITIONAL ARGUMENTS + Runtime resource - Unique name of the runtime to start. This was + optionally provided by setting --runtime-id in the assign runtime command, + or was system-generated if unspecified. 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 runtime 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. + + RUNTIME + ID of the runtime or fully qualified identifier for the runtime. + + To set the name attribute: + ▸ provide the argument runtime on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the runtime. + + To set the region attribute: + ▸ provide the argument runtime on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/colab/runtimes/upgrade b/gcloud/beta/colab/runtimes/upgrade new file mode 100644 index 000000000..ea526cc36 --- /dev/null +++ b/gcloud/beta/colab/runtimes/upgrade @@ -0,0 +1,63 @@ +NAME + gcloud beta colab runtimes upgrade - upgrade a runtime + +SYNOPSIS + gcloud beta colab runtimes upgrade (RUNTIME : --region=REGION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Upgrades a Colab Enterprise notebook runtime. + +EXAMPLES + To upgrade a runtime with id 'my-runtime' in region 'us-central1', run: + + $ gcloud beta colab runtimes upgrade my-runtime --region=us-central1 + +POSITIONAL ARGUMENTS + Runtime resource - Unique name of the runtime to upgrade. This was + optionally provided by setting --runtime-id in the assign runtime command, + or was system-generated if unspecified. 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 runtime 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. + + RUNTIME + ID of the runtime or fully qualified identifier for the runtime. + + To set the name attribute: + ▸ provide the argument runtime on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the runtime. + + To set the region attribute: + ▸ provide the argument runtime on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/compute/backend-services/create b/gcloud/beta/compute/backend-services/create index 1f770675d..4f052e2a7 100644 --- a/gcloud/beta/compute/backend-services/create +++ b/gcloud/beta/compute/backend-services/create @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud beta compute backend-services create BACKEND_SERVICE_NAME [--affinity-cookie-name=AFFINITY_COOKIE_NAME] + [--affinity-cookie-path=AFFINITY_COOKIE_PATH] [--affinity-cookie-ttl=AFFINITY_COOKIE_TTL] [--bypass-cache-on-request-headers=BYPASS_CACHE_ON_REQUEST_HEADERS] [--no-cache-key-include-host] @@ -69,14 +70,19 @@ POSITIONAL ARGUMENTS FLAGS --affinity-cookie-name=AFFINITY_COOKIE_NAME - If --session-affinity is set to HTTP_COOKIE, this flag sets the name of - the cookie. + If --session-affinity is set to HTTP_COOKIE or STRONG_COOKIE_AFFINITY, + this flag sets the name of the cookie. + + --affinity-cookie-path=AFFINITY_COOKIE_PATH + If --session-affinity is set to HTTP_COOKIE or STRONG_COOKIE_AFFINITY, + this flag sets the path of the cookie. --affinity-cookie-ttl=AFFINITY_COOKIE_TTL - If --session-affinity is set to GENERATED_COOKIE or HTTP_COOKIE, this - flag sets the TTL, in seconds, of the resulting cookie. A setting of 0 - indicates that the cookie should be a session cookie. See $ gcloud - topic datetimes for information on duration formats. + If --session-affinity is set to GENERATED_COOKIE, HTTP_COOKIE, or + STRONG_COOKIE_AFFINITY, this flag sets the TTL, in seconds, of the + resulting cookie. A setting of 0 indicates that the cookie should be a + session cookie. See $ gcloud topic datetimes for information on + duration formats. --bypass-cache-on-request-headers=BYPASS_CACHE_ON_REQUEST_HEADERS Bypass the cache when the specified request headers are matched - e.g. diff --git a/gcloud/beta/compute/backend-services/update b/gcloud/beta/compute/backend-services/update index 82ed13561..33ebbe857 100644 --- a/gcloud/beta/compute/backend-services/update +++ b/gcloud/beta/compute/backend-services/update @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud beta compute backend-services update BACKEND_SERVICE_NAME [--affinity-cookie-name=AFFINITY_COOKIE_NAME] + [--affinity-cookie-path=AFFINITY_COOKIE_PATH] [--affinity-cookie-ttl=AFFINITY_COOKIE_TTL] [--cache-key-include-host] [--cache-key-include-http-header=[HEADER_FIELD_NAME,...]] [--cache-key-include-named-cookie=[NAMED_COOKIE,...]] @@ -67,14 +68,19 @@ POSITIONAL ARGUMENTS FLAGS --affinity-cookie-name=AFFINITY_COOKIE_NAME - If --session-affinity is set to HTTP_COOKIE, this flag sets the name of - the cookie. + If --session-affinity is set to HTTP_COOKIE or STRONG_COOKIE_AFFINITY, + this flag sets the name of the cookie. + + --affinity-cookie-path=AFFINITY_COOKIE_PATH + If --session-affinity is set to HTTP_COOKIE or STRONG_COOKIE_AFFINITY, + this flag sets the path of the cookie. --affinity-cookie-ttl=AFFINITY_COOKIE_TTL - If --session-affinity is set to GENERATED_COOKIE or HTTP_COOKIE, this - flag sets the TTL, in seconds, of the resulting cookie. A setting of 0 - indicates that the cookie should be a session cookie. See $ gcloud - topic datetimes for information on duration formats. + If --session-affinity is set to GENERATED_COOKIE, HTTP_COOKIE, or + STRONG_COOKIE_AFFINITY, this flag sets the TTL, in seconds, of the + resulting cookie. A setting of 0 indicates that the cookie should be a + session cookie. See $ gcloud topic datetimes for information on + duration formats. --cache-key-include-host Enable including host in cache key. If enabled, requests to different diff --git a/gcloud/beta/compute/instance-groups/managed/resize-requests/cancel b/gcloud/beta/compute/instance-groups/managed/resize-requests/cancel index 508cc14bf..44714f98e 100644 --- a/gcloud/beta/compute/instance-groups/managed/resize-requests/cancel +++ b/gcloud/beta/compute/instance-groups/managed/resize-requests/cancel @@ -3,9 +3,9 @@ NAME a Compute Engine managed instance group resize request SYNOPSIS - gcloud beta compute instance-groups managed resize-requests cancel - INSTANCE_GROUP_MANAGER --resize-requests=RESIZE_REQUEST_NAMES,[...] - [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + gcloud beta compute instance-groups managed resize-requests cancel NAME + --resize-requests=RESIZE_REQUEST_NAMES,[...] + [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta compute instance-groups managed resize-requests cancel @@ -21,7 +21,7 @@ EXAMPLES cancel my-mig --resize-requests=resize-request-1 POSITIONAL ARGUMENTS - INSTANCE_GROUP_MANAGER + NAME Name of the managed instance group to operate on. REQUIRED FLAGS @@ -29,26 +29,29 @@ REQUIRED FLAGS A list of comma-separated names of resize requests to cancel. OPTIONAL FLAGS - --zone=ZONE - Zone of the managed instance group to operate on. If not specified and - the compute/zone property isn't set, you might be prompted to select a - zone (interactive mode only). + At most one of these can be specified: - To avoid prompting when this flag is omitted, you can set the - compute/zone property: + --region=REGION + Region of the managed instance group to operate on. If not specified, + you might be prompted to select a region (interactive mode only). - $ gcloud config set compute/zone ZONE + A list of regions can be fetched by running: - A list of zones can be fetched by running: + $ gcloud compute regions list - $ gcloud compute zones list + Overrides the default compute/region property value for this command + invocation. - To unset the property, run: + --zone=ZONE + Zone of the managed instance group to operate on. If not specified, + you might be prompted to select a zone (interactive mode only). - $ gcloud config unset compute/zone + A list of zones can be fetched by running: - Alternatively, the zone can be stored in the environment variable - CLOUDSDK_COMPUTE_ZONE. + $ gcloud compute zones list + + Overrides the default compute/zone property value for this command + invocation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/compute/instance-groups/managed/resize-requests/create b/gcloud/beta/compute/instance-groups/managed/resize-requests/create index 56a64a4c5..e6127ab26 100644 --- a/gcloud/beta/compute/instance-groups/managed/resize-requests/create +++ b/gcloud/beta/compute/instance-groups/managed/resize-requests/create @@ -3,10 +3,10 @@ NAME a Compute Engine managed instance group resize request SYNOPSIS - gcloud beta compute instance-groups managed resize-requests create - INSTANCE_GROUP_MANAGER --requested-run-duration=REQUESTED_RUN_DURATION - --resize-by=RESIZE_BY --resize-request=RESIZE_REQUEST_NAME - [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + gcloud beta compute instance-groups managed resize-requests create NAME + --requested-run-duration=REQUESTED_RUN_DURATION --resize-by=RESIZE_BY + --resize-request=RESIZE_REQUEST_NAME [--region=REGION | --zone=ZONE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a Compute Engine managed instance group resize request. @@ -20,7 +20,7 @@ EXAMPLES --requested-run-duration=3d1h30s POSITIONAL ARGUMENTS - INSTANCE_GROUP_MANAGER + NAME Name of the managed instance group to operate on. REQUIRED FLAGS @@ -39,26 +39,29 @@ REQUIRED FLAGS The name of the resize request to create. OPTIONAL FLAGS - --zone=ZONE - Zone of the managed instance group to operate on. If not specified and - the compute/zone property isn't set, you might be prompted to select a - zone (interactive mode only). + At most one of these can be specified: - To avoid prompting when this flag is omitted, you can set the - compute/zone property: + --region=REGION + Region of the managed instance group to operate on. If not specified, + you might be prompted to select a region (interactive mode only). - $ gcloud config set compute/zone ZONE + A list of regions can be fetched by running: - A list of zones can be fetched by running: + $ gcloud compute regions list - $ gcloud compute zones list + Overrides the default compute/region property value for this command + invocation. - To unset the property, run: + --zone=ZONE + Zone of the managed instance group to operate on. If not specified, + you might be prompted to select a zone (interactive mode only). - $ gcloud config unset compute/zone + A list of zones can be fetched by running: - Alternatively, the zone can be stored in the environment variable - CLOUDSDK_COMPUTE_ZONE. + $ gcloud compute zones list + + Overrides the default compute/zone property value for this command + invocation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/compute/instance-groups/managed/resize-requests/delete b/gcloud/beta/compute/instance-groups/managed/resize-requests/delete index 936bb40d5..169001155 100644 --- a/gcloud/beta/compute/instance-groups/managed/resize-requests/delete +++ b/gcloud/beta/compute/instance-groups/managed/resize-requests/delete @@ -3,9 +3,9 @@ NAME a Compute Engine managed instance group resize request SYNOPSIS - gcloud beta compute instance-groups managed resize-requests delete - INSTANCE_GROUP_MANAGER --resize-requests=RESIZE_REQUEST_NAMES,[...] - [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + gcloud beta compute instance-groups managed resize-requests delete NAME + --resize-requests=RESIZE_REQUEST_NAMES,[...] + [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta compute instance-groups managed resize-requests delete @@ -22,7 +22,7 @@ EXAMPLES delete my-mig --resize-requests=resize-request-1 POSITIONAL ARGUMENTS - INSTANCE_GROUP_MANAGER + NAME Name of the managed instance group to operate on. REQUIRED FLAGS @@ -30,26 +30,29 @@ REQUIRED FLAGS A list of comma-separated names of resize requests to delete. OPTIONAL FLAGS - --zone=ZONE - Zone of the managed instance group to operate on. If not specified and - the compute/zone property isn't set, you might be prompted to select a - zone (interactive mode only). + At most one of these can be specified: - To avoid prompting when this flag is omitted, you can set the - compute/zone property: + --region=REGION + Region of the managed instance group to operate on. If not specified, + you might be prompted to select a region (interactive mode only). - $ gcloud config set compute/zone ZONE + A list of regions can be fetched by running: - A list of zones can be fetched by running: + $ gcloud compute regions list - $ gcloud compute zones list + Overrides the default compute/region property value for this command + invocation. - To unset the property, run: + --zone=ZONE + Zone of the managed instance group to operate on. If not specified, + you might be prompted to select a zone (interactive mode only). - $ gcloud config unset compute/zone + A list of zones can be fetched by running: - Alternatively, the zone can be stored in the environment variable - CLOUDSDK_COMPUTE_ZONE. + $ gcloud compute zones list + + Overrides the default compute/zone property value for this command + invocation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/compute/instance-templates/create b/gcloud/beta/compute/instance-templates/create index cc339c29e..ce1de8d92 100644 --- a/gcloud/beta/compute/instance-templates/create +++ b/gcloud/beta/compute/instance-templates/create @@ -697,7 +697,8 @@ FLAGS stack-type Specifies whether IPv6 is enabled on the interface. STACK_TYPE must - be one of: IPV4_ONLY, IPV4_IPV6. The default value is IPV4_ONLY. + be one of: IPV4_ONLY, IPV4_IPV6, IPV6_ONLY. The default value is + IPV4_ONLY. ipv6-network-tier Specifies the IPv6 network tier that will be used to configure the @@ -906,6 +907,8 @@ FLAGS The network interface can have both IPv4 and IPv6 addresses IPV4_ONLY The network interface will be assigned IPv4 addresses + IPV6_ONLY + The network interface will be assigned IPv6 addresses --subnet=SUBNET Specifies the subnet that the VM instances are a part of. If --network diff --git a/gcloud/beta/compute/instances/bulk/create b/gcloud/beta/compute/instances/bulk/create index 940049061..c0d23a87b 100644 --- a/gcloud/beta/compute/instances/bulk/create +++ b/gcloud/beta/compute/instances/bulk/create @@ -654,6 +654,11 @@ OPTIONAL FLAGS https://cloud.google.com/compute/docs/network-bandwidth#rx-tx for more details. + stack-type + Specifies whether IPv6 is enabled on the interface. STACK_TYPE must + be one of: IPV4_ONLY, IPV4_IPV6, IPV6_ONLY. The default value is + IPV4_ONLY. + --network-performance-configs=[PROPERTY=VALUE,...] Configures network performance settings for the instance. If this flag is not specified, the instance will be created with its default network @@ -770,6 +775,8 @@ OPTIONAL FLAGS The network interface can have both IPv4 and IPv6 addresses IPV4_ONLY The network interface will be assigned IPv4 addresses + IPV6_ONLY + The network interface will be assigned IPv6 addresses --subnet=SUBNET Specifies the subnet that the VM instances are a part of. If --network diff --git a/gcloud/beta/compute/instances/create b/gcloud/beta/compute/instances/create index 86a7805b9..b633b919c 100644 --- a/gcloud/beta/compute/instances/create +++ b/gcloud/beta/compute/instances/create @@ -759,7 +759,8 @@ FLAGS stack-type Specifies whether IPv6 is enabled on the interface. STACK_TYPE must - be one of: IPV4_ONLY, IPV4_IPV6. The default value is IPV4_ONLY. + be one of: IPV4_ONLY, IPV4_IPV6, IPV6_ONLY. The default value is + IPV4_ONLY. ipv6-network-tier Specifies the IPv6 network tier that will be used to configure the @@ -972,6 +973,8 @@ FLAGS The network interface can have both IPv4 and IPv6 addresses IPV4_ONLY The network interface will be assigned IPv4 addresses + IPV6_ONLY + The network interface will be assigned IPv6 addresses --subnet=SUBNET Specifies the subnet that the VM instances are a part of. If --network diff --git a/gcloud/beta/compute/networks/subnets/create b/gcloud/beta/compute/networks/subnets/create index 4a835ff27..e5fcdd5ab 100644 --- a/gcloud/beta/compute/networks/subnets/create +++ b/gcloud/beta/compute/networks/subnets/create @@ -185,6 +185,8 @@ OPTIONAL FLAGS New VMs in this subnet can have both IPv4 and IPv6 addresses IPV4_ONLY New VMs in this subnet will only be assigned IPv4 addresses + IPV6_ONLY + New VMs in this subnet will only be assigned IPv6 addresses GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/compute/public-delegated-prefixes/create b/gcloud/beta/compute/public-delegated-prefixes/create index 93f9b1b12..48363532e 100644 --- a/gcloud/beta/compute/public-delegated-prefixes/create +++ b/gcloud/beta/compute/public-delegated-prefixes/create @@ -47,8 +47,8 @@ OPTIONAL FLAGS Specify if this public delegated prefix is meant to be live migrated. --mode=MODE - Specifies the mode of this IPv6 PDP. MODE must be one of: - EXTERNAL_IPV6_FORWARDING_RULE_CREATION, DELEGATION. + Specifies the mode of this IPv6 PDP. MODE must be one of: delegation, + external-ipv6-forwarding-rule-creation. At most one of these can be specified: diff --git a/gcloud/beta/compute/public-delegated-prefixes/delegated-sub-prefixes/create b/gcloud/beta/compute/public-delegated-prefixes/delegated-sub-prefixes/create index c6ef9fd5b..079c01e91 100644 --- a/gcloud/beta/compute/public-delegated-prefixes/delegated-sub-prefixes/create +++ b/gcloud/beta/compute/public-delegated-prefixes/delegated-sub-prefixes/create @@ -56,8 +56,8 @@ OPTIONAL FLAGS Description of the delegated sub prefix to create. --mode=MODE - Specify mode for the sub prefix. MODE must be one of: DELEGATION, - EXTERNAL_IPV6_FORWARDING_RULE_CREATION. + Specifies the mode of this IPv6 PDP. MODE must be one of: delegation, + external-ipv6-forwarding-rule-creation. --range=RANGE IPv4 range from this public delegated prefix that should be delegated, diff --git a/gcloud/beta/config/get b/gcloud/beta/config/get index df1c64ed7..c9aac88e7 100644 --- a/gcloud/beta/config/get +++ b/gcloud/beta/config/get @@ -374,6 +374,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud filestore command group. Defaults to https://file.googleapis.com/ + firebasedataconnect + Overrides API endpoint for gcloud firebase-data-connect command + group. Defaults to https://firebasedataconnect.googleapis.com/ + firestore Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ diff --git a/gcloud/beta/config/help b/gcloud/beta/config/help index de8043f50..4fa67a691 100644 --- a/gcloud/beta/config/help +++ b/gcloud/beta/config/help @@ -406,6 +406,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud filestore command group. Defaults to https://file.googleapis.com/ + firebasedataconnect + Overrides API endpoint for gcloud firebase-data-connect command + group. Defaults to https://firebasedataconnect.googleapis.com/ + firestore Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ diff --git a/gcloud/beta/config/list b/gcloud/beta/config/list index ade9c1ff5..8506e1051 100644 --- a/gcloud/beta/config/list +++ b/gcloud/beta/config/list @@ -418,6 +418,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud filestore command group. Defaults to https://file.googleapis.com/ + firebasedataconnect + Overrides API endpoint for gcloud firebase-data-connect command + group. Defaults to https://firebasedataconnect.googleapis.com/ + firestore Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ diff --git a/gcloud/beta/config/set b/gcloud/beta/config/set index 31335e1fe..0104a25cc 100644 --- a/gcloud/beta/config/set +++ b/gcloud/beta/config/set @@ -421,6 +421,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud filestore command group. Defaults to https://file.googleapis.com/ + firebasedataconnect + Overrides API endpoint for gcloud firebase-data-connect command + group. Defaults to https://firebasedataconnect.googleapis.com/ + firestore Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ diff --git a/gcloud/beta/config/unset b/gcloud/beta/config/unset index a31341a41..8564ba7d2 100644 --- a/gcloud/beta/config/unset +++ b/gcloud/beta/config/unset @@ -382,6 +382,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud filestore command group. Defaults to https://file.googleapis.com/ + firebasedataconnect + Overrides API endpoint for gcloud firebase-data-connect command + group. Defaults to https://firebasedataconnect.googleapis.com/ + firestore Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ diff --git a/gcloud/beta/container/fleet/mesh/help b/gcloud/beta/container/fleet/mesh/help index fb0f37c8e..a4428492d 100644 --- a/gcloud/beta/container/fleet/mesh/help +++ b/gcloud/beta/container/fleet/mesh/help @@ -30,6 +30,9 @@ COMMANDS enable (BETA) Enable Service Mesh Feature. + update + (BETA) Update the configuration of the Service Mesh Feature. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/container/fleet/mesh/update b/gcloud/beta/container/fleet/mesh/update new file mode 100644 index 000000000..da7fd7a4e --- /dev/null +++ b/gcloud/beta/container/fleet/mesh/update @@ -0,0 +1,99 @@ +NAME + gcloud beta container fleet mesh update - update the configuration of the + Service Mesh Feature + +SYNOPSIS + gcloud beta container fleet mesh update + (--fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG + | [(--control-plane=CONTROL_PLANE + --management=MANAGEMENT --origin=ORIGIN) + : [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]]) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update the Service Mesh Feature Spec of a Membership. + +EXAMPLES + To update the control plane management of comma separated Memberships like + membership1,membership2, run: + + $ gcloud beta container fleet mesh update \ + --memberships=membership1,membership2 \ + --control-plane=CONTROL_PLANE + +REQUIRED FLAGS + Exactly one of these must be specified: + + --fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG + The path to a service-mesh.yaml configuration file. + + To enable the Service Mesh Feature with a fleet-level default + membership configuration, run: + + $ gcloud beta container fleet mesh update \ + --fleet-default-member-config=/path/to/service-mesh.yaml + + At least one of these must be specified: + + --control-plane=CONTROL_PLANE + (DEPRECATED) Control plane management to update to. + + The --control-plane flag is now deprecated. Please use --management + instead. See + https://cloud.google.com/service-mesh/docs/managed/provision-managed-anthos-service-mesh. + CONTROL_PLANE must be one of: automatic, manual, unspecified. + + --management=MANAGEMENT + The management mode to update to. MANAGEMENT must be one of: + automatic, manual. + + --origin=ORIGIN + Changing the origin of the membership. ORIGIN must be (only one + value is supported): fleet. + + Membership resource - The group of arguments defining one or more + memberships. 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 --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet mesh update + + $ gcloud alpha container fleet mesh update + diff --git a/gcloud/beta/container/hub/mesh/help b/gcloud/beta/container/hub/mesh/help index 8c640552b..e4c5dd40e 100644 --- a/gcloud/beta/container/hub/mesh/help +++ b/gcloud/beta/container/hub/mesh/help @@ -30,6 +30,9 @@ COMMANDS enable (BETA) Enable Service Mesh Feature. + update + (BETA) Update the configuration of the Service Mesh Feature. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/container/hub/mesh/update b/gcloud/beta/container/hub/mesh/update new file mode 100644 index 000000000..8b644cb54 --- /dev/null +++ b/gcloud/beta/container/hub/mesh/update @@ -0,0 +1,99 @@ +NAME + gcloud beta container hub mesh update - update the configuration of the + Service Mesh Feature + +SYNOPSIS + gcloud beta container hub mesh update + (--fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG + | [(--control-plane=CONTROL_PLANE + --management=MANAGEMENT --origin=ORIGIN) + : [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]]) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update the Service Mesh Feature Spec of a Membership. + +EXAMPLES + To update the control plane management of comma separated Memberships like + membership1,membership2, run: + + $ gcloud beta container hub mesh update \ + --memberships=membership1,membership2 \ + --control-plane=CONTROL_PLANE + +REQUIRED FLAGS + Exactly one of these must be specified: + + --fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG + The path to a service-mesh.yaml configuration file. + + To enable the Service Mesh Feature with a fleet-level default + membership configuration, run: + + $ gcloud beta container hub mesh update \ + --fleet-default-member-config=/path/to/service-mesh.yaml + + At least one of these must be specified: + + --control-plane=CONTROL_PLANE + (DEPRECATED) Control plane management to update to. + + The --control-plane flag is now deprecated. Please use --management + instead. See + https://cloud.google.com/service-mesh/docs/managed/provision-managed-anthos-service-mesh. + CONTROL_PLANE must be one of: automatic, manual, unspecified. + + --management=MANAGEMENT + The management mode to update to. MANAGEMENT must be one of: + automatic, manual. + + --origin=ORIGIN + Changing the origin of the membership. ORIGIN must be (only one + value is supported): fleet. + + Membership resource - The group of arguments defining one or more + memberships. 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 --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub mesh update + + $ gcloud alpha container hub mesh update + diff --git a/gcloud/beta/dataproc/clusters/create b/gcloud/beta/dataproc/clusters/create index 1b6dc6e58..2a795fec0 100644 --- a/gcloud/beta/dataproc/clusters/create +++ b/gcloud/beta/dataproc/clusters/create @@ -37,8 +37,11 @@ SYNOPSIS [--secondary-worker-boot-disk-type=SECONDARY_WORKER_BOOT_DISK_TYPE] [--secondary-worker-local-ssd-interface=SECONDARY_WORKER_LOCAL_SSD_INTERFACE] [--secondary-worker-machine-types=type=MACHINE_TYPE[, - type=MACHINE_TYPE...][,rank=RANK]] [--shielded-integrity-monitoring] - [--shielded-secure-boot] [--shielded-vtpm] [--temp-bucket=TEMP_BUCKET] + type=MACHINE_TYPE...][,rank=RANK]] + [--secondary-worker-standard-capacity-base=SECONDARY_WORKER_STANDARD_CAPACITY_BASE] + [--secondary-worker-standard-capacity-percent-above-base=SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE] + [--shielded-integrity-monitoring] [--shielded-secure-boot] + [--shielded-vtpm] [--temp-bucket=TEMP_BUCKET] [--worker-accelerator=[type=TYPE,[count=COUNT],...]] [--worker-boot-disk-size=WORKER_BOOT_DISK_SIZE] [--worker-boot-disk-type=WORKER_BOOT_DISK_TYPE] @@ -361,6 +364,23 @@ FLAGS Defaults to server-specified.eg. --secondary-worker-machine-types="type=e2-standard-8,type=t2d-standard-8,rank=0" + --secondary-worker-standard-capacity-base=SECONDARY_WORKER_STANDARD_CAPACITY_BASE + This flag sets the base number of Standard VMs to use for secondary + workers + (https://cloud.google.com/dataproc/docs/concepts/compute/secondary-vms#preemptible_and_non-preemptible_secondary_workers). + Dataproc will create only standard VMs until it reaches this number, + then it will mix Spot and Standard VMs according to + SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE. + + --secondary-worker-standard-capacity-percent-above-base=SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE + When combining Standard and Spot VMs for secondary-workers + (https://cloud.google.com/dataproc/docs/concepts/compute/secondary-vms#preemptible_and_non-preemptible_secondary_workers) + once the number of Standard VMs specified by + SECONDARY_WORKER_STANDARD_CAPACITY_BASE has been used, this flag + specifies the percentage of the total number of additional Standard VMs + secondary workers will use. Spot VMs will be used for the remaining + percentage. + --shielded-integrity-monitoring Enables monitoring and attestation of the boot integrity of the cluster's VMs. vTPM (virtual Trusted Platform Module) must also be diff --git a/gcloud/beta/dataproc/workflow-templates/set-managed-cluster b/gcloud/beta/dataproc/workflow-templates/set-managed-cluster index 0d0d1bbb7..c83d191bd 100644 --- a/gcloud/beta/dataproc/workflow-templates/set-managed-cluster +++ b/gcloud/beta/dataproc/workflow-templates/set-managed-cluster @@ -30,8 +30,11 @@ SYNOPSIS [--secondary-worker-boot-disk-type=SECONDARY_WORKER_BOOT_DISK_TYPE] [--secondary-worker-local-ssd-interface=SECONDARY_WORKER_LOCAL_SSD_INTERFACE] [--secondary-worker-machine-types=type=MACHINE_TYPE[, - type=MACHINE_TYPE...][,rank=RANK]] [--shielded-integrity-monitoring] - [--shielded-secure-boot] [--shielded-vtpm] [--temp-bucket=TEMP_BUCKET] + type=MACHINE_TYPE...][,rank=RANK]] + [--secondary-worker-standard-capacity-base=SECONDARY_WORKER_STANDARD_CAPACITY_BASE] + [--secondary-worker-standard-capacity-percent-above-base=SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE] + [--shielded-integrity-monitoring] [--shielded-secure-boot] + [--shielded-vtpm] [--temp-bucket=TEMP_BUCKET] [--worker-accelerator=[type=TYPE,[count=COUNT],...]] [--worker-boot-disk-size=WORKER_BOOT_DISK_SIZE] [--worker-boot-disk-type=WORKER_BOOT_DISK_TYPE] @@ -293,6 +296,23 @@ FLAGS Defaults to server-specified.eg. --secondary-worker-machine-types="type=e2-standard-8,type=t2d-standard-8,rank=0" + --secondary-worker-standard-capacity-base=SECONDARY_WORKER_STANDARD_CAPACITY_BASE + This flag sets the base number of Standard VMs to use for secondary + workers + (https://cloud.google.com/dataproc/docs/concepts/compute/secondary-vms#preemptible_and_non-preemptible_secondary_workers). + Dataproc will create only standard VMs until it reaches this number, + then it will mix Spot and Standard VMs according to + SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE. + + --secondary-worker-standard-capacity-percent-above-base=SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE + When combining Standard and Spot VMs for secondary-workers + (https://cloud.google.com/dataproc/docs/concepts/compute/secondary-vms#preemptible_and_non-preemptible_secondary_workers) + once the number of Standard VMs specified by + SECONDARY_WORKER_STANDARD_CAPACITY_BASE has been used, this flag + specifies the percentage of the total number of additional Standard VMs + secondary workers will use. Spot VMs will be used for the remaining + percentage. + --shielded-integrity-monitoring Enables monitoring and attestation of the boot integrity of the cluster's VMs. vTPM (virtual Trusted Platform Module) must also be diff --git a/gcloud/beta/datastore/indexes/cleanup b/gcloud/beta/datastore/indexes/cleanup index 265e3681e..f2bae55c1 100644 --- a/gcloud/beta/datastore/indexes/cleanup +++ b/gcloud/beta/datastore/indexes/cleanup @@ -3,7 +3,8 @@ NAME based on your local index configuration SYNOPSIS - gcloud beta datastore indexes cleanup INDEX_FILE [GCLOUD_WIDE_FLAG ...] + gcloud beta datastore indexes cleanup INDEX_FILE [--database=DATABASE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) This command removes unused datastore indexes based on your local @@ -21,6 +22,15 @@ POSITIONAL ARGUMENTS your index.yaml file, refer to this configuration guide: https://cloud.google.com/datastore/docs/tools/indexconfig#Datastore_About_index_yaml +FLAGS + --database=DATABASE + The database to operate on. If not specified, the CLI refers the + (default) database by default. + + For example, to operate on database testdb: + + $ gcloud beta datastore indexes cleanup --database='testdb' + 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/datastore/indexes/create b/gcloud/beta/datastore/indexes/create index 1372e57ee..e8c362cab 100644 --- a/gcloud/beta/datastore/indexes/create +++ b/gcloud/beta/datastore/indexes/create @@ -18,7 +18,7 @@ EXAMPLES Detailed information about index configuration can be found at the index.yaml reference - (https://cloud.google.com/appengine/docs/standard/python/config/indexref). + (https://cloud.google.com/datastore/docs/tools/indexconfig). POSITIONAL ARGUMENTS INDEX_FILE diff --git a/gcloud/beta/network-connectivity/hubs/route-tables/routes/list b/gcloud/beta/network-connectivity/hubs/route-tables/routes/list index e071b0186..dd069b5a5 100644 --- a/gcloud/beta/network-connectivity/hubs/route-tables/routes/list +++ b/gcloud/beta/network-connectivity/hubs/route-tables/routes/list @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud beta network-connectivity hubs route-tables routes list - (--route_table=ROUTE_TABLE : --hub=HUB) [--filter=EXPRESSION] + (--route_table=ROUTE_TABLE : --hub=HUB) + [--effective-location=EFFECTIVE_LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -23,6 +24,13 @@ EXAMPLES $ gcloud beta network-connectivity hubs route-tables routes list \ --hub=my-hub --route_table=my-route-table + To list all routes in route table my-route-table, effective at a + location/region run: + + $ gcloud beta network-connectivity hubs route-tables routes list \ + --hub=my-hub --route_table=my-route-table \ + --effective-location=location + REQUIRED FLAGS Route table resource - Parent route table of the routes to display. The arguments in this group can be used to specify the attributes of this @@ -55,6 +63,12 @@ REQUIRED FLAGS fully specified name; ▸ provide the argument --hub on the command line. +FLAGS + --effective-location=EFFECTIVE_LOCATION + The effective location/region to limit the list of routes. The + effective location must be a valid region name. To list valid region + names, use 'gcloud compute regions list'. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/beta/sql/instances/create b/gcloud/beta/sql/instances/create index 80d48fd29..0f9c6cda8 100644 --- a/gcloud/beta/sql/instances/create +++ b/gcloud/beta/sql/instances/create @@ -41,6 +41,7 @@ SYNOPSIS [--password-policy-min-length=PASSWORD_POLICY_MIN_LENGTH] [--password-policy-password-change-interval=PASSWORD_POLICY_PASSWORD_CHANGE_INTERVAL] [--password-policy-reuse-interval=PASSWORD_POLICY_REUSE_INTERVAL] + [--psc-auto-connections=[network=NETWORK],[project=PROJECT]] [--[no-]recreate-replicas-on-primary-crash] [--replica-type=REPLICA_TYPE] [--replication=REPLICATION] [--require-ssl] [--retained-backups-count=RETAINED_BACKUPS_COUNT] @@ -381,6 +382,35 @@ FLAGS Number of previous passwords that cannot be reused. The valid range is 0 to 100. + --psc-auto-connections=[network=NETWORK],[project=PROJECT] + A comma-separated list of networks or a comma-separated list of + network-project pairs. Each project in this list is represented by a + project number (numeric) or by a project ID (alphanumeric). This allows + Private Service Connect connections to be created automatically for the + specified networks. For example, this connection uses "the form + psc-auto-connections=network=projects/testproject1/global/networks/testnetwork1" + or "the form + psc-auto-connections=project=testproject1,network=projects/testproject1/global/networks/testnetwork1". + Sets psc_auto_connections value. + + network + Required, Sets network value. + + project + Sets project value. + + Shorthand Example: + + --psc-auto-connections=network=string,project=string + + JSON Example: + + --psc-auto-connections='{"network": "string", "project": "string"}' + + File Example: + + --psc-auto-connections=path_to_file.(yaml|json) + --[no-]recreate-replicas-on-primary-crash Allow/Disallow replica recreation when a primary MySQL instance operating in reduced durability mode crashes. Not recreating the diff --git a/gcloud/beta/sql/instances/patch b/gcloud/beta/sql/instances/patch index 00cfb74d1..9cc38d11d 100644 --- a/gcloud/beta/sql/instances/patch +++ b/gcloud/beta/sql/instances/patch @@ -58,6 +58,8 @@ SYNOPSIS | --clear-authorized-networks] [--clear-database-flags | --database-flags=FLAG=VALUE,[FLAG=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] + [--clear-psc-auto-connections + | --psc-auto-connections=[network=NETWORK],[project=PROJECT]] [--gce-zone=GCE_ZONE | --secondary-zone=SECONDARY_ZONE --zone=ZONE] [--no-backup | --backup-location=BACKUP_LOCATION --backup-start-time=BACKUP_START_TIME @@ -503,6 +505,43 @@ FLAGS silently ignored. If --update-labels is also specified then --update-labels is applied first. + At most one of these can be specified: + + --clear-psc-auto-connections + This removes all connections created automatically. Cloud SQL uses + these connections to connect to an instance using Private Service + Connect. + + --psc-auto-connections=[network=NETWORK],[project=PROJECT] + A comma-separated list of networks or a comma-separated list of + network-project pairs. Each project in this list is represented by a + project number (numeric) or by a project ID (alphanumeric). This + allows Private Service Connect connections to be created + automatically for the specified networks. For example, this + connection uses "the form + psc-auto-connections=network=projects/testproject1/global/networks/testnetwork1" + or "the form + psc-auto-connections=project=testproject1,network=projects/testproject1/global/networks/testnetwork1". + Sets psc_auto_connections value. + + network + Required, Sets network value. + + project + Sets project value. + + Shorthand Example: + + --psc-auto-connections=network=string,project=string + + JSON Example: + + --psc-auto-connections='{"network": "string", "project": "string"}' + + File Example: + + --psc-auto-connections=path_to_file.(yaml|json) + At most one of these can be specified: --gce-zone=GCE_ZONE diff --git a/gcloud/bigtable/app-profiles/create b/gcloud/bigtable/app-profiles/create index 47bf47018..8a93cc7b3 100644 --- a/gcloud/bigtable/app-profiles/create +++ b/gcloud/bigtable/app-profiles/create @@ -5,10 +5,8 @@ SYNOPSIS gcloud bigtable app-profiles create (APP_PROFILE : --instance=INSTANCE) ([--route-any : --restrict-to=[RESTRICT_TO,...]] | [--route-to=ROUTE_TO : --transactional-writes]) - [--description=DESCRIPTION] [--force] - [--data-boost - --data-boost-compute-billing-owner=DATA_BOOST_COMPUTE_BILLING_OWNER - | [--priority=PRIORITY : --standard]] [GCLOUD_WIDE_FLAG ...] + [--description=DESCRIPTION] [--force] [--priority=PRIORITY] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a new Bigtable app profile. @@ -37,13 +35,6 @@ EXAMPLES $ gcloud bigtable app-profiles create my-app-profile-id \ --instance=my-instance-id --route-any --priority=PRIORITY_MEDIUM - To create an app profile with Data Boost enabled which bills usage to the - host project, run: - - $ gcloud bigtable app-profiles create my-app-profile-id \ - --instance=my-instance-id --data-boost \ - --data-boost-compute-billing-owner=HOST_PAYS - POSITIONAL ARGUMENTS App profile resource - The app profile to create. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -109,58 +100,16 @@ OPTIONAL FLAGS --force Ignore warnings and force create. - At most one of these can be specified: + --priority=PRIORITY + Specify the request priority. If not specified, the app profile uses + PRIORITY_HIGH by default. PRIORITY must be one of: - Data Boost Read-only Isolation - - --data-boost - Use Data Boost serverless compute option, rather than standard - provisioned node compute. If specified, - --data-boost-compute-billing-owner is required. Specifying Data - Boost compute on an app profile that uses standard provisioned node - compute may cause unexpected behavior for running applications. - - This flag argument must be specified if any of the other arguments - in this group are specified. - - --data-boost-compute-billing-owner=DATA_BOOST_COMPUTE_BILLING_OWNER - Specify the Data Boost compute billing owner, required if - --data-boost is passed. DATA_BOOST_COMPUTE_BILLING_OWNER must be - (only one value is supported): - - HOST_PAYS - Compute billing should be accounted towards the host Cloud - project (containing the targeted Bigtable instance / table). - - This flag argument must be specified if any of the other arguments - in this group are specified. - - Standard Isolation - - --priority=PRIORITY - Specify the request priority under standard provisioned node - compute capabilities. Passing this option implies standard - provisioned node compute, e.g. the --standard option. If not - specified, the app profile uses standard provisioned node compute - with PRIORITY_HIGH by default. Specifying request priority on an - app profile that has Data Boost serverless compute enabled changes - the compute option to standard and uses the specified priority, - which might cause unexpected behavior for running applications. - PRIORITY must be one of: - - PRIORITY_HIGH - Requests are treated with high priority. - PRIORITY_LOW - Requests are treated with low priority. - PRIORITY_MEDIUM - Requests are treated with medium priority. - - This flag argument must be specified if any of the other arguments - in this group are specified. - - --standard - Use standard provisioned node compute option, rather than Data - Boost compute option. If specified, --priority is required. + PRIORITY_HIGH + Requests are treated with high priority. + PRIORITY_LOW + Requests are treated with low priority. + PRIORITY_MEDIUM + Requests are treated with medium priority. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/bigtable/app-profiles/update b/gcloud/bigtable/app-profiles/update index 4f1be15ea..ec80cb461 100644 --- a/gcloud/bigtable/app-profiles/update +++ b/gcloud/bigtable/app-profiles/update @@ -3,10 +3,7 @@ NAME SYNOPSIS gcloud bigtable app-profiles update (APP_PROFILE : --instance=INSTANCE) - [--async] [--description=DESCRIPTION] [--force] - [--data-boost - --data-boost-compute-billing-owner=DATA_BOOST_COMPUTE_BILLING_OWNER - | [--priority=PRIORITY : --standard]] + [--async] [--description=DESCRIPTION] [--force] [--priority=PRIORITY] [[--route-any : --restrict-to=[RESTRICT_TO,...]] | [--route-to=ROUTE_TO : --transactional-writes]] [GCLOUD_WIDE_FLAG ...] @@ -37,13 +34,6 @@ EXAMPLES $ gcloud bigtable app-profiles update my-app-profile-id \ --instance=my-instance-id --priority=PRIORITY_LOW - To update an app profile to enable Data Boost which bills usage to the host - project, run: - - $ gcloud bigtable app-profiles update my-app-profile-id \ - --instance=my-instance-id --data-boost \ - --data-boost-compute-billing-owner=HOST_PAYS - POSITIONAL ARGUMENTS App profile resource - The app profile to update. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -87,58 +77,16 @@ FLAGS --force Ignore warnings and force update. - At most one of these can be specified: + --priority=PRIORITY + Specify the request priority. If not specified, the app profile uses + PRIORITY_HIGH by default. PRIORITY must be one of: - Data Boost Read-only Isolation - - --data-boost - Use Data Boost serverless compute option, rather than standard - provisioned node compute. If specified, - --data-boost-compute-billing-owner is required. Specifying Data - Boost compute on an app profile that uses standard provisioned node - compute may cause unexpected behavior for running applications. - - This flag argument must be specified if any of the other arguments - in this group are specified. - - --data-boost-compute-billing-owner=DATA_BOOST_COMPUTE_BILLING_OWNER - Specify the Data Boost compute billing owner, required if - --data-boost is passed. DATA_BOOST_COMPUTE_BILLING_OWNER must be - (only one value is supported): - - HOST_PAYS - Compute billing should be accounted towards the host Cloud - project (containing the targeted Bigtable instance / table). - - This flag argument must be specified if any of the other arguments - in this group are specified. - - Standard Isolation - - --priority=PRIORITY - Specify the request priority under standard provisioned node - compute capabilities. Passing this option implies standard - provisioned node compute, e.g. the --standard option. If not - specified, the app profile uses standard provisioned node compute - with PRIORITY_HIGH by default. Specifying request priority on an - app profile that has Data Boost serverless compute enabled changes - the compute option to standard and uses the specified priority, - which might cause unexpected behavior for running applications. - PRIORITY must be one of: - - PRIORITY_HIGH - Requests are treated with high priority. - PRIORITY_LOW - Requests are treated with low priority. - PRIORITY_MEDIUM - Requests are treated with medium priority. - - This flag argument must be specified if any of the other arguments - in this group are specified. - - --standard - Use standard provisioned node compute option, rather than Data - Boost compute option. If specified, --priority is required. + PRIORITY_HIGH + Requests are treated with high priority. + PRIORITY_LOW + Requests are treated with low priority. + PRIORITY_MEDIUM + Requests are treated with medium priority. At most one of these can be specified: diff --git a/gcloud/compute/backend-services/create b/gcloud/compute/backend-services/create index ff3d946f2..cd96250c6 100644 --- a/gcloud/compute/backend-services/create +++ b/gcloud/compute/backend-services/create @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud compute backend-services create BACKEND_SERVICE_NAME [--affinity-cookie-name=AFFINITY_COOKIE_NAME] + [--affinity-cookie-path=AFFINITY_COOKIE_PATH] [--affinity-cookie-ttl=AFFINITY_COOKIE_TTL] [--bypass-cache-on-request-headers=BYPASS_CACHE_ON_REQUEST_HEADERS] [--no-cache-key-include-host] @@ -25,6 +26,7 @@ SYNOPSIS [--iap=disabled|enabled,[oauth2-client-id=OAUTH2-CLIENT-ID, oauth2-client-secret=OAUTH2-CLIENT-SECRET]] [--idle-timeout-sec=IDLE_TIMEOUT_SEC] + [--ip-address-selection-policy=IP_ADDRESS_SELECTION_POLICY] [--load-balancing-scheme=LOAD_BALANCING_SCHEME; default="EXTERNAL"] [--locality-lb-policy=LOCALITY_LB_POLICY] [--logging-optional=LOGGING_OPTIONAL] @@ -64,14 +66,19 @@ POSITIONAL ARGUMENTS FLAGS --affinity-cookie-name=AFFINITY_COOKIE_NAME - If --session-affinity is set to HTTP_COOKIE, this flag sets the name of - the cookie. + If --session-affinity is set to HTTP_COOKIE or STRONG_COOKIE_AFFINITY, + this flag sets the name of the cookie. + + --affinity-cookie-path=AFFINITY_COOKIE_PATH + If --session-affinity is set to HTTP_COOKIE or STRONG_COOKIE_AFFINITY, + this flag sets the path of the cookie. --affinity-cookie-ttl=AFFINITY_COOKIE_TTL - If --session-affinity is set to GENERATED_COOKIE or HTTP_COOKIE, this - flag sets the TTL, in seconds, of the resulting cookie. A setting of 0 - indicates that the cookie should be a session cookie. See $ gcloud - topic datetimes for information on duration formats. + If --session-affinity is set to GENERATED_COOKIE, HTTP_COOKIE, or + STRONG_COOKIE_AFFINITY, this flag sets the TTL, in seconds, of the + resulting cookie. A setting of 0 indicates that the cookie should be a + session cookie. See $ gcloud topic datetimes for information on + duration formats. --bypass-cache-on-request-headers=BYPASS_CACHE_ON_REQUEST_HEADERS Bypass the cache when the specified request headers are matched - e.g. @@ -338,6 +345,32 @@ FLAGS service-based external and internal passthrough Network Load Balancers as part of a connection tracking policy. + --ip-address-selection-policy=IP_ADDRESS_SELECTION_POLICY + Specifies a preference for traffic sent from the proxy to the backend + (or from the client to the backend for proxyless gRPC). + + Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED, + INTERNAL_MANAGED or EXTERNAL_MANAGED. + + The possible values are: + + IPV4_ONLY + Only send IPv4 traffic to the backends of the backend service, + regardless of traffic from the client to the proxy. Only IPv4 + health checks are used to check the health of the backends. + + PREFER_IPV6 + Prioritize the connection to the endpoint's IPv6 address over its IPv4 + address (provided there is a healthy IPv6 address). + + IPV6_ONLY + Only send IPv6 traffic to the backends of the backend service, + regardless of traffic from the client to the proxy. Only IPv6 + health checks are used to check the health of the backends. + + IP_ADDRESS_SELECTION_POLICY must be one of: IPV4_ONLY, PREFER_IPV6, + IPV6_ONLY. + --load-balancing-scheme=LOAD_BALANCING_SCHEME; default="EXTERNAL" Specifies the load balancer type. Choose EXTERNAL for the classic Application Load Balancers, the external passthrough Network Load diff --git a/gcloud/compute/backend-services/update b/gcloud/compute/backend-services/update index d78efa4a4..a93731fb3 100644 --- a/gcloud/compute/backend-services/update +++ b/gcloud/compute/backend-services/update @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud compute backend-services update BACKEND_SERVICE_NAME [--affinity-cookie-name=AFFINITY_COOKIE_NAME] + [--affinity-cookie-path=AFFINITY_COOKIE_PATH] [--affinity-cookie-ttl=AFFINITY_COOKIE_TTL] [--cache-key-include-host] [--cache-key-include-http-header=[HEADER_FIELD_NAME,...]] [--cache-key-include-named-cookie=[NAMED_COOKIE,...]] @@ -21,6 +22,7 @@ SYNOPSIS [--iap=disabled|enabled,[oauth2-client-id=OAUTH2-CLIENT-ID, oauth2-client-secret=OAUTH2-CLIENT-SECRET]] [--idle-timeout-sec=IDLE_TIMEOUT_SEC] + [--ip-address-selection-policy=IP_ADDRESS_SELECTION_POLICY] [--locality-lb-policy=LOCALITY_LB_POLICY] [--logging-optional=LOGGING_OPTIONAL] [--logging-optional-fields=[LOGGING_OPTIONAL_FIELDS,...]] @@ -60,14 +62,19 @@ POSITIONAL ARGUMENTS FLAGS --affinity-cookie-name=AFFINITY_COOKIE_NAME - If --session-affinity is set to HTTP_COOKIE, this flag sets the name of - the cookie. + If --session-affinity is set to HTTP_COOKIE or STRONG_COOKIE_AFFINITY, + this flag sets the name of the cookie. + + --affinity-cookie-path=AFFINITY_COOKIE_PATH + If --session-affinity is set to HTTP_COOKIE or STRONG_COOKIE_AFFINITY, + this flag sets the path of the cookie. --affinity-cookie-ttl=AFFINITY_COOKIE_TTL - If --session-affinity is set to GENERATED_COOKIE or HTTP_COOKIE, this - flag sets the TTL, in seconds, of the resulting cookie. A setting of 0 - indicates that the cookie should be a session cookie. See $ gcloud - topic datetimes for information on duration formats. + If --session-affinity is set to GENERATED_COOKIE, HTTP_COOKIE, or + STRONG_COOKIE_AFFINITY, this flag sets the TTL, in seconds, of the + resulting cookie. A setting of 0 indicates that the cookie should be a + session cookie. See $ gcloud topic datetimes for information on + duration formats. --cache-key-include-host Enable including host in cache key. If enabled, requests to different @@ -259,6 +266,32 @@ FLAGS service-based external and internal passthrough Network Load Balancers as part of a connection tracking policy. + --ip-address-selection-policy=IP_ADDRESS_SELECTION_POLICY + Specifies a preference for traffic sent from the proxy to the backend + (or from the client to the backend for proxyless gRPC). + + Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED, + INTERNAL_MANAGED or EXTERNAL_MANAGED. + + The possible values are: + + IPV4_ONLY + Only send IPv4 traffic to the backends of the backend service, + regardless of traffic from the client to the proxy. Only IPv4 + health checks are used to check the health of the backends. + + PREFER_IPV6 + Prioritize the connection to the endpoint's IPv6 address over its IPv4 + address (provided there is a healthy IPv6 address). + + IPV6_ONLY + Only send IPv6 traffic to the backends of the backend service, + regardless of traffic from the client to the proxy. Only IPv6 + health checks are used to check the health of the backends. + + IP_ADDRESS_SELECTION_POLICY must be one of: IPV4_ONLY, PREFER_IPV6, + IPV6_ONLY. + --locality-lb-policy=LOCALITY_LB_POLICY The load balancing algorithm used within the scope of the locality. LOCALITY_LB_POLICY must be one of: INVALID_LB_POLICY, ROUND_ROBIN, diff --git a/gcloud/compute/instance-templates/create b/gcloud/compute/instance-templates/create index a94d835e1..15eed6408 100644 --- a/gcloud/compute/instance-templates/create +++ b/gcloud/compute/instance-templates/create @@ -641,7 +641,8 @@ FLAGS stack-type Specifies whether IPv6 is enabled on the interface. STACK_TYPE must - be one of: IPV4_ONLY, IPV4_IPV6. The default value is IPV4_ONLY. + be one of: IPV4_ONLY, IPV4_IPV6, IPV6_ONLY. The default value is + IPV4_ONLY. ipv6-network-tier Specifies the IPv6 network tier that will be used to configure the @@ -832,6 +833,8 @@ FLAGS The network interface can have both IPv4 and IPv6 addresses IPV4_ONLY The network interface will be assigned IPv4 addresses + IPV6_ONLY + The network interface will be assigned IPv6 addresses --subnet=SUBNET Specifies the subnet that the VM instances are a part of. If --network diff --git a/gcloud/compute/instances/bulk/create b/gcloud/compute/instances/bulk/create index 31dd054df..f6d1590ad 100644 --- a/gcloud/compute/instances/bulk/create +++ b/gcloud/compute/instances/bulk/create @@ -643,6 +643,11 @@ OPTIONAL FLAGS https://cloud.google.com/compute/docs/network-bandwidth#rx-tx for more details. + stack-type + Specifies whether IPv6 is enabled on the interface. STACK_TYPE must + be one of: IPV4_ONLY, IPV4_IPV6, IPV6_ONLY. The default value is + IPV4_ONLY. + --network-performance-configs=[PROPERTY=VALUE,...] Configures network performance settings for the instance. If this flag is not specified, the instance will be created with its default network @@ -752,6 +757,8 @@ OPTIONAL FLAGS The network interface can have both IPv4 and IPv6 addresses IPV4_ONLY The network interface will be assigned IPv4 addresses + IPV6_ONLY + The network interface will be assigned IPv6 addresses --subnet=SUBNET Specifies the subnet that the VM instances are a part of. If --network diff --git a/gcloud/compute/instances/create b/gcloud/compute/instances/create index 53a822a92..e74722295 100644 --- a/gcloud/compute/instances/create +++ b/gcloud/compute/instances/create @@ -733,7 +733,8 @@ FLAGS stack-type Specifies whether IPv6 is enabled on the interface. STACK_TYPE must - be one of: IPV4_ONLY, IPV4_IPV6. The default value is IPV4_ONLY. + be one of: IPV4_ONLY, IPV4_IPV6, IPV6_ONLY. The default value is + IPV4_ONLY. ipv6-network-tier Specifies the IPv6 network tier that will be used to configure the @@ -928,6 +929,8 @@ FLAGS The network interface can have both IPv4 and IPv6 addresses IPV4_ONLY The network interface will be assigned IPv4 addresses + IPV6_ONLY + The network interface will be assigned IPv6 addresses --subnet=SUBNET Specifies the subnet that the VM instances are a part of. If --network diff --git a/gcloud/compute/networks/subnets/create b/gcloud/compute/networks/subnets/create index 93471a2fd..54f9cb7ed 100644 --- a/gcloud/compute/networks/subnets/create +++ b/gcloud/compute/networks/subnets/create @@ -185,6 +185,8 @@ OPTIONAL FLAGS New VMs in this subnet can have both IPv4 and IPv6 addresses IPV4_ONLY New VMs in this subnet will only be assigned IPv4 addresses + IPV6_ONLY + New VMs in this subnet will only be assigned IPv6 addresses GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/compute/public-delegated-prefixes/create b/gcloud/compute/public-delegated-prefixes/create index b62040064..1034c80f7 100644 --- a/gcloud/compute/public-delegated-prefixes/create +++ b/gcloud/compute/public-delegated-prefixes/create @@ -47,8 +47,8 @@ OPTIONAL FLAGS Specify if this public delegated prefix is meant to be live migrated. --mode=MODE - Specifies the mode of this IPv6 PDP. MODE must be one of: - EXTERNAL_IPV6_FORWARDING_RULE_CREATION, DELEGATION. + Specifies the mode of this IPv6 PDP. MODE must be one of: delegation, + external-ipv6-forwarding-rule-creation. At most one of these can be specified: diff --git a/gcloud/compute/public-delegated-prefixes/delegated-sub-prefixes/create b/gcloud/compute/public-delegated-prefixes/delegated-sub-prefixes/create index 12d117661..d813a3d77 100644 --- a/gcloud/compute/public-delegated-prefixes/delegated-sub-prefixes/create +++ b/gcloud/compute/public-delegated-prefixes/delegated-sub-prefixes/create @@ -55,8 +55,8 @@ OPTIONAL FLAGS Description of the delegated sub prefix to create. --mode=MODE - Specify mode for the sub prefix. MODE must be one of: DELEGATION, - EXTERNAL_IPV6_FORWARDING_RULE_CREATION. + Specifies the mode of this IPv6 PDP. MODE must be one of: delegation, + external-ipv6-forwarding-rule-creation. --range=RANGE IPv4 range from this public delegated prefix that should be delegated, diff --git a/gcloud/config/get b/gcloud/config/get index 2b57d3b9d..a457a6b39 100644 --- a/gcloud/config/get +++ b/gcloud/config/get @@ -374,6 +374,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud filestore command group. Defaults to https://file.googleapis.com/ + firebasedataconnect + Overrides API endpoint for gcloud firebase-data-connect command + group. Defaults to https://firebasedataconnect.googleapis.com/ + firestore Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ diff --git a/gcloud/config/help b/gcloud/config/help index 416e33849..e99dac4b4 100644 --- a/gcloud/config/help +++ b/gcloud/config/help @@ -406,6 +406,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud filestore command group. Defaults to https://file.googleapis.com/ + firebasedataconnect + Overrides API endpoint for gcloud firebase-data-connect command + group. Defaults to https://firebasedataconnect.googleapis.com/ + firestore Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ diff --git a/gcloud/config/list b/gcloud/config/list index 018eeda51..783e513c6 100644 --- a/gcloud/config/list +++ b/gcloud/config/list @@ -418,6 +418,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud filestore command group. Defaults to https://file.googleapis.com/ + firebasedataconnect + Overrides API endpoint for gcloud firebase-data-connect command + group. Defaults to https://firebasedataconnect.googleapis.com/ + firestore Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ diff --git a/gcloud/config/set b/gcloud/config/set index 9cb4634ad..cdc573dcf 100644 --- a/gcloud/config/set +++ b/gcloud/config/set @@ -421,6 +421,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud filestore command group. Defaults to https://file.googleapis.com/ + firebasedataconnect + Overrides API endpoint for gcloud firebase-data-connect command + group. Defaults to https://firebasedataconnect.googleapis.com/ + firestore Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ diff --git a/gcloud/config/unset b/gcloud/config/unset index d57cf97f8..e4187917f 100644 --- a/gcloud/config/unset +++ b/gcloud/config/unset @@ -382,6 +382,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud filestore command group. Defaults to https://file.googleapis.com/ + firebasedataconnect + Overrides API endpoint for gcloud firebase-data-connect command + group. Defaults to https://firebasedataconnect.googleapis.com/ + firestore Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/ diff --git a/gcloud/container/fleet/mesh/update b/gcloud/container/fleet/mesh/update index 763343f2f..9b1d1ec3f 100644 --- a/gcloud/container/fleet/mesh/update +++ b/gcloud/container/fleet/mesh/update @@ -90,7 +90,9 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This variant is also available: + These variants are also available: $ gcloud alpha container fleet mesh update + $ gcloud beta container fleet mesh update + diff --git a/gcloud/container/hub/mesh/update b/gcloud/container/hub/mesh/update index 274688f07..95173a734 100644 --- a/gcloud/container/hub/mesh/update +++ b/gcloud/container/hub/mesh/update @@ -90,7 +90,9 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This variant is also available: + These variants are also available: $ gcloud alpha container hub mesh update + $ gcloud beta container hub mesh update + diff --git a/gcloud/database-migration/connection-profiles/create/cloudsql b/gcloud/database-migration/connection-profiles/create/cloudsql index be90e1165..e45a9b1d8 100644 --- a/gcloud/database-migration/connection-profiles/create/cloudsql +++ b/gcloud/database-migration/connection-profiles/create/cloudsql @@ -4,8 +4,10 @@ NAME SYNOPSIS gcloud database-migration connection-profiles create cloudsql - (CONNECTION_PROFILE : --region=REGION) - --database-version=DATABASE_VERSION --source-id=SOURCE_ID --tier=TIER + (CONNECTION_PROFILE : --region=REGION) --source-id=SOURCE_ID + --tier=TIER + (--database-version=DATABASE_VERSION + | --database-version-name=DATABASE_VERSION_NAME) [--activation-policy=ACTIVATION_POLICY] [--allocated-ip-range=ALLOCATED_IP_RANGE] [--no-async] [--authorized-networks=NETWORK,[NETWORK,...]] @@ -75,14 +77,6 @@ POSITIONAL ARGUMENTS ▸ provide the argument --region on the command line. REQUIRED FLAGS - --database-version=DATABASE_VERSION - Database engine type and version. DATABASE_VERSION must be one of: - MYSQL_5_7, MYSQL_5_6, MYSQL_8_0, MYSQL_8_0_18, MYSQL_8_0_26, - MYSQL_8_0_27, MYSQL_8_0_28, MYSQL_8_0_30, MYSQL_8_0_31, MYSQL_8_0_32, - MYSQL_8_0_33, MYSQL_8_0_34, MYSQL_8_0_35, MYSQL_8_0_36, MYSQL_8_0_37, - MYSQL_8_4, POSTGRES_9_6, POSTGRES_10, POSTGRES_11, POSTGRES_12, - POSTGRES_13, POSTGRES_14, POSTGRES_15, POSTGRES_16. - Connection profile resource - Database Migration Service source connection profile ID. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. @@ -113,6 +107,19 @@ REQUIRED FLAGS information, see Cloud SQL Instance Settings (https://cloud.google.com/sql/docs/mysql/instance-settings). + Exactly one of these must be specified: + + --database-version=DATABASE_VERSION + Database engine type and version. DATABASE_VERSION must be one of: + MYSQL_5_7, MYSQL_5_6, MYSQL_8_0, MYSQL_8_0_18, MYSQL_8_0_26, + MYSQL_8_0_27, MYSQL_8_0_28, MYSQL_8_0_30, MYSQL_8_0_31, MYSQL_8_0_32, + MYSQL_8_0_33, MYSQL_8_0_34, MYSQL_8_0_35, MYSQL_8_0_36, MYSQL_8_0_37, + MYSQL_8_4, POSTGRES_9_6, POSTGRES_10, POSTGRES_11, POSTGRES_12, + POSTGRES_13, POSTGRES_14, POSTGRES_15, POSTGRES_16. + + --database-version-name=DATABASE_VERSION_NAME + Database version name (e.g. POSTGRES_15) + OPTIONAL FLAGS --activation-policy=ACTIVATION_POLICY Activation policy specifies when the instance is activated; it is diff --git a/gcloud/dataproc/clusters/create b/gcloud/dataproc/clusters/create index 13bff5dec..1bf66405d 100644 --- a/gcloud/dataproc/clusters/create +++ b/gcloud/dataproc/clusters/create @@ -38,8 +38,11 @@ SYNOPSIS [--secondary-worker-boot-disk-type=SECONDARY_WORKER_BOOT_DISK_TYPE] [--secondary-worker-local-ssd-interface=SECONDARY_WORKER_LOCAL_SSD_INTERFACE] [--secondary-worker-machine-types=type=MACHINE_TYPE[, - type=MACHINE_TYPE...][,rank=RANK]] [--shielded-integrity-monitoring] - [--shielded-secure-boot] [--shielded-vtpm] [--temp-bucket=TEMP_BUCKET] + type=MACHINE_TYPE...][,rank=RANK]] + [--secondary-worker-standard-capacity-base=SECONDARY_WORKER_STANDARD_CAPACITY_BASE] + [--secondary-worker-standard-capacity-percent-above-base=SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE] + [--shielded-integrity-monitoring] [--shielded-secure-boot] + [--shielded-vtpm] [--temp-bucket=TEMP_BUCKET] [--worker-accelerator=[type=TYPE,[count=COUNT],...]] [--worker-boot-disk-size=WORKER_BOOT_DISK_SIZE] [--worker-boot-disk-type=WORKER_BOOT_DISK_TYPE] @@ -385,6 +388,23 @@ FLAGS Defaults to server-specified.eg. --secondary-worker-machine-types="type=e2-standard-8,type=t2d-standard-8,rank=0" + --secondary-worker-standard-capacity-base=SECONDARY_WORKER_STANDARD_CAPACITY_BASE + This flag sets the base number of Standard VMs to use for secondary + workers + (https://cloud.google.com/dataproc/docs/concepts/compute/secondary-vms#preemptible_and_non-preemptible_secondary_workers). + Dataproc will create only standard VMs until it reaches this number, + then it will mix Spot and Standard VMs according to + SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE. + + --secondary-worker-standard-capacity-percent-above-base=SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE + When combining Standard and Spot VMs for secondary-workers + (https://cloud.google.com/dataproc/docs/concepts/compute/secondary-vms#preemptible_and_non-preemptible_secondary_workers) + once the number of Standard VMs specified by + SECONDARY_WORKER_STANDARD_CAPACITY_BASE has been used, this flag + specifies the percentage of the total number of additional Standard VMs + secondary workers will use. Spot VMs will be used for the remaining + percentage. + --shielded-integrity-monitoring Enables monitoring and attestation of the boot integrity of the cluster's VMs. vTPM (virtual Trusted Platform Module) must also be diff --git a/gcloud/dataproc/workflow-templates/set-managed-cluster b/gcloud/dataproc/workflow-templates/set-managed-cluster index d51e8176c..fa2645044 100644 --- a/gcloud/dataproc/workflow-templates/set-managed-cluster +++ b/gcloud/dataproc/workflow-templates/set-managed-cluster @@ -31,8 +31,11 @@ SYNOPSIS [--secondary-worker-boot-disk-type=SECONDARY_WORKER_BOOT_DISK_TYPE] [--secondary-worker-local-ssd-interface=SECONDARY_WORKER_LOCAL_SSD_INTERFACE] [--secondary-worker-machine-types=type=MACHINE_TYPE[, - type=MACHINE_TYPE...][,rank=RANK]] [--shielded-integrity-monitoring] - [--shielded-secure-boot] [--shielded-vtpm] [--temp-bucket=TEMP_BUCKET] + type=MACHINE_TYPE...][,rank=RANK]] + [--secondary-worker-standard-capacity-base=SECONDARY_WORKER_STANDARD_CAPACITY_BASE] + [--secondary-worker-standard-capacity-percent-above-base=SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE] + [--shielded-integrity-monitoring] [--shielded-secure-boot] + [--shielded-vtpm] [--temp-bucket=TEMP_BUCKET] [--worker-accelerator=[type=TYPE,[count=COUNT],...]] [--worker-boot-disk-size=WORKER_BOOT_DISK_SIZE] [--worker-boot-disk-type=WORKER_BOOT_DISK_TYPE] @@ -307,6 +310,23 @@ FLAGS Defaults to server-specified.eg. --secondary-worker-machine-types="type=e2-standard-8,type=t2d-standard-8,rank=0" + --secondary-worker-standard-capacity-base=SECONDARY_WORKER_STANDARD_CAPACITY_BASE + This flag sets the base number of Standard VMs to use for secondary + workers + (https://cloud.google.com/dataproc/docs/concepts/compute/secondary-vms#preemptible_and_non-preemptible_secondary_workers). + Dataproc will create only standard VMs until it reaches this number, + then it will mix Spot and Standard VMs according to + SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE. + + --secondary-worker-standard-capacity-percent-above-base=SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE + When combining Standard and Spot VMs for secondary-workers + (https://cloud.google.com/dataproc/docs/concepts/compute/secondary-vms#preemptible_and_non-preemptible_secondary_workers) + once the number of Standard VMs specified by + SECONDARY_WORKER_STANDARD_CAPACITY_BASE has been used, this flag + specifies the percentage of the total number of additional Standard VMs + secondary workers will use. Spot VMs will be used for the remaining + percentage. + --shielded-integrity-monitoring Enables monitoring and attestation of the boot integrity of the cluster's VMs. vTPM (virtual Trusted Platform Module) must also be diff --git a/gcloud/datastore/indexes/create b/gcloud/datastore/indexes/create index 322da77e2..f7027159b 100644 --- a/gcloud/datastore/indexes/create +++ b/gcloud/datastore/indexes/create @@ -17,7 +17,7 @@ EXAMPLES Detailed information about index configuration can be found at the index.yaml reference - (https://cloud.google.com/appengine/docs/standard/python/config/indexref). + (https://cloud.google.com/datastore/docs/tools/indexconfig). POSITIONAL ARGUMENTS INDEX_FILE diff --git a/gcloud/looker/instances/create b/gcloud/looker/instances/create index be9115fc5..8a3b53237 100644 --- a/gcloud/looker/instances/create +++ b/gcloud/looker/instances/create @@ -25,7 +25,7 @@ DESCRIPTION EXAMPLES To create a basic tier instance with the name my-looker-instance in region - us-central-1 with an edition of "LOOKER_CORE_STANDARD", run: + us-central-1 with an edition of LOOKER_CORE_STANDARD, run: $ gcloud looker instances create my-looker-instance \ --region=us-central1 --edition="core-standard" \ @@ -187,11 +187,9 @@ OPTIONAL FLAGS which disrupts service briefly. --maintenance-window-day=MAINTENANCE_WINDOW_DAY - Day of week for maintenance window, in UTC time zone. To set the - maintenance-window-day attribute: - ▸ provide the argument --maintenance-window-day on the command - line. MAINTENANCE_WINDOW_DAY must be one of: friday, monday, - saturday, sunday, thursday, tuesday, wednesday. + Day of week for maintenance window, in UTC time zone. + MAINTENANCE_WINDOW_DAY must be one of: friday, monday, saturday, + sunday, thursday, tuesday, wednesday. This flag argument must be specified if any of the other arguments in this group are specified. @@ -199,10 +197,7 @@ OPTIONAL FLAGS --maintenance-window-time=MAINTENANCE_WINDOW_TIME Hour of day for maintenance window, in UTC time zone. A valid time of day must be specified in 24hr format (ex: 13:00, 17:30, 23:45). - Maintenance will be scheduled within 60 minutes. To set the - maintenance-window-time attribute: - ▸ provide the argument --maintenance-window-time on the command - line. + Maintenance will be scheduled within 60 minutes. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/network-connectivity/hubs/route-tables/routes/list b/gcloud/network-connectivity/hubs/route-tables/routes/list index 950d20968..89fd187f0 100644 --- a/gcloud/network-connectivity/hubs/route-tables/routes/list +++ b/gcloud/network-connectivity/hubs/route-tables/routes/list @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud network-connectivity hubs route-tables routes list - (--route_table=ROUTE_TABLE : --hub=HUB) [--filter=EXPRESSION] + (--route_table=ROUTE_TABLE : --hub=HUB) + [--effective-location=EFFECTIVE_LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -21,6 +22,13 @@ EXAMPLES $ gcloud network-connectivity hubs route-tables routes list \ --hub=my-hub --route_table=my-route-table + To list all routes in route table my-route-table, effective at a + location/region run: + + $ gcloud network-connectivity hubs route-tables routes list \ + --hub=my-hub --route_table=my-route-table \ + --effective-location=location + REQUIRED FLAGS Route table resource - Parent route table of the routes to display. The arguments in this group can be used to specify the attributes of this @@ -53,6 +61,12 @@ REQUIRED FLAGS fully specified name; ▸ provide the argument --hub on the command line. +FLAGS + --effective-location=EFFECTIVE_LOCATION + The effective location/region to limit the list of routes. The + effective location must be a valid region name. To list valid region + names, use 'gcloud compute regions list'. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/network-connectivity/internal-ranges/create b/gcloud/network-connectivity/internal-ranges/create index 7bcc858c8..b9d1dd87b 100644 --- a/gcloud/network-connectivity/internal-ranges/create +++ b/gcloud/network-connectivity/internal-ranges/create @@ -155,7 +155,8 @@ OPTIONAL FLAGS for-migration Ranges created with FOR_MIGRATION are used as locks for migrating - subnetworks between peered VPC networks. + subnetworks between peered VPC networks. This value is for internal + use. for-vpc A cloud resource can use the reserved CIDR block by associating it @@ -172,14 +173,14 @@ OPTIONAL FLAGS --migration-source=MIGRATION_SOURCE The migration source subnetwork (of a for-migration internal range) - resource URI or resource ID. + resource URI or resource ID. This value is for internal use. This flag argument must be specified if any of the other arguments in this group are specified. --migration-target=MIGRATION_TARGET The migration target subnetwork (of a for-migration internal range) - resource URI or resource ID. + resource URI or resource ID. This value is for internal use. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/network-connectivity/spokes/help b/gcloud/network-connectivity/spokes/help index 697765bbb..7f902c046 100644 --- a/gcloud/network-connectivity/spokes/help +++ b/gcloud/network-connectivity/spokes/help @@ -19,6 +19,9 @@ GROUPS linked-interconnect-attachments Manage VLAN attachment spokes. + linked-producer-vpc-network + Manage Producer VPC spokes. + linked-router-appliances Manage Router appliance spokes. diff --git a/gcloud/network-connectivity/spokes/linked-producer-vpc-network/create b/gcloud/network-connectivity/spokes/linked-producer-vpc-network/create new file mode 100644 index 000000000..1ab55a2fb --- /dev/null +++ b/gcloud/network-connectivity/spokes/linked-producer-vpc-network/create @@ -0,0 +1,96 @@ +NAME + gcloud network-connectivity spokes linked-producer-vpc-network create - + create a new Producer VPC spoke + +SYNOPSIS + gcloud network-connectivity spokes linked-producer-vpc-network create SPOKE + --hub=HUB --network=NETWORK --peering=PEERING [--async] + [--description=DESCRIPTION] [--exclude-export-ranges=[CIDR_RANGE,...]] + [--global] [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a new Producer VPC spoke. + +EXAMPLES + To create a Producer VPC spoke named myspoke, run: + + $ gcloud network-connectivity spokes linked-producer-vpc-network \ + create myspoke \ + --hub="https://www.googleapis.com/networkconnectivity/v1/project\ + s/my-project/locations/global/hubs/my-hub" --global \ + --network="https://www.googleapis.com/compute/v1/projects/my-pro\ + ject/global/networks/my-vpc" --peering="my-peering-name" \ + +POSITIONAL ARGUMENTS + Spoke resource - Name of the spoke 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 spoke on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument spoke on the command line with a fully specified + name; + ◆ provide the argument --global on the command line. + + This must be specified. + + SPOKE + ID of the spoke or fully qualified identifier for the spoke. + + To set the spoke attribute: + ▸ provide the argument spoke on the command line. + +REQUIRED FLAGS + --hub=HUB + Hub that the spoke will attach to. The hub must already exist. + + --network=NETWORK + Your VPC network that contains the peering to the Producer VPC, which + this spoke connects to the Hub. The peering must already exist and be + in the ACTIVE state. + + --peering=PEERING + Peering between your network and the Producer VPC, which this spoke + connects to the Hub. The peering must already exist and be in the + ACTIVATE state. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + Description of the spoke to create. + + --exclude-export-ranges=[CIDR_RANGE,...] + Subnet IP address range(s) to hide from other VPC networks that are + connected through Network Connectivity Center. + + --global + Indicates that the spoke is global. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest diff --git a/gcloud/network-connectivity/spokes/linked-producer-vpc-network/help b/gcloud/network-connectivity/spokes/linked-producer-vpc-network/help new file mode 100644 index 000000000..35a0add2b --- /dev/null +++ b/gcloud/network-connectivity/spokes/linked-producer-vpc-network/help @@ -0,0 +1,24 @@ +NAME + gcloud network-connectivity spokes linked-producer-vpc-network - manage + Producer VPC spokes + +SYNOPSIS + gcloud network-connectivity spokes linked-producer-vpc-network COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Producer VPC spokes. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a new Producer VPC spoke. + + update + Update a Producer VPC spoke. diff --git a/gcloud/network-connectivity/spokes/linked-producer-vpc-network/update b/gcloud/network-connectivity/spokes/linked-producer-vpc-network/update new file mode 100644 index 000000000..2d862c50e --- /dev/null +++ b/gcloud/network-connectivity/spokes/linked-producer-vpc-network/update @@ -0,0 +1,96 @@ +NAME + gcloud network-connectivity spokes linked-producer-vpc-network update - + update a Producer VPC spoke + +SYNOPSIS + gcloud network-connectivity spokes linked-producer-vpc-network update SPOKE + [--async] [--description=DESCRIPTION] [--global] + [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update the details of a Producer VPC spoke. + +EXAMPLES + To update the description of a Producer VPC spoke named my-spoke, run: + + $ gcloud network-connectivity spokes linked-producer-vpc-network \ + update myspoke --global --description="new spoke description" + +POSITIONAL ARGUMENTS + Spoke resource - Name of the spoke to update. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument spoke on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument spoke on the command line with a fully specified + name; + ◆ provide the argument --global on the command line. + + This must be specified. + + SPOKE + ID of the spoke or fully qualified identifier for the spoke. + + To set the spoke attribute: + ▸ provide the argument spoke on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + New description of the spoke. + + --global + Indicates that the spoke is global. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud network-connectivity spokes linked-producer-vpc-network \ + update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud network-connectivity spokes linked-producer-vpc-network \ + update --clear-labels --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest diff --git a/gcloud/sql/flags/list b/gcloud/sql/flags/list index e1ebc8697..6795059cd 100644 --- a/gcloud/sql/flags/list +++ b/gcloud/sql/flags/list @@ -20,7 +20,7 @@ FLAGS supported minor versions. DATABASE_VERSION must be one of: MYSQL_5_6, MYSQL_5_7, MYSQL_8_0, MYSQL_8_4, POSTGRES_9_6, POSTGRES_10, POSTGRES_11, POSTGRES_12, POSTGRES_13, POSTGRES_14, POSTGRES_15, - POSTGRES_16, SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, + POSTGRES_16, POSTGRES_17, SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE, SQLSERVER_2022_EXPRESS, SQLSERVER_2022_WEB, diff --git a/gcloud/sql/instances/create b/gcloud/sql/instances/create index 802465281..12563f40d 100644 --- a/gcloud/sql/instances/create +++ b/gcloud/sql/instances/create @@ -39,6 +39,7 @@ SYNOPSIS [--password-policy-min-length=PASSWORD_POLICY_MIN_LENGTH] [--password-policy-password-change-interval=PASSWORD_POLICY_PASSWORD_CHANGE_INTERVAL] [--password-policy-reuse-interval=PASSWORD_POLICY_REUSE_INTERVAL] + [--psc-auto-connections=[network=NETWORK],[project=PROJECT]] [--[no-]recreate-replicas-on-primary-crash] [--replica-type=REPLICA_TYPE] [--replication=REPLICATION] [--require-ssl] [--retained-backups-count=RETAINED_BACKUPS_COUNT] @@ -199,7 +200,7 @@ FLAGS supported minor versions. DATABASE_VERSION must be one of: MYSQL_5_6, MYSQL_5_7, MYSQL_8_0, MYSQL_8_4, POSTGRES_9_6, POSTGRES_10, POSTGRES_11, POSTGRES_12, POSTGRES_13, POSTGRES_14, POSTGRES_15, - POSTGRES_16, SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, + POSTGRES_16, POSTGRES_17, SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE, SQLSERVER_2022_EXPRESS, SQLSERVER_2022_WEB, @@ -365,6 +366,35 @@ FLAGS Number of previous passwords that cannot be reused. The valid range is 0 to 100. + --psc-auto-connections=[network=NETWORK],[project=PROJECT] + A comma-separated list of networks or a comma-separated list of + network-project pairs. Each project in this list is represented by a + project number (numeric) or by a project ID (alphanumeric). This allows + Private Service Connect connections to be created automatically for the + specified networks. For example, this connection uses "the form + psc-auto-connections=network=projects/testproject1/global/networks/testnetwork1" + or "the form + psc-auto-connections=project=testproject1,network=projects/testproject1/global/networks/testnetwork1". + Sets psc_auto_connections value. + + network + Required, Sets network value. + + project + Sets project value. + + Shorthand Example: + + --psc-auto-connections=network=string,project=string + + JSON Example: + + --psc-auto-connections='{"network": "string", "project": "string"}' + + File Example: + + --psc-auto-connections=path_to_file.(yaml|json) + --[no-]recreate-replicas-on-primary-crash Allow/Disallow replica recreation when a primary MySQL instance operating in reduced durability mode crashes. Not recreating the diff --git a/gcloud/sql/instances/patch b/gcloud/sql/instances/patch index 5c638ef1f..6dbf27c96 100644 --- a/gcloud/sql/instances/patch +++ b/gcloud/sql/instances/patch @@ -141,7 +141,7 @@ FLAGS supported minor versions. DATABASE_VERSION must be one of: MYSQL_5_6, MYSQL_5_7, MYSQL_8_0, MYSQL_8_4, POSTGRES_9_6, POSTGRES_10, POSTGRES_11, POSTGRES_12, POSTGRES_13, POSTGRES_14, POSTGRES_15, - POSTGRES_16, SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, + POSTGRES_16, POSTGRES_17, SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE, SQLSERVER_2022_EXPRESS, SQLSERVER_2022_WEB, diff --git a/gcloud/storage/buckets/create b/gcloud/storage/buckets/create index 7b7661f59..b51f96d56 100644 --- a/gcloud/storage/buckets/create +++ b/gcloud/storage/buckets/create @@ -8,7 +8,8 @@ SYNOPSIS -k DEFAULT_ENCRYPTION_KEY] [--default-storage-class=DEFAULT_STORAGE_CLASS, -c DEFAULT_STORAGE_CLASS, -s DEFAULT_STORAGE_CLASS] - [--enable-per-object-retention] [--location=LOCATION, -l LOCATION] + [--enable-hierarchical-namespace] [--enable-per-object-retention] + [--location=LOCATION, -l LOCATION] [--[no-]pap, --[no-]public-access-prevention] [--placement=REGION,REGION] [--recovery-point-objective=SETTING, --rpo=SETTING] @@ -56,6 +57,10 @@ FLAGS If not specified, the default storage class used by Cloud Storage is "Standard". + --enable-hierarchical-namespace + Enable hierarchical namespace for the bucket. To use this flag, you + must also use --uniform-bucket-level-access + --enable-per-object-retention Enables each object in the bucket to have its own retention settings, which prevents deletion until stored for a specific length of time. diff --git a/gcloud/storage/folders/create b/gcloud/storage/folders/create new file mode 100644 index 000000000..aee291ae9 --- /dev/null +++ b/gcloud/storage/folders/create @@ -0,0 +1,52 @@ +NAME + gcloud storage folders create - create folders for hierarchical namespace + bucket + +SYNOPSIS + gcloud storage folders create URL [URL ...] + [--additional-headers=HEADER=VALUE] [--recursive] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create folders. + +EXAMPLES + The following command creates a folder called folder/ in a bucket named + my-bucket: + + $ gcloud storage folders create gs://my-bucket/folder/ + + The following command creates all folders in the path A/B/C/D in a bucket + named my-bucket: + + $ gcloud storage folders create \ + --recursive gs://my-bucket/folder/A/B/C/D + +POSITIONAL ARGUMENTS + URL [URL ...] + The URLs of the folders to create. + +FLAGS + --additional-headers=HEADER=VALUE + Includes arbitrary headers in storage API calls. Accepts a comma + separated list of key=value pairs, e.g. header1=value1,header2=value2. + Overrides the default storage/additional_headers property value for + this command invocation. + + --recursive + Recursively create all folders in a given path if they do not alraedy + exist. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha storage folders create + diff --git a/gcloud/storage/folders/delete b/gcloud/storage/folders/delete new file mode 100644 index 000000000..0873e96b9 --- /dev/null +++ b/gcloud/storage/folders/delete @@ -0,0 +1,40 @@ +NAME + gcloud storage folders delete - delete folders + +SYNOPSIS + gcloud storage folders delete URLS [URLS ...] + [--additional-headers=HEADER=VALUE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete folders. + +EXAMPLES + The following command deletes a folder named folder in a hierarchical + namesapce bucket called my-bucket: + + $ gcloud storage folders delete gs://my-bucket/folder/ + +POSITIONAL ARGUMENTS + URLS [URLS ...] + The URLs of the folders to delete. + +FLAGS + --additional-headers=HEADER=VALUE + Includes arbitrary headers in storage API calls. Accepts a comma + separated list of key=value pairs, e.g. header1=value1,header2=value2. + Overrides the default storage/additional_headers property value for + this command invocation. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha storage folders delete + diff --git a/gcloud/storage/folders/describe b/gcloud/storage/folders/describe new file mode 100644 index 000000000..37dd704c5 --- /dev/null +++ b/gcloud/storage/folders/describe @@ -0,0 +1,45 @@ +NAME + gcloud storage folders describe - describe hierarchical namesapace bucket + folders + +SYNOPSIS + gcloud storage folders describe URL [--additional-headers=HEADER=VALUE] + [--raw] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe hierarchical namespace bucket folders. + +EXAMPLES + The following command shows information about a folder named folder in an + hierarchical namespace bucket called my-bucket: + + $ gcloud storage folders describe gs://my-bucket/folder/ + +POSITIONAL ARGUMENTS + URL + The URL of the folder to describe. + +FLAGS + --additional-headers=HEADER=VALUE + Includes arbitrary headers in storage API calls. Accepts a comma + separated list of key=value pairs, e.g. header1=value1,header2=value2. + Overrides the default storage/additional_headers property value for + this command invocation. + + --raw + Shows metadata in the format returned by the API instead of + standardizing it. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha storage folders describe + diff --git a/gcloud/storage/folders/help b/gcloud/storage/folders/help new file mode 100644 index 000000000..ae4fd2f68 --- /dev/null +++ b/gcloud/storage/folders/help @@ -0,0 +1,34 @@ +NAME + gcloud storage folders - manage Cloud Storage folders + +SYNOPSIS + gcloud storage folders COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Cloud Storage folders. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create folders for hierarchical namespace bucket. + + delete + Delete folders. + + describe + Describe hierarchical namesapace bucket folders. + + list + List folders. + +NOTES + This variant is also available: + + $ gcloud alpha storage folders + diff --git a/gcloud/storage/folders/list b/gcloud/storage/folders/list new file mode 100644 index 000000000..b25f957b0 --- /dev/null +++ b/gcloud/storage/folders/list @@ -0,0 +1,94 @@ +NAME + gcloud storage folders list - list folders + +SYNOPSIS + gcloud storage folders list URL [URL ...] + [--additional-headers=HEADER=VALUE] [--raw] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List folders. + +EXAMPLES + The following command lists all folders in a hierarchical namespace bucket: + + $ gcloud storage folders list gs://my-bucket/ + + The following command lists all folders under a parent folder: + + $ gcloud storage folders list gs://my-bucket/parent-folder/ + + You can use wildcards (https://cloud.google.com/storage/docs/wildcards) to + match multiple paths (including multiple buckets). Bucket wildcards are + expanded to match only buckets contained in your current project. The + following command matches folders that are stored in buckets in your + project that begin with my-b: + + $ gcloud storage folders list gs://my-b*/ + + Following is another example where we are listing all folders that begin + with ``B'' under a given bucket: + + $ gcloud storage folders list gs://my-bucket/B* + +POSITIONAL ARGUMENTS + URL [URL ...] + The URLs of the resources to list. + +FLAGS + --additional-headers=HEADER=VALUE + Includes arbitrary headers in storage API calls. Accepts a comma + separated list of key=value pairs, e.g. header1=value1,header2=value2. + Overrides the default storage/additional_headers property value for + this command invocation. + + --raw + Shows metadata in the format returned by the API instead of + standardizing it. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha storage folders list + diff --git a/gcloud/storage/help b/gcloud/storage/help index 2de832a31..f7f03b0d4 100644 --- a/gcloud/storage/help +++ b/gcloud/storage/help @@ -23,6 +23,9 @@ GROUPS buckets Manage Cloud Storage buckets. + folders + Manage Cloud Storage folders. + hmac Manage Cloud Storage service account HMAC keys.