diff --git a/gcloud/_version b/gcloud/_version index bcd87a5b3..9d8fd0128 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,7 +1,7 @@ -Google Cloud SDK 397.0.0 -alpha 2022.08.05 -beta 2022.08.05 +Google Cloud SDK 398.0.0 +alpha 2022.08.12 +beta 2022.08.12 bq 2.0.75 -core 2022.08.05 +core 2022.08.12 gcloud-crc32c 1.0.0 -gsutil 5.11 +gsutil 5.12 diff --git a/gcloud/ai/endpoints/create b/gcloud/ai/endpoints/create index d22d01a25..554c27275 100644 --- a/gcloud/ai/endpoints/create +++ b/gcloud/ai/endpoints/create @@ -3,8 +3,10 @@ NAME SYNOPSIS gcloud ai endpoints create --display-name=DISPLAY_NAME - [--description=DESCRIPTION] [--endpoint-id=ENDPOINT_ID] - [--labels=[KEY=VALUE,...]] [--network=NETWORK] [--region=REGION] + [--description=DESCRIPTION] + [--encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME] + [--endpoint-id=ENDPOINT_ID] [--labels=[KEY=VALUE,...]] + [--network=NETWORK] [--region=REGION] [--request-response-logging-rate=REQUEST_RESPONSE_LOGGING_RATE --request-response-logging-table=REQUEST_RESPONSE_LOGGING_TABLE] [GCLOUD_WIDE_FLAG ...] @@ -23,6 +25,14 @@ OPTIONAL FLAGS --description=DESCRIPTION Description of the endpoint. + --encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME + The Cloud KMS resource identifier of the customer managed encryption + key used to protect a resource. Has the form: + projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key. + + The key needs to be in the same region as where the compute resource is + created. + --endpoint-id=ENDPOINT_ID User-specified ID of the endpoint. diff --git a/gcloud/ai/endpoints/deploy-model b/gcloud/ai/endpoints/deploy-model index 07896290b..addecaa13 100644 --- a/gcloud/ai/endpoints/deploy-model +++ b/gcloud/ai/endpoints/deploy-model @@ -6,6 +6,7 @@ SYNOPSIS gcloud ai endpoints deploy-model (ENDPOINT : --region=REGION) --display-name=DISPLAY_NAME --model=MODEL [--accelerator=[count=COUNT],[type=TYPE]] + [--autoscaling-metric-specs=[METRIC-NAME=TARGET,...]] [--deployed-model-id=DEPLOYED_MODEL_ID] [--disable-container-logging] [--enable-access-logging] [--machine-type=MACHINE_TYPE] [--max-replica-count=MAX_REPLICA_COUNT] @@ -73,6 +74,20 @@ OPTIONAL FLAGS For example: --accelerator=type=nvidia-tesla-k80,count=1 + --autoscaling-metric-specs=[METRIC-NAME=TARGET,...] + Metric specifications that overrides a resource utilization metric's + target value. At most one entry is allowed per metric. + + METRIC-NAME + Resource metric name. Choices are 'cpu-usage', 'gpu-duty-cycle'. + + TARGET + Target resource utilization in percentage (1% - 100%) for the given + metric. If the value is set to 60, the target resource utilization + is 60%. + + For example: --autoscaling-metric-specs=cpu-usage=70 + --deployed-model-id=DEPLOYED_MODEL_ID User-specified ID of the deployed-model. diff --git a/gcloud/alpha/ai/endpoints/create b/gcloud/alpha/ai/endpoints/create index c524fac34..eee9c3e5e 100644 --- a/gcloud/alpha/ai/endpoints/create +++ b/gcloud/alpha/ai/endpoints/create @@ -3,8 +3,10 @@ NAME SYNOPSIS gcloud alpha ai endpoints create --display-name=DISPLAY_NAME - [--description=DESCRIPTION] [--endpoint-id=ENDPOINT_ID] - [--labels=[KEY=VALUE,...]] [--network=NETWORK] [--region=REGION] + [--description=DESCRIPTION] + [--encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME] + [--endpoint-id=ENDPOINT_ID] [--labels=[KEY=VALUE,...]] + [--network=NETWORK] [--region=REGION] [--request-response-logging-rate=REQUEST_RESPONSE_LOGGING_RATE --request-response-logging-table=REQUEST_RESPONSE_LOGGING_TABLE] [GCLOUD_WIDE_FLAG ...] @@ -23,6 +25,14 @@ OPTIONAL FLAGS --description=DESCRIPTION Description of the endpoint. + --encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME + The Cloud KMS resource identifier of the customer managed encryption + key used to protect a resource. Has the form: + projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key. + + The key needs to be in the same region as where the compute resource is + created. + --endpoint-id=ENDPOINT_ID User-specified ID of the endpoint. diff --git a/gcloud/alpha/artifacts/docker/images/describe b/gcloud/alpha/artifacts/docker/images/describe index b4aadcde2..f0ea84194 100644 --- a/gcloud/alpha/artifacts/docker/images/describe +++ b/gcloud/alpha/artifacts/docker/images/describe @@ -50,7 +50,8 @@ FLAGS reference. --show-all-metadata - Include all metadata in the output. + Include all metadata in the output. Metadata will be grouped by Grafeas + kind, with an additional section for intoto provenance metadata. --show-build-details Include build metadata in the output. @@ -65,7 +66,9 @@ FLAGS Include vulnerability metadata in the output. --show-provenance - Include build provenance metadata in the output. + Include intoto provenance metadata in the output, in the + provenance_summary section. To see all build metadata in the output, + use --show-all-metadata or --show-build-details. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/builds/cancel b/gcloud/alpha/builds/cancel index 6dfe80f41..55f503c2e 100644 --- a/gcloud/alpha/builds/cancel +++ b/gcloud/alpha/builds/cancel @@ -24,8 +24,8 @@ POSITIONAL ARGUMENTS FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global service - region is used. + supported region name (e.g. us-central1). If unset, builds/region is + used. If builds/region is unset,region is set to "global". GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/builds/describe b/gcloud/alpha/builds/describe index 0f2c35399..7be1c5265 100644 --- a/gcloud/alpha/builds/describe +++ b/gcloud/alpha/builds/describe @@ -20,8 +20,8 @@ POSITIONAL ARGUMENTS FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global service - region is used. + supported region name (e.g. us-central1). If unset, builds/region is + used. If builds/region is unset,region is set to "global". GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/builds/list b/gcloud/alpha/builds/list index 422266a7e..a7092c5e0 100644 --- a/gcloud/alpha/builds/list +++ b/gcloud/alpha/builds/list @@ -25,8 +25,8 @@ FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global service - region is used. + supported region name (e.g. us-central1). If unset, builds/region is + used. If builds/region is unset,region is set to "global". LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/builds/log b/gcloud/alpha/builds/log index dc693fd3e..e4332f0eb 100644 --- a/gcloud/alpha/builds/log +++ b/gcloud/alpha/builds/log @@ -26,8 +26,8 @@ POSITIONAL ARGUMENTS FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global service - region is used. + supported region name (e.g. us-central1). If unset, builds/region is + used. If builds/region is unset,region is set to "global". --stream If a build is ongoing, stream the logs to stdout until the build diff --git a/gcloud/alpha/builds/submit b/gcloud/alpha/builds/submit index 7abe99b20..6b28dadc5 100644 --- a/gcloud/alpha/builds/submit +++ b/gcloud/alpha/builds/submit @@ -94,8 +94,8 @@ FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global service - region is used. + supported region name (e.g. us-central1). If unset, builds/region is + used. If builds/region is unset,region is set to "global". --substitutions=[KEY=VALUE,...] Parameters to be substituted in the build specification. diff --git a/gcloud/alpha/builds/triggers/create/gitlab-enterprise b/gcloud/alpha/builds/triggers/create/gitlab-enterprise index 0c306f9fd..e46bb92f5 100644 --- a/gcloud/alpha/builds/triggers/create/gitlab-enterprise +++ b/gcloud/alpha/builds/triggers/create/gitlab-enterprise @@ -67,8 +67,8 @@ REQUIRED FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global - service region is used. + supported region name (e.g. us-central1). If unset, builds/region + is used. If builds/region is unset,region is set to "global". This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/alpha/builds/triggers/import b/gcloud/alpha/builds/triggers/import index 176e60245..f5f100aab 100644 --- a/gcloud/alpha/builds/triggers/import +++ b/gcloud/alpha/builds/triggers/import @@ -22,8 +22,8 @@ REQUIRED FLAGS OPTIONAL FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global service - region is used. + supported region name (e.g. us-central1). If unset, builds/region is + used. If builds/region is unset,region is set to "global". GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/builds/triggers/list b/gcloud/alpha/builds/triggers/list index 55b92c8c6..7dcbd6a51 100644 --- a/gcloud/alpha/builds/triggers/list +++ b/gcloud/alpha/builds/triggers/list @@ -18,8 +18,8 @@ EXAMPLES FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global service - region is used. + supported region name (e.g. us-central1). If unset, builds/region is + used. If builds/region is unset,region is set to "global". LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/compute/backend-buckets/update b/gcloud/alpha/compute/backend-buckets/update index d4b2b293d..e7696936b 100644 --- a/gcloud/alpha/compute/backend-buckets/update +++ b/gcloud/alpha/compute/backend-buckets/update @@ -331,7 +331,12 @@ FLAGS Set this to zero (0) to disable serve-while-stale. --no-serve-while-stale - Clears serve while stale value. + (DEPRECATED) Clears serve while stale value. + + The --no-serve-while-stale option is deprecated and will be removed + in an upcoming release; use --serve-while-stale instead. If you're + currently using this argument, you should remove it from your + workflows. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/compute/backend-services/update b/gcloud/alpha/compute/backend-services/update index 27fb05acb..5c20bbc34 100644 --- a/gcloud/alpha/compute/backend-services/update +++ b/gcloud/alpha/compute/backend-services/update @@ -721,7 +721,12 @@ FLAGS Set this to zero (0) to disable serve-while-stale. --no-serve-while-stale - Clears serve while stale value. + (DEPRECATED) Clears serve while stale value. + + The --no-serve-while-stale option is deprecated and will be removed + in an upcoming release; use --serve-while-stale instead. If you're + currently using this argument, you should remove it from your + workflows. At most one of these can be specified: diff --git a/gcloud/alpha/compute/firewall-rules/delete b/gcloud/alpha/compute/firewall-rules/delete index 9e3e8f3dc..ed28c7545 100644 --- a/gcloud/alpha/compute/firewall-rules/delete +++ b/gcloud/alpha/compute/firewall-rules/delete @@ -10,6 +10,11 @@ DESCRIPTION (ALPHA) gcloud alpha compute firewall-rules delete deletes one or more Compute Engine firewall rules. +EXAMPLES + To delete a firewall rule, run: + + $ gcloud alpha compute firewall-rules delete my-firewall-rule + POSITIONAL ARGUMENTS NAME [NAME ...] Names of the firewall rules to delete. diff --git a/gcloud/alpha/compute/firewall-rules/describe b/gcloud/alpha/compute/firewall-rules/describe index 28dd2f7b1..5f1572c64 100644 --- a/gcloud/alpha/compute/firewall-rules/describe +++ b/gcloud/alpha/compute/firewall-rules/describe @@ -9,6 +9,11 @@ DESCRIPTION (ALPHA) gcloud alpha compute firewall-rules describe displays all data associated with a Compute Engine firewall rule in a project. +EXAMPLES + To describe a firewall rule, run: + + $ gcloud alpha compute firewall-rules describe my-firewall-rule + POSITIONAL ARGUMENTS NAME Name of the firewall rule to describe. diff --git a/gcloud/alpha/compute/forwarding-rules/create b/gcloud/alpha/compute/forwarding-rules/create index 7eb564b8c..46bacb139 100644 --- a/gcloud/alpha/compute/forwarding-rules/create +++ b/gcloud/alpha/compute/forwarding-rules/create @@ -223,8 +223,8 @@ OPTIONAL FLAGS INTERNAL Internal load balancing or forwarding, used with --backend-service. INTERNAL_MANAGED - Internal load balancing, used with --target-tcp-proxy, - --target-http-proxy, --target-https-proxy. + Internal load balancing, used with --target-http-proxy, + --target-https-proxy, --target-tcp-proxy. INTERNAL_SELF_MANAGED Traffic Director load balancing or forwarding, used with --target-http-proxy, --target-https-proxy, --target-grpc-proxy, diff --git a/gcloud/alpha/compute/forwarding-rules/set-target b/gcloud/alpha/compute/forwarding-rules/set-target index 0c5c4cf24..94efbbf44 100644 --- a/gcloud/alpha/compute/forwarding-rules/set-target +++ b/gcloud/alpha/compute/forwarding-rules/set-target @@ -130,8 +130,12 @@ REQUIRED FLAGS OPTIONAL FLAGS --load-balancing-scheme=LOAD_BALANCING_SCHEME; default="EXTERNAL" - This defines the forwarding rule's load balancing scheme. - LOAD_BALANCING_SCHEME must be one of: + (DEPRECATED) This defines the forwarding rule's load balancing scheme. + + The --load-balancing-scheme option is deprecated and will be removed in + an upcoming release. If you're currently using this argument, you + should remove it from your workflows. LOAD_BALANCING_SCHEME must be one + of: EXTERNAL External load balancing or forwarding, used with one of @@ -144,15 +148,15 @@ OPTIONAL FLAGS INTERNAL Internal load balancing or forwarding, used with --backend-service. INTERNAL_MANAGED - Internal load balancing, used with --target-tcp-proxy, - --target-http-proxy, --target-https-proxy. + Internal load balancing, used with --target-http-proxy, + --target-https-proxy, --target-tcp-proxy. INTERNAL_SELF_MANAGED Traffic Director load balancing or forwarding, used with --target-http-proxy, --target-https-proxy, --target-grpc-proxy, --target-tcp-proxy. --network=NETWORK - (Only for --load-balancing-scheme=INTERNAL or + (DEPRECATED) Only for --load-balancing-scheme=INTERNAL or --load-balancing-scheme=INTERNAL_SELF_MANAGED or --load-balancing-scheme=EXTERNAL_MANAGED (regional) or --load-balancing-scheme=INTERNAL_MANAGED) Network that this forwarding @@ -160,16 +164,28 @@ OPTIONAL FLAGS used. In the absence of the default network, this field must be specified. + The --network option is deprecated and will be removed in an upcoming + release. If you're currently using this argument, you should remove it + from your workflows. + --subnet=SUBNET - (Only for --load-balancing-scheme=INTERNAL and + (DEPRECATED) Only for --load-balancing-scheme=INTERNAL and --load-balancing-scheme=INTERNAL_MANAGED) Subnetwork that this forwarding rule applies to. If the network is auto mode, this flag is optional. If the network is custom mode, this flag is required. + The --subnet option is deprecated and will be removed in an upcoming + release. If you're currently using this argument, you should remove it + from your workflows. + --subnet-region=SUBNET_REGION - Region of the subnetwork to operate on. If not specified, the region is - set to the region of the forwarding rule. Overrides the default - compute/region property value for this command invocation. + (DEPRECATED) Region of the subnetwork to operate on. If not specified, + the region is set to the region of the forwarding rule. Overrides the + default compute/region property value for this command invocation. + + The --subnet-region option is deprecated and will be removed in an + upcoming release. If you're currently using this argument, you should + remove it from your workflows. --target-instance-zone=TARGET_INSTANCE_ZONE Zone of the target instance to operate on. Overrides the default diff --git a/gcloud/alpha/compute/instance-templates/create b/gcloud/alpha/compute/instance-templates/create index c88ba6a41..923a867d5 100644 --- a/gcloud/alpha/compute/instance-templates/create +++ b/gcloud/alpha/compute/instance-templates/create @@ -247,6 +247,11 @@ FLAGS the instance, this option won't apply. The default value for this is yes. + architecture + Specifies the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. + boot If yes, indicates that this is a boot disk. The instance will use the first partition of the disk for its root file system. The @@ -310,11 +315,6 @@ FLAGS among other restrictions. For more information, see https://cloud.google.com/compute/docs/disks/sharing-disks-between-vms. - architecture - Storage resources can be used to create boot disks compatible with - different machine architectures. ARCHITECTURE must be one of: - ARM64, X86_64. - --description=DESCRIPTION Specifies a textual description for the instance template. diff --git a/gcloud/alpha/compute/instance-templates/create-with-container b/gcloud/alpha/compute/instance-templates/create-with-container index 84415ec9b..333d922fb 100644 --- a/gcloud/alpha/compute/instance-templates/create-with-container +++ b/gcloud/alpha/compute/instance-templates/create-with-container @@ -340,6 +340,11 @@ FLAGS the instance, this option won't apply. The default value for this is yes. + architecture + Specifies the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. + multi-writer If yes, the disk is created in multi-writer mode so that it can be attached with read-write access to two VMs. The default value is diff --git a/gcloud/alpha/compute/instances/bulk/create b/gcloud/alpha/compute/instances/bulk/create index d89ea1b57..ca3f483c1 100644 --- a/gcloud/alpha/compute/instances/bulk/create +++ b/gcloud/alpha/compute/instances/bulk/create @@ -276,6 +276,11 @@ OPTIONAL FLAGS the instance, this option won't apply. The default value for this is yes. + architecture + Specifies the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. + boot If yes, indicates that this is a boot disk. The instance will use the first partition of the disk for its root file system. The diff --git a/gcloud/alpha/compute/instances/create b/gcloud/alpha/compute/instances/create index 4968b4b20..6c0562bdf 100644 --- a/gcloud/alpha/compute/instances/create +++ b/gcloud/alpha/compute/instances/create @@ -278,6 +278,11 @@ FLAGS the instance, this option won't apply. The default value for this is yes. + architecture + Specifies the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. + boot If yes, indicates that this is a boot disk. The instance will use the first partition of the disk for its root file system. The @@ -383,11 +388,6 @@ FLAGS disk will be replicated to the specified replica zone and the zone of the newly created instance. - architecture - Storage resources can be used to create boot disks compatible with - different machine architectures. ARCHITECTURE must be one of: - ARM64, X86_64. - --csek-key-file=FILE Path to a Customer-Supplied Encryption Key (CSEK) key file that maps Compute Engine resources to user managed keys to be used when creating, diff --git a/gcloud/alpha/compute/instances/create-with-container b/gcloud/alpha/compute/instances/create-with-container index 5630adc71..4a7bfc875 100644 --- a/gcloud/alpha/compute/instances/create-with-container +++ b/gcloud/alpha/compute/instances/create-with-container @@ -350,6 +350,11 @@ FLAGS the instance, this option won't apply. The default value for this is yes. + architecture + Specifies the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. + multi-writer If yes, the disk is created in multi-writer mode so that it can be attached with read-write access to two VMs. The default value is diff --git a/gcloud/alpha/compute/security-policies/create b/gcloud/alpha/compute/security-policies/create index 06172e3d2..5ee14b464 100644 --- a/gcloud/alpha/compute/security-policies/create +++ b/gcloud/alpha/compute/security-policies/create @@ -13,6 +13,17 @@ DESCRIPTION security policies. A security policy policy is a set of rules that controls access to various resources. +EXAMPLES + To create a security policy with a given type and description, run: + + $ gcloud alpha compute security-policies create my-policy \ + --type=CLOUD_ARMOR_EDGE --description="policy description" + + To create a security from an input file, run: + + $ gcloud alpha compute security-policies create my-policy \ + --file-name=my-file-name + POSITIONAL ARGUMENTS NAME Name of the security policy to create. diff --git a/gcloud/alpha/compute/security-policies/delete b/gcloud/alpha/compute/security-policies/delete index 8ee94e767..c48d134c1 100644 --- a/gcloud/alpha/compute/security-policies/delete +++ b/gcloud/alpha/compute/security-policies/delete @@ -10,6 +10,11 @@ DESCRIPTION Engine security policies. Security policies can only be deleted when no other resources (e.g., backend services) refer to them. +EXAMPLES + To delete a security policy, run: + + $ gcloud alpha compute security-policies delete my-policy + POSITIONAL ARGUMENTS NAME [NAME ...] Names of the security policies to delete. diff --git a/gcloud/alpha/compute/security-policies/describe b/gcloud/alpha/compute/security-policies/describe index 43c1d614d..c29524ece 100644 --- a/gcloud/alpha/compute/security-policies/describe +++ b/gcloud/alpha/compute/security-policies/describe @@ -10,6 +10,11 @@ DESCRIPTION (ALPHA) gcloud alpha compute security-policies describe displays all data associated with Compute Engine security policy in a project. +EXAMPLES + To describe a security policy, run: + + $ gcloud alpha compute security-policies describe my-policy + POSITIONAL ARGUMENTS NAME Name of the security policy to describe. diff --git a/gcloud/alpha/compute/security-policies/export b/gcloud/alpha/compute/security-policies/export index 85b42ccb2..03934032c 100644 --- a/gcloud/alpha/compute/security-policies/export +++ b/gcloud/alpha/compute/security-policies/export @@ -1,6 +1,6 @@ NAME gcloud alpha compute security-policies export - export security policy - configs into yaml files + configs into YAML or JSON files SYNOPSIS gcloud alpha compute security-policies export NAME --file-name=FILE_NAME @@ -8,7 +8,14 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Export security policy configs into yaml files. + (ALPHA) gcloud alpha compute security-policies export exports all data + associated with Compute Engine security policy into a local file. + +EXAMPLES + To export a security policy in JSON format to a given file, run: + + $ gcloud alpha compute security-policies export my-policy \ + --file-name=my-file-name --file-format=json POSITIONAL ARGUMENTS NAME diff --git a/gcloud/alpha/compute/security-policies/help b/gcloud/alpha/compute/security-policies/help index 5b216b61d..1c4351550 100644 --- a/gcloud/alpha/compute/security-policies/help +++ b/gcloud/alpha/compute/security-policies/help @@ -43,7 +43,7 @@ COMMANDS (ALPHA) Describe a Compute Engine security policy. export - (ALPHA) Export security policy configs into yaml files. + (ALPHA) Export security policy configs into YAML or JSON files. import (ALPHA) Import security policy configs into your project. diff --git a/gcloud/alpha/compute/security-policies/rules/create b/gcloud/alpha/compute/security-policies/rules/create index 98d77f349..a3d2d51fe 100644 --- a/gcloud/alpha/compute/security-policies/rules/create +++ b/gcloud/alpha/compute/security-policies/rules/create @@ -27,14 +27,12 @@ DESCRIPTION (ALPHA) gcloud alpha compute security-policies rules create is used to create security policy rules. - For example to create a rule at priority 1000 to block the IP range - 1.2.3.0/24, run: +EXAMPLES + To create a rule at priority 1000 to block the IP range 1.2.3.0/24, run: $ gcloud alpha compute security-policies rules create 1000 \ - --action deny-403 \ - --security-policy my-policy \ - --description "block 1.2.3.0/24" \ - --src-ip-ranges 1.2.3.0/24 + --action=deny-403 --security-policy=my-policy \ + --description="block 1.2.3.0/24" --src-ip-ranges=1.2.3.0/24 POSITIONAL ARGUMENTS PRIORITY diff --git a/gcloud/alpha/compute/security-policies/rules/delete b/gcloud/alpha/compute/security-policies/rules/delete index 412d5b115..fce3a4885 100644 --- a/gcloud/alpha/compute/security-policies/rules/delete +++ b/gcloud/alpha/compute/security-policies/rules/delete @@ -10,6 +10,12 @@ DESCRIPTION (ALPHA) gcloud alpha compute security-policies rules delete is used to delete security policy rules. +EXAMPLES + To delete the rule at priority 1000, run: + + $ gcloud alpha compute security-policies rules delete 1000 \ + --security-policy=my-policy + POSITIONAL ARGUMENTS [PRIORITY ...] The priority of the rules to delete. Rules are evaluated in order from diff --git a/gcloud/alpha/compute/security-policies/rules/describe b/gcloud/alpha/compute/security-policies/rules/describe index a1d9e8081..a66f9182f 100644 --- a/gcloud/alpha/compute/security-policies/rules/describe +++ b/gcloud/alpha/compute/security-policies/rules/describe @@ -10,6 +10,12 @@ DESCRIPTION (ALPHA) gcloud alpha compute security-policies rules describe displays all data associated with a security policy rule. +EXAMPLES + To describe the rule at priority 1000, run: + + $ gcloud alpha compute security-policies rules describe 1000 \ + --security-policy=my-policy + POSITIONAL ARGUMENTS PRIORITY The priority of the rule to describe. Rules are evaluated in order from diff --git a/gcloud/alpha/compute/security-policies/rules/update b/gcloud/alpha/compute/security-policies/rules/update index ca22fe6ef..d536fa7c3 100644 --- a/gcloud/alpha/compute/security-policies/rules/update +++ b/gcloud/alpha/compute/security-policies/rules/update @@ -27,13 +27,12 @@ DESCRIPTION (ALPHA) gcloud alpha compute security-policies rules update is used to update security policy rules. - For example to update the description and IP ranges of a rule at priority - 1000, run: +EXAMPLES + To update the description and IP ranges of a rule at priority 1000, run: $ gcloud alpha compute security-policies rules update 1000 \ - --security-policy my-policy \ - --description "block 1.2.3.4/32" \ - --src-ip-ranges 1.2.3.4/32 + --security-policy=my-policy --description="block 1.2.3.4/32" \ + --src-ip-ranges=1.2.3.4/32 POSITIONAL ARGUMENTS PRIORITY diff --git a/gcloud/alpha/container/binauthz/policy/export-system-policy b/gcloud/alpha/container/binauthz/policy/export-system-policy index dbf8fc1c3..ffad78d65 100644 --- a/gcloud/alpha/container/binauthz/policy/export-system-policy +++ b/gcloud/alpha/container/binauthz/policy/export-system-policy @@ -31,11 +31,15 @@ FLAGS --location=LOCATION; default="global" The region for which to get the system policy (or "global"). LOCATION must be one of: global, asia-east1, asia-east2, asia-northeast1, - asia-northeast2, asia-northeast3, asia-south1, asia-southeast1, - asia-southeast2, australia-southeast1, europe-north1, europe-west1, - europe-west2, europe-west3, europe-west4, europe-west5, europe-west6, - northamerica-northeast1, southamerica-east1, us-central1, us-east1, - us-east4, us-west1, us-west2, us-west3, us-west4. + asia-northeast2, asia-northeast3, asia-south1, asia-south2, + asia-southeast1, asia-southeast2, australia-southeast1, + australia-southeast2, europe-central2, europe-north1, + europe-southwest1, europe-west1, europe-west12, europe-west2, + europe-west3, europe-west4, europe-west5, europe-west6, europe-west8, + europe-west9, me-central1, me-west1, northamerica-northeast1, + northamerica-northeast2, southamerica-east1, southamerica-west1, + us-central1, us-central2, us-east1, us-east4, us-east5, us-east7, + us-south1, us-west1, us-west2, us-west3, us-west4. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/deploy/releases/create b/gcloud/alpha/deploy/releases/create index 18618ebbc..99716afe9 100644 --- a/gcloud/alpha/deploy/releases/create +++ b/gcloud/alpha/deploy/releases/create @@ -169,17 +169,28 @@ FLAGS after the release is complete. --skaffold-file=SKAFFOLD_FILE - Path of the skaffold file relative to the source directory. + Path of the skaffold file absolute or relative to the source + directory. Examples: - Use Skaffold file: + Use Skaffold file with relative path: The current working directory + is expected to be some part of the skaffold path (e.g. the current + working directory could be /home/user) $ gcloud alpha deploy releases create --source=/home/user/source \ --skaffold-file=config/skaffold.yaml - The skaffold file absolute file path is expected to be: - /home/user/source/config/skaffold.yaml + The skaffold file absolute file path is expected to be: + /home/user/source/config/skaffold.yaml + + Use Skaffold file with absolute path and with or without source argument: + + $ gcloud alpha deploy releases create --source=/home/user/source \ + --skaffold-file=/home/user/source/config/skaffold.yaml + + $ gcloud alpha deploy releases create \ + --skaffold-file=/home/user/source/config/skaffold.yaml --source=SOURCE; default="." The location of the source that contains skaffold.yaml. The location diff --git a/gcloud/alpha/firebase/test/android/help b/gcloud/alpha/firebase/test/android/help index 755b570aa..42e480f79 100644 --- a/gcloud/alpha/firebase/test/android/help +++ b/gcloud/alpha/firebase/test/android/help @@ -64,6 +64,10 @@ GROUPS COMMANDS COMMAND is one of the following: + list-device-capacities + (ALPHA) List capacity information for all supported Android models & + versions. + run (ALPHA) Invoke a test in Firebase Test Lab for Android and view test results. diff --git a/gcloud/alpha/firebase/test/android/list-device-capacities b/gcloud/alpha/firebase/test/android/list-device-capacities new file mode 100644 index 000000000..4d0e87949 --- /dev/null +++ b/gcloud/alpha/firebase/test/android/list-device-capacities @@ -0,0 +1,74 @@ +NAME + gcloud alpha firebase test android list-device-capacities - list capacity + information for all supported Android models & versions + +SYNOPSIS + gcloud alpha firebase test android list-device-capacities + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List device capacity (high/medium/low/none) for all Android models + & versions. + + Device capacity is static information solely based on the number of devices + in Firebase Test Lab. It's important to note that device capacity does not + directly reflect any real-time data, like the length of the test queue, + traffic, or the available/busy/broken state of the devices. + +EXAMPLES + To list capacity information for all devices which are available for + testing, run: + + $ gcloud alpha firebase test android list-device-capacities + + To list only models made by Samsung, run: + + $ gcloud alpha firebase test android list-device-capacities \ + --filter=Samsung + + To list only physical device models, run: + + $ gcloud alpha firebase test android list-device-capacities \ + --filter=physical + +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 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/firebase/test/android/run b/gcloud/alpha/firebase/test/android/run index a24fce4a4..5f52e7537 100644 --- a/gcloud/alpha/firebase/test/android/run +++ b/gcloud/alpha/firebase/test/android/run @@ -367,7 +367,7 @@ FLAGS is no greater than the total number of test cases. When you select one or more physical devices, the number of shards specified must be <= 50. When you select one or more ARM virtual devices, the number of - shards specified must be <= 100. When you select only x86 virtual + shards specified must be <= 50. When you select only x86 virtual devices, the number of shards specified must be <= 500. --test-targets-for-shard=TEST_TARGETS_FOR_SHARD @@ -375,7 +375,7 @@ FLAGS each shard (a group of test cases). Each time this flag is repeated, it creates a new shard. The shards are run in parallel on separate devices. You can repeat this flag up to 50 times when you select one - or more physical devices, up to 100 times when you select one or more + or more physical devices, up to 50 times when you select one or more ARM virtual devices, and up to 500 times when you select only x86 virtual devices. diff --git a/gcloud/alpha/firebase/test/ios/help b/gcloud/alpha/firebase/test/ios/help index 44f3ad475..601a0eab6 100644 --- a/gcloud/alpha/firebase/test/ios/help +++ b/gcloud/alpha/firebase/test/ios/help @@ -51,6 +51,10 @@ GROUPS COMMANDS COMMAND is one of the following: + list-device-capacities + (ALPHA) List capacity information for all supported iOS models & + versions. + run (ALPHA) Invoke a test in Firebase Test Lab for iOS and view test results. diff --git a/gcloud/alpha/firebase/test/ios/list-device-capacities b/gcloud/alpha/firebase/test/ios/list-device-capacities new file mode 100644 index 000000000..7cc694b50 --- /dev/null +++ b/gcloud/alpha/firebase/test/ios/list-device-capacities @@ -0,0 +1,72 @@ +NAME + gcloud alpha firebase test ios list-device-capacities - list capacity + information for all supported iOS models & versions + +SYNOPSIS + gcloud alpha firebase test ios list-device-capacities [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List device capacity (high/medium/low/none) for all iOS models & + versions. + + Device capacity is static information solely based on the number of devices + in Firebase Test Lab. It's important to note that device capacity does not + directly reflect any real-time data, like the length of the test queue, + traffic, or the available/busy/broken state of the devices. + +EXAMPLES + To list capacity information for all devices which are available for + testing, run: + + $ gcloud alpha firebase test ios list-device-capacities + + To list capacity for only ipad devices, run: + + $ gcloud alpha firebase test ios list-device-capacities --filter=ipad + + To list capacity for only iOS version 14.2 devices, run: + + $ gcloud alpha firebase test ios list-device-capacities --filter=14.2 + +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 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/iam/workload-identity-pools/create-cred-config b/gcloud/alpha/iam/workload-identity-pools/create-cred-config index e7be8d626..10b187af5 100644 --- a/gcloud/alpha/iam/workload-identity-pools/create-cred-config +++ b/gcloud/alpha/iam/workload-identity-pools/create-cred-config @@ -119,7 +119,8 @@ OPTIONAL FLAGS enforce the AWS IMDSv2 flow. --subject-token-type=SUBJECT_TOKEN_TYPE - The type of token being used for authorization. + The type of token being used for authorization. This defaults to + urn:ietf:params:oauth:token-type:jwt. Arguments for an executable type credential source. diff --git a/gcloud/alpha/network-services/gateways/delete b/gcloud/alpha/network-services/gateways/delete index e064e026a..c340359ac 100644 --- a/gcloud/alpha/network-services/gateways/delete +++ b/gcloud/alpha/network-services/gateways/delete @@ -8,6 +8,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Delete the specified Network Services gateway. +EXAMPLES + To delete a gateway named 'my-gateway', run: + + $ gcloud alpha network-services gateways delete my-gateway \ + --location=global + POSITIONAL ARGUMENTS Gateway resource - Name of the gateway you want to delete. The arguments in this group can be used to specify the attributes of this resource. @@ -57,5 +63,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services gateways delete diff --git a/gcloud/alpha/network-services/gateways/describe b/gcloud/alpha/network-services/gateways/describe index 2bbe30f6e..0d46c61c1 100644 --- a/gcloud/alpha/network-services/gateways/describe +++ b/gcloud/alpha/network-services/gateways/describe @@ -58,5 +58,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services gateways describe diff --git a/gcloud/alpha/network-services/gateways/export b/gcloud/alpha/network-services/gateways/export index f4ab8377e..d90a1cc36 100644 --- a/gcloud/alpha/network-services/gateways/export +++ b/gcloud/alpha/network-services/gateways/export @@ -10,6 +10,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Export the configuration for a Network Services gateway. +EXAMPLES + To export a gateway named 'my-gateway' to a YAML file, run: + + $ gcloud alpha network-services gateways export my-gateway \ + --destination=my-gateway.yaml --location=global + POSITIONAL ARGUMENTS Gateway resource - Name of the gateway to export. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -62,5 +68,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services gateways export diff --git a/gcloud/alpha/network-services/gateways/help b/gcloud/alpha/network-services/gateways/help index 17360bd02..825f61602 100644 --- a/gcloud/alpha/network-services/gateways/help +++ b/gcloud/alpha/network-services/gateways/help @@ -34,5 +34,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services gateways diff --git a/gcloud/alpha/network-services/gateways/import b/gcloud/alpha/network-services/gateways/import index eb84020e5..3f7001a7e 100644 --- a/gcloud/alpha/network-services/gateways/import +++ b/gcloud/alpha/network-services/gateways/import @@ -10,6 +10,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Import the configuration for a Network Services gateway. +EXAMPLES + To import a gateway named 'my-gateway' from a YAML file, run: + + $ gcloud alpha network-services gateways import my-gateway \ + --source=my-gateway.yaml --location=global + POSITIONAL ARGUMENTS Gateway resource - Name of the gateway to import. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -69,5 +75,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services gateways import diff --git a/gcloud/alpha/network-services/gateways/list b/gcloud/alpha/network-services/gateways/list index ca30a21ae..393df065a 100644 --- a/gcloud/alpha/network-services/gateways/list +++ b/gcloud/alpha/network-services/gateways/list @@ -10,6 +10,11 @@ DESCRIPTION (ALPHA) List all Network Services gateways in the specified location of the current project. +EXAMPLES + To list gateways in the current project, run: + + $ gcloud alpha network-services gateways list --location=global + REQUIRED FLAGS Location resource - The project of the gateways to display. This represents a Cloud resource. (NOTE) Some attributes are not given @@ -75,5 +80,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services gateways list diff --git a/gcloud/alpha/network-services/grpc-routes/delete b/gcloud/alpha/network-services/grpc-routes/delete index 0d34a2409..5338d2d76 100644 --- a/gcloud/alpha/network-services/grpc-routes/delete +++ b/gcloud/alpha/network-services/grpc-routes/delete @@ -8,6 +8,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Delete the specified grpc route. +EXAMPLES + To delete a grpc route named 'my-grpc-route', run: + + $ gcloud alpha network-services grpc-routes delete my-grpc-route \ + --location=global + POSITIONAL ARGUMENTS Grpc route resource - Name of the grpc route you want to delete. The arguments in this group can be used to specify the attributes of this @@ -57,5 +63,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services grpc-routes delete diff --git a/gcloud/alpha/network-services/grpc-routes/describe b/gcloud/alpha/network-services/grpc-routes/describe index aef6d1a77..566e3cbc4 100644 --- a/gcloud/alpha/network-services/grpc-routes/describe +++ b/gcloud/alpha/network-services/grpc-routes/describe @@ -58,5 +58,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services grpc-routes describe diff --git a/gcloud/alpha/network-services/grpc-routes/export b/gcloud/alpha/network-services/grpc-routes/export index 8e0777ddd..00ba2fc46 100644 --- a/gcloud/alpha/network-services/grpc-routes/export +++ b/gcloud/alpha/network-services/grpc-routes/export @@ -9,6 +9,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Export a grpc route. +EXAMPLES + To export a grpc route named 'my-grpc-route' to a YAML file, run: + + $ gcloud alpha network-services grpc-routes export my-grpc-route \ + --destination=my-grpc-route.yaml --location=global + POSITIONAL ARGUMENTS Grpc route resource - Name of the grpc route to export. The arguments in this group can be used to specify the attributes of this resource. (NOTE) @@ -61,5 +67,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services grpc-routes export diff --git a/gcloud/alpha/network-services/grpc-routes/help b/gcloud/alpha/network-services/grpc-routes/help index 97f80ff13..afa754729 100644 --- a/gcloud/alpha/network-services/grpc-routes/help +++ b/gcloud/alpha/network-services/grpc-routes/help @@ -35,5 +35,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services grpc-routes diff --git a/gcloud/alpha/network-services/grpc-routes/import b/gcloud/alpha/network-services/grpc-routes/import index 623614a75..87332111b 100644 --- a/gcloud/alpha/network-services/grpc-routes/import +++ b/gcloud/alpha/network-services/grpc-routes/import @@ -9,6 +9,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Import a grpc route. +EXAMPLES + To import a grpc route named 'my-grpc-route' from a YAML file, run: + + $ gcloud alpha network-services grpc-routes import my-grpc-route \ + --source=my-grpc-route.yaml --location=global + POSITIONAL ARGUMENTS Grpc route resource - Name of the grpc route to import. The arguments in this group can be used to specify the attributes of this resource. (NOTE) @@ -68,5 +74,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services grpc-routes import diff --git a/gcloud/alpha/network-services/grpc-routes/list b/gcloud/alpha/network-services/grpc-routes/list index 55f1c3812..3025861fe 100644 --- a/gcloud/alpha/network-services/grpc-routes/list +++ b/gcloud/alpha/network-services/grpc-routes/list @@ -10,6 +10,11 @@ DESCRIPTION (ALPHA) List all grpc routes in the specified location of the current project. +EXAMPLES + To list grpc routes in the current project, run: + + $ gcloud alpha network-services grpc-routes list --location=global + REQUIRED FLAGS Location resource - The project of the grpc routes to display. This represents a Cloud resource. (NOTE) Some attributes are not given @@ -75,5 +80,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services grpc-routes list diff --git a/gcloud/alpha/network-services/http-routes/delete b/gcloud/alpha/network-services/http-routes/delete index d382b0624..68af9e86b 100644 --- a/gcloud/alpha/network-services/http-routes/delete +++ b/gcloud/alpha/network-services/http-routes/delete @@ -8,6 +8,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Delete the specified http route. +EXAMPLES + To delete a route named 'my-route', run: + + $ gcloud alpha network-services http-routes delete my-route \ + --location=global + POSITIONAL ARGUMENTS Http route resource - Name of the http route you want to delete. The arguments in this group can be used to specify the attributes of this @@ -57,5 +63,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services http-routes delete diff --git a/gcloud/alpha/network-services/http-routes/describe b/gcloud/alpha/network-services/http-routes/describe index bc32311af..f21861987 100644 --- a/gcloud/alpha/network-services/http-routes/describe +++ b/gcloud/alpha/network-services/http-routes/describe @@ -58,5 +58,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services http-routes describe diff --git a/gcloud/alpha/network-services/http-routes/export b/gcloud/alpha/network-services/http-routes/export index 962e860fa..4ace2a1d1 100644 --- a/gcloud/alpha/network-services/http-routes/export +++ b/gcloud/alpha/network-services/http-routes/export @@ -9,6 +9,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Export a http route. +EXAMPLES + To export a route named 'my-route' to a YAML file, run: + + $ gcloud alpha network-services http-routes export my-route \ + --destination=my-route.yaml --location=global + POSITIONAL ARGUMENTS Http route resource - Name of the http route to export. The arguments in this group can be used to specify the attributes of this resource. (NOTE) @@ -61,5 +67,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services http-routes export diff --git a/gcloud/alpha/network-services/http-routes/help b/gcloud/alpha/network-services/http-routes/help index 93456c4e4..43a07d316 100644 --- a/gcloud/alpha/network-services/http-routes/help +++ b/gcloud/alpha/network-services/http-routes/help @@ -35,5 +35,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services http-routes diff --git a/gcloud/alpha/network-services/http-routes/import b/gcloud/alpha/network-services/http-routes/import index 053716ca5..296ff8adb 100644 --- a/gcloud/alpha/network-services/http-routes/import +++ b/gcloud/alpha/network-services/http-routes/import @@ -9,6 +9,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Import a http route. +EXAMPLES + To import a route named 'my-route' from a YAML file, run: + + $ gcloud alpha network-services http-routes import my-route \ + --source=my-route.yaml --location=global + POSITIONAL ARGUMENTS Http route resource - Name of the http route to import. The arguments in this group can be used to specify the attributes of this resource. (NOTE) @@ -68,5 +74,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services http-routes import diff --git a/gcloud/alpha/network-services/http-routes/list b/gcloud/alpha/network-services/http-routes/list index ecf44c638..65985e26f 100644 --- a/gcloud/alpha/network-services/http-routes/list +++ b/gcloud/alpha/network-services/http-routes/list @@ -10,6 +10,11 @@ DESCRIPTION (ALPHA) List all http routes in the specified location of the current project. +EXAMPLES + To list meshes in the current project, run: + + $ gcloud alpha network-services http-routes list --location=global + REQUIRED FLAGS Location resource - The project of the http routes to display. This represents a Cloud resource. (NOTE) Some attributes are not given @@ -75,5 +80,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services http-routes list diff --git a/gcloud/alpha/network-services/meshes/delete b/gcloud/alpha/network-services/meshes/delete index 0a20d0611..b8e85d860 100644 --- a/gcloud/alpha/network-services/meshes/delete +++ b/gcloud/alpha/network-services/meshes/delete @@ -1,5 +1,5 @@ NAME - gcloud alpha network-services meshes delete - delete mesh + gcloud alpha network-services meshes delete - delete a mesh SYNOPSIS gcloud alpha network-services meshes delete (MESH : --location=LOCATION) @@ -8,6 +8,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Delete the specified mesh. +EXAMPLES + To delete a mesh named 'my-mesh', run: + + $ gcloud alpha network-services meshes delete my-mesh \ + --location=global + POSITIONAL ARGUMENTS Mesh resource - Name of the mesh you want to delete. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -57,5 +63,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services meshes delete diff --git a/gcloud/alpha/network-services/meshes/describe b/gcloud/alpha/network-services/meshes/describe index 242511ebe..afb8c8404 100644 --- a/gcloud/alpha/network-services/meshes/describe +++ b/gcloud/alpha/network-services/meshes/describe @@ -58,5 +58,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services meshes describe diff --git a/gcloud/alpha/network-services/meshes/export b/gcloud/alpha/network-services/meshes/export index 19a5bb8ab..8779f5f3c 100644 --- a/gcloud/alpha/network-services/meshes/export +++ b/gcloud/alpha/network-services/meshes/export @@ -1,5 +1,5 @@ NAME - gcloud alpha network-services meshes export - export mesh + gcloud alpha network-services meshes export - export a mesh SYNOPSIS gcloud alpha network-services meshes export (MESH : --location=LOCATION) @@ -8,6 +8,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Export a mesh. +EXAMPLES + To export a mesh named 'my-mesh' to a YAML file, run: + + $ gcloud alpha network-services meshes export my-mesh \ + --destination=my-mesh.yaml --location=global + POSITIONAL ARGUMENTS Mesh resource - Name of the mesh to export. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -60,5 +66,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services meshes export diff --git a/gcloud/alpha/network-services/meshes/help b/gcloud/alpha/network-services/meshes/help index 94d30a6c9..a29602ccc 100644 --- a/gcloud/alpha/network-services/meshes/help +++ b/gcloud/alpha/network-services/meshes/help @@ -16,16 +16,16 @@ COMMANDS COMMAND is one of the following: delete - (ALPHA) Delete mesh. + (ALPHA) Delete a mesh. describe (ALPHA) Describe a mesh. export - (ALPHA) Export mesh. + (ALPHA) Export a mesh. import - (ALPHA) Import mesh. + (ALPHA) Import a mesh. list (ALPHA) List meshes. @@ -34,5 +34,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services meshes diff --git a/gcloud/alpha/network-services/meshes/import b/gcloud/alpha/network-services/meshes/import index 6052aa49b..661edf5ee 100644 --- a/gcloud/alpha/network-services/meshes/import +++ b/gcloud/alpha/network-services/meshes/import @@ -1,5 +1,5 @@ NAME - gcloud alpha network-services meshes import - import mesh + gcloud alpha network-services meshes import - import a mesh SYNOPSIS gcloud alpha network-services meshes import (MESH : --location=LOCATION) @@ -8,6 +8,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Import a mesh. +EXAMPLES + To import a mesh named 'my-mesh' from a YAML file, run: + + $ gcloud alpha network-services meshes import my-mesh \ + --source=my-mesh.yaml --location=global + POSITIONAL ARGUMENTS Mesh resource - Name of the mesh to import. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -67,5 +73,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services meshes import diff --git a/gcloud/alpha/network-services/meshes/list b/gcloud/alpha/network-services/meshes/list index 7766fbd5d..60de7e12d 100644 --- a/gcloud/alpha/network-services/meshes/list +++ b/gcloud/alpha/network-services/meshes/list @@ -9,6 +9,11 @@ SYNOPSIS DESCRIPTION (ALPHA) List all meshes in the specified location of the current project. +EXAMPLES + To list meshes in the current project, run: + + $ gcloud alpha network-services meshes list --location=global + REQUIRED FLAGS Location resource - The project of the meshes to display. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this @@ -73,5 +78,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services meshes list diff --git a/gcloud/alpha/network-services/tcp-routes/delete b/gcloud/alpha/network-services/tcp-routes/delete index 4b4fee1ae..f85cecebe 100644 --- a/gcloud/alpha/network-services/tcp-routes/delete +++ b/gcloud/alpha/network-services/tcp-routes/delete @@ -8,6 +8,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Delete the specified tcp route. +EXAMPLES + To delete a tcp route named 'my-tcp-route', run: + + $ gcloud alpha network-services tcp-routes delete my-tcp-route \ + --location=global + POSITIONAL ARGUMENTS Tcp route resource - Name of the tcp route you want to delete. The arguments in this group can be used to specify the attributes of this @@ -57,5 +63,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services tcp-routes delete diff --git a/gcloud/alpha/network-services/tcp-routes/describe b/gcloud/alpha/network-services/tcp-routes/describe index d9e2b813b..78f7f33d0 100644 --- a/gcloud/alpha/network-services/tcp-routes/describe +++ b/gcloud/alpha/network-services/tcp-routes/describe @@ -58,5 +58,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services tcp-routes describe diff --git a/gcloud/alpha/network-services/tcp-routes/export b/gcloud/alpha/network-services/tcp-routes/export index 049ebd377..316597069 100644 --- a/gcloud/alpha/network-services/tcp-routes/export +++ b/gcloud/alpha/network-services/tcp-routes/export @@ -9,6 +9,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Export a tcp route. +EXAMPLES + To export a tcp route named 'my-tcp-route' to a YAML file, run: + + $ gcloud alpha network-services tcp-routes export my-tcp-route \ + --destination=my-tcp-route.yaml --location=global + POSITIONAL ARGUMENTS Tcp route resource - Name of the tcp route to export. The arguments in this group can be used to specify the attributes of this resource. (NOTE) @@ -61,5 +67,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services tcp-routes export diff --git a/gcloud/alpha/network-services/tcp-routes/help b/gcloud/alpha/network-services/tcp-routes/help index 04e534876..ab197a50b 100644 --- a/gcloud/alpha/network-services/tcp-routes/help +++ b/gcloud/alpha/network-services/tcp-routes/help @@ -35,5 +35,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services tcp-routes diff --git a/gcloud/alpha/network-services/tcp-routes/import b/gcloud/alpha/network-services/tcp-routes/import index 562499bff..f20020411 100644 --- a/gcloud/alpha/network-services/tcp-routes/import +++ b/gcloud/alpha/network-services/tcp-routes/import @@ -9,6 +9,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Import a tcp route. +EXAMPLES + To import a tcp route named 'my-tcp-route' from a YAML file, run: + + $ gcloud alpha network-services tcp-routes import my-tcp-route \ + --source=my-tcp-route.yaml --location=global + POSITIONAL ARGUMENTS Tcp route resource - Name of the tcp route to import. The arguments in this group can be used to specify the attributes of this resource. (NOTE) @@ -68,5 +74,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services tcp-routes import diff --git a/gcloud/alpha/network-services/tcp-routes/list b/gcloud/alpha/network-services/tcp-routes/list index 2f36e67a5..edfce9d6e 100644 --- a/gcloud/alpha/network-services/tcp-routes/list +++ b/gcloud/alpha/network-services/tcp-routes/list @@ -10,6 +10,11 @@ DESCRIPTION (ALPHA) List all tcp routes in the specified location of the current project. +EXAMPLES + To list tcp routes in the current project, run: + + $ gcloud alpha network-services tcp-routes list --location=global + REQUIRED FLAGS Location resource - The project of the tcp routes to display. This represents a Cloud resource. (NOTE) Some attributes are not given @@ -75,5 +80,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services tcp-routes list diff --git a/gcloud/alpha/spanner/instances/create b/gcloud/alpha/spanner/instances/create index 334087e1c..65f127014 100644 --- a/gcloud/alpha/spanner/instances/create +++ b/gcloud/alpha/spanner/instances/create @@ -3,8 +3,9 @@ NAME SYNOPSIS gcloud alpha spanner instances create INSTANCE --config=CONFIG - --description=DESCRIPTION - (--nodes=NODES | --processing-units=PROCESSING_UNITS) [--async] + --description=DESCRIPTION [--async] [--expire-behavior=EXPIRE_BEHAVIOR] + [--instance-type=INSTANCE_TYPE] + [--nodes=NODES | --processing-units=PROCESSING_UNITS] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -30,7 +31,33 @@ REQUIRED FLAGS --description=DESCRIPTION Description of the instance. - Exactly one of these must be specified: +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --expire-behavior=EXPIRE_BEHAVIOR + The expire behavior of a free instance. EXPIRE_BEHAVIOR must be one of: + + free-to-provisioned + When the free instance expires, upgrade the instance to a + provisioned instance + remove-after-grace-period + When the free instance expires, disable the instance, and delete it + after the grace period passes if it has not been upgraded. + + --instance-type=INSTANCE_TYPE + The type of this instance. INSTANCE_TYPE must be one of: + + free-instance + Free instances provide no guarantee for dedicated resources, + [node_count, processing_units] should be 0. They come with stricter + usage limits and limited support. + provisioned + Provisioned instances have dedicated resources, standard usage + limits and support + + At most one of these can be specified: --nodes=NODES Number of nodes for the instance. @@ -38,11 +65,6 @@ REQUIRED FLAGS --processing-units=PROCESSING_UNITS Number of processing units for the instance. -OPTIONAL FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/spanner/instances/update b/gcloud/alpha/spanner/instances/update index 785170ac0..fe20dac5d 100644 --- a/gcloud/alpha/spanner/instances/update +++ b/gcloud/alpha/spanner/instances/update @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud alpha spanner instances update INSTANCE [--async] - [--description=DESCRIPTION] + [--description=DESCRIPTION] [--expire-behavior=EXPIRE_BEHAVIOR] + [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS] [GCLOUD_WIDE_FLAG ...] @@ -32,6 +33,27 @@ FLAGS --description=DESCRIPTION Description of the instance. + --expire-behavior=EXPIRE_BEHAVIOR + The expire behavior of a free instance. EXPIRE_BEHAVIOR must be one of: + + free-to-provisioned + When the free instance expires, upgrade the instance to a + provisioned instance + remove-after-grace-period + When the free instance expires, disable the instance, and delete it + after the grace period passes if it has not been upgraded. + + --instance-type=INSTANCE_TYPE + The type of this instance. INSTANCE_TYPE must be one of: + + free-instance + Free instances provide no guarantee for dedicated resources, + [node_count, processing_units] should be 0. They come with stricter + usage limits and limited support. + provisioned + Provisioned instances have dedicated resources, standard usage + limits and support + At most one of these can be specified: --nodes=NODES diff --git a/gcloud/alpha/sql/instances/create b/gcloud/alpha/sql/instances/create index cecf24516..891b20bf3 100644 --- a/gcloud/alpha/sql/instances/create +++ b/gcloud/alpha/sql/instances/create @@ -15,6 +15,7 @@ SYNOPSIS [--backup-start-time=BACKUP_START_TIME] [--collation=COLLATION] [--cpu=CPU] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] [--database-version=DATABASE_VERSION; default="MYSQL_8_0"] + [--[no-]deletion-protection] [--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] @@ -183,6 +184,12 @@ FLAGS is used. See the list of database versions at https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion. + --[no-]deletion-protection + Enable deletion protection on a Cloud SQL instance. Use + --deletion-protection to enable deletion protection on an instance and + --no-deletion-protection to disable it. Use --deletion-protection to + enable and --no-deletion-protection to disable. + --deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE Date when the deny maintenance period ends, that is 2021-01-10. diff --git a/gcloud/alpha/sql/instances/patch b/gcloud/alpha/sql/instances/patch index ee9481fe4..5edfb143e 100644 --- a/gcloud/alpha/sql/instances/patch +++ b/gcloud/alpha/sql/instances/patch @@ -12,6 +12,7 @@ SYNOPSIS [--audit-upload-interval=AUDIT_UPLOAD_INTERVAL] [--availability-type=AVAILABILITY_TYPE] [--clear-password-policy] [--cpu=CPU] [--database-version=DATABASE_VERSION] + [--[no-]deletion-protection] [--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] [--diff] @@ -125,6 +126,12 @@ FLAGS occur. See the list of database versions at https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion. + --[no-]deletion-protection + Enable deletion protection on a Cloud SQL instance. Use + --deletion-protection to enable deletion protection on an instance and + --no-deletion-protection to disable it. Use --deletion-protection to + enable and --no-deletion-protection to disable. + --deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE Date when the deny maintenance period ends, that is 2021-01-10. diff --git a/gcloud/alpha/storage/cat b/gcloud/alpha/storage/cat index 32ed76a70..030c41ef7 100644 --- a/gcloud/alpha/storage/cat +++ b/gcloud/alpha/storage/cat @@ -3,7 +3,8 @@ NAME stdout SYNOPSIS - gcloud alpha storage cat URL [URL ...] [--display-url, -d] + gcloud alpha storage cat URL [URL ...] + [--decryption-keys=[DECRYPTION_KEY,...]] [--display-url, -d] [--range=RANGE, -r RANGE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -38,6 +39,13 @@ POSITIONAL ARGUMENTS The url of objects to list. FLAGS + --decryption-keys=[DECRYPTION_KEY,...] + A comma separated list of customer-supplied encryption keys (RFC 4648 + section 4 base64-encoded AES256 strings) that will be used to decrypt + Google Cloud Storage objects. Data encrypted with a customer-managed + encryption key (CMEK) is decrypted automatically, so CMEKs do not need + to be listed here. + --display-url, -d Prints the header before each object. diff --git a/gcloud/alpha/storage/cp b/gcloud/alpha/storage/cp index d32a6b8ea..7b090eb4a 100644 --- a/gcloud/alpha/storage/cp +++ b/gcloud/alpha/storage/cp @@ -8,8 +8,9 @@ SYNOPSIS [--content-encoding=CONTENT_ENCODING] [--content-language=CONTENT_LANGUAGE] [--content-md5=MD5_DIGEST] [--content-type=CONTENT_TYPE] [--continue-on-error, -c] - [--custom-time=CUSTOM_TIME] [--daisy-chain, -D] [--do-not-decompress] - [--if-generation-match=GENERATION] + [--custom-time=CUSTOM_TIME] [--daisy-chain, -D] + [--decryption-keys=[DECRYPTION_KEY,...]] [--do-not-decompress] + [--encryption-key=ENCRYPTION_KEY] [--if-generation-match=GENERATION] [--if-metageneration-match=METAGENERATION] [--ignore-symlinks] [--manifest-path=MANIFEST_PATH, -L MANIFEST_PATH] [--preserve-posix, -P] [--print-created-message, -v] @@ -114,9 +115,27 @@ FLAGS composite object into a non-composite object. Note: Daisy chain mode is automatically used when copying between providers. + --decryption-keys=[DECRYPTION_KEY,...] + A comma separated list of customer-supplied encryption keys (RFC 4648 + section 4 base64-encoded AES256 strings) that will be used to decrypt + Google Cloud Storage objects. Data encrypted with a customer-managed + encryption key (CMEK) is decrypted automatically, so CMEKs do not need + to be listed here. + --do-not-decompress Do not automatically decompress downloaded gzip files. + --encryption-key=ENCRYPTION_KEY + The encryption key to use for encrypting target objects. The specified + encryption key can be a customer-supplied encryption key (An RFC 4648 + section 4 base64-encoded AES256 string), or a customer-managed + encryption key of the form + projects/{project}/locations/{location}/keyRings/ + {key-ring}/cryptoKeys/{crypto-key}. The specified key also acts as a + decryption key, which is useful when copying or moving encryted data to + a new location. Using this flag in an objects update command triggers a + rewrite of target objects. + --if-generation-match=GENERATION Execute only if the generation matches the generation of the requested object. diff --git a/gcloud/alpha/storage/ls b/gcloud/alpha/storage/ls index 434e9452f..9edf38de8 100644 --- a/gcloud/alpha/storage/ls +++ b/gcloud/alpha/storage/ls @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud alpha storage ls [PATH ...] [--all-versions, -a] [--buckets, -b] - [--etag, -e] [--format=FORMAT] [--readable-sizes] [--recursive, -R, -r] + [--decryption-keys=[DECRYPTION_KEY,...]] [--etag, -e] [--format=FORMAT] + [--readable-sizes] [--recursive, -R, -r] [--full, -L | --json, -j | --long, -l] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -80,6 +81,13 @@ FLAGS Typically used in combination with --full to get the full metadata of buckets. + --decryption-keys=[DECRYPTION_KEY,...] + A comma separated list of customer-supplied encryption keys (RFC 4648 + section 4 base64-encoded AES256 strings) that will be used to decrypt + Google Cloud Storage objects. Data encrypted with a customer-managed + encryption key (CMEK) is decrypted automatically, so CMEKs do not need + to be listed here. + --etag, -e Include ETag metadata in listings that use the --long flag. diff --git a/gcloud/alpha/storage/objects/describe b/gcloud/alpha/storage/objects/describe index 125b7f76d..83dcebddc 100644 --- a/gcloud/alpha/storage/objects/describe +++ b/gcloud/alpha/storage/objects/describe @@ -3,8 +3,7 @@ NAME SYNOPSIS gcloud alpha storage objects describe URL - [--decryption-keys=[DECRYPTION_KEY,...]] - [--encryption-key=ENCRYPTION_KEY] [GCLOUD_WIDE_FLAG ...] + [--decryption-keys=[DECRYPTION_KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Describe a Cloud Storage object. @@ -32,17 +31,6 @@ FLAGS encryption key (CMEK) is decrypted automatically, so CMEKs do not need to be listed here. - --encryption-key=ENCRYPTION_KEY - The encryption key to use for encrypting target objects. The specified - encryption key can be a customer-supplied encryption key (An RFC 4648 - section 4 base64-encoded AES256 string), or a customer-managed - encryption key of the form - projects/{project}/locations/{location}/keyRings/ - {key-ring}/cryptoKeys/{crypto-key}. The specified key also acts as a - decryption key, which is useful when copying or moving encryted data to - a new location. Using this flag in an objects update command triggers a - rewrite of target objects. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/storage/objects/list b/gcloud/alpha/storage/objects/list index 26a39bbff..d64fad7a7 100644 --- a/gcloud/alpha/storage/objects/list +++ b/gcloud/alpha/storage/objects/list @@ -3,9 +3,8 @@ NAME SYNOPSIS gcloud alpha storage objects list URLS [URLS ...] - [--decryption-keys=[DECRYPTION_KEY,...]] - [--encryption-key=ENCRYPTION_KEY] [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [--decryption-keys=[DECRYPTION_KEY,...]] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -41,17 +40,6 @@ FLAGS encryption key (CMEK) is decrypted automatically, so CMEKs do not need to be listed here. - --encryption-key=ENCRYPTION_KEY - The encryption key to use for encrypting target objects. The specified - encryption key can be a customer-supplied encryption key (An RFC 4648 - section 4 base64-encoded AES256 string), or a customer-managed - encryption key of the form - projects/{project}/locations/{location}/keyRings/ - {key-ring}/cryptoKeys/{crypto-key}. The specified key also acts as a - decryption key, which is useful when copying or moving encryted data to - a new location. Using this flag in an objects update command triggers a - rewrite of target objects. - LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/artifacts/docker/images/describe b/gcloud/artifacts/docker/images/describe index 1a91eaf31..187b5e90b 100644 --- a/gcloud/artifacts/docker/images/describe +++ b/gcloud/artifacts/docker/images/describe @@ -50,7 +50,8 @@ FLAGS reference. --show-all-metadata - Include all metadata in the output. + Include all metadata in the output. Metadata will be grouped by Grafeas + kind, with an additional section for intoto provenance metadata. --show-build-details Include build metadata in the output. @@ -65,7 +66,9 @@ FLAGS Include vulnerability metadata in the output. --show-provenance - Include build provenance metadata in the output. + Include intoto provenance metadata in the output, in the + provenance_summary section. To see all build metadata in the output, + use --show-all-metadata or --show-build-details. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/ai/endpoints/create b/gcloud/beta/ai/endpoints/create index 15180aba1..cdf11b153 100644 --- a/gcloud/beta/ai/endpoints/create +++ b/gcloud/beta/ai/endpoints/create @@ -3,8 +3,10 @@ NAME SYNOPSIS gcloud beta ai endpoints create --display-name=DISPLAY_NAME - [--description=DESCRIPTION] [--endpoint-id=ENDPOINT_ID] - [--labels=[KEY=VALUE,...]] [--network=NETWORK] [--region=REGION] + [--description=DESCRIPTION] + [--encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME] + [--endpoint-id=ENDPOINT_ID] [--labels=[KEY=VALUE,...]] + [--network=NETWORK] [--region=REGION] [--request-response-logging-rate=REQUEST_RESPONSE_LOGGING_RATE --request-response-logging-table=REQUEST_RESPONSE_LOGGING_TABLE] [GCLOUD_WIDE_FLAG ...] @@ -23,6 +25,14 @@ OPTIONAL FLAGS --description=DESCRIPTION Description of the endpoint. + --encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME + The Cloud KMS resource identifier of the customer managed encryption + key used to protect a resource. Has the form: + projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key. + + The key needs to be in the same region as where the compute resource is + created. + --endpoint-id=ENDPOINT_ID User-specified ID of the endpoint. diff --git a/gcloud/beta/artifacts/docker/images/describe b/gcloud/beta/artifacts/docker/images/describe index f56c88562..abcfe0055 100644 --- a/gcloud/beta/artifacts/docker/images/describe +++ b/gcloud/beta/artifacts/docker/images/describe @@ -50,7 +50,8 @@ FLAGS reference. --show-all-metadata - Include all metadata in the output. + Include all metadata in the output. Metadata will be grouped by Grafeas + kind, with an additional section for intoto provenance metadata. --show-build-details Include build metadata in the output. @@ -65,7 +66,9 @@ FLAGS Include vulnerability metadata in the output. --show-provenance - Include build provenance metadata in the output. + Include intoto provenance metadata in the output, in the + provenance_summary section. To see all build metadata in the output, + use --show-all-metadata or --show-build-details. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/builds/cancel b/gcloud/beta/builds/cancel index 42c3d0603..e7684360e 100644 --- a/gcloud/beta/builds/cancel +++ b/gcloud/beta/builds/cancel @@ -24,8 +24,8 @@ POSITIONAL ARGUMENTS FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global service - region is used. + supported region name (e.g. us-central1). If unset, builds/region is + used. If builds/region is unset,region is set to "global". GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/builds/describe b/gcloud/beta/builds/describe index 1b240c0c2..ee22d76b4 100644 --- a/gcloud/beta/builds/describe +++ b/gcloud/beta/builds/describe @@ -20,8 +20,8 @@ POSITIONAL ARGUMENTS FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global service - region is used. + supported region name (e.g. us-central1). If unset, builds/region is + used. If builds/region is unset,region is set to "global". GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/builds/list b/gcloud/beta/builds/list index a135ea3c6..37b5be390 100644 --- a/gcloud/beta/builds/list +++ b/gcloud/beta/builds/list @@ -24,8 +24,8 @@ FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global service - region is used. + supported region name (e.g. us-central1). If unset, builds/region is + used. If builds/region is unset,region is set to "global". LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/builds/log b/gcloud/beta/builds/log index 5ce61a851..ecbfa3787 100644 --- a/gcloud/beta/builds/log +++ b/gcloud/beta/builds/log @@ -26,8 +26,8 @@ POSITIONAL ARGUMENTS FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global service - region is used. + supported region name (e.g. us-central1). If unset, builds/region is + used. If builds/region is unset,region is set to "global". --stream If a build is ongoing, stream the logs to stdout until the build diff --git a/gcloud/beta/builds/submit b/gcloud/beta/builds/submit index 898f478f8..498f02c78 100644 --- a/gcloud/beta/builds/submit +++ b/gcloud/beta/builds/submit @@ -94,8 +94,8 @@ FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global service - region is used. + supported region name (e.g. us-central1). If unset, builds/region is + used. If builds/region is unset,region is set to "global". --substitutions=[KEY=VALUE,...] Parameters to be substituted in the build specification. diff --git a/gcloud/beta/builds/triggers/import b/gcloud/beta/builds/triggers/import index 76ba44ef3..d0c12567f 100644 --- a/gcloud/beta/builds/triggers/import +++ b/gcloud/beta/builds/triggers/import @@ -22,8 +22,8 @@ REQUIRED FLAGS OPTIONAL FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global service - region is used. + supported region name (e.g. us-central1). If unset, builds/region is + used. If builds/region is unset,region is set to "global". GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/builds/triggers/list b/gcloud/beta/builds/triggers/list index ddf5a40b6..cb74cde02 100644 --- a/gcloud/beta/builds/triggers/list +++ b/gcloud/beta/builds/triggers/list @@ -18,8 +18,8 @@ EXAMPLES FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global service - region is used. + supported region name (e.g. us-central1). If unset, builds/region is + used. If builds/region is unset,region is set to "global". LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/compute/backend-buckets/update b/gcloud/beta/compute/backend-buckets/update index 41989e194..b884cad19 100644 --- a/gcloud/beta/compute/backend-buckets/update +++ b/gcloud/beta/compute/backend-buckets/update @@ -331,7 +331,12 @@ FLAGS Set this to zero (0) to disable serve-while-stale. --no-serve-while-stale - Clears serve while stale value. + (DEPRECATED) Clears serve while stale value. + + The --no-serve-while-stale option is deprecated and will be removed + in an upcoming release; use --serve-while-stale instead. If you're + currently using this argument, you should remove it from your + workflows. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/compute/backend-services/update b/gcloud/beta/compute/backend-services/update index e20093c80..3cc3a615e 100644 --- a/gcloud/beta/compute/backend-services/update +++ b/gcloud/beta/compute/backend-services/update @@ -720,7 +720,12 @@ FLAGS Set this to zero (0) to disable serve-while-stale. --no-serve-while-stale - Clears serve while stale value. + (DEPRECATED) Clears serve while stale value. + + The --no-serve-while-stale option is deprecated and will be removed + in an upcoming release; use --serve-while-stale instead. If you're + currently using this argument, you should remove it from your + workflows. At most one of these can be specified: diff --git a/gcloud/beta/compute/firewall-rules/delete b/gcloud/beta/compute/firewall-rules/delete index 9d7125c20..726baa9b1 100644 --- a/gcloud/beta/compute/firewall-rules/delete +++ b/gcloud/beta/compute/firewall-rules/delete @@ -10,6 +10,11 @@ DESCRIPTION (BETA) gcloud beta compute firewall-rules delete deletes one or more Compute Engine firewall rules. +EXAMPLES + To delete a firewall rule, run: + + $ gcloud beta compute firewall-rules delete my-firewall-rule + POSITIONAL ARGUMENTS NAME [NAME ...] Names of the firewall rules to delete. diff --git a/gcloud/beta/compute/firewall-rules/describe b/gcloud/beta/compute/firewall-rules/describe index f68eda9d8..52345f7b0 100644 --- a/gcloud/beta/compute/firewall-rules/describe +++ b/gcloud/beta/compute/firewall-rules/describe @@ -9,6 +9,11 @@ DESCRIPTION (BETA) gcloud beta compute firewall-rules describe displays all data associated with a Compute Engine firewall rule in a project. +EXAMPLES + To describe a firewall rule, run: + + $ gcloud beta compute firewall-rules describe my-firewall-rule + POSITIONAL ARGUMENTS NAME Name of the firewall rule to describe. diff --git a/gcloud/beta/compute/forwarding-rules/create b/gcloud/beta/compute/forwarding-rules/create index 7e649fdd9..63922dcf5 100644 --- a/gcloud/beta/compute/forwarding-rules/create +++ b/gcloud/beta/compute/forwarding-rules/create @@ -215,8 +215,8 @@ OPTIONAL FLAGS INTERNAL Internal load balancing or forwarding, used with --backend-service. INTERNAL_MANAGED - Internal load balancing, used with --target-tcp-proxy, - --target-http-proxy, --target-https-proxy. + Internal load balancing, used with --target-http-proxy, + --target-https-proxy, --target-tcp-proxy. INTERNAL_SELF_MANAGED Traffic Director load balancing or forwarding, used with --target-http-proxy, --target-https-proxy, --target-grpc-proxy, diff --git a/gcloud/beta/compute/forwarding-rules/set-target b/gcloud/beta/compute/forwarding-rules/set-target index b2274068e..a5b81b4c2 100644 --- a/gcloud/beta/compute/forwarding-rules/set-target +++ b/gcloud/beta/compute/forwarding-rules/set-target @@ -130,8 +130,12 @@ REQUIRED FLAGS OPTIONAL FLAGS --load-balancing-scheme=LOAD_BALANCING_SCHEME; default="EXTERNAL" - This defines the forwarding rule's load balancing scheme. - LOAD_BALANCING_SCHEME must be one of: + (DEPRECATED) This defines the forwarding rule's load balancing scheme. + + The --load-balancing-scheme option is deprecated and will be removed in + an upcoming release. If you're currently using this argument, you + should remove it from your workflows. LOAD_BALANCING_SCHEME must be one + of: EXTERNAL External load balancing or forwarding, used with one of @@ -144,15 +148,15 @@ OPTIONAL FLAGS INTERNAL Internal load balancing or forwarding, used with --backend-service. INTERNAL_MANAGED - Internal load balancing, used with --target-tcp-proxy, - --target-http-proxy, --target-https-proxy. + Internal load balancing, used with --target-http-proxy, + --target-https-proxy, --target-tcp-proxy. INTERNAL_SELF_MANAGED Traffic Director load balancing or forwarding, used with --target-http-proxy, --target-https-proxy, --target-grpc-proxy, --target-tcp-proxy. --network=NETWORK - (Only for --load-balancing-scheme=INTERNAL or + (DEPRECATED) Only for --load-balancing-scheme=INTERNAL or --load-balancing-scheme=INTERNAL_SELF_MANAGED or --load-balancing-scheme=EXTERNAL_MANAGED (regional) or --load-balancing-scheme=INTERNAL_MANAGED) Network that this forwarding @@ -160,16 +164,28 @@ OPTIONAL FLAGS used. In the absence of the default network, this field must be specified. + The --network option is deprecated and will be removed in an upcoming + release. If you're currently using this argument, you should remove it + from your workflows. + --subnet=SUBNET - (Only for --load-balancing-scheme=INTERNAL and + (DEPRECATED) Only for --load-balancing-scheme=INTERNAL and --load-balancing-scheme=INTERNAL_MANAGED) Subnetwork that this forwarding rule applies to. If the network is auto mode, this flag is optional. If the network is custom mode, this flag is required. + The --subnet option is deprecated and will be removed in an upcoming + release. If you're currently using this argument, you should remove it + from your workflows. + --subnet-region=SUBNET_REGION - Region of the subnetwork to operate on. If not specified, the region is - set to the region of the forwarding rule. Overrides the default - compute/region property value for this command invocation. + (DEPRECATED) Region of the subnetwork to operate on. If not specified, + the region is set to the region of the forwarding rule. Overrides the + default compute/region property value for this command invocation. + + The --subnet-region option is deprecated and will be removed in an + upcoming release. If you're currently using this argument, you should + remove it from your workflows. --target-instance-zone=TARGET_INSTANCE_ZONE Zone of the target instance to operate on. Overrides the default diff --git a/gcloud/beta/compute/instance-templates/create b/gcloud/beta/compute/instance-templates/create index 4f338a777..2a6122658 100644 --- a/gcloud/beta/compute/instance-templates/create +++ b/gcloud/beta/compute/instance-templates/create @@ -241,6 +241,11 @@ FLAGS the instance, this option won't apply. The default value for this is yes. + architecture + Specifies the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. + boot If yes, indicates that this is a boot disk. The instance will use the first partition of the disk for its root file system. The diff --git a/gcloud/beta/compute/instance-templates/create-with-container b/gcloud/beta/compute/instance-templates/create-with-container index 676cb7c1c..3ea3e260b 100644 --- a/gcloud/beta/compute/instance-templates/create-with-container +++ b/gcloud/beta/compute/instance-templates/create-with-container @@ -335,6 +335,11 @@ FLAGS the instance, this option won't apply. The default value for this is yes. + architecture + Specifies the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. + multi-writer If yes, the disk is created in multi-writer mode so that it can be attached with read-write access to two VMs. The default value is diff --git a/gcloud/beta/compute/instances/bulk/create b/gcloud/beta/compute/instances/bulk/create index e000c2279..26d51e53e 100644 --- a/gcloud/beta/compute/instances/bulk/create +++ b/gcloud/beta/compute/instances/bulk/create @@ -272,6 +272,11 @@ OPTIONAL FLAGS the instance, this option won't apply. The default value for this is yes. + architecture + Specifies the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. + boot If yes, indicates that this is a boot disk. The instance will use the first partition of the disk for its root file system. The diff --git a/gcloud/beta/compute/instances/create b/gcloud/beta/compute/instances/create index 9f48ff696..2d6231351 100644 --- a/gcloud/beta/compute/instances/create +++ b/gcloud/beta/compute/instances/create @@ -260,6 +260,11 @@ FLAGS the instance, this option won't apply. The default value for this is yes. + architecture + Specifies the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. + boot If yes, indicates that this is a boot disk. The instance will use the first partition of the disk for its root file system. The diff --git a/gcloud/beta/compute/instances/create-with-container b/gcloud/beta/compute/instances/create-with-container index 00f26d677..b8208b315 100644 --- a/gcloud/beta/compute/instances/create-with-container +++ b/gcloud/beta/compute/instances/create-with-container @@ -344,6 +344,11 @@ FLAGS the instance, this option won't apply. The default value for this is yes. + architecture + Specifies the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. + multi-writer If yes, the disk is created in multi-writer mode so that it can be attached with read-write access to two VMs. The default value is diff --git a/gcloud/beta/compute/reservations/create b/gcloud/beta/compute/reservations/create index 698f461f8..6037fae3a 100644 --- a/gcloud/beta/compute/reservations/create +++ b/gcloud/beta/compute/reservations/create @@ -7,7 +7,8 @@ SYNOPSIS (--machine-type=MACHINE_TYPE --vm-count=VM_COUNT : --accelerator=[count=COUNT],[type=TYPE] --local-ssd=[interface=INTERFACE],[size=SIZE] - --min-cpu-platform=MIN_CPU_PLATFORM --require-specific-reservation) + --min-cpu-platform=MIN_CPU_PLATFORM + --require-specific-reservation --resource-policies=[KEY=VALUE,...]) [--description=DESCRIPTION] [--zone=ZONE] [--share-setting=SHARE_SETTING --share-with=SHARE_WITH,[SHARE_WITH,...]] [GCLOUD_WIDE_FLAG ...] @@ -80,6 +81,10 @@ REQUIRED FLAGS reservation by name using --reservation-affinity=specific can consume from this reservation. + --resource-policies=[KEY=VALUE,...] + Specify if this is reservation with resource policy. If you omit this + flag, no resource policy will be added to this reservation. + OPTIONAL FLAGS --description=DESCRIPTION An optional description of the reservation to create. diff --git a/gcloud/beta/compute/security-policies/create b/gcloud/beta/compute/security-policies/create index 430ab19d9..ccb6c7826 100644 --- a/gcloud/beta/compute/security-policies/create +++ b/gcloud/beta/compute/security-policies/create @@ -13,6 +13,17 @@ DESCRIPTION security policies. A security policy policy is a set of rules that controls access to various resources. +EXAMPLES + To create a security policy with a given type and description, run: + + $ gcloud beta compute security-policies create my-policy \ + --type=CLOUD_ARMOR_EDGE --description="policy description" + + To create a security from an input file, run: + + $ gcloud beta compute security-policies create my-policy \ + --file-name=my-file-name + POSITIONAL ARGUMENTS NAME Name of the security policy to create. diff --git a/gcloud/beta/compute/security-policies/delete b/gcloud/beta/compute/security-policies/delete index 0c57e83a7..83e540d70 100644 --- a/gcloud/beta/compute/security-policies/delete +++ b/gcloud/beta/compute/security-policies/delete @@ -10,6 +10,11 @@ DESCRIPTION security policies. Security policies can only be deleted when no other resources (e.g., backend services) refer to them. +EXAMPLES + To delete a security policy, run: + + $ gcloud beta compute security-policies delete my-policy + POSITIONAL ARGUMENTS NAME [NAME ...] Names of the security policies to delete. diff --git a/gcloud/beta/compute/security-policies/describe b/gcloud/beta/compute/security-policies/describe index adf11e118..40a53b6b8 100644 --- a/gcloud/beta/compute/security-policies/describe +++ b/gcloud/beta/compute/security-policies/describe @@ -10,6 +10,11 @@ DESCRIPTION (BETA) gcloud beta compute security-policies describe displays all data associated with Compute Engine security policy in a project. +EXAMPLES + To describe a security policy, run: + + $ gcloud beta compute security-policies describe my-policy + POSITIONAL ARGUMENTS NAME Name of the security policy to describe. diff --git a/gcloud/beta/compute/security-policies/export b/gcloud/beta/compute/security-policies/export index c341df98f..137f16dbd 100644 --- a/gcloud/beta/compute/security-policies/export +++ b/gcloud/beta/compute/security-policies/export @@ -1,6 +1,6 @@ NAME gcloud beta compute security-policies export - export security policy - configs into yaml files + configs into YAML or JSON files SYNOPSIS gcloud beta compute security-policies export NAME --file-name=FILE_NAME @@ -8,7 +8,14 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Export security policy configs into yaml files. + (BETA) gcloud beta compute security-policies export exports all data + associated with Compute Engine security policy into a local file. + +EXAMPLES + To export a security policy in JSON format to a given file, run: + + $ gcloud beta compute security-policies export my-policy \ + --file-name=my-file-name --file-format=json POSITIONAL ARGUMENTS NAME diff --git a/gcloud/beta/compute/security-policies/help b/gcloud/beta/compute/security-policies/help index d61c1991d..3d3cd9c2b 100644 --- a/gcloud/beta/compute/security-policies/help +++ b/gcloud/beta/compute/security-policies/help @@ -43,7 +43,7 @@ COMMANDS (BETA) Describe a Compute Engine security policy. export - (BETA) Export security policy configs into yaml files. + (BETA) Export security policy configs into YAML or JSON files. import (BETA) Import security policy configs into your project. diff --git a/gcloud/beta/compute/security-policies/rules/create b/gcloud/beta/compute/security-policies/rules/create index 13f907f39..d9a335739 100644 --- a/gcloud/beta/compute/security-policies/rules/create +++ b/gcloud/beta/compute/security-policies/rules/create @@ -24,14 +24,12 @@ DESCRIPTION (BETA) gcloud beta compute security-policies rules create is used to create security policy rules. - For example to create a rule at priority 1000 to block the IP range - 1.2.3.0/24, run: +EXAMPLES + To create a rule at priority 1000 to block the IP range 1.2.3.0/24, run: $ gcloud beta compute security-policies rules create 1000 \ - --action deny-403 \ - --security-policy my-policy \ - --description "block 1.2.3.0/24" \ - --src-ip-ranges 1.2.3.0/24 + --action=deny-403 --security-policy=my-policy \ + --description="block 1.2.3.0/24" --src-ip-ranges=1.2.3.0/24 POSITIONAL ARGUMENTS PRIORITY @@ -55,10 +53,6 @@ REQUIRED FLAGS deny-502 Denies the request from HTTP(S) Load Balancing, with an HTTP response status code of 503. - fairshare - When traffic reaches the threshold limit, requests from the clients - matching this rule begin to be rate-limited using the Fair Share - algorithm. rate-based-ban Enforces rate-based ban action from HTTP(S) Load Balancing, based on rate limit options. diff --git a/gcloud/beta/compute/security-policies/rules/delete b/gcloud/beta/compute/security-policies/rules/delete index 65db853b8..12489d683 100644 --- a/gcloud/beta/compute/security-policies/rules/delete +++ b/gcloud/beta/compute/security-policies/rules/delete @@ -10,6 +10,12 @@ DESCRIPTION (BETA) gcloud beta compute security-policies rules delete is used to delete security policy rules. +EXAMPLES + To delete the rule at priority 1000, run: + + $ gcloud beta compute security-policies rules delete 1000 \ + --security-policy=my-policy + POSITIONAL ARGUMENTS [PRIORITY ...] The priority of the rules to delete. Rules are evaluated in order from diff --git a/gcloud/beta/compute/security-policies/rules/describe b/gcloud/beta/compute/security-policies/rules/describe index 2ac1790ae..d52b519a9 100644 --- a/gcloud/beta/compute/security-policies/rules/describe +++ b/gcloud/beta/compute/security-policies/rules/describe @@ -10,6 +10,12 @@ DESCRIPTION (BETA) gcloud beta compute security-policies rules describe displays all data associated with a security policy rule. +EXAMPLES + To describe the rule at priority 1000, run: + + $ gcloud beta compute security-policies rules describe 1000 \ + --security-policy=my-policy + POSITIONAL ARGUMENTS PRIORITY The priority of the rule to describe. Rules are evaluated in order from diff --git a/gcloud/beta/compute/security-policies/rules/update b/gcloud/beta/compute/security-policies/rules/update index b7553cf47..df6b5cb53 100644 --- a/gcloud/beta/compute/security-policies/rules/update +++ b/gcloud/beta/compute/security-policies/rules/update @@ -25,13 +25,12 @@ DESCRIPTION (BETA) gcloud beta compute security-policies rules update is used to update security policy rules. - For example to update the description and IP ranges of a rule at priority - 1000, run: +EXAMPLES + To update the description and IP ranges of a rule at priority 1000, run: $ gcloud beta compute security-policies rules update 1000 \ - --security-policy my-policy \ - --description "block 1.2.3.4/32" \ - --src-ip-ranges 1.2.3.4/32 + --security-policy=my-policy --description="block 1.2.3.4/32" \ + --src-ip-ranges=1.2.3.4/32 POSITIONAL ARGUMENTS PRIORITY @@ -55,10 +54,6 @@ FLAGS deny-502 Denies the request from HTTP(S) Load Balancing, with an HTTP response status code of 503. - fairshare - When traffic reaches the threshold limit, requests from the clients - matching this rule begin to be rate-limited using the Fair Share - algorithm. rate-based-ban Enforces rate-based ban action from HTTP(S) Load Balancing, based on rate limit options. diff --git a/gcloud/beta/dataflow/flex-template/build b/gcloud/beta/dataflow/flex-template/build index b93ef14b8..e88b8402a 100644 --- a/gcloud/beta/dataflow/flex-template/build +++ b/gcloud/beta/dataflow/flex-template/build @@ -35,6 +35,19 @@ EXAMPLES gs://template-file-gcs-path --image=gcr://image-path \ --metadata-file=/local/path/to/metadata.json --sdk-language=JAVA + If using prebuilt template image from private registry, run: + + $ gcloud beta dataflow flex-template build \ + gs://template-file-gcs-path \ + --image=private.registry.com:3000/image-path \ + --image-repository-username-secret-id="projects/test-project/sec\ + rets/username-secret" \ + --image-repository-password-secret-id="projects/test-project/sec\ + rets/password-secret/versions/latest" \ + --metadata-file=metadata.json --sdk-language=JAVA + + To build the template image and flex template json file, run: + $ gcloud beta dataflow flex-template build \ gs://template-file-gcs-path \ --image-gcr-path=gcr://path-tos-tore-image \ diff --git a/gcloud/beta/deploy/releases/create b/gcloud/beta/deploy/releases/create index 66194d10b..fc5820119 100644 --- a/gcloud/beta/deploy/releases/create +++ b/gcloud/beta/deploy/releases/create @@ -169,17 +169,28 @@ FLAGS after the release is complete. --skaffold-file=SKAFFOLD_FILE - Path of the skaffold file relative to the source directory. + Path of the skaffold file absolute or relative to the source + directory. Examples: - Use Skaffold file: + Use Skaffold file with relative path: The current working directory + is expected to be some part of the skaffold path (e.g. the current + working directory could be /home/user) $ gcloud beta deploy releases create --source=/home/user/source \ --skaffold-file=config/skaffold.yaml - The skaffold file absolute file path is expected to be: - /home/user/source/config/skaffold.yaml + The skaffold file absolute file path is expected to be: + /home/user/source/config/skaffold.yaml + + Use Skaffold file with absolute path and with or without source argument: + + $ gcloud beta deploy releases create --source=/home/user/source \ + --skaffold-file=/home/user/source/config/skaffold.yaml + + $ gcloud beta deploy releases create \ + --skaffold-file=/home/user/source/config/skaffold.yaml --source=SOURCE; default="." The location of the source that contains skaffold.yaml. The location diff --git a/gcloud/beta/firebase/test/android/run b/gcloud/beta/firebase/test/android/run index a5daa31cd..4118ecf55 100644 --- a/gcloud/beta/firebase/test/android/run +++ b/gcloud/beta/firebase/test/android/run @@ -367,7 +367,7 @@ FLAGS is no greater than the total number of test cases. When you select one or more physical devices, the number of shards specified must be <= 50. When you select one or more ARM virtual devices, the number of - shards specified must be <= 100. When you select only x86 virtual + shards specified must be <= 50. When you select only x86 virtual devices, the number of shards specified must be <= 500. --test-targets-for-shard=TEST_TARGETS_FOR_SHARD @@ -375,7 +375,7 @@ FLAGS each shard (a group of test cases). Each time this flag is repeated, it creates a new shard. The shards are run in parallel on separate devices. You can repeat this flag up to 50 times when you select one - or more physical devices, up to 100 times when you select one or more + or more physical devices, up to 50 times when you select one or more ARM virtual devices, and up to 500 times when you select only x86 virtual devices. diff --git a/gcloud/beta/iam/workload-identity-pools/create-cred-config b/gcloud/beta/iam/workload-identity-pools/create-cred-config index 33c74f2f7..7b877c983 100644 --- a/gcloud/beta/iam/workload-identity-pools/create-cred-config +++ b/gcloud/beta/iam/workload-identity-pools/create-cred-config @@ -119,7 +119,8 @@ OPTIONAL FLAGS enforce the AWS IMDSv2 flow. --subject-token-type=SUBJECT_TOKEN_TYPE - The type of token being used for authorization. + The type of token being used for authorization. This defaults to + urn:ietf:params:oauth:token-type:jwt. Arguments for an executable type credential source. diff --git a/gcloud/beta/run/deploy b/gcloud/beta/run/deploy index 27d92c421..53833e2a0 100644 --- a/gcloud/beta/run/deploy +++ b/gcloud/beta/run/deploy @@ -22,7 +22,8 @@ SYNOPSIS --update-config-maps=[KEY=VALUE,...]] [--image=IMAGE | --source=SOURCE] [--[no-]allow-unauthenticated --breakglass=JUSTIFICATION - --clear-vpc-connector --[no-]cpu-throttling --description=DESCRIPTION + --clear-vpc-connector --[no-]cpu-boost --[no-]cpu-throttling + --description=DESCRIPTION --execution-environment=EXECUTION_ENVIRONMENT --revision-suffix=REVISION_SUFFIX --[no-]session-affinity --vpc-connector=VPC_CONNECTOR --vpc-egress=VPC_EGRESS @@ -373,6 +374,11 @@ FLAGS --clear-vpc-connector Remove the VPC connector for this resource. + --[no-]cpu-boost + Whether to allocate extra CPU to containers on startup. This can + reduce the percieved latency of a cold start request. Use --cpu-boost + to enable and --no-cpu-boost to disable. + --[no-]cpu-throttling Whether to throttle the CPU when the container is not actively serving requests. Use --cpu-throttling to enable and diff --git a/gcloud/beta/run/services/update b/gcloud/beta/run/services/update index a609f98e2..c4098ced9 100644 --- a/gcloud/beta/run/services/update +++ b/gcloud/beta/run/services/update @@ -11,8 +11,8 @@ SYNOPSIS [--platform=PLATFORM; default="managed"] [--port=PORT] [--service-account=SERVICE_ACCOUNT] [--tag=TAG] [--timeout=TIMEOUT] [--no-traffic] [--[no-]use-http2] - [--breakglass=JUSTIFICATION --clear-vpc-connector --[no-]cpu-throttling - --execution-environment=EXECUTION_ENVIRONMENT + [--breakglass=JUSTIFICATION --clear-vpc-connector --[no-]cpu-boost + --[no-]cpu-throttling --execution-environment=EXECUTION_ENVIRONMENT --revision-suffix=REVISION_SUFFIX --[no-]session-affinity --vpc-connector=VPC_CONNECTOR --vpc-egress=VPC_EGRESS --add-cloudsql-instances=[CLOUDSQL-INSTANCES,...] @@ -209,6 +209,11 @@ FLAGS --clear-vpc-connector Remove the VPC connector for this resource. + --[no-]cpu-boost + Whether to allocate extra CPU to containers on startup. This can + reduce the percieved latency of a cold start request. Use --cpu-boost + to enable and --no-cpu-boost to disable. + --[no-]cpu-throttling Whether to throttle the CPU when the container is not actively serving requests. Use --cpu-throttling to enable and diff --git a/gcloud/beta/sql/instances/create b/gcloud/beta/sql/instances/create index 490d48597..b30e91d52 100644 --- a/gcloud/beta/sql/instances/create +++ b/gcloud/beta/sql/instances/create @@ -15,6 +15,7 @@ SYNOPSIS [--backup-start-time=BACKUP_START_TIME] [--collation=COLLATION] [--cpu=CPU] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] [--database-version=DATABASE_VERSION; default="MYSQL_8_0"] + [--[no-]deletion-protection] [--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] @@ -183,6 +184,12 @@ FLAGS is used. See the list of database versions at https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion. + --[no-]deletion-protection + Enable deletion protection on a Cloud SQL instance. Use + --deletion-protection to enable deletion protection on an instance and + --no-deletion-protection to disable it. Use --deletion-protection to + enable and --no-deletion-protection to disable. + --deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE Date when the deny maintenance period ends, that is 2021-01-10. diff --git a/gcloud/beta/sql/instances/patch b/gcloud/beta/sql/instances/patch index abd890d70..5c5db4229 100644 --- a/gcloud/beta/sql/instances/patch +++ b/gcloud/beta/sql/instances/patch @@ -12,6 +12,7 @@ SYNOPSIS [--audit-upload-interval=AUDIT_UPLOAD_INTERVAL] [--availability-type=AVAILABILITY_TYPE] [--clear-password-policy] [--cpu=CPU] [--database-version=DATABASE_VERSION] + [--[no-]deletion-protection] [--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] [--diff] @@ -125,6 +126,12 @@ FLAGS occur. See the list of database versions at https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion. + --[no-]deletion-protection + Enable deletion protection on a Cloud SQL instance. Use + --deletion-protection to enable deletion protection on an instance and + --no-deletion-protection to disable it. Use --deletion-protection to + enable and --no-deletion-protection to disable. + --deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE Date when the deny maintenance period ends, that is 2021-01-10. diff --git a/gcloud/builds/cancel b/gcloud/builds/cancel index c4c655cdb..53f664406 100644 --- a/gcloud/builds/cancel +++ b/gcloud/builds/cancel @@ -24,8 +24,8 @@ POSITIONAL ARGUMENTS FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global service - region is used. + supported region name (e.g. us-central1). If unset, builds/region is + used. If builds/region is unset,region is set to "global". GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/builds/describe b/gcloud/builds/describe index 5b2c3ffd2..0bd5b2a1b 100644 --- a/gcloud/builds/describe +++ b/gcloud/builds/describe @@ -20,8 +20,8 @@ POSITIONAL ARGUMENTS FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global service - region is used. + supported region name (e.g. us-central1). If unset, builds/region is + used. If builds/region is unset,region is set to "global". GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/builds/list b/gcloud/builds/list index d93f8e28f..e0fb661a1 100644 --- a/gcloud/builds/list +++ b/gcloud/builds/list @@ -24,8 +24,8 @@ FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global service - region is used. + supported region name (e.g. us-central1). If unset, builds/region is + used. If builds/region is unset,region is set to "global". LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/builds/log b/gcloud/builds/log index 15befd524..1c35f5666 100644 --- a/gcloud/builds/log +++ b/gcloud/builds/log @@ -25,8 +25,8 @@ POSITIONAL ARGUMENTS FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global service - region is used. + supported region name (e.g. us-central1). If unset, builds/region is + used. If builds/region is unset,region is set to "global". --stream If a build is ongoing, stream the logs to stdout until the build diff --git a/gcloud/builds/submit b/gcloud/builds/submit index e95f2c37c..dda137381 100644 --- a/gcloud/builds/submit +++ b/gcloud/builds/submit @@ -94,8 +94,8 @@ FLAGS --region=REGION The region of the Cloud Build Service to use. Must be set to a - supported region name (e.g. us-central1). If unset, the global service - region is used. + supported region name (e.g. us-central1). If unset, builds/region is + used. If builds/region is unset,region is set to "global". --substitutions=[KEY=VALUE,...] Parameters to be substituted in the build specification. diff --git a/gcloud/compute/backend-buckets/update b/gcloud/compute/backend-buckets/update index bb3d45484..9c62582e4 100644 --- a/gcloud/compute/backend-buckets/update +++ b/gcloud/compute/backend-buckets/update @@ -319,7 +319,12 @@ FLAGS Set this to zero (0) to disable serve-while-stale. --no-serve-while-stale - Clears serve while stale value. + (DEPRECATED) Clears serve while stale value. + + The --no-serve-while-stale option is deprecated and will be removed + in an upcoming release; use --serve-while-stale instead. If you're + currently using this argument, you should remove it from your + workflows. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/compute/backend-services/update b/gcloud/compute/backend-services/update index 4eeec0889..e26ad4921 100644 --- a/gcloud/compute/backend-services/update +++ b/gcloud/compute/backend-services/update @@ -691,7 +691,12 @@ FLAGS Set this to zero (0) to disable serve-while-stale. --no-serve-while-stale - Clears serve while stale value. + (DEPRECATED) Clears serve while stale value. + + The --no-serve-while-stale option is deprecated and will be removed + in an upcoming release; use --serve-while-stale instead. If you're + currently using this argument, you should remove it from your + workflows. At most one of these can be specified: diff --git a/gcloud/compute/firewall-rules/delete b/gcloud/compute/firewall-rules/delete index 4aa9ba68f..23a8a08a8 100644 --- a/gcloud/compute/firewall-rules/delete +++ b/gcloud/compute/firewall-rules/delete @@ -8,6 +8,11 @@ DESCRIPTION gcloud compute firewall-rules delete deletes one or more Compute Engine firewall rules. +EXAMPLES + To delete a firewall rule, run: + + $ gcloud compute firewall-rules delete my-firewall-rule + POSITIONAL ARGUMENTS NAME [NAME ...] Names of the firewall rules to delete. diff --git a/gcloud/compute/firewall-rules/describe b/gcloud/compute/firewall-rules/describe index f42feb128..66f188c14 100644 --- a/gcloud/compute/firewall-rules/describe +++ b/gcloud/compute/firewall-rules/describe @@ -9,6 +9,11 @@ DESCRIPTION gcloud compute firewall-rules describe displays all data associated with a Compute Engine firewall rule in a project. +EXAMPLES + To describe a firewall rule, run: + + $ gcloud compute firewall-rules describe my-firewall-rule + POSITIONAL ARGUMENTS NAME Name of the firewall rule to describe. diff --git a/gcloud/compute/forwarding-rules/create b/gcloud/compute/forwarding-rules/create index ece678cb3..0a06eff06 100644 --- a/gcloud/compute/forwarding-rules/create +++ b/gcloud/compute/forwarding-rules/create @@ -212,7 +212,7 @@ OPTIONAL FLAGS INTERNAL Internal load balancing or forwarding, used with --backend-service. INTERNAL_MANAGED - Internal HTTP(S) Load Balancing, used with --target-http-proxy, + Internal load balancing, used with --target-http-proxy, --target-https-proxy. INTERNAL_SELF_MANAGED Traffic Director load balancing or forwarding, used with diff --git a/gcloud/compute/forwarding-rules/set-target b/gcloud/compute/forwarding-rules/set-target index af7092aa3..b874074ab 100644 --- a/gcloud/compute/forwarding-rules/set-target +++ b/gcloud/compute/forwarding-rules/set-target @@ -128,8 +128,12 @@ REQUIRED FLAGS OPTIONAL FLAGS --load-balancing-scheme=LOAD_BALANCING_SCHEME; default="EXTERNAL" - This defines the forwarding rule's load balancing scheme. - LOAD_BALANCING_SCHEME must be one of: + (DEPRECATED) This defines the forwarding rule's load balancing scheme. + + The --load-balancing-scheme option is deprecated and will be removed in + an upcoming release. If you're currently using this argument, you + should remove it from your workflows. LOAD_BALANCING_SCHEME must be one + of: EXTERNAL External load balancing or forwarding, used with one of @@ -142,7 +146,7 @@ OPTIONAL FLAGS INTERNAL Internal load balancing or forwarding, used with --backend-service. INTERNAL_MANAGED - Internal HTTP(S) Load Balancing, used with --target-http-proxy, + Internal load balancing, used with --target-http-proxy, --target-https-proxy. INTERNAL_SELF_MANAGED Traffic Director load balancing or forwarding, used with @@ -150,7 +154,7 @@ OPTIONAL FLAGS --target-tcp-proxy. --network=NETWORK - (Only for --load-balancing-scheme=INTERNAL or + (DEPRECATED) Only for --load-balancing-scheme=INTERNAL or --load-balancing-scheme=INTERNAL_SELF_MANAGED or --load-balancing-scheme=EXTERNAL_MANAGED (regional) or --load-balancing-scheme=INTERNAL_MANAGED) Network that this forwarding @@ -158,16 +162,28 @@ OPTIONAL FLAGS used. In the absence of the default network, this field must be specified. + The --network option is deprecated and will be removed in an upcoming + release. If you're currently using this argument, you should remove it + from your workflows. + --subnet=SUBNET - (Only for --load-balancing-scheme=INTERNAL and + (DEPRECATED) Only for --load-balancing-scheme=INTERNAL and --load-balancing-scheme=INTERNAL_MANAGED) Subnetwork that this forwarding rule applies to. If the network is auto mode, this flag is optional. If the network is custom mode, this flag is required. + The --subnet option is deprecated and will be removed in an upcoming + release. If you're currently using this argument, you should remove it + from your workflows. + --subnet-region=SUBNET_REGION - Region of the subnetwork to operate on. If not specified, the region is - set to the region of the forwarding rule. Overrides the default - compute/region property value for this command invocation. + (DEPRECATED) Region of the subnetwork to operate on. If not specified, + the region is set to the region of the forwarding rule. Overrides the + default compute/region property value for this command invocation. + + The --subnet-region option is deprecated and will be removed in an + upcoming release. If you're currently using this argument, you should + remove it from your workflows. --target-instance-zone=TARGET_INSTANCE_ZONE Zone of the target instance to operate on. Overrides the default diff --git a/gcloud/compute/instance-templates/create b/gcloud/compute/instance-templates/create index 8e82ccda0..4d5b46e19 100644 --- a/gcloud/compute/instance-templates/create +++ b/gcloud/compute/instance-templates/create @@ -232,6 +232,11 @@ FLAGS the instance, this option won't apply. The default value for this is yes. + architecture + Specifies the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. + boot If yes, indicates that this is a boot disk. The instance will use the first partition of the disk for its root file system. The diff --git a/gcloud/compute/instance-templates/create-with-container b/gcloud/compute/instance-templates/create-with-container index 82d6c3609..6af9593d7 100644 --- a/gcloud/compute/instance-templates/create-with-container +++ b/gcloud/compute/instance-templates/create-with-container @@ -320,6 +320,11 @@ FLAGS the instance, this option won't apply. The default value for this is yes. + architecture + Specifies the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. + --description=DESCRIPTION Specifies a textual description for the instance template. diff --git a/gcloud/compute/instances/bulk/create b/gcloud/compute/instances/bulk/create index 918dee637..a3f1f284b 100644 --- a/gcloud/compute/instances/bulk/create +++ b/gcloud/compute/instances/bulk/create @@ -269,6 +269,11 @@ OPTIONAL FLAGS the instance, this option won't apply. The default value for this is yes. + architecture + Specifies the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. + boot If yes, indicates that this is a boot disk. The instance will use the first partition of the disk for its root file system. The diff --git a/gcloud/compute/instances/create b/gcloud/compute/instances/create index 116c2508b..7f5bbb44e 100644 --- a/gcloud/compute/instances/create +++ b/gcloud/compute/instances/create @@ -254,6 +254,11 @@ FLAGS the instance, this option won't apply. The default value for this is yes. + architecture + Specifies the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. + boot If yes, indicates that this is a boot disk. The instance will use the first partition of the disk for its root file system. The diff --git a/gcloud/compute/instances/create-with-container b/gcloud/compute/instances/create-with-container index db62ed584..a0a29e36b 100644 --- a/gcloud/compute/instances/create-with-container +++ b/gcloud/compute/instances/create-with-container @@ -341,6 +341,11 @@ FLAGS the instance, this option won't apply. The default value for this is yes. + architecture + Specifies the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. + --description=DESCRIPTION Specifies a textual description of the instances. diff --git a/gcloud/compute/security-policies/create b/gcloud/compute/security-policies/create index 461148d47..b3bf4acc9 100644 --- a/gcloud/compute/security-policies/create +++ b/gcloud/compute/security-policies/create @@ -13,6 +13,17 @@ DESCRIPTION policies. A security policy policy is a set of rules that controls access to various resources. +EXAMPLES + To create a security policy with a given type and description, run: + + $ gcloud compute security-policies create my-policy \ + --type=CLOUD_ARMOR_EDGE --description="policy description" + + To create a security from an input file, run: + + $ gcloud compute security-policies create my-policy \ + --file-name=my-file-name + POSITIONAL ARGUMENTS NAME Name of the security policy to create. diff --git a/gcloud/compute/security-policies/delete b/gcloud/compute/security-policies/delete index 5c7bc1f3a..e7b828ec6 100644 --- a/gcloud/compute/security-policies/delete +++ b/gcloud/compute/security-policies/delete @@ -10,6 +10,11 @@ DESCRIPTION policies. Security policies can only be deleted when no other resources (e.g., backend services) refer to them. +EXAMPLES + To delete a security policy, run: + + $ gcloud compute security-policies delete my-policy + POSITIONAL ARGUMENTS NAME [NAME ...] Names of the security policies to delete. diff --git a/gcloud/compute/security-policies/describe b/gcloud/compute/security-policies/describe index 9b5c0b896..f4f6c5dbe 100644 --- a/gcloud/compute/security-policies/describe +++ b/gcloud/compute/security-policies/describe @@ -9,6 +9,11 @@ DESCRIPTION gcloud compute security-policies describe displays all data associated with Compute Engine security policy in a project. +EXAMPLES + To describe a security policy, run: + + $ gcloud compute security-policies describe my-policy + POSITIONAL ARGUMENTS NAME Name of the security policy to describe. diff --git a/gcloud/compute/security-policies/export b/gcloud/compute/security-policies/export index ab908ea7b..213573368 100644 --- a/gcloud/compute/security-policies/export +++ b/gcloud/compute/security-policies/export @@ -1,13 +1,20 @@ NAME gcloud compute security-policies export - export security policy configs - into yaml files + into YAML or JSON files SYNOPSIS gcloud compute security-policies export NAME --file-name=FILE_NAME [--file-format=FILE_FORMAT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Export security policy configs into yaml files. + gcloud compute security-policies export exports all data associated with + Compute Engine security policy into a local file. + +EXAMPLES + To export a security policy in JSON format to a given file, run: + + $ gcloud compute security-policies export my-policy \ + --file-name=my-file-name --file-format=json POSITIONAL ARGUMENTS NAME diff --git a/gcloud/compute/security-policies/help b/gcloud/compute/security-policies/help index e62900236..2ff60d40e 100644 --- a/gcloud/compute/security-policies/help +++ b/gcloud/compute/security-policies/help @@ -42,7 +42,7 @@ COMMANDS Describe a Compute Engine security policy. export - Export security policy configs into yaml files. + Export security policy configs into YAML or JSON files. import Import security policy configs into your project. diff --git a/gcloud/compute/security-policies/rules/create b/gcloud/compute/security-policies/rules/create index dcc468b91..965a23127 100644 --- a/gcloud/compute/security-policies/rules/create +++ b/gcloud/compute/security-policies/rules/create @@ -24,14 +24,12 @@ DESCRIPTION gcloud compute security-policies rules create is used to create security policy rules. - For example to create a rule at priority 1000 to block the IP range - 1.2.3.0/24, run: +EXAMPLES + To create a rule at priority 1000 to block the IP range 1.2.3.0/24, run: $ gcloud compute security-policies rules create 1000 \ - --action deny-403 \ - --security-policy my-policy \ - --description "block 1.2.3.0/24" \ - --src-ip-ranges 1.2.3.0/24 + --action=deny-403 --security-policy=my-policy \ + --description="block 1.2.3.0/24" --src-ip-ranges=1.2.3.0/24 POSITIONAL ARGUMENTS PRIORITY @@ -55,10 +53,6 @@ REQUIRED FLAGS deny-502 Denies the request from HTTP(S) Load Balancing, with an HTTP response status code of 503. - fairshare - When traffic reaches the threshold limit, requests from the clients - matching this rule begin to be rate-limited using the Fair Share - algorithm. rate-based-ban Enforces rate-based ban action from HTTP(S) Load Balancing, based on rate limit options. diff --git a/gcloud/compute/security-policies/rules/delete b/gcloud/compute/security-policies/rules/delete index f3d42956f..858265cf4 100644 --- a/gcloud/compute/security-policies/rules/delete +++ b/gcloud/compute/security-policies/rules/delete @@ -10,6 +10,12 @@ DESCRIPTION gcloud compute security-policies rules delete is used to delete security policy rules. +EXAMPLES + To delete the rule at priority 1000, run: + + $ gcloud compute security-policies rules delete 1000 \ + --security-policy=my-policy + POSITIONAL ARGUMENTS [PRIORITY ...] The priority of the rules to delete. Rules are evaluated in order from diff --git a/gcloud/compute/security-policies/rules/describe b/gcloud/compute/security-policies/rules/describe index 855e8c263..5a14c26f1 100644 --- a/gcloud/compute/security-policies/rules/describe +++ b/gcloud/compute/security-policies/rules/describe @@ -10,6 +10,12 @@ DESCRIPTION gcloud compute security-policies rules describe displays all data associated with a security policy rule. +EXAMPLES + To describe the rule at priority 1000, run: + + $ gcloud compute security-policies rules describe 1000 \ + --security-policy=my-policy + POSITIONAL ARGUMENTS PRIORITY The priority of the rule to describe. Rules are evaluated in order from diff --git a/gcloud/compute/security-policies/rules/update b/gcloud/compute/security-policies/rules/update index d92e800a8..2839a8699 100644 --- a/gcloud/compute/security-policies/rules/update +++ b/gcloud/compute/security-policies/rules/update @@ -25,13 +25,12 @@ DESCRIPTION gcloud compute security-policies rules update is used to update security policy rules. - For example to update the description and IP ranges of a rule at priority - 1000, run: +EXAMPLES + To update the description and IP ranges of a rule at priority 1000, run: $ gcloud compute security-policies rules update 1000 \ - --security-policy my-policy \ - --description "block 1.2.3.4/32" \ - --src-ip-ranges 1.2.3.4/32 + --security-policy=my-policy --description="block 1.2.3.4/32" \ + --src-ip-ranges=1.2.3.4/32 POSITIONAL ARGUMENTS PRIORITY @@ -55,10 +54,6 @@ FLAGS deny-502 Denies the request from HTTP(S) Load Balancing, with an HTTP response status code of 503. - fairshare - When traffic reaches the threshold limit, requests from the clients - matching this rule begin to be rate-limited using the Fair Share - algorithm. rate-based-ban Enforces rate-based ban action from HTTP(S) Load Balancing, based on rate limit options. diff --git a/gcloud/compute/url-maps/invalidate-cdn-cache b/gcloud/compute/url-maps/invalidate-cdn-cache index 348597d8a..e1f997a75 100644 --- a/gcloud/compute/url-maps/invalidate-cdn-cache +++ b/gcloud/compute/url-maps/invalidate-cdn-cache @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud compute url-maps invalidate-cdn-cache URLMAP --path=PATH [--async] - [--host=HOST] [GCLOUD_WIDE_FLAG ...] + [--host=HOST] [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION gcloud compute url-maps invalidate-cdn-cache requests that Cloud CDN stop @@ -48,6 +48,31 @@ OPTIONAL FLAGS If set, this invalidation will apply only to requests to the specified host. + At most one of these can be specified: + + --global + If set, the URL map is global. + + --region=REGION + Region of the URL map to operate on. If not specified, you might be + prompted to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + 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/compute/url-maps/list-cdn-cache-invalidations b/gcloud/compute/url-maps/list-cdn-cache-invalidations index 30dfb07df..cfd419524 100644 --- a/gcloud/compute/url-maps/list-cdn-cache-invalidations +++ b/gcloud/compute/url-maps/list-cdn-cache-invalidations @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud compute url-maps list-cdn-cache-invalidations URL_MAP - [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] + [--limit=LIMIT] [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION List Cloud CDN cache invalidations for a URL map. A cache invalidation @@ -19,6 +19,31 @@ FLAGS --limit=LIMIT The maximum number of invalidations to list. + At most one of these can be specified: + + --global + If set, the URL map is global. + + --region=REGION + Region of the URL map to describe. If not specified, you might be + prompted to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + 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/dataflow/flex-template/build b/gcloud/dataflow/flex-template/build index ac900cf9e..966695c4b 100644 --- a/gcloud/dataflow/flex-template/build +++ b/gcloud/dataflow/flex-template/build @@ -35,6 +35,18 @@ EXAMPLES --image=gcr://image-path \ --metadata-file=/local/path/to/metadata.json --sdk-language=JAVA + If using prebuilt template image from private registry, run: + + $ gcloud dataflow flex-template build gs://template-file-gcs-path \ + --image=private.registry.com:3000/image-path \ + --image-repository-username-secret-id="projects/test-project/sec\ + rets/username-secret" \ + --image-repository-password-secret-id="projects/test-project/sec\ + rets/password-secret/versions/latest" \ + --metadata-file=metadata.json --sdk-language=JAVA + + To build the template image and flex template json file, run: + $ gcloud dataflow flex-template build gs://template-file-gcs-path \ --image-gcr-path=gcr://path-tos-tore-image \ --jar=path/to/pipeline.jar --jar=path/to/dependency.jar \ diff --git a/gcloud/deploy/releases/create b/gcloud/deploy/releases/create index 103f70a2b..3758248d3 100644 --- a/gcloud/deploy/releases/create +++ b/gcloud/deploy/releases/create @@ -168,17 +168,28 @@ FLAGS after the release is complete. --skaffold-file=SKAFFOLD_FILE - Path of the skaffold file relative to the source directory. + Path of the skaffold file absolute or relative to the source + directory. Examples: - Use Skaffold file: + Use Skaffold file with relative path: The current working directory + is expected to be some part of the skaffold path (e.g. the current + working directory could be /home/user) $ gcloud deploy releases create --source=/home/user/source \ --skaffold-file=config/skaffold.yaml - The skaffold file absolute file path is expected to be: - /home/user/source/config/skaffold.yaml + The skaffold file absolute file path is expected to be: + /home/user/source/config/skaffold.yaml + + Use Skaffold file with absolute path and with or without source argument: + + $ gcloud deploy releases create --source=/home/user/source \ + --skaffold-file=/home/user/source/config/skaffold.yaml + + $ gcloud deploy releases create \ + --skaffold-file=/home/user/source/config/skaffold.yaml --source=SOURCE; default="." The location of the source that contains skaffold.yaml. The location diff --git a/gcloud/iam/workload-identity-pools/create-cred-config b/gcloud/iam/workload-identity-pools/create-cred-config index 4ea38ca5a..da2a60f25 100644 --- a/gcloud/iam/workload-identity-pools/create-cred-config +++ b/gcloud/iam/workload-identity-pools/create-cred-config @@ -119,7 +119,8 @@ OPTIONAL FLAGS enforce the AWS IMDSv2 flow. --subject-token-type=SUBJECT_TOKEN_TYPE - The type of token being used for authorization. + The type of token being used for authorization. This defaults to + urn:ietf:params:oauth:token-type:jwt. Arguments for an executable type credential source. diff --git a/gcloud/network-services/gateways/delete b/gcloud/network-services/gateways/delete new file mode 100644 index 000000000..590ab9a06 --- /dev/null +++ b/gcloud/network-services/gateways/delete @@ -0,0 +1,66 @@ +NAME + gcloud network-services gateways delete - delete a gateway + +SYNOPSIS + gcloud network-services gateways delete (GATEWAY : --location=LOCATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete the specified Network Services gateway. + +EXAMPLES + To delete a gateway named 'my-gateway', run: + + $ gcloud network-services gateways delete my-gateway \ + --location=global + +POSITIONAL ARGUMENTS + Gateway resource - Name of the gateway you want to delete. The arguments + in this group can be used to specify the attributes of this resource. + (NOTE) Some attributes are not given arguments in this group but can be + set in other ways. To set the project attribute: + ◆ provide the argument gateway on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + GATEWAY + ID of the gateway or fully qualified identifier for the gateway. To + set the gateway attribute: + ▸ provide the argument gateway on the command line. + + 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 gateway 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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services gateways delete + diff --git a/gcloud/network-services/gateways/describe b/gcloud/network-services/gateways/describe new file mode 100644 index 000000000..011293c7c --- /dev/null +++ b/gcloud/network-services/gateways/describe @@ -0,0 +1,61 @@ +NAME + gcloud network-services gateways describe - describe a gateway + +SYNOPSIS + gcloud network-services gateways describe (GATEWAY : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show the details of a Network Services gateway. + +EXAMPLES + Show details about a gateway named 'my-gateway'. + + $ gcloud network-services gateways describe my-gateway \ + --location=global + +POSITIONAL ARGUMENTS + Gateway resource - Name of the gateway to be described. 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 gateway on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + GATEWAY + ID of the gateway or fully qualified identifier for the gateway. To + set the gateway attribute: + ▸ provide the argument gateway on the command line. + + 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 gateway 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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services gateways describe + diff --git a/gcloud/network-services/gateways/export b/gcloud/network-services/gateways/export new file mode 100644 index 000000000..3a55067d8 --- /dev/null +++ b/gcloud/network-services/gateways/export @@ -0,0 +1,70 @@ +NAME + gcloud network-services gateways export - export the configuration for a + gateway + +SYNOPSIS + gcloud network-services gateways export (GATEWAY : --location=LOCATION) + [--destination=DESTINATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Export the configuration for a Network Services gateway. + +EXAMPLES + To export a gateway named 'my-gateway' to a YAML file, run: + + $ gcloud network-services gateways export my-gateway \ + --destination=my-gateway.yaml --location=global + +POSITIONAL ARGUMENTS + Gateway resource - Name of the gateway to export. 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 gateway on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + GATEWAY + ID of the gateway or fully qualified identifier for the gateway. To + set the gateway attribute: + ▸ provide the argument gateway on the command line. + + 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 gateway on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --destination=DESTINATION + Path to a YAML file where the configuration will be exported. The + exported data will not contain any output-only fields. Alternatively, + you may omit this flag to write to standard output. For a schema + describing the export/import format, see + $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + +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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services gateways export + diff --git a/gcloud/network-services/gateways/help b/gcloud/network-services/gateways/help new file mode 100644 index 000000000..d7a798976 --- /dev/null +++ b/gcloud/network-services/gateways/help @@ -0,0 +1,37 @@ +NAME + gcloud network-services gateways - manage Network Services Gateways + +SYNOPSIS + gcloud network-services gateways COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Network Services Gateways. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + Delete a gateway. + + describe + Describe a gateway. + + export + Export the configuration for a gateway. + + import + Import the configuration for a gateway. + + list + List gateways. + +NOTES + This variant is also available: + + $ gcloud alpha network-services gateways + diff --git a/gcloud/network-services/gateways/import b/gcloud/network-services/gateways/import new file mode 100644 index 000000000..f5e76be9f --- /dev/null +++ b/gcloud/network-services/gateways/import @@ -0,0 +1,77 @@ +NAME + gcloud network-services gateways import - import the configuration for a + gateway + +SYNOPSIS + gcloud network-services gateways import (GATEWAY : --location=LOCATION) + [--async] [--source=SOURCE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Import the configuration for a Network Services gateway. + +EXAMPLES + To import a gateway named 'my-gateway' from a YAML file, run: + + $ gcloud network-services gateways import my-gateway \ + --source=my-gateway.yaml --location=global + +POSITIONAL ARGUMENTS + Gateway resource - Name of the gateway to import. 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 gateway on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + GATEWAY + ID of the gateway or fully qualified identifier for the gateway. To + set the gateway attribute: + ▸ provide the argument gateway on the command line. + + 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 gateway on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --source=SOURCE + Path to a YAML file containing the configuration export data. The YAML + file must not contain any output-only fields. Alternatively, you may + omit this flag to read from standard input. For a schema describing the + export/import format, see: $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + + $CLOUDSDKROOT is can be obtained with the following command: + + $ gcloud info --format='value(installation.sdk_root)' + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services gateways import + diff --git a/gcloud/network-services/gateways/list b/gcloud/network-services/gateways/list new file mode 100644 index 000000000..a98711582 --- /dev/null +++ b/gcloud/network-services/gateways/list @@ -0,0 +1,83 @@ +NAME + gcloud network-services gateways list - list gateways + +SYNOPSIS + gcloud network-services gateways list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all Network Services gateways in the specified location of the current + project. + +EXAMPLES + To list gateways in the current project, run: + + $ gcloud network-services gateways list --location=global + +REQUIRED FLAGS + Location resource - The project of the gateways 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; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + 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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services gateways list + diff --git a/gcloud/network-services/grpc-routes/delete b/gcloud/network-services/grpc-routes/delete new file mode 100644 index 000000000..da3765dd5 --- /dev/null +++ b/gcloud/network-services/grpc-routes/delete @@ -0,0 +1,66 @@ +NAME + gcloud network-services grpc-routes delete - delete grpc route + +SYNOPSIS + gcloud network-services grpc-routes delete + (GRPC_ROUTE : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete the specified grpc route. + +EXAMPLES + To delete a grpc route named 'my-grpc-route', run: + + $ gcloud network-services grpc-routes delete my-grpc-route \ + --location=global + +POSITIONAL ARGUMENTS + Grpc route resource - Name of the grpc route you want to delete. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument grpc_route on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + GRPC_ROUTE + ID of the grpc route or fully qualified identifier for the grpc + route. To set the grpc_route attribute: + ▸ provide the argument grpc_route 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 grpc_route 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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services grpc-routes delete + diff --git a/gcloud/network-services/grpc-routes/describe b/gcloud/network-services/grpc-routes/describe new file mode 100644 index 000000000..3bdbd28ef --- /dev/null +++ b/gcloud/network-services/grpc-routes/describe @@ -0,0 +1,61 @@ +NAME + gcloud network-services grpc-routes describe - describe a grpc route + +SYNOPSIS + gcloud network-services grpc-routes describe + (GRPC_ROUTE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details of a grpc route. + +EXAMPLES + Show details about a grpc route named 'my-grpc-route'. + + $ gcloud network-services grpc-routes describe my-grpc-route \ + --location=global + +POSITIONAL ARGUMENTS + Grpc route resource - Name of the grpc route to be described. 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 grpc_route on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + GRPC_ROUTE + ID of the grpc route or fully qualified identifier for the grpc + route. To set the grpc_route attribute: + ▸ provide the argument grpc_route 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 grpc_route 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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services grpc-routes describe + diff --git a/gcloud/network-services/grpc-routes/export b/gcloud/network-services/grpc-routes/export new file mode 100644 index 000000000..901e4bf13 --- /dev/null +++ b/gcloud/network-services/grpc-routes/export @@ -0,0 +1,70 @@ +NAME + gcloud network-services grpc-routes export - export grpc route + +SYNOPSIS + gcloud network-services grpc-routes export + (GRPC_ROUTE : --location=LOCATION) [--destination=DESTINATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Export a grpc route. + +EXAMPLES + To export a grpc route named 'my-grpc-route' to a YAML file, run: + + $ gcloud network-services grpc-routes export my-grpc-route \ + --destination=my-grpc-route.yaml --location=global + +POSITIONAL ARGUMENTS + Grpc route resource - Name of the grpc route to export. 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 grpc_route on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + GRPC_ROUTE + ID of the grpc route or fully qualified identifier for the grpc + route. To set the grpc_route attribute: + ▸ provide the argument grpc_route 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 grpc_route on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --destination=DESTINATION + Path to a YAML file where the configuration will be exported. The + exported data will not contain any output-only fields. Alternatively, + you may omit this flag to write to standard output. For a schema + describing the export/import format, see + $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + +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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services grpc-routes export + diff --git a/gcloud/network-services/grpc-routes/help b/gcloud/network-services/grpc-routes/help new file mode 100644 index 000000000..6b7ae5b72 --- /dev/null +++ b/gcloud/network-services/grpc-routes/help @@ -0,0 +1,37 @@ +NAME + gcloud network-services grpc-routes - manage Network Services GrpcRoutes + +SYNOPSIS + gcloud network-services grpc-routes COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Network Services GrpcRoutes. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + Delete grpc route. + + describe + Describe a grpc route. + + export + Export grpc route. + + import + Import grpc route. + + list + List grpc routes. + +NOTES + This variant is also available: + + $ gcloud alpha network-services grpc-routes + diff --git a/gcloud/network-services/grpc-routes/import b/gcloud/network-services/grpc-routes/import new file mode 100644 index 000000000..2ea58377c --- /dev/null +++ b/gcloud/network-services/grpc-routes/import @@ -0,0 +1,77 @@ +NAME + gcloud network-services grpc-routes import - import grpc route + +SYNOPSIS + gcloud network-services grpc-routes import + (GRPC_ROUTE : --location=LOCATION) [--async] [--source=SOURCE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Import a grpc route. + +EXAMPLES + To import a grpc route named 'my-grpc-route' from a YAML file, run: + + $ gcloud network-services grpc-routes import my-grpc-route \ + --source=my-grpc-route.yaml --location=global + +POSITIONAL ARGUMENTS + Grpc route resource - Name of the grpc route to import. 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 grpc_route on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + GRPC_ROUTE + ID of the grpc route or fully qualified identifier for the grpc + route. To set the grpc_route attribute: + ▸ provide the argument grpc_route 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 grpc_route on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --source=SOURCE + Path to a YAML file containing the configuration export data. The YAML + file must not contain any output-only fields. Alternatively, you may + omit this flag to read from standard input. For a schema describing the + export/import format, see: $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + + $CLOUDSDKROOT is can be obtained with the following command: + + $ gcloud info --format='value(installation.sdk_root)' + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services grpc-routes import + diff --git a/gcloud/network-services/grpc-routes/list b/gcloud/network-services/grpc-routes/list new file mode 100644 index 000000000..44c7180a1 --- /dev/null +++ b/gcloud/network-services/grpc-routes/list @@ -0,0 +1,82 @@ +NAME + gcloud network-services grpc-routes list - list grpc routes + +SYNOPSIS + gcloud network-services grpc-routes list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all grpc routes in the specified location of the current project. + +EXAMPLES + To list grpc routes in the current project, run: + + $ gcloud network-services grpc-routes list --location=global + +REQUIRED FLAGS + Location resource - The project of the grpc routes 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; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + 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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services grpc-routes list + diff --git a/gcloud/network-services/help b/gcloud/network-services/help index d4e34b8ea..892223f01 100644 --- a/gcloud/network-services/help +++ b/gcloud/network-services/help @@ -18,9 +18,24 @@ GROUPS endpoint-policies Manage Network Services EndpointPolicies. + gateways + Manage Network Services Gateways. + + grpc-routes + Manage Network Services GrpcRoutes. + + http-routes + Manage Network Services HttpRoutes. + + meshes + Manage Network Services Meshes. + service-bindings Manage Network Services Bindings. + tcp-routes + Manage Network Services TcpRoutes. + NOTES These variants are also available: diff --git a/gcloud/network-services/http-routes/delete b/gcloud/network-services/http-routes/delete new file mode 100644 index 000000000..7dc8ae557 --- /dev/null +++ b/gcloud/network-services/http-routes/delete @@ -0,0 +1,66 @@ +NAME + gcloud network-services http-routes delete - delete http route + +SYNOPSIS + gcloud network-services http-routes delete + (HTTP_ROUTE : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete the specified http route. + +EXAMPLES + To delete a route named 'my-route', run: + + $ gcloud network-services http-routes delete my-route \ + --location=global + +POSITIONAL ARGUMENTS + Http route resource - Name of the http route you want to delete. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument http_route on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + HTTP_ROUTE + ID of the http route or fully qualified identifier for the http + route. To set the http_route attribute: + ▸ provide the argument http_route 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 http_route 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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services http-routes delete + diff --git a/gcloud/network-services/http-routes/describe b/gcloud/network-services/http-routes/describe new file mode 100644 index 000000000..674a4529f --- /dev/null +++ b/gcloud/network-services/http-routes/describe @@ -0,0 +1,61 @@ +NAME + gcloud network-services http-routes describe - describe a HTTP route + +SYNOPSIS + gcloud network-services http-routes describe + (HTTP_ROUTE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details of a HTTP route. + +EXAMPLES + Show details about a HTTP route named 'my-http-route'. + + $ gcloud network-services http-routes describe my-http-route \ + --location=global + +POSITIONAL ARGUMENTS + Http route resource - Name of the HTTP route to be described. 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 http_route on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + HTTP_ROUTE + ID of the http route or fully qualified identifier for the http + route. To set the http_route attribute: + ▸ provide the argument http_route 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 http_route 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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services http-routes describe + diff --git a/gcloud/network-services/http-routes/export b/gcloud/network-services/http-routes/export new file mode 100644 index 000000000..52b17257b --- /dev/null +++ b/gcloud/network-services/http-routes/export @@ -0,0 +1,70 @@ +NAME + gcloud network-services http-routes export - export http route + +SYNOPSIS + gcloud network-services http-routes export + (HTTP_ROUTE : --location=LOCATION) [--destination=DESTINATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Export a http route. + +EXAMPLES + To export a route named 'my-route' to a YAML file, run: + + $ gcloud network-services http-routes export my-route \ + --destination=my-route.yaml --location=global + +POSITIONAL ARGUMENTS + Http route resource - Name of the http route to export. 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 http_route on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + HTTP_ROUTE + ID of the http route or fully qualified identifier for the http + route. To set the http_route attribute: + ▸ provide the argument http_route 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 http_route on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --destination=DESTINATION + Path to a YAML file where the configuration will be exported. The + exported data will not contain any output-only fields. Alternatively, + you may omit this flag to write to standard output. For a schema + describing the export/import format, see + $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + +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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services http-routes export + diff --git a/gcloud/network-services/http-routes/help b/gcloud/network-services/http-routes/help new file mode 100644 index 000000000..43a11556d --- /dev/null +++ b/gcloud/network-services/http-routes/help @@ -0,0 +1,37 @@ +NAME + gcloud network-services http-routes - manage Network Services HttpRoutes + +SYNOPSIS + gcloud network-services http-routes COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Network Services HttpRoutes. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + Delete http route. + + describe + Describe a HTTP route. + + export + Export http route. + + import + Import http route. + + list + List http routes. + +NOTES + This variant is also available: + + $ gcloud alpha network-services http-routes + diff --git a/gcloud/network-services/http-routes/import b/gcloud/network-services/http-routes/import new file mode 100644 index 000000000..6ec781a45 --- /dev/null +++ b/gcloud/network-services/http-routes/import @@ -0,0 +1,77 @@ +NAME + gcloud network-services http-routes import - import http route + +SYNOPSIS + gcloud network-services http-routes import + (HTTP_ROUTE : --location=LOCATION) [--async] [--source=SOURCE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Import a http route. + +EXAMPLES + To import a route named 'my-route' from a YAML file, run: + + $ gcloud network-services http-routes import my-route \ + --source=my-route.yaml --location=global + +POSITIONAL ARGUMENTS + Http route resource - Name of the http route to import. 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 http_route on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + HTTP_ROUTE + ID of the http route or fully qualified identifier for the http + route. To set the http_route attribute: + ▸ provide the argument http_route 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 http_route on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --source=SOURCE + Path to a YAML file containing the configuration export data. The YAML + file must not contain any output-only fields. Alternatively, you may + omit this flag to read from standard input. For a schema describing the + export/import format, see: $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + + $CLOUDSDKROOT is can be obtained with the following command: + + $ gcloud info --format='value(installation.sdk_root)' + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services http-routes import + diff --git a/gcloud/network-services/http-routes/list b/gcloud/network-services/http-routes/list new file mode 100644 index 000000000..6e9401d41 --- /dev/null +++ b/gcloud/network-services/http-routes/list @@ -0,0 +1,82 @@ +NAME + gcloud network-services http-routes list - list http routes + +SYNOPSIS + gcloud network-services http-routes list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all http routes in the specified location of the current project. + +EXAMPLES + To list meshes in the current project, run: + + $ gcloud network-services http-routes list --location=global + +REQUIRED FLAGS + Location resource - The project of the http routes 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; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + 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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services http-routes list + diff --git a/gcloud/network-services/meshes/delete b/gcloud/network-services/meshes/delete new file mode 100644 index 000000000..3aeea32d7 --- /dev/null +++ b/gcloud/network-services/meshes/delete @@ -0,0 +1,65 @@ +NAME + gcloud network-services meshes delete - delete a mesh + +SYNOPSIS + gcloud network-services meshes delete (MESH : --location=LOCATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete the specified mesh. + +EXAMPLES + To delete a mesh named 'my-mesh', run: + + $ gcloud network-services meshes delete my-mesh --location=global + +POSITIONAL ARGUMENTS + Mesh resource - Name of the mesh you want to delete. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. To set the project attribute: + ◆ provide the argument mesh on the command line with a fully specified + name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + MESH + ID of the mesh or fully qualified identifier for the mesh. To set the + mesh attribute: + ▸ provide the argument mesh on the command line. + + 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 mesh 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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services meshes delete + diff --git a/gcloud/network-services/meshes/describe b/gcloud/network-services/meshes/describe new file mode 100644 index 000000000..7d8e17ed7 --- /dev/null +++ b/gcloud/network-services/meshes/describe @@ -0,0 +1,60 @@ +NAME + gcloud network-services meshes describe - describe a mesh + +SYNOPSIS + gcloud network-services meshes describe (MESH : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details of a mesh. + +EXAMPLES + Show details about a mesh named 'my-mesh'. + + $ gcloud network-services meshes describe my-mesh --location=global + +POSITIONAL ARGUMENTS + Mesh resource - Name of the mesh to be described. 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 mesh on the command line with a fully specified + name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + MESH + ID of the mesh or fully qualified identifier for the mesh. To set the + mesh attribute: + ▸ provide the argument mesh on the command line. + + 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 mesh 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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services meshes describe + diff --git a/gcloud/network-services/meshes/export b/gcloud/network-services/meshes/export new file mode 100644 index 000000000..5f3a36fe4 --- /dev/null +++ b/gcloud/network-services/meshes/export @@ -0,0 +1,69 @@ +NAME + gcloud network-services meshes export - export a mesh + +SYNOPSIS + gcloud network-services meshes export (MESH : --location=LOCATION) + [--destination=DESTINATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Export a mesh. + +EXAMPLES + To export a mesh named 'my-mesh' to a YAML file, run: + + $ gcloud network-services meshes export my-mesh \ + --destination=my-mesh.yaml --location=global + +POSITIONAL ARGUMENTS + Mesh resource - Name of the mesh to export. 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 mesh on the command line with a fully specified + name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + MESH + ID of the mesh or fully qualified identifier for the mesh. To set the + mesh attribute: + ▸ provide the argument mesh on the command line. + + 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 mesh on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --destination=DESTINATION + Path to a YAML file where the configuration will be exported. The + exported data will not contain any output-only fields. Alternatively, + you may omit this flag to write to standard output. For a schema + describing the export/import format, see + $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + +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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services meshes export + diff --git a/gcloud/network-services/meshes/help b/gcloud/network-services/meshes/help new file mode 100644 index 000000000..46cbe4432 --- /dev/null +++ b/gcloud/network-services/meshes/help @@ -0,0 +1,37 @@ +NAME + gcloud network-services meshes - manage Network Services Meshes + +SYNOPSIS + gcloud network-services meshes COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Network Services Meshes. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + Delete a mesh. + + describe + Describe a mesh. + + export + Export a mesh. + + import + Import a mesh. + + list + List meshes. + +NOTES + This variant is also available: + + $ gcloud alpha network-services meshes + diff --git a/gcloud/network-services/meshes/import b/gcloud/network-services/meshes/import new file mode 100644 index 000000000..e82c6c272 --- /dev/null +++ b/gcloud/network-services/meshes/import @@ -0,0 +1,76 @@ +NAME + gcloud network-services meshes import - import a mesh + +SYNOPSIS + gcloud network-services meshes import (MESH : --location=LOCATION) + [--async] [--source=SOURCE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Import a mesh. + +EXAMPLES + To import a mesh named 'my-mesh' from a YAML file, run: + + $ gcloud network-services meshes import my-mesh \ + --source=my-mesh.yaml --location=global + +POSITIONAL ARGUMENTS + Mesh resource - Name of the mesh to import. 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 mesh on the command line with a fully specified + name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + MESH + ID of the mesh or fully qualified identifier for the mesh. To set the + mesh attribute: + ▸ provide the argument mesh on the command line. + + 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 mesh on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --source=SOURCE + Path to a YAML file containing the configuration export data. The YAML + file must not contain any output-only fields. Alternatively, you may + omit this flag to read from standard input. For a schema describing the + export/import format, see: $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + + $CLOUDSDKROOT is can be obtained with the following command: + + $ gcloud info --format='value(installation.sdk_root)' + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services meshes import + diff --git a/gcloud/network-services/meshes/list b/gcloud/network-services/meshes/list new file mode 100644 index 000000000..edfc8715a --- /dev/null +++ b/gcloud/network-services/meshes/list @@ -0,0 +1,81 @@ +NAME + gcloud network-services meshes list - list meshes + +SYNOPSIS + gcloud network-services meshes list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all meshes in the specified location of the current project. + +EXAMPLES + To list meshes in the current project, run: + + $ gcloud network-services meshes list --location=global + +REQUIRED FLAGS + Location resource - The project of the meshes 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; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + 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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services meshes list + diff --git a/gcloud/network-services/tcp-routes/delete b/gcloud/network-services/tcp-routes/delete new file mode 100644 index 000000000..24245b8f3 --- /dev/null +++ b/gcloud/network-services/tcp-routes/delete @@ -0,0 +1,66 @@ +NAME + gcloud network-services tcp-routes delete - delete tcp route + +SYNOPSIS + gcloud network-services tcp-routes delete (TCP_ROUTE : --location=LOCATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete the specified tcp route. + +EXAMPLES + To delete a tcp route named 'my-tcp-route', run: + + $ gcloud network-services tcp-routes delete my-tcp-route \ + --location=global + +POSITIONAL ARGUMENTS + Tcp route resource - Name of the tcp route you want to delete. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument tcp_route on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + TCP_ROUTE + ID of the tcp route or fully qualified identifier for the tcp route. + To set the tcp_route attribute: + ▸ provide the argument tcp_route 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 tcp_route 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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services tcp-routes delete + diff --git a/gcloud/network-services/tcp-routes/describe b/gcloud/network-services/tcp-routes/describe new file mode 100644 index 000000000..879542ae5 --- /dev/null +++ b/gcloud/network-services/tcp-routes/describe @@ -0,0 +1,61 @@ +NAME + gcloud network-services tcp-routes describe - describe a TCP route + +SYNOPSIS + gcloud network-services tcp-routes describe + (TCP_ROUTE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details of a TCP route. + +EXAMPLES + Show details about a TCP route named 'my-tcp-route'. + + $ gcloud network-services tcp-routes describe my-tcp-route \ + --location=global + +POSITIONAL ARGUMENTS + Tcp route resource - Name of the TCP route to be described. 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 tcp_route on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + TCP_ROUTE + ID of the tcp route or fully qualified identifier for the tcp route. + To set the tcp_route attribute: + ▸ provide the argument tcp_route 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 tcp_route 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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services tcp-routes describe + diff --git a/gcloud/network-services/tcp-routes/export b/gcloud/network-services/tcp-routes/export new file mode 100644 index 000000000..4767ea572 --- /dev/null +++ b/gcloud/network-services/tcp-routes/export @@ -0,0 +1,69 @@ +NAME + gcloud network-services tcp-routes export - export tcp route + +SYNOPSIS + gcloud network-services tcp-routes export (TCP_ROUTE : --location=LOCATION) + [--destination=DESTINATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Export a tcp route. + +EXAMPLES + To export a tcp route named 'my-tcp-route' to a YAML file, run: + + $ gcloud network-services tcp-routes export my-tcp-route \ + --destination=my-tcp-route.yaml --location=global + +POSITIONAL ARGUMENTS + Tcp route resource - Name of the tcp route to export. 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 tcp_route on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + TCP_ROUTE + ID of the tcp route or fully qualified identifier for the tcp route. + To set the tcp_route attribute: + ▸ provide the argument tcp_route 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 tcp_route on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --destination=DESTINATION + Path to a YAML file where the configuration will be exported. The + exported data will not contain any output-only fields. Alternatively, + you may omit this flag to write to standard output. For a schema + describing the export/import format, see + $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + +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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services tcp-routes export + diff --git a/gcloud/network-services/tcp-routes/help b/gcloud/network-services/tcp-routes/help new file mode 100644 index 000000000..6ba5b1b76 --- /dev/null +++ b/gcloud/network-services/tcp-routes/help @@ -0,0 +1,37 @@ +NAME + gcloud network-services tcp-routes - manage Network Services TcpRoutes + +SYNOPSIS + gcloud network-services tcp-routes COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Network Services TcpRoutes. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + Delete tcp route. + + describe + Describe a TCP route. + + export + Export tcp route. + + import + Import tcp route. + + list + List tcp routes. + +NOTES + This variant is also available: + + $ gcloud alpha network-services tcp-routes + diff --git a/gcloud/network-services/tcp-routes/import b/gcloud/network-services/tcp-routes/import new file mode 100644 index 000000000..17926538a --- /dev/null +++ b/gcloud/network-services/tcp-routes/import @@ -0,0 +1,76 @@ +NAME + gcloud network-services tcp-routes import - import tcp route + +SYNOPSIS + gcloud network-services tcp-routes import (TCP_ROUTE : --location=LOCATION) + [--async] [--source=SOURCE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Import a tcp route. + +EXAMPLES + To import a tcp route named 'my-tcp-route' from a YAML file, run: + + $ gcloud network-services tcp-routes import my-tcp-route \ + --source=my-tcp-route.yaml --location=global + +POSITIONAL ARGUMENTS + Tcp route resource - Name of the tcp route to import. 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 tcp_route on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + TCP_ROUTE + ID of the tcp route or fully qualified identifier for the tcp route. + To set the tcp_route attribute: + ▸ provide the argument tcp_route 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 tcp_route on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --source=SOURCE + Path to a YAML file containing the configuration export data. The YAML + file must not contain any output-only fields. Alternatively, you may + omit this flag to read from standard input. For a schema describing the + export/import format, see: $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + + $CLOUDSDKROOT is can be obtained with the following command: + + $ gcloud info --format='value(installation.sdk_root)' + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services tcp-routes import + diff --git a/gcloud/network-services/tcp-routes/list b/gcloud/network-services/tcp-routes/list new file mode 100644 index 000000000..a9b1240bd --- /dev/null +++ b/gcloud/network-services/tcp-routes/list @@ -0,0 +1,82 @@ +NAME + gcloud network-services tcp-routes list - list tcp routes + +SYNOPSIS + gcloud network-services tcp-routes list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all tcp routes in the specified location of the current project. + +EXAMPLES + To list tcp routes in the current project, run: + + $ gcloud network-services tcp-routes list --location=global + +REQUIRED FLAGS + Location resource - The project of the tcp routes 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; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + 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/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services tcp-routes list + diff --git a/gcloud/redis/instances/create b/gcloud/redis/instances/create index 58febcf10..646e29087 100644 --- a/gcloud/redis/instances/create +++ b/gcloud/redis/instances/create @@ -4,8 +4,10 @@ NAME SYNOPSIS gcloud redis instances create (INSTANCE : --region=REGION) [--alternative-zone=ALTERNATIVE_ZONE] [--async] - [--connect-mode=CONNECT_MODE] [--display-name=DISPLAY_NAME] - [--enable-auth] [--labels=[KEY=VALUE,...]] + [--connect-mode=CONNECT_MODE] + [--customer-managed-key=CUSTOMER_MANAGED_KEY] + [--display-name=DISPLAY_NAME] [--enable-auth] + [--labels=[KEY=VALUE,...]] [--maintenance-window-day=MAINTENANCE_WINDOW_DAY] [--maintenance-window-hour=MAINTENANCE_WINDOW_HOUR] [--network=NETWORK; default="default"] @@ -79,6 +81,10 @@ FLAGS Network connection mode used by instances. CONNECT_MODE must be one of: connect-mode-unspecified, direct-peering, private-service-access. + --customer-managed-key=CUSTOMER_MANAGED_KEY + The KMS key reference that you want to use to encrypt the data at rest + for this Redis instance. If this is provided, CMEK is enabled. + --display-name=DISPLAY_NAME A human-readable name for the instance. diff --git a/gcloud/sql/instances/create b/gcloud/sql/instances/create index adab763c5..8c068b07c 100644 --- a/gcloud/sql/instances/create +++ b/gcloud/sql/instances/create @@ -14,6 +14,7 @@ SYNOPSIS [--backup-start-time=BACKUP_START_TIME] [--collation=COLLATION] [--cpu=CPU] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] [--database-version=DATABASE_VERSION; default="MYSQL_8_0"] + [--[no-]deletion-protection] [--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] @@ -173,6 +174,12 @@ FLAGS SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE. + --[no-]deletion-protection + Enable deletion protection on a Cloud SQL instance. Use + --deletion-protection to enable deletion protection on an instance and + --no-deletion-protection to disable it. Use --deletion-protection to + enable and --no-deletion-protection to disable. + --deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE Date when the deny maintenance period ends, that is 2021-01-10. diff --git a/gcloud/sql/instances/patch b/gcloud/sql/instances/patch index ca868a182..acd3b85b6 100644 --- a/gcloud/sql/instances/patch +++ b/gcloud/sql/instances/patch @@ -9,6 +9,7 @@ SYNOPSIS [--audit-upload-interval=AUDIT_UPLOAD_INTERVAL] [--availability-type=AVAILABILITY_TYPE] [--clear-password-policy] [--cpu=CPU] [--database-version=DATABASE_VERSION] + [--[no-]deletion-protection] [--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] [--diff] @@ -120,6 +121,12 @@ FLAGS SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE. + --[no-]deletion-protection + Enable deletion protection on a Cloud SQL instance. Use + --deletion-protection to enable deletion protection on an instance and + --no-deletion-protection to disable it. Use --deletion-protection to + enable and --no-deletion-protection to disable. + --deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE Date when the deny maintenance period ends, that is 2021-01-10.