diff --git a/gcloud/_version b/gcloud/_version index 2b2614885..3899073a9 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 417.0.1 -alpha 2023.02.08 -beta 2023.02.08 -bq 2.0.84 +Google Cloud SDK 418.0.0 +alpha 2023.02.13 +beta 2023.02.13 +bq 2.0.85 bundled-python3-unix 3.9.16 -core 2023.02.08 +core 2023.02.13 gcloud-crc32c 1.0.0 -gsutil 5.19 +gsutil 5.20 diff --git a/gcloud/ai-platform/jobs/submit/training b/gcloud/ai-platform/jobs/submit/training index 919612581..b6420b9a3 100644 --- a/gcloud/ai-platform/jobs/submit/training +++ b/gcloud/ai-platform/jobs/submit/training @@ -352,13 +352,15 @@ FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/ai/custom-jobs/create b/gcloud/ai/custom-jobs/create index 40001efa1..5006517d5 100644 --- a/gcloud/ai/custom-jobs/create +++ b/gcloud/ai/custom-jobs/create @@ -243,13 +243,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/ai/hp-tuning-jobs/create b/gcloud/ai/hp-tuning-jobs/create index b9477b91c..626638414 100644 --- a/gcloud/ai/hp-tuning-jobs/create +++ b/gcloud/ai/hp-tuning-jobs/create @@ -137,13 +137,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/ai/model-monitoring-jobs/create b/gcloud/ai/model-monitoring-jobs/create index 87ec7ba1a..dfa09453b 100644 --- a/gcloud/ai/model-monitoring-jobs/create +++ b/gcloud/ai/model-monitoring-jobs/create @@ -175,13 +175,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/ai/models/copy b/gcloud/ai/models/copy new file mode 100644 index 000000000..1c8555863 --- /dev/null +++ b/gcloud/ai/models/copy @@ -0,0 +1,78 @@ +NAME + gcloud ai models copy - copy a model + +SYNOPSIS + gcloud ai models copy --source-model=SOURCE_MODEL + [--kms-key-name=KMS_KEY_NAME] [--region=REGION] + [--destination-model-id=DESTINATION_MODEL_ID + | --destination-parent-model=DESTINATION_PARENT_MODEL] + [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + To copy a model 123 of project example from region us-central1 to region + europe-west4, run: + + $ gcloud ai models copy \ + --source-model=projects/example/locations/us-central1/models/\ + 123 --region=projects/example/locations/europe-west4 + +REQUIRED FLAGS + --source-model=SOURCE_MODEL + The resource name of the Model to copy. That Model must be in the same + Project. Format: + projects/{project}/locations/{location}/models/{model}. + +OPTIONAL FLAGS + --kms-key-name=KMS_KEY_NAME + The Cloud KMS resource identifier of the customer managed encryption + key used to protect the 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 the destination region of the + model to be copied. + + Region resource - Cloud region to copy the model into. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. To set the project attribute: + ◆ provide the argument --region on the command line with a fully + specified name; + ◆ set the property ai/region with a fully specified name; + ◆ choose one from the prompted list of available regions with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --region=REGION + ID of the region or fully qualified identifier for the region. To set + the region attribute: + ▸ provide the argument --region on the command line; + ▸ set the property ai/region; + ▸ choose one from the prompted list of available regions. + + At most one of these can be specified: + + --destination-model-id=DESTINATION_MODEL_ID + Copy source_model into a new Model with this ID. The ID will become + the final component of the model resource name. This value may be up + to 63 characters, and valid characters are [a-z0-9-]. The first + character cannot be a number or hyphen. + + --destination-parent-model=DESTINATION_PARENT_MODEL + Specify this field to copy source_model into this existing Model as a + new version. Format: + projects/{project}/locations/{location}/models/{model}. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha ai models copy + + $ gcloud beta ai models copy + diff --git a/gcloud/ai/models/help b/gcloud/ai/models/help index 11dd9e560..2059cbe22 100644 --- a/gcloud/ai/models/help +++ b/gcloud/ai/models/help @@ -15,6 +15,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + copy + Copy a model. + delete Delete an existing Vertex AI model. diff --git a/gcloud/ai/tensorboards/create b/gcloud/ai/tensorboards/create index 2a195d5fb..da7cf5129 100644 --- a/gcloud/ai/tensorboards/create +++ b/gcloud/ai/tensorboards/create @@ -81,13 +81,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/alloydb/backups/create b/gcloud/alloydb/backups/create index 330d861a7..dc5979c59 100644 --- a/gcloud/alloydb/backups/create +++ b/gcloud/alloydb/backups/create @@ -56,13 +56,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/alloydb/clusters/create b/gcloud/alloydb/clusters/create index 37d8fb3bd..0f70ec068 100644 --- a/gcloud/alloydb/clusters/create +++ b/gcloud/alloydb/clusters/create @@ -106,7 +106,7 @@ OPTIONAL FLAGS --automated-backup-encryption-key-keyring on the command line. --automated-backup-encryption-key-location=AUTOMATED_BACKUP_ENCRYPTION_KEY_LOCATION - The Cloud location for the key. To set the kms-location + The Google Cloud location for the key. To set the kms-location attribute: ◇ provide the argument --automated-backup-encryption-key on the command line with a fully specified name; @@ -114,7 +114,8 @@ OPTIONAL FLAGS --automated-backup-encryption-key-location on the command line. --automated-backup-encryption-key-project=AUTOMATED_BACKUP_ENCRYPTION_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ◇ provide the argument --automated-backup-encryption-key on the command line with a fully specified name; ◇ provide the argument @@ -154,13 +155,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/alloydb/clusters/restore b/gcloud/alloydb/clusters/restore index 16c0917bc..71aa69727 100644 --- a/gcloud/alloydb/clusters/restore +++ b/gcloud/alloydb/clusters/restore @@ -63,13 +63,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/alloydb/clusters/update b/gcloud/alloydb/clusters/update index 5d18de9b9..cc2f3a3c8 100644 --- a/gcloud/alloydb/clusters/update +++ b/gcloud/alloydb/clusters/update @@ -99,7 +99,7 @@ OPTIONAL FLAGS --automated-backup-encryption-key-keyring on the command line. --automated-backup-encryption-key-location=AUTOMATED_BACKUP_ENCRYPTION_KEY_LOCATION - The Cloud location for the key. To set the kms-location + The Google Cloud location for the key. To set the kms-location attribute: ◇ provide the argument --automated-backup-encryption-key on the command line with a fully specified name; @@ -107,7 +107,8 @@ OPTIONAL FLAGS --automated-backup-encryption-key-location on the command line. --automated-backup-encryption-key-project=AUTOMATED_BACKUP_ENCRYPTION_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ◇ provide the argument --automated-backup-encryption-key on the command line with a fully specified name; ◇ provide the argument diff --git a/gcloud/alloydb/instances/create b/gcloud/alloydb/instances/create index c6cfee57e..41cdf9ed0 100644 --- a/gcloud/alloydb/instances/create +++ b/gcloud/alloydb/instances/create @@ -7,6 +7,10 @@ SYNOPSIS --cpu-count=CPU_COUNT --instance-type=INSTANCE_TYPE --region=REGION [--async] [--availability-type=AVAILABILITY_TYPE] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] + [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] + [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] + [--[no-]insights-config-record-application-tags] + [--[no-]insights-config-record-client-address] [--read-pool-node-count=READ_POOL_NODE_COUNT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -76,6 +80,27 @@ OPTIONAL FLAGS API for allowed flags. (e.g., --database-flags max_allowed_packet=55555,skip_grant_tables=,log_output=1) + --insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE + Number of query plans to sample every minute. Default value is 5. + Allowed range: 0 to 20. + + --insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH + Query string length in bytes to be stored by the query insights + feature. Default length is 1024 bytes. Allowed range: 256 to 4500 + bytes. + + --[no-]insights-config-record-application-tags + Allow application tags to be recorded by the query insights feature. + + Use --insights-config-record-application-tags to enable and + --no-insights-config-record-application-tags to disable. + + --[no-]insights-config-record-client-address + Allow the client address to be recorded by the query insights feature. + + Use --insights-config-record-client-address to enable and + --no-insights-config-record-client-address to disable. + --read-pool-node-count=READ_POOL_NODE_COUNT Read capacity, i.e. number of nodes in a read pool instance. diff --git a/gcloud/alloydb/instances/update b/gcloud/alloydb/instances/update index 16e1e92c0..2bc81a857 100644 --- a/gcloud/alloydb/instances/update +++ b/gcloud/alloydb/instances/update @@ -6,6 +6,10 @@ SYNOPSIS gcloud alloydb instances update INSTANCE --cluster=CLUSTER --region=REGION [--async] [--availability-type=AVAILABILITY_TYPE] [--cpu-count=CPU_COUNT] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] + [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] + [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] + [--[no-]insights-config-record-application-tags] + [--[no-]insights-config-record-client-address] [--read-pool-node-count=READ_POOL_NODE_COUNT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -58,6 +62,27 @@ OPTIONAL FLAGS API for allowed flags. (e.g., --database-flags max_allowed_packet=55555,skip_grant_tables=,log_output=1) + --insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE + Number of query plans to sample every minute. Default value is 5. + Allowed range: 0 to 20. + + --insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH + Query string length in bytes to be stored by the query insights + feature. Default length is 1024 bytes. Allowed range: 256 to 4500 + bytes. + + --[no-]insights-config-record-application-tags + Allow application tags to be recorded by the query insights feature. + + Use --insights-config-record-application-tags to enable and + --no-insights-config-record-application-tags to disable. + + --[no-]insights-config-record-client-address + Allow the client address to be recorded by the query insights feature. + + Use --insights-config-record-client-address to enable and + --no-insights-config-record-client-address to disable. + --read-pool-node-count=READ_POOL_NODE_COUNT Read capacity, i.e. number of nodes in a read pool instance. diff --git a/gcloud/alpha/ai-platform/jobs/submit/training b/gcloud/alpha/ai-platform/jobs/submit/training index 0b17b582a..30526178a 100644 --- a/gcloud/alpha/ai-platform/jobs/submit/training +++ b/gcloud/alpha/ai-platform/jobs/submit/training @@ -369,13 +369,15 @@ FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/alpha/ai/custom-jobs/create b/gcloud/alpha/ai/custom-jobs/create index 45f241057..e932bdda0 100644 --- a/gcloud/alpha/ai/custom-jobs/create +++ b/gcloud/alpha/ai/custom-jobs/create @@ -244,13 +244,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/alpha/ai/hp-tuning-jobs/create b/gcloud/alpha/ai/hp-tuning-jobs/create index 9b5f3089e..123fab2e5 100644 --- a/gcloud/alpha/ai/hp-tuning-jobs/create +++ b/gcloud/alpha/ai/hp-tuning-jobs/create @@ -137,13 +137,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/alpha/ai/model-monitoring-jobs/create b/gcloud/alpha/ai/model-monitoring-jobs/create index ad999a42e..67b798e84 100644 --- a/gcloud/alpha/ai/model-monitoring-jobs/create +++ b/gcloud/alpha/ai/model-monitoring-jobs/create @@ -175,13 +175,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/alpha/ai/models/copy b/gcloud/alpha/ai/models/copy index 0a2807893..f9f1e0d75 100644 --- a/gcloud/alpha/ai/models/copy +++ b/gcloud/alpha/ai/models/copy @@ -27,8 +27,8 @@ OPTIONAL FLAGS The Cloud KMS resource identifier of the customer managed encryption key used to protect the 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. + The key needs to be in the same region as the destination region of the + model to be copied. Region resource - Cloud region to copy the model into. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this @@ -73,7 +73,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud ai models copy $ gcloud beta ai models copy diff --git a/gcloud/alpha/ai/tensorboards/create b/gcloud/alpha/ai/tensorboards/create index 7431c6e08..7fe9a1ca5 100644 --- a/gcloud/alpha/ai/tensorboards/create +++ b/gcloud/alpha/ai/tensorboards/create @@ -67,13 +67,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/alpha/alloydb/backups/create b/gcloud/alpha/alloydb/backups/create index 9a2a1a8bf..663750e9f 100644 --- a/gcloud/alpha/alloydb/backups/create +++ b/gcloud/alpha/alloydb/backups/create @@ -56,13 +56,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/alpha/alloydb/clusters/create b/gcloud/alpha/alloydb/clusters/create index 9637b6d6d..3f0c1f5ab 100644 --- a/gcloud/alpha/alloydb/clusters/create +++ b/gcloud/alpha/alloydb/clusters/create @@ -84,14 +84,16 @@ OPTIONAL FLAGS on the command line. --continuous-backup-encryption-key-location=CONTINUOUS_BACKUP_ENCRYPTION_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▫ provide the argument --continuous-backup-encryption-key on the command line with a fully specified name; ▫ provide the argument --continuous-backup-encryption-key-location on the command line. --continuous-backup-encryption-key-project=CONTINUOUS_BACKUP_ENCRYPTION_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▫ provide the argument --continuous-backup-encryption-key on the command line with a fully specified name; ▫ provide the argument --continuous-backup-encryption-key-project @@ -156,7 +158,7 @@ OPTIONAL FLAGS --automated-backup-encryption-key-keyring on the command line. --automated-backup-encryption-key-location=AUTOMATED_BACKUP_ENCRYPTION_KEY_LOCATION - The Cloud location for the key. To set the kms-location + The Google Cloud location for the key. To set the kms-location attribute: ◇ provide the argument --automated-backup-encryption-key on the command line with a fully specified name; @@ -164,7 +166,8 @@ OPTIONAL FLAGS --automated-backup-encryption-key-location on the command line. --automated-backup-encryption-key-project=AUTOMATED_BACKUP_ENCRYPTION_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ◇ provide the argument --automated-backup-encryption-key on the command line with a fully specified name; ◇ provide the argument @@ -204,13 +207,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/alpha/alloydb/clusters/create-secondary b/gcloud/alpha/alloydb/clusters/create-secondary index f890a56fa..8f3f6d824 100644 --- a/gcloud/alpha/alloydb/clusters/create-secondary +++ b/gcloud/alpha/alloydb/clusters/create-secondary @@ -58,13 +58,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/alpha/alloydb/clusters/restore b/gcloud/alpha/alloydb/clusters/restore index f568d59c6..1cc9e01d2 100644 --- a/gcloud/alpha/alloydb/clusters/restore +++ b/gcloud/alpha/alloydb/clusters/restore @@ -6,7 +6,7 @@ SYNOPSIS gcloud alpha alloydb clusters restore CLUSTER --region=REGION [--async] [--network=NETWORK] [--backup=BACKUP - : --point-in-time=POINT_IN_TIME --source-cluster=SOURCE_CLUSTER] + | --point-in-time=POINT_IN_TIME --source-cluster=SOURCE_CLUSTER] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] [GCLOUD_WIDE_FLAG ...] @@ -86,13 +86,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/alpha/alloydb/clusters/update b/gcloud/alpha/alloydb/clusters/update index 27b9bb646..f8e02c05f 100644 --- a/gcloud/alpha/alloydb/clusters/update +++ b/gcloud/alpha/alloydb/clusters/update @@ -11,9 +11,8 @@ SYNOPSIS [--automated-backup-encryption-key=AUTOMATED_BACKUP_ENCRYPTION_KEY : --automated-backup-encryption-key-keyring=AUTOMATED_BACKUP_ENCRYPTION_KEY_KEYRING --automated-backup-encryption-key-location=AUTOMATED_BACKUP_ENCRYPTION_KEY_LOCATION --automated-backup-encryption-key-project=AUTOMATED_BACKUP_ENCRYPTION_KEY_PROJECT] --automated-backup-retention-count=RETENTION_COUNT | --automated-backup-retention-period=RETENTION_PERIOD]] [--continuous-backup-recovery-window-days=RECOVERY_PERIOD - --enable-continuous-backup - [--continuous-backup-encryption-key=CONTINUOUS_BACKUP_ENCRYPTION_KEY - : --continuous-backup-encryption-key-keyring=CONTINUOUS_BACKUP_ENCRYPTION_KEY_KEYRING --continuous-backup-encryption-key-location=CONTINUOUS_BACKUP_ENCRYPTION_KEY_LOCATION --continuous-backup-encryption-key-project=CONTINUOUS_BACKUP_ENCRYPTION_KEY_PROJECT]] + --enable-continuous-backup --clear-continuous-backup-encryption-key + | [--continuous-backup-encryption-key=CONTINUOUS_BACKUP_ENCRYPTION_KEY : --continuous-backup-encryption-key-keyring=CONTINUOUS_BACKUP_ENCRYPTION_KEY_KEYRING --continuous-backup-encryption-key-location=CONTINUOUS_BACKUP_ENCRYPTION_KEY_LOCATION --continuous-backup-encryption-key-project=CONTINUOUS_BACKUP_ENCRYPTION_KEY_PROJECT]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -103,7 +102,7 @@ OPTIONAL FLAGS --automated-backup-encryption-key-keyring on the command line. --automated-backup-encryption-key-location=AUTOMATED_BACKUP_ENCRYPTION_KEY_LOCATION - The Cloud location for the key. To set the kms-location + The Google Cloud location for the key. To set the kms-location attribute: ◇ provide the argument --automated-backup-encryption-key on the command line with a fully specified name; @@ -111,7 +110,8 @@ OPTIONAL FLAGS --automated-backup-encryption-key-location on the command line. --automated-backup-encryption-key-project=AUTOMATED_BACKUP_ENCRYPTION_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ◇ provide the argument --automated-backup-encryption-key on the command line with a fully specified name; ◇ provide the argument @@ -139,42 +139,53 @@ OPTIONAL FLAGS --enable-continuous-backup Enables Continuous Backups on the cluster. - Key resource - The Cloud KMS (Key Management Service) cryptokey that - will be used to protect the continuous backup. The 'AlloyDB Service - Agent's service account must hold permission 'Cloud KMS CryptoKey - Encrypter/Decrypter'. The arguments in this group can be used to specify - the attributes of this resource. + Encryption configuration for Continuous Backups. - --continuous-backup-encryption-key=CONTINUOUS_BACKUP_ENCRYPTION_KEY - ID of the key or fully qualified identifier for the key. To set the - kms-key attribute: - ▫ provide the argument --continuous-backup-encryption-key on the - command line. + At most one of these can be specified: - This flag argument must be specified if any of the other arguments - in this group are specified. + --clear-continuous-backup-encryption-key + Clears the encryption configuration for Continuous Backups. Google + default encryption will be used for future Continuous Backups. - --continuous-backup-encryption-key-keyring=CONTINUOUS_BACKUP_ENCRYPTION_KEY_KEYRING - The KMS keyring of the key. To set the kms-keyring attribute: - ▫ provide the argument --continuous-backup-encryption-key on the - command line with a fully specified name; - ▫ provide the argument --continuous-backup-encryption-key-keyring - on the command line. + Key resource - The Cloud KMS (Key Management Service) cryptokey that + will be used to protect the continuous backup. The 'AlloyDB Service + Agent's service account must hold permission 'Cloud KMS CryptoKey + Encrypter/Decrypter'. The arguments in this group can be used to + specify the attributes of this resource. - --continuous-backup-encryption-key-location=CONTINUOUS_BACKUP_ENCRYPTION_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: - ▫ provide the argument --continuous-backup-encryption-key on the - command line with a fully specified name; - ▫ provide the argument - --continuous-backup-encryption-key-location on the command line. + --continuous-backup-encryption-key=CONTINUOUS_BACKUP_ENCRYPTION_KEY + ID of the key or fully qualified identifier for the key. To set + the kms-key attribute: + ◇ provide the argument --continuous-backup-encryption-key on + the command line. - --continuous-backup-encryption-key-project=CONTINUOUS_BACKUP_ENCRYPTION_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: - ▫ provide the argument --continuous-backup-encryption-key on the - command line with a fully specified name; - ▫ provide the argument --continuous-backup-encryption-key-project - on the command line; - ▫ set the property core/project. + This flag argument must be specified if any of the other + arguments in this group are specified. + + --continuous-backup-encryption-key-keyring=CONTINUOUS_BACKUP_ENCRYPTION_KEY_KEYRING + The KMS keyring of the key. To set the kms-keyring attribute: + ◇ provide the argument --continuous-backup-encryption-key on + the command line with a fully specified name; + ◇ provide the argument + --continuous-backup-encryption-key-keyring on the command line. + + --continuous-backup-encryption-key-location=CONTINUOUS_BACKUP_ENCRYPTION_KEY_LOCATION + The Google Cloud location for the key. To set the kms-location + attribute: + ◇ provide the argument --continuous-backup-encryption-key on + the command line with a fully specified name; + ◇ provide the argument + --continuous-backup-encryption-key-location on the command + line. + + --continuous-backup-encryption-key-project=CONTINUOUS_BACKUP_ENCRYPTION_KEY_PROJECT + The Google Cloud project for the key. To set the kms-project + attribute: + ◇ provide the argument --continuous-backup-encryption-key on + the command line with a fully specified name; + ◇ provide the argument + --continuous-backup-encryption-key-project on the command line; + ◇ set the property core/project. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/alloydb/instances/create b/gcloud/alpha/alloydb/instances/create index 1b70f5558..6bc1ff899 100644 --- a/gcloud/alpha/alloydb/instances/create +++ b/gcloud/alpha/alloydb/instances/create @@ -7,6 +7,10 @@ SYNOPSIS --cpu-count=CPU_COUNT --instance-type=INSTANCE_TYPE --region=REGION [--async] [--availability-type=AVAILABILITY_TYPE] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] + [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] + [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] + [--[no-]insights-config-record-application-tags] + [--[no-]insights-config-record-client-address] [--read-pool-node-count=READ_POOL_NODE_COUNT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -77,6 +81,27 @@ OPTIONAL FLAGS API for allowed flags. (e.g., --database-flags max_allowed_packet=55555,skip_grant_tables=,log_output=1) + --insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE + Number of query plans to sample every minute. Default value is 5. + Allowed range: 0 to 20. + + --insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH + Query string length in bytes to be stored by the query insights + feature. Default length is 1024 bytes. Allowed range: 256 to 4500 + bytes. + + --[no-]insights-config-record-application-tags + Allow application tags to be recorded by the query insights feature. + + Use --insights-config-record-application-tags to enable and + --no-insights-config-record-application-tags to disable. + + --[no-]insights-config-record-client-address + Allow the client address to be recorded by the query insights feature. + + Use --insights-config-record-client-address to enable and + --no-insights-config-record-client-address to disable. + --read-pool-node-count=READ_POOL_NODE_COUNT Read capacity, i.e. number of nodes in a read pool instance. diff --git a/gcloud/alpha/alloydb/instances/update b/gcloud/alpha/alloydb/instances/update index 6e8e24360..00f7f86a5 100644 --- a/gcloud/alpha/alloydb/instances/update +++ b/gcloud/alpha/alloydb/instances/update @@ -6,6 +6,10 @@ SYNOPSIS gcloud alpha alloydb instances update INSTANCE --cluster=CLUSTER --region=REGION [--async] [--availability-type=AVAILABILITY_TYPE] [--cpu-count=CPU_COUNT] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] + [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] + [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] + [--[no-]insights-config-record-application-tags] + [--[no-]insights-config-record-client-address] [--read-pool-node-count=READ_POOL_NODE_COUNT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -58,6 +62,27 @@ OPTIONAL FLAGS API for allowed flags. (e.g., --database-flags max_allowed_packet=55555,skip_grant_tables=,log_output=1) + --insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE + Number of query plans to sample every minute. Default value is 5. + Allowed range: 0 to 20. + + --insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH + Query string length in bytes to be stored by the query insights + feature. Default length is 1024 bytes. Allowed range: 256 to 4500 + bytes. + + --[no-]insights-config-record-application-tags + Allow application tags to be recorded by the query insights feature. + + Use --insights-config-record-application-tags to enable and + --no-insights-config-record-application-tags to disable. + + --[no-]insights-config-record-client-address + Allow the client address to be recorded by the query insights feature. + + Use --insights-config-record-client-address to enable and + --no-insights-config-record-client-address to disable. + --read-pool-node-count=READ_POOL_NODE_COUNT Read capacity, i.e. number of nodes in a read pool instance. diff --git a/gcloud/alpha/artifacts/help b/gcloud/alpha/artifacts/help index dc1ddf9f3..28962776b 100644 --- a/gcloud/alpha/artifacts/help +++ b/gcloud/alpha/artifacts/help @@ -48,6 +48,10 @@ GROUPS versions (ALPHA) Manage Artifact Registry package versions. + vpcsc-config + (ALPHA) Manage Artifact Registry VPC Service Controls configuration for + remote repositories. + yum (ALPHA) Manage Artifact Registry RPM packages. diff --git a/gcloud/alpha/artifacts/vpcsc-config/allow b/gcloud/alpha/artifacts/vpcsc-config/allow new file mode 100644 index 000000000..dd0cfb6f5 --- /dev/null +++ b/gcloud/alpha/artifacts/vpcsc-config/allow @@ -0,0 +1,66 @@ +NAME + gcloud alpha artifacts vpcsc-config allow - allow Artifact Registry remote + repositories inside a service perimeter to retrieve data from their + upstream sources outside of the perimeter + +SYNOPSIS + gcloud alpha artifacts vpcsc-config allow [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Allow Artifact Registry remote repositories inside a service + perimeter to retrieve data from their upstream sources outside of the + perimeter. + + This command can fail for the following reasons: + ▪ Lack of permission - "accesscontextmanager.policies.update". + ▪ The resource could be outside of the VPC SC perimeter. + ▪ Lack of permission - "artifactregistry.vpcscconfigs.update" + +EXAMPLES + The following command allows remote repositories in the project my-project + and in the region us--west1 to retrieve data from upstream sources outside + the perimeter: + + $ gcloud alpha artifacts vpcsc-config allow --project=my-project \ + --location=us-west1 + +FLAGS + Location resource - The Artifact Registry VPC SC config to update. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property artifacts/location with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --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; + ▸ set the property artifacts/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud artifacts vpcsc-config allow + + $ gcloud beta artifacts vpcsc-config allow + diff --git a/gcloud/alpha/artifacts/vpcsc-config/deny b/gcloud/alpha/artifacts/vpcsc-config/deny new file mode 100644 index 000000000..c93cad941 --- /dev/null +++ b/gcloud/alpha/artifacts/vpcsc-config/deny @@ -0,0 +1,65 @@ +NAME + gcloud alpha artifacts vpcsc-config deny - deny access to upstream sources + outside the service perimeter for Artifact Registry remote repositories + inside the perimeter + +SYNOPSIS + gcloud alpha artifacts vpcsc-config deny [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Deny access to upstream sources outside the service perimeter for + Artifact Registry remote repositories inside the perimeter. + + This command can fail for the following reasons: + ▪ Lack of permission - "accesscontextmanager.policies.update". + ▪ The resource could be outside of the VPC SC perimeter. + ▪ Lack of permission - "artifactregistry.vpcscconfigs.update" + +EXAMPLES + The following command denies access to upstream sources outside the service + perimeter for remote repositories in the project my-project and in the + region us--west1: + + $ gcloud alpha artifacts vpcsc-config deny --project=my-project \ + --location=us-west1 + +FLAGS + Location resource - The Artifact Registry VPC SC config to update. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property artifacts/location with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --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; + ▸ set the property artifacts/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud artifacts vpcsc-config deny + + $ gcloud beta artifacts vpcsc-config deny + diff --git a/gcloud/alpha/artifacts/vpcsc-config/describe b/gcloud/alpha/artifacts/vpcsc-config/describe new file mode 100644 index 000000000..89d7c38bc --- /dev/null +++ b/gcloud/alpha/artifacts/vpcsc-config/describe @@ -0,0 +1,63 @@ +NAME + gcloud alpha artifacts vpcsc-config describe - describe the current + Artifact Registry configuration for VPC Service Controls + +SYNOPSIS + gcloud alpha artifacts vpcsc-config describe [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe the current Artifact Registry configuration for VPC + Service Controls. + + This command can fail for the following reasons: + ▪ Lack of permission - "accesscontextmanager.policies.get". + ▪ The resource could be outside of the VPC SC perimeter. + ▪ Lack of permission - "artifactregistry.vpcscconfigs.get" + +EXAMPLES + The following command returns the current VPC Service Controls + configuration for the project my-project and region us-west1: + + $ gcloud alpha artifacts vpcsc-config describe \ + --project=my-project --location=us-west1 + +FLAGS + Location resource - The Artifact Registry VPC SC configs to describe. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property artifacts/location with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --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; + ▸ set the property artifacts/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud artifacts vpcsc-config describe + + $ gcloud beta artifacts vpcsc-config describe + diff --git a/gcloud/alpha/artifacts/vpcsc-config/help b/gcloud/alpha/artifacts/vpcsc-config/help new file mode 100644 index 000000000..79de69dcc --- /dev/null +++ b/gcloud/alpha/artifacts/vpcsc-config/help @@ -0,0 +1,42 @@ +NAME + gcloud alpha artifacts vpcsc-config - manage Artifact Registry VPC Service + Controls configuration for remote repositories + +SYNOPSIS + gcloud alpha artifacts vpcsc-config COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Artifact Registry VPC Service Controls configuration for + remote repositories. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + allow + (ALPHA) Allow Artifact Registry remote repositories inside a service + perimeter to retrieve data from their upstream sources outside of the + perimeter. + + deny + (ALPHA) Deny access to upstream sources outside the service perimeter + for Artifact Registry remote repositories inside the perimeter. + + describe + (ALPHA) Describe the current Artifact Registry configuration for VPC + Service Controls. + +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. These variants are also available: + + $ gcloud artifacts vpcsc-config + + $ gcloud beta artifacts vpcsc-config + diff --git a/gcloud/alpha/auth/help b/gcloud/alpha/auth/help index 00ad2905d..291679cf5 100644 --- a/gcloud/alpha/auth/help +++ b/gcloud/alpha/auth/help @@ -22,6 +22,11 @@ DESCRIPTION global flags, see the gcloud CLI overview (https://cloud.google.com/sdk/gcloud/reference). + See $ gcloud topic client-certificate to learn how to use Mutual TLS when + using gcloud. Mutual TLS can be used for certificate based access + (https://cloud.google.com/beyondcorp-enterprise/docs/securing-resources-with-certificate-based-access) + with gcloud. + EXAMPLES To authenticate a user account with gcloud and minimal user output, run: diff --git a/gcloud/alpha/bigtable/backups/list b/gcloud/alpha/bigtable/backups/list index 8934dfa89..90cf0c4cd 100644 --- a/gcloud/alpha/bigtable/backups/list +++ b/gcloud/alpha/bigtable/backups/list @@ -2,9 +2,10 @@ NAME gcloud alpha bigtable backups list - list existing Bigtable backups SYNOPSIS - gcloud alpha bigtable backups list --cluster=CLUSTER --instance=INSTANCE - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + gcloud alpha bigtable backups list [--cluster=CLUSTER] + [--instance=INSTANCE] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) List existing Bigtable backups. diff --git a/gcloud/alpha/bigtable/clusters/list b/gcloud/alpha/bigtable/clusters/list index 54b40e59d..7ce31cf51 100644 --- a/gcloud/alpha/bigtable/clusters/list +++ b/gcloud/alpha/bigtable/clusters/list @@ -2,7 +2,7 @@ NAME gcloud alpha bigtable clusters list - list existing Bigtable clusters SYNOPSIS - gcloud alpha bigtable clusters list --instances=[INSTANCES,...] + gcloud alpha bigtable clusters list [--instances=[INSTANCES,...]] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/alpha/bigtable/instances/config/export b/gcloud/alpha/bigtable/instances/config/export index cb80bbdca..99b74be45 100644 --- a/gcloud/alpha/bigtable/instances/config/export +++ b/gcloud/alpha/bigtable/instances/config/export @@ -3,7 +3,7 @@ NAME for a Cloud Bigtable instance SYNOPSIS - gcloud alpha bigtable instances config export (INSTANCE : --all) + gcloud alpha bigtable instances config export ([INSTANCE]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] @@ -47,9 +47,6 @@ POSITIONAL ARGUMENTS set the instance attribute: ▸ provide the argument instance on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/bigtable/operations/list b/gcloud/alpha/bigtable/operations/list index 96e71cce3..26bf2c4af 100644 --- a/gcloud/alpha/bigtable/operations/list +++ b/gcloud/alpha/bigtable/operations/list @@ -2,7 +2,7 @@ NAME gcloud alpha bigtable operations list - list Cloud Bigtable operations SYNOPSIS - gcloud alpha bigtable operations list --instance=INSTANCE + gcloud alpha bigtable operations list [--instance=INSTANCE] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/alpha/bms/instances/list b/gcloud/alpha/bms/instances/list index c7fdb7a48..473f48f2b 100644 --- a/gcloud/alpha/bms/instances/list +++ b/gcloud/alpha/bms/instances/list @@ -3,7 +3,7 @@ NAME project SYNOPSIS - gcloud alpha bms instances list --region=REGION [--filter=EXPRESSION] + gcloud alpha bms instances list [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION diff --git a/gcloud/alpha/bms/networks/list b/gcloud/alpha/bms/networks/list index 9ed83fcf8..8079ffd41 100644 --- a/gcloud/alpha/bms/networks/list +++ b/gcloud/alpha/bms/networks/list @@ -3,7 +3,7 @@ NAME project SYNOPSIS - gcloud alpha bms networks list --region=REGION [--filter=EXPRESSION] + gcloud alpha bms networks list [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION diff --git a/gcloud/alpha/bms/networks/list-ip-reservations b/gcloud/alpha/bms/networks/list-ip-reservations index 6d2525b5a..9016a4244 100644 --- a/gcloud/alpha/bms/networks/list-ip-reservations +++ b/gcloud/alpha/bms/networks/list-ip-reservations @@ -3,7 +3,7 @@ NAME for Bare Metal Solution networks in a project SYNOPSIS - gcloud alpha bms networks list-ip-reservations --region=REGION + gcloud alpha bms networks list-ip-reservations [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION diff --git a/gcloud/alpha/bms/nfs-shares/list b/gcloud/alpha/bms/nfs-shares/list index 2dc6ef61e..7a283560f 100644 --- a/gcloud/alpha/bms/nfs-shares/list +++ b/gcloud/alpha/bms/nfs-shares/list @@ -3,7 +3,7 @@ NAME project SYNOPSIS - gcloud alpha bms nfs-shares list --region=REGION [--filter=EXPRESSION] + gcloud alpha bms nfs-shares list [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION diff --git a/gcloud/alpha/bms/volumes/list b/gcloud/alpha/bms/volumes/list index 39b29ba88..968e81a01 100644 --- a/gcloud/alpha/bms/volumes/list +++ b/gcloud/alpha/bms/volumes/list @@ -3,7 +3,7 @@ NAME project SYNOPSIS - gcloud alpha bms volumes list --region=REGION [--filter=EXPRESSION] + gcloud alpha bms volumes list [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION diff --git a/gcloud/alpha/bq/datasets/config/export b/gcloud/alpha/bq/datasets/config/export index d5fdaba98..83a69b179 100644 --- a/gcloud/alpha/bq/datasets/config/export +++ b/gcloud/alpha/bq/datasets/config/export @@ -3,7 +3,7 @@ NAME Google BigQuery dataset SYNOPSIS - gcloud alpha bq datasets config export (DATASET : --all) + gcloud alpha bq datasets config export ([DATASET]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] @@ -47,9 +47,6 @@ POSITIONAL ARGUMENTS set the dataset attribute: ▸ provide the argument dataset on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/bq/jobs/config/export b/gcloud/alpha/bq/jobs/config/export index 12e32a787..39f5a92e2 100644 --- a/gcloud/alpha/bq/jobs/config/export +++ b/gcloud/alpha/bq/jobs/config/export @@ -3,8 +3,9 @@ NAME BigQuery job SYNOPSIS - gcloud alpha bq jobs config export (JOB : --all) [--path=PATH; default="-"] - [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] + gcloud alpha bq jobs config export ([JOB]] --all) + [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha bq jobs config export exports the configuration for a @@ -45,9 +46,6 @@ POSITIONAL ARGUMENTS job attribute: ▸ provide the argument job on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/builds/triggers/config/export b/gcloud/alpha/builds/triggers/config/export index ccee71c07..e87ed1ce8 100644 --- a/gcloud/alpha/builds/triggers/config/export +++ b/gcloud/alpha/builds/triggers/config/export @@ -3,7 +3,7 @@ NAME Google Cloud Build trigger SYNOPSIS - gcloud alpha builds triggers config export (TRIGGER : --all) + gcloud alpha builds triggers config export ([TRIGGER]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] @@ -47,9 +47,6 @@ POSITIONAL ARGUMENTS set the trigger attribute: ▸ provide the argument trigger on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/builds/triggers/create/gitlab-enterprise b/gcloud/alpha/builds/triggers/create/gitlab-enterprise index ed823b094..5d3c24101 100644 --- a/gcloud/alpha/builds/triggers/create/gitlab-enterprise +++ b/gcloud/alpha/builds/triggers/create/gitlab-enterprise @@ -4,18 +4,16 @@ NAME SYNOPSIS gcloud alpha builds triggers create gitlab-enterprise - (--trigger-config=PATH - | [--gitlab-config-resource=GITLAB_CONFIG_RESOURCE - --project-namespace=PROJECT_NAMESPACE (--branch-pattern=REGEX - | --tag-pattern=REGEX | [--pull-request-pattern=REGEX - : --comment-control=COMMENT_CONTROL; + (--trigger-config=PATH | [(--branch-pattern=REGEX | --tag-pattern=REGEX + | [--pull-request-pattern=REGEX : --comment-control=COMMENT_CONTROL; default=CommentControlValueValuesEnum(COMMENTS_ENABLED, 1)]) (--build-config=PATH | --inline-config=PATH | [--dockerfile=DOCKERFILE : --dockerfile-dir=DOCKERFILE_DIR; default="/" --dockerfile-image=DOCKERFILE_IMAGE]) - : --description=DESCRIPTION --ignored-files=[GLOB,...] - --included-files=[GLOB,...] --name=NAME --region=REGION - --require-approval + (--gitlab-config-resource=GITLAB_CONFIG_RESOURCE + --project-namespace=PROJECT_NAMESPACE) : --description=DESCRIPTION + --ignored-files=[GLOB,...] --included-files=[GLOB,...] --name=NAME + --region=REGION --require-approval --service-account=SERVICE_ACCOUNT --substitutions=[KEY=VALUE,...]]) [GCLOUD_WIDE_FLAG ...] @@ -23,7 +21,7 @@ DESCRIPTION (ALPHA) Create a build trigger for a GitLab Enterprise repository. EXAMPLES - To create a push trigger for all branches: + To create a push trigger with a 1st-gen repository for all branches: $ gcloud alpha builds triggers create gitlab-enterprise \ --name="my-trigger" \ @@ -33,7 +31,7 @@ EXAMPLES --gitlab-config-resource="projects/1234/locations/global/gitLabC\ onfigs/5678" --branch-pattern=".*" --build-config="cloudbuild.yaml" - To create a pull request trigger for main: + To create a pull request trigger with a 1st-gen repository for main: $ gcloud alpha builds triggers create gitlab-enterprise \ --name="my-trigger" \ @@ -54,18 +52,6 @@ REQUIRED FLAGS Flag based trigger configuration - --gitlab-config-resource=GITLAB_CONFIG_RESOURCE - GitLab config resource name. - - This flag argument must be specified if any of the other arguments - in this group are specified. - - --project-namespace=PROJECT_NAMESPACE - GitLab project namespace. - - This flag argument must be specified if any of the other arguments - in this group are specified. - --description=DESCRIPTION Build trigger description. @@ -206,6 +192,22 @@ REQUIRED FLAGS Use a build configuration (cloudbuild.yaml) file for building multiple images in a single trigger. + Exactly one of these must be specified: + + 1st-gen repository settings. + + --gitlab-config-resource=GITLAB_CONFIG_RESOURCE + GitLab config resource name. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --project-namespace=PROJECT_NAMESPACE + GitLab project namespace. + + This flag argument must be specified if any of the other + arguments in this group are specified. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/certificate-manager/maps/entries/create b/gcloud/alpha/certificate-manager/maps/entries/create index eac9a452a..4b41448af 100644 --- a/gcloud/alpha/certificate-manager/maps/entries/create +++ b/gcloud/alpha/certificate-manager/maps/entries/create @@ -6,8 +6,8 @@ SYNOPSIS gcloud alpha certificate-manager maps entries create (ENTRY : --location=LOCATION --map=MAP) (--hostname=HOSTNAME | --set-primary) [--description=DESCRIPTION] - --certificates=[CERTIFICATES,...] [--async] [--labels=[KEY=VALUE,...]] - [GCLOUD_WIDE_FLAG ...] + [--async] [--certificates=[CERTIFICATES,...]] + [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) This command creates a certificate map entry. @@ -72,6 +72,10 @@ COMMONLY USED FLAGS Text description of a certificate map entry. OTHER FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + Certificate resource - The certificates to be attached to the entry. 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 @@ -89,10 +93,6 @@ OTHER FLAGS certificates. To set the certificate attribute: ▸ provide the argument --certificates on the command line. - --async - Return immediately, without waiting for the operation in progress to - complete. - --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/alpha/certificate-manager/maps/entries/update b/gcloud/alpha/certificate-manager/maps/entries/update index cdc3e1e71..ddb56b53d 100644 --- a/gcloud/alpha/certificate-manager/maps/entries/update +++ b/gcloud/alpha/certificate-manager/maps/entries/update @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud alpha certificate-manager maps entries update (ENTRY : --location=LOCATION --map=MAP) [--description=DESCRIPTION] - --certificates=[CERTIFICATES,...] [--async] + [--async] [--certificates=[CERTIFICATES,...]] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -59,6 +59,10 @@ COMMONLY USED FLAGS Text description of a certificate map entry. OTHER FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + Certificate resource - The certificates to be attached to the entry. 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 @@ -76,10 +80,6 @@ OTHER FLAGS certificates. To set the certificate attribute: ▸ provide the argument --certificates on the command line. - --async - Return immediately, without waiting for the operation in progress to - complete. - --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. diff --git a/gcloud/alpha/composer/environments/create b/gcloud/alpha/composer/environments/create index 7e80168ce..f20505a0f 100644 --- a/gcloud/alpha/composer/environments/create +++ b/gcloud/alpha/composer/environments/create @@ -33,7 +33,7 @@ SYNOPSIS --snapshot-creation-schedule=SNAPSHOT_CREATION_SCHEDULE --snapshot-location=SNAPSHOT_LOCATION --snapshot-schedule-timezone=SNAPSHOT_SCHEDULE_TIMEZONE] - [--enable-triggerer + [--enable-triggerer --triggerer-count=TRIGGERER_COUNT --triggerer-cpu=TRIGGERER_CPU --triggerer-memory=TRIGGERER_MEMORY] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] @@ -413,8 +413,14 @@ FLAGS greater. --enable-triggerer - Enable use of a triggerer, supported in the Environments with - Composer 2.0.31 and Airflow 2.2.5 and greater. + (DEPRECATED) Enable use of a triggerer, supported in the Environments + with Composer 2.0.31 and Airflow 2.2.5 and greater. + + This flag is deprecated. Use --triggerer-count instead. + + --triggerer-count=TRIGGERER_COUNT + Number of triggerers, supported in the Environments with Composer + 2.0.31 and Airflow 2.2.5 and greater. --triggerer-cpu=TRIGGERER_CPU CPU allocated to Airflow triggerer. Supported in the Environments @@ -446,13 +452,15 @@ FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/alpha/composer/environments/list b/gcloud/alpha/composer/environments/list index eaf7805a9..a7ea236d3 100644 --- a/gcloud/alpha/composer/environments/list +++ b/gcloud/alpha/composer/environments/list @@ -3,7 +3,7 @@ NAME environments under a project and location SYNOPSIS - gcloud alpha composer environments list --locations=[LOCATIONS,...] + gcloud alpha composer environments list [--locations=[LOCATIONS,...]] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/alpha/composer/environments/update b/gcloud/alpha/composer/environments/update index 023d38810..f6b669940 100644 --- a/gcloud/alpha/composer/environments/update +++ b/gcloud/alpha/composer/environments/update @@ -30,7 +30,7 @@ SYNOPSIS --web-server-storage=WEB_SERVER_STORAGE --worker-cpu=WORKER_CPU --worker-memory=WORKER_MEMORY --worker-storage=WORKER_STORAGE --disable-triggerer - | --enable-triggerer + | --enable-triggerer --triggerer-count=TRIGGERER_COUNT --triggerer-cpu=TRIGGERER_CPU --triggerer-memory=TRIGGERER_MEMORY | --update-airflow-configs=[KEY=VALUE,...] --clear-airflow-configs | --remove-airflow-configs=[KEY,...] @@ -299,14 +299,23 @@ REQUIRED FLAGS At most one of these can be specified: --disable-triggerer - Disable a triggerer, supported in the Environments with Composer - 2.0.31 and Airflow 2.2.5 and greater. + (DEPRECATED) Disable a triggerer, supported in the Environments + with Composer 2.0.31 and Airflow 2.2.5 and greater. + + This flag is deprecated. Use --triggerer-count 0 instead. Group of arguments for setting triggerer settings during update in Composer 2.0.31 or greater. --enable-triggerer - Enable use of a triggerer, supported in the Environments with + (DEPRECATED) Enable use of a triggerer, supported in the + Environments with Composer 2.0.31 and Airflow 2.2.5 and + greater. + + This flag is deprecated. Use --triggerer-count instead. + + --triggerer-count=TRIGGERER_COUNT + Number of triggerers, supported in the Environments with Composer 2.0.31 and Airflow 2.2.5 and greater. --triggerer-cpu=TRIGGERER_CPU diff --git a/gcloud/alpha/composer/operations/list b/gcloud/alpha/composer/operations/list index 3edc9fc94..5dc030849 100644 --- a/gcloud/alpha/composer/operations/list +++ b/gcloud/alpha/composer/operations/list @@ -2,7 +2,7 @@ NAME gcloud alpha composer operations list - lists environment operations SYNOPSIS - gcloud alpha composer operations list --locations=[LOCATIONS,...] + gcloud alpha composer operations list [--locations=[LOCATIONS,...]] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/alpha/compute/backend-buckets/config/export b/gcloud/alpha/compute/backend-buckets/config/export index 2b0bafff8..aff22bea7 100644 --- a/gcloud/alpha/compute/backend-buckets/config/export +++ b/gcloud/alpha/compute/backend-buckets/config/export @@ -3,8 +3,8 @@ NAME configuration for a Compute Engine backend bucket SYNOPSIS - gcloud alpha compute backend-buckets config export (BACKEND_BUCKET : --all) - [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] + gcloud alpha compute backend-buckets config export ([BACKEND_BUCKET]] + --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -49,9 +49,6 @@ POSITIONAL ARGUMENTS backend bucket. To set the backend_bucket attribute: ▸ provide the argument backend_bucket on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/compute/backend-services/create b/gcloud/alpha/compute/backend-services/create index cdaeca5c3..5408d39c4 100644 --- a/gcloud/alpha/compute/backend-services/create +++ b/gcloud/alpha/compute/backend-services/create @@ -267,9 +267,9 @@ FLAGS --[no-]enable-logging The logging options for the load balancer traffic served by this backend service. If logging is enabled, logs will be exported to Cloud - Logging. This can only be specified if the protocol is HTTP, HTTPS, - HTTP2, TCP, SSL, UDP, or UNSPECIFIED. Disabled by default. Use - --enable-logging to enable and --no-enable-logging to disable. + Logging. Disabled by default. This field cannot be specified for SSL + Proxy and TCP Proxy Load Balancing. Use --enable-logging to enable and + --no-enable-logging to disable. --[no-]enable-strong-affinity Enable or disable strong session affinity. This is only available for @@ -341,29 +341,27 @@ FLAGS --logging-optional=LOGGING_OPTIONAL This field can only be specified if logging is enabled for the backend - service. Configures whether all, none or a subset of optional fields - should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL, - EXCLUDE_ALL_OPTIONAL, CUSTOM]. This can only be specified if the - protocol is HTTP, HTTPS, HTTP2, TCP, SSL, UDP, or UNSPECIFIED. Default - is EXCLUDE_ALL_OPTIONAL. LOGGING_OPTIONAL must be one of: + service. Configures whether all, none, or a subset of optional fields + should be added to the reported logs. Default is EXCLUDE_ALL_OPTIONAL. + This field can only be specified for Internal TCP/UDP Load Balancing + and External Network Load Balancing. LOGGING_OPTIONAL must be one of: EXCLUDE_ALL_OPTIONAL, INCLUDE_ALL_OPTIONAL, CUSTOM. --logging-optional-fields=[LOGGING_OPTIONAL_FIELDS,...] This field can only be specified if logging is enabled for the backend - service and "logConfig.optionalMode" was set to CUSTOM. Contains a + service and "--logging-optional" was set to CUSTOM. Contains a comma-separated list of optional fields you want to include in the logs. For example: serverInstance, serverGkeDetails.cluster, - serverGkeDetails.pod.podNamespace. This can only be specified if the - protocol is HTTP, HTTPS, HTTP2, TCP, SSL, UDP, or UNSPECIFIED. + serverGkeDetails.pod.podNamespace. This can only be specified for + Internal TCP/UDP Load Balancing and External Network Load Balancing. --logging-sample-rate=LOGGING_SAMPLE_RATE This field can only be specified if logging is enabled for the backend service. The value of the field must be a float in the range [0, 1]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no - logged requests are reported. This can only be specified if the - protocol is HTTP, HTTPS, HTTP2, TCP, SSL, UDP, or UNSPECIFIED. The - default value is 0.0. + logged requests are reported. The default value is 1.0 when logging is + enabled and 0.0 otherwise. --max-ttl=MAX_TTL Specifies the maximum allowed TTL for cached content served by this diff --git a/gcloud/alpha/compute/backend-services/update b/gcloud/alpha/compute/backend-services/update index fd986132d..f0458bc4f 100644 --- a/gcloud/alpha/compute/backend-services/update +++ b/gcloud/alpha/compute/backend-services/update @@ -180,9 +180,9 @@ FLAGS --[no-]enable-logging The logging options for the load balancer traffic served by this backend service. If logging is enabled, logs will be exported to Cloud - Logging. This can only be specified if the protocol is HTTP, HTTPS, - HTTP2, TCP, SSL, UDP, or UNSPECIFIED. Disabled by default. Use - --enable-logging to enable and --no-enable-logging to disable. + Logging. Disabled by default. This field cannot be specified for SSL + Proxy and TCP Proxy Load Balancing. Use --enable-logging to enable and + --no-enable-logging to disable. --[no-]enable-strong-affinity Enable or disable strong session affinity. This is only available for @@ -249,29 +249,27 @@ FLAGS --logging-optional=LOGGING_OPTIONAL This field can only be specified if logging is enabled for the backend - service. Configures whether all, none or a subset of optional fields - should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL, - EXCLUDE_ALL_OPTIONAL, CUSTOM]. This can only be specified if the - protocol is HTTP, HTTPS, HTTP2, TCP, SSL, UDP, or UNSPECIFIED. Default - is EXCLUDE_ALL_OPTIONAL. LOGGING_OPTIONAL must be one of: + service. Configures whether all, none, or a subset of optional fields + should be added to the reported logs. Default is EXCLUDE_ALL_OPTIONAL. + This field can only be specified for Internal TCP/UDP Load Balancing + and External Network Load Balancing. LOGGING_OPTIONAL must be one of: EXCLUDE_ALL_OPTIONAL, INCLUDE_ALL_OPTIONAL, CUSTOM. --logging-optional-fields=[LOGGING_OPTIONAL_FIELDS,...] This field can only be specified if logging is enabled for the backend - service and "logConfig.optionalMode" was set to CUSTOM. Contains a + service and "--logging-optional" was set to CUSTOM. Contains a comma-separated list of optional fields you want to include in the logs. For example: serverInstance, serverGkeDetails.cluster, - serverGkeDetails.pod.podNamespace. This can only be specified if the - protocol is HTTP, HTTPS, HTTP2, TCP, SSL, UDP, or UNSPECIFIED. + serverGkeDetails.pod.podNamespace. This can only be specified for + Internal TCP/UDP Load Balancing and External Network Load Balancing. --logging-sample-rate=LOGGING_SAMPLE_RATE This field can only be specified if logging is enabled for the backend service. The value of the field must be a float in the range [0, 1]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no - logged requests are reported. This can only be specified if the - protocol is HTTP, HTTPS, HTTP2, TCP, SSL, UDP, or UNSPECIFIED. The - default value is 0.0. + logged requests are reported. The default value is 1.0 when logging is + enabled and 0.0 otherwise. --port-name=PORT_NAME Backend services for external HTTP(S) load balancing, internal HTTP(S) diff --git a/gcloud/alpha/compute/firewall-rules/config/export b/gcloud/alpha/compute/firewall-rules/config/export index ba8df8a7d..61cfd3f94 100644 --- a/gcloud/alpha/compute/firewall-rules/config/export +++ b/gcloud/alpha/compute/firewall-rules/config/export @@ -3,7 +3,7 @@ NAME configuration for a Compute Engine firewall SYNOPSIS - gcloud alpha compute firewall-rules config export (FIREWALL : --all) + gcloud alpha compute firewall-rules config export ([FIREWALL]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] @@ -47,9 +47,6 @@ POSITIONAL ARGUMENTS firewall_rule. To set the firewall attribute: ▸ provide the argument firewall on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/compute/reservations/create b/gcloud/alpha/compute/reservations/create index 41bf718cf..bcf257761 100644 --- a/gcloud/alpha/compute/reservations/create +++ b/gcloud/alpha/compute/reservations/create @@ -61,8 +61,9 @@ REQUIRED FLAGS 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. + The resource policies to include in this reservation. If you omit + this flag, no resource policies are added. You can specify any string + as the key, and specify the name of a resource policy as the value. Manage the instance properties for the SpecificSKU reservation. diff --git a/gcloud/alpha/compute/ssl-policies/config/export b/gcloud/alpha/compute/ssl-policies/config/export index 4bd02862f..0aa6f3220 100644 --- a/gcloud/alpha/compute/ssl-policies/config/export +++ b/gcloud/alpha/compute/ssl-policies/config/export @@ -3,7 +3,7 @@ NAME for a Compute Engine ssl policy SYNOPSIS - gcloud alpha compute ssl-policies config export (SSL_POLICY : --all) + gcloud alpha compute ssl-policies config export ([SSL_POLICY]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] @@ -47,9 +47,6 @@ POSITIONAL ARGUMENTS policy. To set the ssl_policy attribute: ▸ provide the argument ssl_policy on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/compute/target-grpc-proxies/config/export b/gcloud/alpha/compute/target-grpc-proxies/config/export index fa664cfdf..65084d59f 100644 --- a/gcloud/alpha/compute/target-grpc-proxies/config/export +++ b/gcloud/alpha/compute/target-grpc-proxies/config/export @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha compute target-grpc-proxies config export - (TARGET_GRPC_PROXY : --all) [--path=PATH; default="-"] + ([TARGET_GRPC_PROXY]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -50,9 +50,6 @@ POSITIONAL ARGUMENTS target GRPC proxy. To set the target_grpc_proxy attribute: ▸ provide the argument target_grpc_proxy on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/compute/target-http-proxies/config/export b/gcloud/alpha/compute/target-http-proxies/config/export index 6433f68c0..9c57efef8 100644 --- a/gcloud/alpha/compute/target-http-proxies/config/export +++ b/gcloud/alpha/compute/target-http-proxies/config/export @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha compute target-http-proxies config export - (TARGET_HTTP_PROXY : --all) [--path=PATH; default="-"] + ([TARGET_HTTP_PROXY]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -50,9 +50,6 @@ POSITIONAL ARGUMENTS target HTTP proxy. To set the target_http_proxy attribute: ▸ provide the argument target_http_proxy on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/compute/target-https-proxies/config/export b/gcloud/alpha/compute/target-https-proxies/config/export index 721736ddf..918dd5fda 100644 --- a/gcloud/alpha/compute/target-https-proxies/config/export +++ b/gcloud/alpha/compute/target-https-proxies/config/export @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha compute target-https-proxies config export - (TARGET_HTTPS_PROXY : --all) [--path=PATH; default="-"] + ([TARGET_HTTPS_PROXY]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -50,9 +50,6 @@ POSITIONAL ARGUMENTS target HTTPS proxy. To set the target_https_proxy attribute: ▸ provide the argument target_https_proxy on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/compute/target-https-proxies/create b/gcloud/alpha/compute/target-https-proxies/create index f31bd7fd0..012ba230a 100644 --- a/gcloud/alpha/compute/target-https-proxies/create +++ b/gcloud/alpha/compute/target-https-proxies/create @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha compute target-https-proxies create NAME --url-map=URL_MAP - --certificate-map=CERTIFICATE_MAP [--description=DESCRIPTION] + [--certificate-map=CERTIFICATE_MAP] [--description=DESCRIPTION] [--proxy-bind] [--quic-override=QUIC_OVERRIDE; default="NONE"] [--ssl-certificates=SSL_CERTIFICATE,[...]] [--ssl-policy=SSL_POLICY] [--global | --region=REGION] diff --git a/gcloud/alpha/compute/target-https-proxies/update b/gcloud/alpha/compute/target-https-proxies/update index e5f4e00fe..4046ace80 100644 --- a/gcloud/alpha/compute/target-https-proxies/update +++ b/gcloud/alpha/compute/target-https-proxies/update @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud alpha compute target-https-proxies update NAME [--quic-override=QUIC_OVERRIDE] [--url-map=URL_MAP] - [[--certificate-map=CERTIFICATE_MAP : --clear-certificate-map] + [--certificate-map=CERTIFICATE_MAP | --clear-certificate-map | --ssl-certificates=SSL_CERTIFICATE,[...] --global-ssl-certificates | --ssl-certificates-region=SSL_CERTIFICATES_REGION] [--clear-ssl-policy | --ssl-policy=SSL_POLICY --global-ssl-policy diff --git a/gcloud/alpha/compute/target-ssl-proxies/config/export b/gcloud/alpha/compute/target-ssl-proxies/config/export index d2f48fa74..67afd92df 100644 --- a/gcloud/alpha/compute/target-ssl-proxies/config/export +++ b/gcloud/alpha/compute/target-ssl-proxies/config/export @@ -3,9 +3,9 @@ NAME configuration for a Compute Engine target ssl proxy SYNOPSIS - gcloud alpha compute target-ssl-proxies config export - (TARGET_SSL_PROXY : --all) [--path=PATH; default="-"] - [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] + gcloud alpha compute target-ssl-proxies config export ([TARGET_SSL_PROXY]] + --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute target-ssl-proxies config export exports the @@ -50,9 +50,6 @@ POSITIONAL ARGUMENTS target SSL proxy. To set the target_ssl_proxy attribute: ▸ provide the argument target_ssl_proxy on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/compute/target-ssl-proxies/create b/gcloud/alpha/compute/target-ssl-proxies/create index 5941386ec..b4050bc02 100644 --- a/gcloud/alpha/compute/target-ssl-proxies/create +++ b/gcloud/alpha/compute/target-ssl-proxies/create @@ -5,8 +5,7 @@ SYNOPSIS gcloud alpha compute target-ssl-proxies create NAME --backend-service=BACKEND_SERVICE (--certificate-map=CERTIFICATE_MAP - : --ssl-certificates=SSL_CERTIFICATE,[...]) - [--description=DESCRIPTION] + --ssl-certificates=SSL_CERTIFICATE,[...]) [--description=DESCRIPTION] [--proxy-header=PROXY_HEADER; default="NONE"] [--ssl-policy=SSL_POLICY] [--global-ssl-policy | --ssl-policy-region=SSL_POLICY_REGION] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/alpha/compute/target-ssl-proxies/update b/gcloud/alpha/compute/target-ssl-proxies/update index a283b8828..c8c6367f1 100644 --- a/gcloud/alpha/compute/target-ssl-proxies/update +++ b/gcloud/alpha/compute/target-ssl-proxies/update @@ -4,11 +4,11 @@ NAME SYNOPSIS gcloud alpha compute target-ssl-proxies update NAME [--backend-service=BACKEND_SERVICE] [--proxy-header=PROXY_HEADER] - [--certificate-map=CERTIFICATE_MAP - : --ssl-certificates=SSL_CERTIFICATE,[...] | --clear-ssl-certificates - | --clear-certificate-map] [--clear-ssl-policy | --ssl-policy=SSL_POLICY --global-ssl-policy - | --ssl-policy-region=SSL_POLICY_REGION] [GCLOUD_WIDE_FLAG ...] + | --ssl-policy-region=SSL_POLICY_REGION] + [--ssl-certificates=SSL_CERTIFICATE,[...] | --clear-ssl-certificates + | --certificate-map=CERTIFICATE_MAP | --clear-certificate-map] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute target-ssl-proxies update is used to replace @@ -39,6 +39,26 @@ FLAGS Enables PROXY protocol (version 1) for passing client connection information. + At most one of these can be specified: + + --clear-ssl-policy + Removes any attached SSL policy from the SSL proxy. + + --ssl-policy=SSL_POLICY + A reference to an SSL policy resource that defines the server-side + support for SSL features and affects the connections between clients + and the SSL proxy load balancer. The SSL policy must exist and cannot + be deleted while referenced by a target SSL proxy. + + At most one of these can be specified: + + --global-ssl-policy + If set, the SSL policy is global. + + --ssl-policy-region=SSL_POLICY_REGION + Region of the SSL policy to operate on. Overrides the default + compute/region property value for this command invocation. + At most one of these can be specified: --ssl-certificates=SSL_CERTIFICATE,[...] @@ -71,26 +91,6 @@ FLAGS --clear-certificate-map Removes any attached certificate map from the SSL proxy. - At most one of these can be specified: - - --clear-ssl-policy - Removes any attached SSL policy from the SSL proxy. - - --ssl-policy=SSL_POLICY - A reference to an SSL policy resource that defines the server-side - support for SSL features and affects the connections between clients - and the SSL proxy load balancer. The SSL policy must exist and cannot - be deleted while referenced by a target SSL proxy. - - At most one of these can be specified: - - --global-ssl-policy - If set, the SSL policy is global. - - --ssl-policy-region=SSL_POLICY_REGION - Region of the SSL policy to operate on. Overrides the default - compute/region property value for this command invocation. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/compute/target-tcp-proxies/config/export b/gcloud/alpha/compute/target-tcp-proxies/config/export index 39fd77157..e924179b4 100644 --- a/gcloud/alpha/compute/target-tcp-proxies/config/export +++ b/gcloud/alpha/compute/target-tcp-proxies/config/export @@ -3,9 +3,9 @@ NAME configuration for a Compute Engine target tcp proxy SYNOPSIS - gcloud alpha compute target-tcp-proxies config export - (TARGET_TCP_PROXY : --all) [--path=PATH; default="-"] - [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] + gcloud alpha compute target-tcp-proxies config export ([TARGET_TCP_PROXY]] + --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute target-tcp-proxies config export exports the @@ -50,9 +50,6 @@ POSITIONAL ARGUMENTS target TCP proxy. To set the target_tcp_proxy attribute: ▸ provide the argument target_tcp_proxy on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/compute/tpus/queued-resources/create b/gcloud/alpha/compute/tpus/queued-resources/create index 6a7a6fe94..cb0b240dc 100644 --- a/gcloud/alpha/compute/tpus/queued-resources/create +++ b/gcloud/alpha/compute/tpus/queued-resources/create @@ -6,7 +6,7 @@ SYNOPSIS gcloud alpha compute tpus queued-resources create (QUEUED_RESOURCE : --zone=ZONE) --accelerator-type=ACCELERATOR_TYPE --runtime-version=RUNTIME_VERSION - (--node-id=NODE_ID : --node-count=NODE_COUNT --node-prefix=NODE_PREFIX) + (--node-id=NODE_ID | --node-count=NODE_COUNT --node-prefix=NODE_PREFIX) [--async] [--best-effort] [--guaranteed] [--internal-ips] [--reserved] [--valid-after-duration=VALID_AFTER_DURATION] [--valid-after-time=VALID_AFTER_TIME] diff --git a/gcloud/alpha/container/azure/clusters/create b/gcloud/alpha/container/azure/clusters/create index 009894fd0..b1912a71b 100644 --- a/gcloud/alpha/container/azure/clusters/create +++ b/gcloud/alpha/container/azure/clusters/create @@ -10,7 +10,7 @@ SYNOPSIS --resource-group-id=RESOURCE_GROUP_ID --service-address-cidr-blocks=SERVICE_ADDRESS_CIDR_BLOCKS --ssh-public-key=SSH_PUBLIC_KEY --vnet-id=VNET_ID - (--client=CLIENT : --azure-application-id=AZURE_APPLICATION_ID + (--client=CLIENT | --azure-application-id=AZURE_APPLICATION_ID --azure-tenant-id=AZURE_TENANT_ID) [--admin-users=USER,[USER,...]] [--annotations=ANNOTATION,[ANNOTATION,...]] [--async] [--config-encryption-key-id=CONFIG_ENCRYPTION_KEY_ID] diff --git a/gcloud/alpha/container/azure/clusters/update b/gcloud/alpha/container/azure/clusters/update index ef038a63a..4e51404ec 100644 --- a/gcloud/alpha/container/azure/clusters/update +++ b/gcloud/alpha/container/azure/clusters/update @@ -10,7 +10,7 @@ SYNOPSIS [--validate-only] [--vm-size=VM_SIZE] [--annotations=ANNOTATION,[ANNOTATION,...] | --clear-annotations] [--clear-description | --description=DESCRIPTION] - [--client=CLIENT : --azure-application-id=AZURE_APPLICATION_ID + [--client=CLIENT | --azure-application-id=AZURE_APPLICATION_ID --azure-tenant-id=AZURE_TENANT_ID] [--disable-managed-prometheus | --enable-managed-prometheus] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/alpha/container/backup-restore/restore-plans/create b/gcloud/alpha/container/backup-restore/restore-plans/create index 981443ad7..4d9defa98 100644 --- a/gcloud/alpha/container/backup-restore/restore-plans/create +++ b/gcloud/alpha/container/backup-restore/restore-plans/create @@ -182,7 +182,7 @@ OPTIONAL FLAGS List of cluster-scoped resource types to be restored. Not specifying this means NO cluster resource will be restored. The format of a resource is "/", e.g. storage.k8s.io/StorageClass for - StorageClass. + StorageClass. Use an empty string for core API group. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/backup-restore/restore-plans/update b/gcloud/alpha/container/backup-restore/restore-plans/update index 2cba88f63..d1dd10fe0 100644 --- a/gcloud/alpha/container/backup-restore/restore-plans/update +++ b/gcloud/alpha/container/backup-restore/restore-plans/update @@ -187,7 +187,7 @@ FLAGS List of cluster-scoped resource types to be restored. Not specifying this means NO cluster resource will be restored. The format of a resource is "/", e.g. storage.k8s.io/StorageClass for - StorageClass. + StorageClass. Use an empty string for core API group. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/bare-metal/admin-clusters/query-version-config b/gcloud/alpha/container/bare-metal/admin-clusters/query-version-config index d7ed2b924..ccc689a84 100644 --- a/gcloud/alpha/container/bare-metal/admin-clusters/query-version-config +++ b/gcloud/alpha/container/bare-metal/admin-clusters/query-version-config @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud alpha container bare-metal admin-clusters query-version-config - --admin-cluster=ADMIN_CLUSTER [--location=LOCATION] + [--admin-cluster=ADMIN_CLUSTER] [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -13,14 +13,15 @@ DESCRIPTION admin cluster. EXAMPLES - To query versions for creating an admin cluster, run: + To query versions for creating an admin cluster in location us-west1, run: - $ gcloud alpha container bare-metal admin-clusters \ query-version-config + $ gcloud alpha container bare-metal admin-clusters \ query-version-config --location=us-west1 - To query versions for upgrading an admin cluster named my-admin-cluster, - run: + To query versions for upgrading an admin cluster named my-admin-cluster in + location us-west1, run: - $ gcloud alpha container bare-metal admin-clusters \ query-version-config --admin-cluster=my-admin-cluster + $ gcloud alpha container bare-metal admin-clusters \ query-version-config --location=us-west1 \ + --admin-cluster=my-admin-cluster FLAGS Use cases for querying versions. @@ -45,8 +46,8 @@ FLAGS admin_cluster. To set the admin_cluster attribute: ◇ provide the argument --admin-cluster on the command line. - Location resource - Google Cloud location to query version configuration. - This represents a Cloud resource. (NOTE) Some attributes are not given + Location resource - Google Cloud location to query versions. This + represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the project attribute: ◆ provide the argument --location on the command line with a fully diff --git a/gcloud/alpha/container/bare-metal/clusters/create b/gcloud/alpha/container/bare-metal/clusters/create index a2e1f9dfb..0fd4aaf75 100644 --- a/gcloud/alpha/container/bare-metal/clusters/create +++ b/gcloud/alpha/container/bare-metal/clusters/create @@ -10,19 +10,23 @@ SYNOPSIS (--control-plane-load-balancer-port=CONTROL_PLANE_LOAD_BALANCER_PORT (--control-plane-vip=CONTROL_PLANE_VIP --ingress-vip=INGRESS_VIP) (--enable-manual-lb - : [--metal-lb-address-pools-from-file=METAL_LB_ADDRESS_POOLS_FROM_FILE : --metal-lb-load-balancer-node-configs-from-file=METAL_LB_LOAD_BALANCER_NODE_CONFIGS_FROM_FILE --metal-lb-load-balancer-node-labels=[KEY=VALUE, - ...] --metal-lb-load-balancer-node-taints=[KEY=VALUE:EFFECT,...]])) - ((((--control-plane-node-configs-from-file=CONTROL_PLANE_NODE_CONFIGS_FROM_FILE : --control-plane-node-labels=[KEY=VALUE, - ...] --control-plane-node-taints=[KEY=VALUE:EFFECT,...]))) + | [--metal-lb-address-pools-from-file=METAL_LB_ADDRESS_POOLS_FROM_FILE : --metal-lb-load-balancer-node-configs=[labels=LABELS], + [node-ip=NODE-IP] + --metal-lb-load-balancer-node-labels=[KEY=VALUE,...] + --metal-lb-load-balancer-node-taints=[KEY=VALUE:EFFECT,...]])) + ((((--control-plane-node-configs=[labels=LABELS],[node-ip=NODE-IP] + : --control-plane-node-labels=[KEY=VALUE,...] + --control-plane-node-taints=[KEY=VALUE:EFFECT,...]))) : --api-server-args=[KEY=VALUE,...]) (--island-mode-pod-address-cidr-blocks=POD_ADDRESS,[POD_ADDRESS,...] --island-mode-service-address-cidr-blocks=SERVICE_ADDRESS,[...]) ((--lvp-node-mounts-config-path=LVP_NODE_MOUNTS_CONFIG_PATH --lvp-node-mounts-config-storage-class=LVP_NODE_MOUNTS_CONFIG_STORAGE_CLASS) ((--lvp-share-path=LVP_SHARE_PATH --lvp-share-storage-class=LVP_SHARE_STORAGE_CLASS) : --shared-path-pv-count=SHARED_PATH_PV_COUNT)) - --admin-users=ADMIN_USERS - --maintenance-address-cidr-blocks=[MAINTENANCE_ADDRESS_CIDR_BLOCKS,...] - [--annotations=[KEY=VALUE,...]] [--async] [--description=DESCRIPTION] - [--enable-application-logs] [--login-user=LOGIN_USER] [--validate-only] + [--admin-users=ADMIN_USERS] [--annotations=[KEY=VALUE,...]] [--async] + [--description=DESCRIPTION] [--enable-application-logs] + [--login-user=LOGIN_USER] + [--maintenance-address-cidr-blocks=[MAINTENANCE_ADDRESS_CIDR_BLOCKS, + ...]] [--validate-only] [--container-runtime=CONTAINER_RUNTIME --max-pods-per-node=MAX_PODS_PER_NODE] [--uri=URI : --no-proxy=[NO_PROXY,...]] [GCLOUD_WIDE_FLAG ...] @@ -175,29 +179,12 @@ REQUIRED FLAGS MetalLB Node Pool configuration. - --metal-lb-load-balancer-node-configs-from-file=METAL_LB_LOAD_BALANCER_NODE_CONFIGS_FROM_FILE - Path of the YAML/JSON file that contains the Metal LB node - configs. + Populate MetalLB load balancer node config. - Examples: + At most one of these can be specified: - nodeConfigs: - - nodeIP: 10.200.0.10 - labels: - node1: label1 - node2: label2 - - nodeIP: 10.200.0.11 - labels: - node3: label3 - node4: label4 - - List of supported fields in nodeConfigs - - KEY VALUE NOTE - nodeIP string required, - mutable - labels one or more key-val pairs optional, - mutable + --metal-lb-load-balancer-node-configs=[labels=LABELS],[node-ip=NODE-IP] + MetalLB load balancer node configuration. --metal-lb-load-balancer-node-labels=[KEY=VALUE,...] Labels assigned to nodes of a MetalLB node pool. @@ -224,30 +211,12 @@ REQUIRED FLAGS This must be specified. - --control-plane-node-configs-from-file=CONTROL_PLANE_NODE_CONFIGS_FROM_FILE - Path of the YAML/JSON file that contains the control plane node - configs. + Populate control plane node config. - Examples: + Exactly one of these must be specified: - nodeConfigs: - - nodeIP: 10.200.0.10 - labels: - node1: label1 - node2: label2 - - nodeIP: 10.200.0.11 - labels: - node3: label3 - node4: label4 - - List of supported fields in nodeConfigs - - KEY VALUE NOTE - nodeIP string required, mutable - labels one or more key-val pairs optional, mutable - - This flag argument must be specified if any of the other - arguments in this group are specified. + --control-plane-node-configs=[labels=LABELS],[node-ip=NODE-IP] + Control plane node configuration. --control-plane-node-labels=[KEY=VALUE,...] Labels assigned to nodes of a node pool. @@ -326,11 +295,6 @@ OPTIONAL FLAGS Users that will be granted the cluster-admin role on the cluster, providing full access to the cluster. - Anthos on bare metal cluster maintenance configuration. - - --maintenance-address-cidr-blocks=[MAINTENANCE_ADDRESS_CIDR_BLOCKS,...] - IPv4 addresses to be placed into maintenance mode. - --annotations=[KEY=VALUE,...] Annotations on the Anthos on bare metal resource. @@ -352,6 +316,11 @@ OPTIONAL FLAGS --login-user=LOGIN_USER User name used to access node machines. + Anthos on bare metal cluster maintenance configuration. + + --maintenance-address-cidr-blocks=[MAINTENANCE_ADDRESS_CIDR_BLOCKS,...] + IPv4 addresses to be placed into maintenance mode. + --validate-only If set, only validate the request, but do not actually perform the operation. diff --git a/gcloud/alpha/container/bare-metal/clusters/query-version-config b/gcloud/alpha/container/bare-metal/clusters/query-version-config index 2896f613b..e027c0ffc 100644 --- a/gcloud/alpha/container/bare-metal/clusters/query-version-config +++ b/gcloud/alpha/container/bare-metal/clusters/query-version-config @@ -4,33 +4,58 @@ NAME SYNOPSIS gcloud alpha container bare-metal clusters query-version-config - (--cluster=CLUSTER - : [--admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP - : --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION; default="global" --admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT]) - [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + [--location=LOCATION] + [--cluster=CLUSTER + | [--admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP + : --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION; default="global" --admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Query versions for creating or upgrading an Anthos on bare metal user cluster. EXAMPLES - To query versions for creating a cluster with an admin cluster membership - named my-admin-cluster-membership managed in project - my-admin-cluster-project run: + To query all available versions in location us-west1, run: $ gcloud alpha container bare-metal clusters query-version-config \ + --location=us-west1 + + To query versions for creating a cluster with an admin cluster membership + named my-admin-cluster-membership managed in project + my-admin-cluster-project and location us-west, run: + + $ gcloud alpha container bare-metal clusters query-version-config \ + --location=us-west1 \ --admin-cluster-membership=my-admin-cluster-membership \ --admin-cluster-membership-project=my-admin-cluster-project - To query versions for upgrading a user cluster named my-user-cluster, run: + To query versions for upgrading a user cluster named my-user-cluster in + location us-west1, run: $ gcloud alpha container bare-metal clusters query-version-config \ - --cluster=my-user-cluster + --location=us-west1 --cluster=my-user-cluster + +FLAGS + Location resource - Google Cloud location to query versions. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property container_bare_metal/location with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --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; + ▸ set the property container_bare_metal/location. -REQUIRED FLAGS Use cases for querying versions. - Exactly one of these must be specified: + At most one of these can be specified: Upgrade an Anthos on bare metal user cluster use case. @@ -87,24 +112,6 @@ REQUIRED FLAGS ◇ provide the argument --project on the command line; ◇ set the property core/project. -OPTIONAL FLAGS - Location resource - Google Cloud location to query version configuration. - 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 container_bare_metal/location with a fully specified - name; - ◆ provide the argument --project on the command line; - ◆ set the property core/project. - - --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; - ▸ set the property container_bare_metal/location. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/container/bare-metal/clusters/update b/gcloud/alpha/container/bare-metal/clusters/update index 53d187dfd..4ee6ed442 100644 --- a/gcloud/alpha/container/bare-metal/clusters/update +++ b/gcloud/alpha/container/bare-metal/clusters/update @@ -10,11 +10,14 @@ SYNOPSIS [--maintenance-address-cidr-blocks=[MAINTENANCE_ADDRESS_CIDR_BLOCKS, ...]] [--validate-only] [--version=VERSION] [--api-server-args=[KEY=VALUE,...] - --control-plane-node-configs-from-file=CONTROL_PLANE_NODE_CONFIGS_FROM_FILE --control-plane-node-labels=[KEY=VALUE, - ...] --control-plane-node-taints=[KEY=VALUE:EFFECT,...]] + --control-plane-node-configs=[labels=LABELS],[node-ip=NODE-IP] + --control-plane-node-labels=[KEY=VALUE,...] + --control-plane-node-taints=[KEY=VALUE:EFFECT,...]] [--metal-lb-address-pools-from-file=METAL_LB_ADDRESS_POOLS_FROM_FILE - --metal-lb-load-balancer-node-configs-from-file=METAL_LB_LOAD_BALANCER_NODE_CONFIGS_FROM_FILE --metal-lb-load-balancer-node-labels=[KEY=VALUE, - ...] --metal-lb-load-balancer-node-taints=[KEY=VALUE:EFFECT,...]] + --metal-lb-load-balancer-node-configs=[labels=LABELS], + [node-ip=NODE-IP] + --metal-lb-load-balancer-node-labels=[KEY=VALUE,...] + --metal-lb-load-balancer-node-taints=[KEY=VALUE:EFFECT,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -109,27 +112,12 @@ FLAGS Anthos on bare metal node configuration for control plane nodes. - --control-plane-node-configs-from-file=CONTROL_PLANE_NODE_CONFIGS_FROM_FILE - Path of the YAML/JSON file that contains the control plane node - configs. + Populate control plane node config. - Examples: + At most one of these can be specified: - nodeConfigs: - - nodeIP: 10.200.0.10 - labels: - node1: label1 - node2: label2 - - nodeIP: 10.200.0.11 - labels: - node3: label3 - node4: label4 - - List of supported fields in nodeConfigs - - KEY VALUE NOTE - nodeIP string required, mutable - labels one or more key-val pairs optional, mutable + --control-plane-node-configs=[labels=LABELS],[node-ip=NODE-IP] + Control plane node configuration. --control-plane-node-labels=[KEY=VALUE,...] Labels assigned to nodes of a node pool. @@ -177,29 +165,12 @@ FLAGS MetalLB Node Pool configuration. - --metal-lb-load-balancer-node-configs-from-file=METAL_LB_LOAD_BALANCER_NODE_CONFIGS_FROM_FILE - Path of the YAML/JSON file that contains the Metal LB node - configs. + Populate MetalLB load balancer node config. - Examples: + At most one of these can be specified: - nodeConfigs: - - nodeIP: 10.200.0.10 - labels: - node1: label1 - node2: label2 - - nodeIP: 10.200.0.11 - labels: - node3: label3 - node4: label4 - - List of supported fields in nodeConfigs - - KEY VALUE NOTE - nodeIP string required, - mutable - labels one or more key-val pairs optional, - mutable + --metal-lb-load-balancer-node-configs=[labels=LABELS],[node-ip=NODE-IP] + MetalLB load balancer node configuration. --metal-lb-load-balancer-node-labels=[KEY=VALUE,...] Labels assigned to nodes of a MetalLB node pool. diff --git a/gcloud/alpha/container/vmware/clusters/create b/gcloud/alpha/container/vmware/clusters/create index 896b0f698..d78c4e4b3 100644 --- a/gcloud/alpha/container/vmware/clusters/create +++ b/gcloud/alpha/container/vmware/clusters/create @@ -8,8 +8,10 @@ SYNOPSIS (--admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP : --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION --admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT) ((--control-plane-vip=CONTROL_PLANE_VIP --ingress-vip=INGRESS_VIP) - (--metal-lb-config-from-file=METAL_LB_CONFIG_FROM_FILE - : --control-plane-node-port=CONTROL_PLANE_NODE_PORT + (--metal-lb-config-address-pools=[addresses=ADDRESSES], + [avoid-buggy-ips=AVOID-BUGGY-IPS], + [manual-assign=MANUAL-ASSIGN],[pool=POOL] + | --control-plane-node-port=CONTROL_PLANE_NODE_PORT --ingress-http-node-port=INGRESS_HTTP_NODE_PORT --ingress-https-node-port=INGRESS_HTTPS_NODE_PORT --konnectivity-server-node-port=KONNECTIVITY_SERVER_NODE_PORT @@ -21,11 +23,11 @@ SYNOPSIS : --dns-search-domains=[DNS_SEARCH_DOMAINS,...] --dns-servers=[DNS_SERVERS,...] --ntp-servers=[NTP_SERVERS,...] --enable-dhcp - | --static-ip-config-from-file=STATIC_IP_CONFIG_FROM_FILE) - [--admin-users=ADMIN_USERS] [--annotations=[KEY=VALUE,...]] [--async] - [--description=DESCRIPTION] [--disable-aag-config] - [--disable-vsphere-csi] [--enable-auto-repair] [--enable-vm-tracking] - [--validate-only] [--version=VERSION] + | --static-ip-config-ip-blocks=[gateway=GATEWAY], + [ips=IPS],[netmask=NETMASK]) [--admin-users=ADMIN_USERS] + [--annotations=[KEY=VALUE,...]] [--async] [--description=DESCRIPTION] + [--disable-aag-config] [--disable-vsphere-csi] [--enable-auto-repair] + [--enable-vm-tracking] [--validate-only] [--version=VERSION] [--cpus=CPUS --enable-auto-resize --memory=MEMORY --replicas=REPLICAS] [--enable-advanced-networking --enable-dataplane-v2] [GCLOUD_WIDE_FLAG ...] @@ -126,40 +128,22 @@ REQUIRED FLAGS MetalLB Configuration - --metal-lb-config-from-file=METAL_LB_CONFIG_FROM_FILE - Path of the YAML/JSON file that contains the MetalLB - configurations. + At most one of these can be specified: + + --metal-lb-config-address-pools=[addresses=ADDRESSES],[avoid-buggy-ips=AVOID-BUGGY-IPS],[manual-assign=MANUAL-ASSIGN],[pool=POOL] + MetalLB load balancer configurations. Examples: - metalLBConfig: - addressPools: - - pool: lb-test-ip - addresses: - - 10.251.133.79/32 - - 10.251.133.80/32 - avoidBuggyIPs: True - manualAssign: False - - pool: ingress-ip - addresses: - - 10.251.133.70/32 - avoidBuggyIPs: False - manualAssign: True + To specify MetalLB load balancer configurations for two address + pools pool1 and pool2, - List of supported fields in metalLBConfig + $ gcloud gcloud alpha container vmware clusters create + --metal-lb-config-address-pools 'pool=pool1,avoid-buggy-ips=True,manual-assign=True,addresses=192.168.1.1/32;192.168.1.2-192.168.1.3' + --metal-lb-config-address-pools 'pool=pool2,avoid-buggy-ips=False,manual-assign=False,addresses=192.168.2.1/32;192.168.2.2-192.168.2.3' - KEY VALUE NOTE - addressPools one or more addressPools required, mutable - - List of supported fields in addressPools - - KEY VALUE NOTE - pool string required, mutable - addresses one or more IP ranges required, mutable - avoidBuggyIPs bool optional, mutable, - defaults to False - manualAssign bool optional, mutable, - defaults to False + Use quote around the flag value to escape semicolon in the + terminal. Manual load balancer configuration @@ -231,46 +215,21 @@ REQUIRED FLAGS Static IP configuration group - --static-ip-config-from-file=STATIC_IP_CONFIG_FROM_FILE - Path of the YAML/JSON file that contains the static IP - configurations, used by Anthos on VMware user cluster node pools. + At most one of these can be specified: - Examples: + --static-ip-config-ip-blocks=[gateway=GATEWAY],[ips=IPS],[netmask=NETMASK] + Static IP configurations. - staticIPConfig: - ipBlocks: - - gateway: 10.251.31.254 - netmask: 255.255.252.0 - ips: - - hostname: hostname-1 - ip: 1.1.1.1 - - hostname: hostname-2 - ip: 2.2.2.2 - - hostname: hostname-3 - ip: 3.3.3.3 - - hostname: hostname-4 - ip: 4.4.4.4 + Example: - List of supported fields in staticIPConfig + To specify two Static IP blocks, - KEY VALUE NOTE - ipBlocks one or more ipBlocks required, mutable + $ gcloud gcloud alpha container vmware clusters create + --static-ip-config-ip-blocks 'gateway=192.168.0.1,netmask=255.255.255.0,ips=hostname-1:1.1.1.1;hostname-2:2.2.2.2' + --static-ip-config-ip-blocks 'gateway=192.168.1.1,netmask=255.255.0.0,ips=hostname-3:3.3.3.3;hostname-4:4.4.4.4' - List of supported fields in ipBlocks - - KEY VALUE NOTE - gateway IP address required, immutable - netmask IP address required, immutable - ips one or more ips required, mutable - - List of supported fields in ips - - KEY VALUE NOTE - hostname string optional, immutable - ip IP address required, immutable - - New ips fields can be added, existing ips fields cannot be - removed or updated. + Use quote around the flag value to escape semicolon in the + terminal. OPTIONAL FLAGS User cluster authorization configurations to bootstrap onto the admin diff --git a/gcloud/alpha/container/vmware/clusters/query-version-config b/gcloud/alpha/container/vmware/clusters/query-version-config index 0f864abb5..16a19afc8 100644 --- a/gcloud/alpha/container/vmware/clusters/query-version-config +++ b/gcloud/alpha/container/vmware/clusters/query-version-config @@ -4,33 +4,58 @@ NAME SYNOPSIS gcloud alpha container vmware clusters query-version-config - (--cluster=CLUSTER - : [--admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP - : --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION; default="global" --admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT]) - [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + [--location=LOCATION] + [--cluster=CLUSTER + | [--admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP + : --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION; default="global" --admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Query versions for creating or upgrading an Anthos on VMware user cluster. EXAMPLES - To query versions for creating a cluster with an admin cluster membership - named my-admin-cluster-membership managed in project - my-admin-cluster-project run: + To query all available versions in location us-west1, run: $ gcloud alpha container vmware clusters query-version-config \ + --location=us-west1 + + To query versions for creating a cluster with an admin cluster membership + named my-admin-cluster-membership managed in project + my-admin-cluster-project and location us-west, run: + + $ gcloud alpha container vmware clusters query-version-config \ + --location=us-west1 \ --admin-cluster-membership=my-admin-cluster-membership \ --admin-cluster-membership-project=my-admin-cluster-project - To query versions for upgrading a user cluster named my-user-cluster, run: + To query versions for upgrading a user cluster named my-user-cluster in + location us-west1, run: $ gcloud alpha container vmware clusters query-version-config \ - --cluster=my-user-cluster + --location=us-west1 --cluster=my-user-cluster + +FLAGS + Location resource - Google Cloud location to query versions. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property container_vmware/location with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --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; + ▸ set the property container_vmware/location. -REQUIRED FLAGS Use cases for querying versions. - Exactly one of these must be specified: + At most one of these can be specified: Upgrade an Anthos on VMware user cluster use case. @@ -87,24 +112,6 @@ REQUIRED FLAGS ◇ provide the argument --project on the command line; ◇ set the property core/project. -OPTIONAL FLAGS - Location resource - Google Cloud location to query version configuration. - 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 container_vmware/location with a fully specified - name; - ◆ provide the argument --project on the command line; - ◆ set the property core/project. - - --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; - ▸ set the property container_vmware/location. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/container/vmware/clusters/update b/gcloud/alpha/container/vmware/clusters/update index 1637ded01..5e64512e3 100644 --- a/gcloud/alpha/container/vmware/clusters/update +++ b/gcloud/alpha/container/vmware/clusters/update @@ -6,9 +6,11 @@ SYNOPSIS gcloud alpha container vmware clusters update (CLUSTER : --location=LOCATION) [--admin-users=ADMIN_USERS] [--async] [--description=DESCRIPTION] - [--metal-lb-config-from-file=METAL_LB_CONFIG_FROM_FILE] - [--static-ip-config-from-file=STATIC_IP_CONFIG_FROM_FILE] - [--version=VERSION] + [--metal-lb-config-address-pools=[addresses=ADDRESSES], + [avoid-buggy-ips=AVOID-BUGGY-IPS], + [manual-assign=MANUAL-ASSIGN],[pool=POOL]] + [--static-ip-config-ip-blocks=[gateway=GATEWAY], + [ips=IPS],[netmask=NETMASK]] [--version=VERSION] [--cpus=CPUS --memory=MEMORY --disable-auto-resize | --enable-auto-resize] [--disable-aag-config | --enable-aag-config] [--disable-auto-repair | --enable-auto-repair] @@ -71,40 +73,22 @@ FLAGS MetalLB Configuration - --metal-lb-config-from-file=METAL_LB_CONFIG_FROM_FILE - Path of the YAML/JSON file that contains the MetalLB - configurations. + At most one of these can be specified: + + --metal-lb-config-address-pools=[addresses=ADDRESSES],[avoid-buggy-ips=AVOID-BUGGY-IPS],[manual-assign=MANUAL-ASSIGN],[pool=POOL] + MetalLB load balancer configurations. Examples: - metalLBConfig: - addressPools: - - pool: lb-test-ip - addresses: - - 10.251.133.79/32 - - 10.251.133.80/32 - avoidBuggyIPs: True - manualAssign: False - - pool: ingress-ip - addresses: - - 10.251.133.70/32 - avoidBuggyIPs: False - manualAssign: True + To specify MetalLB load balancer configurations for two address + pools pool1 and pool2, - List of supported fields in metalLBConfig + $ gcloud gcloud alpha container vmware clusters update + --metal-lb-config-address-pools 'pool=pool1,avoid-buggy-ips=True,manual-assign=True,addresses=192.168.1.1/32;192.168.1.2-192.168.1.3' + --metal-lb-config-address-pools 'pool=pool2,avoid-buggy-ips=False,manual-assign=False,addresses=192.168.2.1/32;192.168.2.2-192.168.2.3' - KEY VALUE NOTE - addressPools one or more addressPools required, mutable - - List of supported fields in addressPools - - KEY VALUE NOTE - pool string required, mutable - addresses one or more IP ranges required, mutable - avoidBuggyIPs bool optional, mutable, - defaults to False - manualAssign bool optional, mutable, - defaults to False + Use quote around the flag value to escape semicolon in the + terminal. VMware User Cluster network configurations @@ -112,46 +96,21 @@ FLAGS Static IP configuration group - --static-ip-config-from-file=STATIC_IP_CONFIG_FROM_FILE - Path of the YAML/JSON file that contains the static IP - configurations, used by Anthos on VMware user cluster node pools. + At most one of these can be specified: - Examples: + --static-ip-config-ip-blocks=[gateway=GATEWAY],[ips=IPS],[netmask=NETMASK] + Static IP configurations. - staticIPConfig: - ipBlocks: - - gateway: 10.251.31.254 - netmask: 255.255.252.0 - ips: - - hostname: hostname-1 - ip: 1.1.1.1 - - hostname: hostname-2 - ip: 2.2.2.2 - - hostname: hostname-3 - ip: 3.3.3.3 - - hostname: hostname-4 - ip: 4.4.4.4 + Example: - List of supported fields in staticIPConfig + To specify two Static IP blocks, - KEY VALUE NOTE - ipBlocks one or more ipBlocks required, mutable + $ gcloud gcloud alpha container vmware clusters update + --static-ip-config-ip-blocks 'gateway=192.168.0.1,netmask=255.255.255.0,ips=hostname-1:1.1.1.1;hostname-2:2.2.2.2' + --static-ip-config-ip-blocks 'gateway=192.168.1.1,netmask=255.255.0.0,ips=hostname-3:3.3.3.3;hostname-4:4.4.4.4' - List of supported fields in ipBlocks - - KEY VALUE NOTE - gateway IP address required, immutable - netmask IP address required, immutable - ips one or more ips required, mutable - - List of supported fields in ips - - KEY VALUE NOTE - hostname string optional, immutable - ip IP address required, immutable - - New ips fields can be added, existing ips fields cannot be - removed or updated. + Use quote around the flag value to escape semicolon in the + terminal. --version=VERSION Anthos Cluster on VMware version for the user cluster resource diff --git a/gcloud/alpha/database-migration/connection-profiles/list b/gcloud/alpha/database-migration/connection-profiles/list index 1cddb474e..9ec67c520 100644 --- a/gcloud/alpha/database-migration/connection-profiles/list +++ b/gcloud/alpha/database-migration/connection-profiles/list @@ -3,7 +3,7 @@ NAME Migration Service connection profiles SYNOPSIS - gcloud alpha database-migration connection-profiles list --region=REGION + gcloud alpha database-migration connection-profiles list [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/alpha/database-migration/migration-jobs/update b/gcloud/alpha/database-migration/migration-jobs/update index bea588d89..8bba28920 100644 --- a/gcloud/alpha/database-migration/migration-jobs/update +++ b/gcloud/alpha/database-migration/migration-jobs/update @@ -4,9 +4,10 @@ NAME SYNOPSIS gcloud alpha database-migration migration-jobs update - (MIGRATION_JOB : --region=REGION) --destination=DESTINATION - --source=SOURCE [--no-async] [--display-name=DISPLAY_NAME] - [--dump-path=DUMP_PATH] [--type=TYPE] [--update-labels=[KEY=VALUE,...]] + (MIGRATION_JOB : --region=REGION) [--no-async] + [--destination=DESTINATION] [--display-name=DISPLAY_NAME] + [--dump-path=DUMP_PATH] [--source=SOURCE] [--type=TYPE] + [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [--peer-vpc=PEER_VPC | --static-ip | --vm=VM --vm-ip=VM_IP --vm-port=VM_PORT --vpc=VPC] @@ -58,6 +59,9 @@ POSITIONAL ARGUMENTS ▸ provide the argument --region on the command line. FLAGS + --no-async + Waits for the operation in progress to complete before returning. + Connection profile resource - ID of the destination connection profile, representing the destination database. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be @@ -75,6 +79,15 @@ FLAGS connection_profile. To set the connection_profile attribute: ▸ provide the argument --destination on the command line. + --display-name=DISPLAY_NAME + A user-friendly name for the migration job. The display name can + include letters, numbers, spaces, and hyphens, and must start with a + letter. + + --dump-path=DUMP_PATH + Path to the dump file in Google Cloud Storage, in the format: + gs://[BUCKET_NAME]/[OBJECT_NAME]. + Connection profile resource - ID of the source connection profile, representing the source database. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in @@ -92,18 +105,6 @@ FLAGS connection_profile. To set the connection_profile attribute: ▸ provide the argument --source on the command line. - --no-async - Waits for the operation in progress to complete before returning. - - --display-name=DISPLAY_NAME - A user-friendly name for the migration job. The display name can - include letters, numbers, spaces, and hyphens, and must start with a - letter. - - --dump-path=DUMP_PATH - Path to the dump file in Google Cloud Storage, in the format: - gs://[BUCKET_NAME]/[OBJECT_NAME]. - --type=TYPE Type of the migration job. TYPE must be one of: ONE_TIME, CONTINUOUS. diff --git a/gcloud/alpha/dataflow/jobs/config/export b/gcloud/alpha/dataflow/jobs/config/export index 851d5000b..b139c3e8d 100644 --- a/gcloud/alpha/dataflow/jobs/config/export +++ b/gcloud/alpha/dataflow/jobs/config/export @@ -3,7 +3,7 @@ NAME Dataflow job SYNOPSIS - gcloud alpha dataflow jobs config export (JOB : --all) + gcloud alpha dataflow jobs config export ([JOB]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] @@ -47,9 +47,6 @@ POSITIONAL ARGUMENTS job attribute: ▸ provide the argument job on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/dataproc/clusters/create b/gcloud/alpha/dataproc/clusters/create index 0dbcc8fe4..2d3778c5f 100644 --- a/gcloud/alpha/dataproc/clusters/create +++ b/gcloud/alpha/dataproc/clusters/create @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud alpha dataproc clusters create (CLUSTER : --region=REGION) - --autoscaling-policy=AUTOSCALING_POLICY [--no-address] [--async] + [--no-address] [--async] [--autoscaling-policy=AUTOSCALING_POLICY] [--bucket=BUCKET] [--dataproc-metastore=DATAPROC_METASTORE] [--driver-pool-accelerator=[type=TYPE,[count=COUNT],...]] [--driver-pool-boot-disk-size=DRIVER_POOL_BOOT_DISK_SIZE] @@ -102,11 +102,6 @@ POSITIONAL ARGUMENTS ▸ set the property dataproc/region. FLAGS - --autoscaling-policy=AUTOSCALING_POLICY - ID of the autoscaling policy or fully qualified identifier for the - autoscaling policy. To set the autoscaling_policy attribute: - ◆ provide the argument --autoscaling-policy on the command line. - --no-address If provided, the instances in the cluster will not be assigned external IP addresses. @@ -122,6 +117,11 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --autoscaling-policy=AUTOSCALING_POLICY + ID of the autoscaling policy or fully qualified identifier for the + autoscaling policy. To set the autoscaling_policy attribute: + ◆ provide the argument --autoscaling-policy on the command line. + --bucket=BUCKET The Google Cloud Storage bucket to use by default to stage job dependencies, miscellaneous config files, and job driver console output @@ -449,14 +449,16 @@ FLAGS line. --gce-pd-kms-key-location=GCE_PD_KMS_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --gce-pd-kms-key on the command line with a fully specified name; ▸ provide the argument --gce-pd-kms-key-location on the command line. --gce-pd-kms-key-project=GCE_PD_KMS_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --gce-pd-kms-key on the command line with a fully specified name; ▸ provide the argument --gce-pd-kms-key-project on the command @@ -710,14 +712,16 @@ FLAGS line. --kerberos-kms-key-location=KERBEROS_KMS_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▫ provide the argument --kerberos-kms-key on the command line with a fully specified name; ▫ provide the argument --kerberos-kms-key-location on the command line. --kerberos-kms-key-project=KERBEROS_KMS_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▫ provide the argument --kerberos-kms-key on the command line with a fully specified name; ▫ provide the argument --kerberos-kms-key-project on the command diff --git a/gcloud/alpha/dataproc/clusters/update b/gcloud/alpha/dataproc/clusters/update index e28f862d4..6aa360e51 100644 --- a/gcloud/alpha/dataproc/clusters/update +++ b/gcloud/alpha/dataproc/clusters/update @@ -7,7 +7,7 @@ SYNOPSIS [--graceful-decommission-timeout=GRACEFUL_DECOMMISSION_TIMEOUT] [--num-secondary-workers=NUM_SECONDARY_WORKERS] [--num-workers=NUM_WORKERS] [--update-labels=[KEY=VALUE,...]] - [--autoscaling-policy=AUTOSCALING_POLICY : --disable-autoscaling] + [--autoscaling-policy=AUTOSCALING_POLICY | --disable-autoscaling] [--clear-labels | --remove-labels=[KEY,...]] [--expiration-time=EXPIRATION_TIME | --max-age=MAX_AGE | --no-max-age] [--max-idle=MAX_IDLE | --no-max-idle] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/alpha/dataproc/workflow-templates/set-managed-cluster b/gcloud/alpha/dataproc/workflow-templates/set-managed-cluster index f80917280..a82b55ad3 100644 --- a/gcloud/alpha/dataproc/workflow-templates/set-managed-cluster +++ b/gcloud/alpha/dataproc/workflow-templates/set-managed-cluster @@ -4,9 +4,10 @@ NAME SYNOPSIS gcloud alpha dataproc workflow-templates set-managed-cluster - (TEMPLATE : --region=REGION) --autoscaling-policy=AUTOSCALING_POLICY - [--no-address] [--bucket=BUCKET] [--cluster-name=CLUSTER_NAME] - [--dataproc-metastore=DATAPROC_METASTORE] [--enable-component-gateway] + (TEMPLATE : --region=REGION) [--no-address] + [--autoscaling-policy=AUTOSCALING_POLICY] [--bucket=BUCKET] + [--cluster-name=CLUSTER_NAME] [--dataproc-metastore=DATAPROC_METASTORE] + [--enable-component-gateway] [--initialization-action-timeout=TIMEOUT; default="10m"] [--initialization-actions=CLOUD_STORAGE_URI,[...]] [--labels=[KEY=VALUE,...]] @@ -90,11 +91,6 @@ POSITIONAL ARGUMENTS ▸ set the property dataproc/region. FLAGS - --autoscaling-policy=AUTOSCALING_POLICY - ID of the autoscaling policy or fully qualified identifier for the - autoscaling policy. To set the autoscaling_policy attribute: - ◆ provide the argument --autoscaling-policy on the command line. - --no-address If provided, the instances in the cluster will not be assigned external IP addresses. @@ -106,6 +102,11 @@ FLAGS achieved without external IP addresses using Private Google Access (https://cloud.google.com/compute/docs/private-google-access). + --autoscaling-policy=AUTOSCALING_POLICY + ID of the autoscaling policy or fully qualified identifier for the + autoscaling policy. To set the autoscaling_policy attribute: + ◆ provide the argument --autoscaling-policy on the command line. + --bucket=BUCKET The Google Cloud Storage bucket to use by default to stage job dependencies, miscellaneous config files, and job driver console output @@ -470,14 +471,16 @@ FLAGS line. --kerberos-kms-key-location=KERBEROS_KMS_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▫ provide the argument --kerberos-kms-key on the command line with a fully specified name; ▫ provide the argument --kerberos-kms-key-location on the command line. --kerberos-kms-key-project=KERBEROS_KMS_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▫ provide the argument --kerberos-kms-key on the command line with a fully specified name; ▫ provide the argument --kerberos-kms-key-project on the command diff --git a/gcloud/alpha/dns/managed-zones/config/export b/gcloud/alpha/dns/managed-zones/config/export index 4b978d60a..25eb7b2bb 100644 --- a/gcloud/alpha/dns/managed-zones/config/export +++ b/gcloud/alpha/dns/managed-zones/config/export @@ -3,7 +3,7 @@ NAME a Dns managed zone SYNOPSIS - gcloud alpha dns managed-zones config export (MANAGED_ZONE : --all) + gcloud alpha dns managed-zones config export ([MANAGED_ZONE]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] @@ -48,9 +48,6 @@ POSITIONAL ARGUMENTS managed_zone. To set the managed_zone attribute: ▸ provide the argument managed_zone on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/dns/policies/config/export b/gcloud/alpha/dns/policies/config/export index 56fa46457..c8ff5e9ee 100644 --- a/gcloud/alpha/dns/policies/config/export +++ b/gcloud/alpha/dns/policies/config/export @@ -3,7 +3,7 @@ NAME Dns policy SYNOPSIS - gcloud alpha dns policies config export (POLICY : --all) + gcloud alpha dns policies config export ([POLICY]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] @@ -47,9 +47,6 @@ POSITIONAL ARGUMENTS the policy attribute: ▸ provide the argument policy on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/dns/record-sets/create b/gcloud/alpha/dns/record-sets/create index b122ea4dd..27d454c8a 100644 --- a/gcloud/alpha/dns/record-sets/create +++ b/gcloud/alpha/dns/record-sets/create @@ -128,16 +128,18 @@ REQUIRED FLAGS For --routing-policy-type = "GEO" this flag indicates the geo-locations policy data. The field accepts a semicolon-delimited list of the format - "${region}=${rrdata},${rrdata}". Each individual rrdata can - either be an ip address or a string of the format - forwarding_config_name@region. + "${region}=${rrdata},${rrdata}". Each rrdata can either be an IP + address or a reference to a forwarding rule of the format + FORWARDING_RULE_NAME", "FORWARDING_RULE_NAME@region", or the full + resource path of the forwarding rule. Configuration for primary backup routing policy --routing-policy-backup-data=ROUTING_POLICY_BACKUP_DATA - The backup config for a primary backup routing policy. This is - the same format as the routing-policy-data arg as this is just - another geo policy. + The backup configuration for a primary backup routing policy. + This configuration has the same format as the + routing-policy-data argument because it is just another + geo-locations policy. This flag argument must be specified if any of the other arguments in this group are specified. @@ -152,9 +154,10 @@ REQUIRED FLAGS arguments in this group are specified. --routing-policy-primary-data=ROUTING_POLICY_PRIMARY_DATA - The primary config for a primary backup routing policy. This is - just a list of forwarding configs of the format "config_name" - or "config_name@scope" + The primary configuration for a primary backup routing policy. + This configuration is a list of forwarding rules of the format + "FORWARDING_RULE_NAME", "FORWARDING_RULE_NAME@scope", or the + full resource path of the forwarding rule. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/alpha/dns/record-sets/update b/gcloud/alpha/dns/record-sets/update index 0d0239376..4bfae052f 100644 --- a/gcloud/alpha/dns/record-sets/update +++ b/gcloud/alpha/dns/record-sets/update @@ -95,16 +95,18 @@ REQUIRED FLAGS For --routing-policy-type = "GEO" this flag indicates the geo-locations policy data. The field accepts a semicolon-delimited list of the format - "${region}=${rrdata},${rrdata}". Each individual rrdata can - either be an ip address or a string of the format - forwarding_config_name@region. + "${region}=${rrdata},${rrdata}". Each rrdata can either be an IP + address or a reference to a forwarding rule of the format + FORWARDING_RULE_NAME", "FORWARDING_RULE_NAME@region", or the full + resource path of the forwarding rule. Configuration for primary backup routing policy --routing-policy-backup-data=ROUTING_POLICY_BACKUP_DATA - The backup config for a primary backup routing policy. This is - the same format as the routing-policy-data arg as this is just - another geo policy. + The backup configuration for a primary backup routing policy. + This configuration has the same format as the + routing-policy-data argument because it is just another + geo-locations policy. This flag argument must be specified if any of the other arguments in this group are specified. @@ -119,9 +121,10 @@ REQUIRED FLAGS arguments in this group are specified. --routing-policy-primary-data=ROUTING_POLICY_PRIMARY_DATA - The primary config for a primary backup routing policy. This is - just a list of forwarding configs of the format "config_name" - or "config_name@scope" + The primary configuration for a primary backup routing policy. + This configuration is a list of forwarding rules of the format + "FORWARDING_RULE_NAME", "FORWARDING_RULE_NAME@scope", or the + full resource path of the forwarding rule. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/alpha/edge-cloud/container/vpn-connections/create b/gcloud/alpha/edge-cloud/container/vpn-connections/create index c62110e0c..877aa9ffe 100644 --- a/gcloud/alpha/edge-cloud/container/vpn-connections/create +++ b/gcloud/alpha/edge-cloud/container/vpn-connections/create @@ -7,7 +7,7 @@ SYNOPSIS (VPN_CONNECTION : --location=LOCATION) --cluster=CLUSTER --vpc-network=VPC_NETWORK [--async] [--high-availability] [--labels=[KEY=VALUE,...]] [--nat-gateway-ip=NAT_GATEWAY_IP] - [--vpc-project=VPC_PROJECT] [GCLOUD_WIDE_FLAG ...] + [--router=ROUTER] [--vpc-project=VPC_PROJECT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Creates a new VPN connection. @@ -81,6 +81,12 @@ OPTIONAL FLAGS The NAT gateway IP for the gateway floating IPs. Required if cluster sits behind NAT. + --router=ROUTER + Name of the Cloud Router to use when creating the VPN connection. This + Cloud Router must be in the same region as the cluster and connected to + the provided VPC network. If not provided, a service-managed Cloud + Router will either be created or reused to create the VPN connection. + --vpc-project=VPC_PROJECT The project of the VPC network. Required if the project of VPC network differs from the project of the cluster. diff --git a/gcloud/alpha/edge-cloud/networking/help b/gcloud/alpha/edge-cloud/networking/help index 6cbcc14a6..b801019f0 100644 --- a/gcloud/alpha/edge-cloud/networking/help +++ b/gcloud/alpha/edge-cloud/networking/help @@ -32,9 +32,14 @@ GROUPS subnets (ALPHA) Manage Distributed Cloud Edge Network subnets. + zones + (ALPHA) Manage Distributed Cloud Edge Network zones. + 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 edge-cloud networking diff --git a/gcloud/alpha/edge-cloud/networking/interconnects/attachments/dedicated/create b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/dedicated/create index c151d67a2..d8f7fd4f3 100644 --- a/gcloud/alpha/edge-cloud/networking/interconnects/attachments/dedicated/create +++ b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/dedicated/create @@ -107,5 +107,8 @@ 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 edge-cloud networking interconnects attachments dedicated \ + create diff --git a/gcloud/alpha/edge-cloud/networking/interconnects/attachments/dedicated/help b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/dedicated/help index efe199268..2169d8c27 100644 --- a/gcloud/alpha/edge-cloud/networking/interconnects/attachments/dedicated/help +++ b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/dedicated/help @@ -27,5 +27,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 edge-cloud networking interconnects attachments dedicated diff --git a/gcloud/alpha/edge-cloud/networking/interconnects/attachments/delete b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/delete index b554292c3..04cd40c3d 100644 --- a/gcloud/alpha/edge-cloud/networking/interconnects/attachments/delete +++ b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/delete @@ -75,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 edge-cloud networking interconnects attachments delete diff --git a/gcloud/alpha/edge-cloud/networking/interconnects/attachments/describe b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/describe index 817a1c5c8..be579651c 100644 --- a/gcloud/alpha/edge-cloud/networking/interconnects/attachments/describe +++ b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/describe @@ -72,5 +72,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 edge-cloud networking interconnects attachments describe diff --git a/gcloud/alpha/edge-cloud/networking/interconnects/attachments/help b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/help index 8be0760f5..100a2f3e1 100644 --- a/gcloud/alpha/edge-cloud/networking/interconnects/attachments/help +++ b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/help @@ -39,5 +39,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud edge-cloud networking interconnects attachments diff --git a/gcloud/alpha/edge-cloud/networking/interconnects/attachments/list b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/list index 32ac67b7e..232e6dc21 100644 --- a/gcloud/alpha/edge-cloud/networking/interconnects/attachments/list +++ b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/list @@ -94,5 +94,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 edge-cloud networking interconnects attachments list diff --git a/gcloud/alpha/edge-cloud/networking/interconnects/describe b/gcloud/alpha/edge-cloud/networking/interconnects/describe index 5f1096da1..a3d52d5d2 100644 --- a/gcloud/alpha/edge-cloud/networking/interconnects/describe +++ b/gcloud/alpha/edge-cloud/networking/interconnects/describe @@ -67,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 edge-cloud networking interconnects describe diff --git a/gcloud/alpha/edge-cloud/networking/interconnects/get-diagnostics b/gcloud/alpha/edge-cloud/networking/interconnects/get-diagnostics index 60e0653bd..387017796 100644 --- a/gcloud/alpha/edge-cloud/networking/interconnects/get-diagnostics +++ b/gcloud/alpha/edge-cloud/networking/interconnects/get-diagnostics @@ -63,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 edge-cloud networking interconnects get-diagnostics diff --git a/gcloud/alpha/edge-cloud/networking/interconnects/help b/gcloud/alpha/edge-cloud/networking/interconnects/help index 7e1189aa5..fa0e2590a 100644 --- a/gcloud/alpha/edge-cloud/networking/interconnects/help +++ b/gcloud/alpha/edge-cloud/networking/interconnects/help @@ -38,5 +38,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 edge-cloud networking interconnects diff --git a/gcloud/alpha/edge-cloud/networking/interconnects/list b/gcloud/alpha/edge-cloud/networking/interconnects/list index c64a20688..29e093e7d 100644 --- a/gcloud/alpha/edge-cloud/networking/interconnects/list +++ b/gcloud/alpha/edge-cloud/networking/interconnects/list @@ -94,5 +94,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 edge-cloud networking interconnects list diff --git a/gcloud/alpha/edge-cloud/networking/networks/create b/gcloud/alpha/edge-cloud/networking/networks/create index 679a4c335..b0d8bd2b3 100644 --- a/gcloud/alpha/edge-cloud/networking/networks/create +++ b/gcloud/alpha/edge-cloud/networking/networks/create @@ -89,5 +89,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 edge-cloud networking networks create diff --git a/gcloud/alpha/edge-cloud/networking/networks/delete b/gcloud/alpha/edge-cloud/networking/networks/delete index 8dc027e02..7b95384b0 100644 --- a/gcloud/alpha/edge-cloud/networking/networks/delete +++ b/gcloud/alpha/edge-cloud/networking/networks/delete @@ -72,5 +72,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 edge-cloud networking networks delete diff --git a/gcloud/alpha/edge-cloud/networking/networks/describe b/gcloud/alpha/edge-cloud/networking/networks/describe index 027fa8080..7eae4af41 100644 --- a/gcloud/alpha/edge-cloud/networking/networks/describe +++ b/gcloud/alpha/edge-cloud/networking/networks/describe @@ -67,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 edge-cloud networking networks describe diff --git a/gcloud/alpha/edge-cloud/networking/networks/get-status b/gcloud/alpha/edge-cloud/networking/networks/get-status index 58ac45cee..dab6f5d75 100644 --- a/gcloud/alpha/edge-cloud/networking/networks/get-status +++ b/gcloud/alpha/edge-cloud/networking/networks/get-status @@ -61,5 +61,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 edge-cloud networking networks get-status diff --git a/gcloud/alpha/edge-cloud/networking/networks/help b/gcloud/alpha/edge-cloud/networking/networks/help index 526222276..17c197e8f 100644 --- a/gcloud/alpha/edge-cloud/networking/networks/help +++ b/gcloud/alpha/edge-cloud/networking/networks/help @@ -36,5 +36,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 edge-cloud networking networks diff --git a/gcloud/alpha/edge-cloud/networking/networks/list b/gcloud/alpha/edge-cloud/networking/networks/list index 14f668d5c..56a73b8f0 100644 --- a/gcloud/alpha/edge-cloud/networking/networks/list +++ b/gcloud/alpha/edge-cloud/networking/networks/list @@ -94,5 +94,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 edge-cloud networking networks list diff --git a/gcloud/alpha/edge-cloud/networking/operations/describe b/gcloud/alpha/edge-cloud/networking/operations/describe index 36f2938f1..0e702e805 100644 --- a/gcloud/alpha/edge-cloud/networking/operations/describe +++ b/gcloud/alpha/edge-cloud/networking/operations/describe @@ -60,5 +60,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 edge-cloud networking operations describe diff --git a/gcloud/alpha/edge-cloud/networking/operations/help b/gcloud/alpha/edge-cloud/networking/operations/help index 91fad0d11..62309aceb 100644 --- a/gcloud/alpha/edge-cloud/networking/operations/help +++ b/gcloud/alpha/edge-cloud/networking/operations/help @@ -28,5 +28,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 edge-cloud networking operations diff --git a/gcloud/alpha/edge-cloud/networking/operations/wait b/gcloud/alpha/edge-cloud/networking/operations/wait index 2f968cd5b..ffc20bf81 100644 --- a/gcloud/alpha/edge-cloud/networking/operations/wait +++ b/gcloud/alpha/edge-cloud/networking/operations/wait @@ -62,5 +62,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 edge-cloud networking operations wait diff --git a/gcloud/alpha/edge-cloud/networking/routers/add-bgp-peer b/gcloud/alpha/edge-cloud/networking/routers/add-bgp-peer index b38b54350..01a1bc50c 100644 --- a/gcloud/alpha/edge-cloud/networking/routers/add-bgp-peer +++ b/gcloud/alpha/edge-cloud/networking/routers/add-bgp-peer @@ -84,5 +84,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 edge-cloud networking routers add-bgp-peer diff --git a/gcloud/alpha/edge-cloud/networking/routers/add-interface b/gcloud/alpha/edge-cloud/networking/routers/add-interface index ac2750e55..ffc1dc01e 100644 --- a/gcloud/alpha/edge-cloud/networking/routers/add-interface +++ b/gcloud/alpha/edge-cloud/networking/routers/add-interface @@ -112,5 +112,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 edge-cloud networking routers add-interface diff --git a/gcloud/alpha/edge-cloud/networking/routers/create b/gcloud/alpha/edge-cloud/networking/routers/create index ad178e624..a5539f647 100644 --- a/gcloud/alpha/edge-cloud/networking/routers/create +++ b/gcloud/alpha/edge-cloud/networking/routers/create @@ -92,5 +92,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 edge-cloud networking routers create diff --git a/gcloud/alpha/edge-cloud/networking/routers/delete b/gcloud/alpha/edge-cloud/networking/routers/delete index d71fe2836..261c78afb 100644 --- a/gcloud/alpha/edge-cloud/networking/routers/delete +++ b/gcloud/alpha/edge-cloud/networking/routers/delete @@ -72,5 +72,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 edge-cloud networking routers delete diff --git a/gcloud/alpha/edge-cloud/networking/routers/describe b/gcloud/alpha/edge-cloud/networking/routers/describe index 390aea78e..9397af9e4 100644 --- a/gcloud/alpha/edge-cloud/networking/routers/describe +++ b/gcloud/alpha/edge-cloud/networking/routers/describe @@ -66,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 edge-cloud networking routers describe diff --git a/gcloud/alpha/edge-cloud/networking/routers/get-status b/gcloud/alpha/edge-cloud/networking/routers/get-status index 8c9d54138..04d4f002d 100644 --- a/gcloud/alpha/edge-cloud/networking/routers/get-status +++ b/gcloud/alpha/edge-cloud/networking/routers/get-status @@ -61,5 +61,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 edge-cloud networking routers get-status diff --git a/gcloud/alpha/edge-cloud/networking/routers/help b/gcloud/alpha/edge-cloud/networking/routers/help index 61e519df7..77f0b6473 100644 --- a/gcloud/alpha/edge-cloud/networking/routers/help +++ b/gcloud/alpha/edge-cloud/networking/routers/help @@ -39,8 +39,7 @@ COMMANDS (ALPHA) List Distributed Cloud Edge Network routers. remove-bgp-peer - (ALPHA) Remove a list of BGP peers from a Distributed Cloud Edge - Network router. + (ALPHA) Remove a BGP peer from a Distributed Cloud Edge Network router. remove-interface (ALPHA) remove an interface on a Distributed Cloud Edge Network router. @@ -52,5 +51,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud edge-cloud networking routers diff --git a/gcloud/alpha/edge-cloud/networking/routers/list b/gcloud/alpha/edge-cloud/networking/routers/list index 384a615c1..a57ac523a 100644 --- a/gcloud/alpha/edge-cloud/networking/routers/list +++ b/gcloud/alpha/edge-cloud/networking/routers/list @@ -93,5 +93,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud edge-cloud networking routers list diff --git a/gcloud/alpha/edge-cloud/networking/routers/remove-bgp-peer b/gcloud/alpha/edge-cloud/networking/routers/remove-bgp-peer index a18d0fbbb..83822ca12 100644 --- a/gcloud/alpha/edge-cloud/networking/routers/remove-bgp-peer +++ b/gcloud/alpha/edge-cloud/networking/routers/remove-bgp-peer @@ -1,27 +1,27 @@ NAME - gcloud alpha edge-cloud networking routers remove-bgp-peer - remove a list - of BGP peers from a Distributed Cloud Edge Network router + gcloud alpha edge-cloud networking routers remove-bgp-peer - remove a BGP + peer from a Distributed Cloud Edge Network router SYNOPSIS gcloud alpha edge-cloud networking routers remove-bgp-peer (ROUTER : --location=LOCATION --zone=ZONE) - --peer-names=[BGP_PEER_NAME,...] [--async] [GCLOUD_WIDE_FLAG ...] + (--peer-name=PEER_NAME | --peer-names=[PEER_NAME,...]) [--async] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete a list of BGP peers from a Distributed Cloud Edge Network + (ALPHA) Delete a list of BGP peer from a Distributed Cloud Edge Network router EXAMPLES - To delete a list of BGP peers contains 'peer1' and 'peer2' from the - Distributed Cloud Edge Network router 'my-router' in edge zone - 'us-central1-edge-den1' , run: + To delete a BGP peer 'peer1' from the Distributed Cloud Edge Network router + 'my-router' in edge zone 'us-central1-edge-den1' , run: $ gcloud alpha edge-cloud networking routers remove-bgp-peer \ - my-router --peer-names=peer1,peer2 --location=us-central1 \ + my-router --peer-name=peer1 --location=us-central1 \ --zone=us-central1-edge-den1 POSITIONAL ARGUMENTS - Router resource - The router from which we delete a list of bgp peers. The + Router resource - The router from which we delete a BGP peer. 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: @@ -53,9 +53,14 @@ POSITIONAL ARGUMENTS ▸ provide the argument --zone on the command line. REQUIRED FLAGS - --peer-names=[BGP_PEER_NAME,...] - The list of names for peers being removed. Only single value allowed - currently. + Exactly one of these must be specified: + + --peer-name=PEER_NAME + The name of the BGP peer being removed. + + --peer-names=[PEER_NAME,...] + The list of names for peers being removed. Only single value allowed + currently. OPTIONAL FLAGS --async @@ -74,5 +79,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 edge-cloud networking routers remove-bgp-peer diff --git a/gcloud/alpha/edge-cloud/networking/routers/remove-interface b/gcloud/alpha/edge-cloud/networking/routers/remove-interface index 22f7b0b8b..027292a50 100644 --- a/gcloud/alpha/edge-cloud/networking/routers/remove-interface +++ b/gcloud/alpha/edge-cloud/networking/routers/remove-interface @@ -78,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 edge-cloud networking routers remove-interface diff --git a/gcloud/alpha/edge-cloud/networking/subnets/create b/gcloud/alpha/edge-cloud/networking/subnets/create index 217ea6c69..009a445a0 100644 --- a/gcloud/alpha/edge-cloud/networking/subnets/create +++ b/gcloud/alpha/edge-cloud/networking/subnets/create @@ -105,5 +105,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud edge-cloud networking subnets create diff --git a/gcloud/alpha/edge-cloud/networking/subnets/delete b/gcloud/alpha/edge-cloud/networking/subnets/delete index cb000dbd4..a9df11bec 100644 --- a/gcloud/alpha/edge-cloud/networking/subnets/delete +++ b/gcloud/alpha/edge-cloud/networking/subnets/delete @@ -72,5 +72,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 edge-cloud networking subnets delete diff --git a/gcloud/alpha/edge-cloud/networking/subnets/describe b/gcloud/alpha/edge-cloud/networking/subnets/describe index 4b4771878..d996ec160 100644 --- a/gcloud/alpha/edge-cloud/networking/subnets/describe +++ b/gcloud/alpha/edge-cloud/networking/subnets/describe @@ -66,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 edge-cloud networking subnets describe diff --git a/gcloud/alpha/edge-cloud/networking/subnets/help b/gcloud/alpha/edge-cloud/networking/subnets/help index c245dbddb..feba9725f 100644 --- a/gcloud/alpha/edge-cloud/networking/subnets/help +++ b/gcloud/alpha/edge-cloud/networking/subnets/help @@ -32,5 +32,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 edge-cloud networking subnets diff --git a/gcloud/alpha/edge-cloud/networking/subnets/list b/gcloud/alpha/edge-cloud/networking/subnets/list index fd664c643..39be03612 100644 --- a/gcloud/alpha/edge-cloud/networking/subnets/list +++ b/gcloud/alpha/edge-cloud/networking/subnets/list @@ -93,5 +93,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud edge-cloud networking subnets list diff --git a/gcloud/alpha/edge-cloud/networking/zones/help b/gcloud/alpha/edge-cloud/networking/zones/help new file mode 100644 index 000000000..01852b5d4 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/zones/help @@ -0,0 +1,29 @@ +NAME + gcloud alpha edge-cloud networking zones - manage Distributed Cloud Edge + Network zones + +SYNOPSIS + gcloud alpha edge-cloud networking zones COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Distributed Cloud Edge Network zones. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + init + (ALPHA) Initialize a specified Distributed Cloud Edge Network zone. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud edge-cloud networking zones + diff --git a/gcloud/alpha/edge-cloud/networking/zones/init b/gcloud/alpha/edge-cloud/networking/zones/init new file mode 100644 index 000000000..72a8cf58e --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/zones/init @@ -0,0 +1,60 @@ +NAME + gcloud alpha edge-cloud networking zones init - initialize a specified + Distributed Cloud Edge Network zone + +SYNOPSIS + gcloud alpha edge-cloud networking zones init (ZONE : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Initialize a specified Distributed Cloud Edge Network zone. + +EXAMPLES + To initialize a Distributed Cloud Edge Network zone called + 'us-central1-edge-den1', run: + + $ gcloud alpha edge-cloud networking zones init \ + us-central1-edge-den1 --location=us-central1 + +POSITIONAL ARGUMENTS + Zone resource - The zone to initialize. 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 zone on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + ZONE + ID of the zone or fully qualified identifier for the zone. To set the + zone attribute: + ▸ provide the argument zone on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the zone. To set the location attribute: + ▸ provide the argument zone 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. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud edge-cloud networking zones init + diff --git a/gcloud/alpha/firestore/indexes/composite/create b/gcloud/alpha/firestore/indexes/composite/create index b50191441..428423af3 100644 --- a/gcloud/alpha/firestore/indexes/composite/create +++ b/gcloud/alpha/firestore/indexes/composite/create @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud alpha firestore indexes composite create --field-config=FIELD_CONFIG - (--collection-group=COLLECTION_GROUP : --database=DATABASE) [--async] + (--collection-group=COLLECTION_GROUP : --database=DATABASE) + [--api-scope=API_SCOPE; default="any-api"] [--async] + [--query-scope=QUERY_SCOPE; default="collection"] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -81,10 +83,18 @@ REQUIRED FLAGS ▸ the default value of argument [--database] is (default). OPTIONAL FLAGS + --api-scope=API_SCOPE; default="any-api" + Api scope the index applies to. API_SCOPE must be one of: any-api, + datastore-mode-api. + --async Return immediately, without waiting for the operation in progress to complete. + --query-scope=QUERY_SCOPE; default="collection" + Query scope the index applies to. QUERY_SCOPE must be one of: + collection, collection-group, collection-recursive. + 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/iam/service-accounts/config/export b/gcloud/alpha/iam/service-accounts/config/export index c5917c3b0..b31d97a55 100644 --- a/gcloud/alpha/iam/service-accounts/config/export +++ b/gcloud/alpha/iam/service-accounts/config/export @@ -3,7 +3,7 @@ NAME for a Iam service account SYNOPSIS - gcloud alpha iam service-accounts config export (SERVICE_ACCOUNT : --all) + gcloud alpha iam service-accounts config export ([SERVICE_ACCOUNT]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] @@ -49,9 +49,6 @@ POSITIONAL ARGUMENTS serviceAccount. To set the service_account attribute: ▸ provide the argument service_account on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/identity/groups/config/export b/gcloud/alpha/identity/groups/config/export index 34056a258..e89cfa6dd 100644 --- a/gcloud/alpha/identity/groups/config/export +++ b/gcloud/alpha/identity/groups/config/export @@ -3,7 +3,7 @@ NAME Cloud Identity group SYNOPSIS - gcloud alpha identity groups config export (GROUP : --all) + gcloud alpha identity groups config export ([GROUP]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] @@ -47,9 +47,6 @@ POSITIONAL ARGUMENTS the group attribute: ▸ provide the argument group on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/kms/ekm-connections/create b/gcloud/alpha/kms/ekm-connections/create index 3a1ede9ff..f6ce7eeac 100644 --- a/gcloud/alpha/kms/ekm-connections/create +++ b/gcloud/alpha/kms/ekm-connections/create @@ -40,7 +40,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --location=LOCATION - The Cloud location for the ekmconnection. To set the location + The Google Cloud location for the ekmconnection. To set the location attribute: ▸ provide the argument ekm_connection on the command line with a fully specified name; diff --git a/gcloud/alpha/kms/ekm-connections/describe b/gcloud/alpha/kms/ekm-connections/describe index d8be396fa..c3f9f8b9b 100644 --- a/gcloud/alpha/kms/ekm-connections/describe +++ b/gcloud/alpha/kms/ekm-connections/describe @@ -36,7 +36,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --location=LOCATION - The Cloud location for the ekmconnection. To set the location + The Google Cloud location for the ekmconnection. To set the location attribute: ▸ provide the argument ekm_connection on the command line with a fully specified name; diff --git a/gcloud/alpha/kms/ekm-connections/update b/gcloud/alpha/kms/ekm-connections/update index c37f0d55c..172234f1e 100644 --- a/gcloud/alpha/kms/ekm-connections/update +++ b/gcloud/alpha/kms/ekm-connections/update @@ -50,7 +50,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --location=LOCATION - The Cloud location for the ekmconnection. To set the location + The Google Cloud location for the ekmconnection. To set the location attribute: ▸ provide the argument ekm_connection on the command line with a fully specified name; diff --git a/gcloud/alpha/kms/inventory/get-protected-resources-summary b/gcloud/alpha/kms/inventory/get-protected-resources-summary index ef5a1205f..5e3be40ba 100644 --- a/gcloud/alpha/kms/inventory/get-protected-resources-summary +++ b/gcloud/alpha/kms/inventory/get-protected-resources-summary @@ -36,7 +36,7 @@ REQUIRED FLAGS ▸ provide the argument --keyring on the command line. --location=LOCATION - The Cloud location for the key. To set the location attribute: + The Google Cloud location for the key. To set the location attribute: ▸ provide the argument --keyname on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/alpha/kms/inventory/search-protected-resources b/gcloud/alpha/kms/inventory/search-protected-resources index 8c28b6e0a..4e0def2e7 100644 --- a/gcloud/alpha/kms/inventory/search-protected-resources +++ b/gcloud/alpha/kms/inventory/search-protected-resources @@ -41,7 +41,7 @@ REQUIRED FLAGS ▸ provide the argument --keyring on the command line. --location=LOCATION - The Cloud location for the key. To set the location attribute: + The Google Cloud location for the key. To set the location attribute: ▸ provide the argument --keyname on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/alpha/kms/keyrings/create b/gcloud/alpha/kms/keyrings/create index 90194d1a4..04d1fc4c7 100644 --- a/gcloud/alpha/kms/keyrings/create +++ b/gcloud/alpha/kms/keyrings/create @@ -28,7 +28,8 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --location=LOCATION - The Cloud location for the keyring. To set the location attribute: + The Google Cloud location for the keyring. To set the location + attribute: ▸ provide the argument keyring on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/alpha/kms/keyrings/describe b/gcloud/alpha/kms/keyrings/describe index dce268489..0aab864cf 100644 --- a/gcloud/alpha/kms/keyrings/describe +++ b/gcloud/alpha/kms/keyrings/describe @@ -34,7 +34,8 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --location=LOCATION - The Cloud location for the keyring. To set the location attribute: + The Google Cloud location for the keyring. To set the location + attribute: ▸ provide the argument keyring on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/alpha/kms/keys/create b/gcloud/alpha/kms/keys/create index a288efe17..9aa73e6cc 100644 --- a/gcloud/alpha/kms/keys/create +++ b/gcloud/alpha/kms/keys/create @@ -139,7 +139,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --keyring on the command line. --location=LOCATION - The Cloud location for the key. To set the location attribute: + The Google Cloud location for the key. To set the location attribute: ▸ provide the argument key on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/alpha/kms/keys/describe b/gcloud/alpha/kms/keys/describe index 84c1139f7..7a0f28f13 100644 --- a/gcloud/alpha/kms/keys/describe +++ b/gcloud/alpha/kms/keys/describe @@ -41,7 +41,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --keyring on the command line. --location=LOCATION - The Cloud location for the key. To set the location attribute: + The Google Cloud location for the key. To set the location attribute: ▸ provide the argument key on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/alpha/kms/keys/list b/gcloud/alpha/kms/keys/list index 72a3f47bb..71eae7521 100644 --- a/gcloud/alpha/kms/keys/list +++ b/gcloud/alpha/kms/keys/list @@ -35,7 +35,8 @@ REQUIRED FLAGS this group are specified. --location=LOCATION - The Cloud location for the keyring. To set the location attribute: + The Google Cloud location for the keyring. To set the location + attribute: ▸ provide the argument --keyring on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/alpha/kms/keys/remove-rotation-schedule b/gcloud/alpha/kms/keys/remove-rotation-schedule index 8a63427d1..d27a108d9 100644 --- a/gcloud/alpha/kms/keys/remove-rotation-schedule +++ b/gcloud/alpha/kms/keys/remove-rotation-schedule @@ -3,8 +3,8 @@ NAME schedule for a key SYNOPSIS - gcloud alpha kms keys remove-rotation-schedule KEY [--keyring=KEYRING] - [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + gcloud alpha kms keys remove-rotation-schedule + (KEY : --keyring=KEYRING --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Removes the rotation schedule for the given key. @@ -17,15 +17,35 @@ EXAMPLES --location=global --keyring=fellowship POSITIONAL ARGUMENTS - KEY - Name of the key from which to clear the rotation schedule. + Key resource - The KMS key resource. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument key on the command line with a fully specified + name; + ◆ set the property core/project. -FLAGS - --keyring=KEYRING - Key ring of the key. + This must be specified. - --location=LOCATION - Location of the key. + KEY + ID of the key or fully qualified identifier for the key. To set the + key attribute: + ▸ provide the argument key on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --keyring=KEYRING + The KMS keyring of the key. To set the keyring attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --keyring on the command line. + + --location=LOCATION + The Google Cloud location for the key. To set the location attribute: + ▸ provide the argument key 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, diff --git a/gcloud/alpha/kms/keys/set-primary-version b/gcloud/alpha/kms/keys/set-primary-version index 9afdba170..b1b3d394f 100644 --- a/gcloud/alpha/kms/keys/set-primary-version +++ b/gcloud/alpha/kms/keys/set-primary-version @@ -3,8 +3,9 @@ NAME key SYNOPSIS - gcloud alpha kms keys set-primary-version KEY --version=VERSION - [--keyring=KEYRING] [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + gcloud alpha kms keys set-primary-version + (KEY : --keyring=KEYRING --location=LOCATION) --version=VERSION + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Sets the specified version as the primary version of the given key. @@ -18,20 +19,40 @@ EXAMPLES --keyring=fellowship --location=global POSITIONAL ARGUMENTS - KEY - Name of the key to modify. + Key resource - The KMS key resource. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument key on the command line with a fully specified + name; + ◆ set the property core/project. + + This must be specified. + + KEY + ID of the key or fully qualified identifier for the key. To set the + key attribute: + ▸ provide the argument key on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --keyring=KEYRING + The KMS keyring of the key. To set the keyring attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --keyring on the command line. + + --location=LOCATION + The Google Cloud location for the key. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. REQUIRED FLAGS --version=VERSION Version to make primary. -OPTIONAL FLAGS - --keyring=KEYRING - Key ring of the key. - - --location=LOCATION - Location of the key. - 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/kms/keys/set-rotation-schedule b/gcloud/alpha/kms/keys/set-rotation-schedule index 7a6fc9ca6..1a453633b 100644 --- a/gcloud/alpha/kms/keys/set-rotation-schedule +++ b/gcloud/alpha/kms/keys/set-rotation-schedule @@ -3,8 +3,9 @@ NAME for a key SYNOPSIS - gcloud alpha kms keys set-rotation-schedule KEY [--keyring=KEYRING] - [--location=LOCATION] [--next-rotation-time=NEXT_ROTATION_TIME] + gcloud alpha kms keys set-rotation-schedule + (KEY : --keyring=KEYRING --location=LOCATION) + [--next-rotation-time=NEXT_ROTATION_TIME] [--rotation-period=ROTATION_PERIOD] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -29,16 +30,37 @@ EXAMPLES --next-rotation-time=2017-10-12T12:34:56.1234Z POSITIONAL ARGUMENTS - KEY - Name of the key to update the schedule of. + Key resource - The KMS key resource. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument key on the command line with a fully specified + name; + ◆ set the property core/project. + + This must be specified. + + KEY + ID of the key or fully qualified identifier for the key. To set the + key attribute: + ▸ provide the argument key on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --keyring=KEYRING + The KMS keyring of the key. To set the keyring attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --keyring on the command line. + + --location=LOCATION + The Google Cloud location for the key. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. FLAGS - --keyring=KEYRING - Key ring of the key. - - --location=LOCATION - Location of the key. - --next-rotation-time=NEXT_ROTATION_TIME Next automatic rotation time of the key. See $ gcloud topic datetimes for information on time formats. diff --git a/gcloud/alpha/kms/keys/update b/gcloud/alpha/kms/keys/update index 953b73d26..20e2a3da7 100644 --- a/gcloud/alpha/kms/keys/update +++ b/gcloud/alpha/kms/keys/update @@ -100,7 +100,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --keyring on the command line. --location=LOCATION - The Cloud location for the key. To set the location attribute: + The Google Cloud location for the key. To set the location attribute: ▸ provide the argument key on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/alpha/logging/settings/update b/gcloud/alpha/logging/settings/update index 03408ea87..3241cc734 100644 --- a/gcloud/alpha/logging/settings/update +++ b/gcloud/alpha/logging/settings/update @@ -106,13 +106,15 @@ OPTIONAL FLAGS ▫ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▫ provide the argument --kms-key-name on the command line with a fully specified name; ▫ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▫ provide the argument --kms-key-name on the command line with a fully specified name; ▫ provide the argument --kms-project on the command line; diff --git a/gcloud/alpha/ml-engine/jobs/submit/training b/gcloud/alpha/ml-engine/jobs/submit/training index 652f2a756..2b8aea490 100644 --- a/gcloud/alpha/ml-engine/jobs/submit/training +++ b/gcloud/alpha/ml-engine/jobs/submit/training @@ -369,13 +369,15 @@ FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/alpha/monitoring/channels/config/export b/gcloud/alpha/monitoring/channels/config/export index e3fc9b3d0..d7bb034ff 100644 --- a/gcloud/alpha/monitoring/channels/config/export +++ b/gcloud/alpha/monitoring/channels/config/export @@ -3,7 +3,7 @@ NAME for a Monitoring notification channel SYNOPSIS - gcloud alpha monitoring channels config export (CHANNEL : --all) + gcloud alpha monitoring channels config export ([CHANNEL]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] @@ -50,9 +50,6 @@ POSITIONAL ARGUMENTS notification_channel. To set the channel attribute: ▸ provide the argument channel on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/monitoring/policies/config/export b/gcloud/alpha/monitoring/policies/config/export index c72cda9ee..1f0f9430e 100644 --- a/gcloud/alpha/monitoring/policies/config/export +++ b/gcloud/alpha/monitoring/policies/config/export @@ -3,7 +3,7 @@ NAME for a Monitoring alert policy SYNOPSIS - gcloud alpha monitoring policies config export (POLICY : --all) + gcloud alpha monitoring policies config export ([POLICY]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] @@ -48,9 +48,6 @@ POSITIONAL ARGUMENTS the policy attribute: ▸ provide the argument policy on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/monitoring/policies/create b/gcloud/alpha/monitoring/policies/create index d2d5596f7..e3a487857 100644 --- a/gcloud/alpha/monitoring/policies/create +++ b/gcloud/alpha/monitoring/policies/create @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud alpha monitoring policies create - --notification-channels=[NOTIFICATION_CHANNELS,...] + [--notification-channels=[NOTIFICATION_CHANNELS,...]] [--aggregation=AGGREGATION --condition-display-name=CONDITION_DISPLAY_NAME --condition-filter=CONDITION_FILTER diff --git a/gcloud/alpha/netapp/volumes/create b/gcloud/alpha/netapp/volumes/create index c94812556..3743b731f 100644 --- a/gcloud/alpha/netapp/volumes/create +++ b/gcloud/alpha/netapp/volumes/create @@ -6,9 +6,8 @@ SYNOPSIS --capacity=CAPACITY --network=[name=NAME],[reserved-ip-range=RESERVED-IP-RANGE] --protocols=PROTOCOL,[PROTOCOL,...] --share-name=SHARE_NAME - --storage-pool=STORAGE_POOL --from-snapshot=FROM_SNAPSHOT [--async] - [--description=DESCRIPTION] [--enable-kerberos=ENABLE_KERBEROS] - [--enable-ldap=ENABLE_LDAP] + --storage-pool=STORAGE_POOL [--async] [--description=DESCRIPTION] + [--enable-kerberos=ENABLE_KERBEROS] [--enable-ldap=ENABLE_LDAP] [--export-policy=[access-type=ACCESS-TYPE], [allowed-clients=ALLOWED-CLIENTS],[has-root-access=HAS-ROOT-ACCESS], [kerberos-5-read-only=KERBEROS-5-READ-ONLY], @@ -17,7 +16,8 @@ SYNOPSIS [kerberos-5i-read-write=KERBEROS-5I-READ-WRITE], [kerberos-5p-read-only=KERBEROS-5P-READ-ONLY], [kerberos-5p-read-write=KERBEROS-5P-READ-WRITE], - [nfsv3=NFSV3],[nfsv4=NFSV4]] [--labels=[KEY=VALUE,...]] + [nfsv3=NFSV3],[nfsv4=NFSV4]] [--from-snapshot=FROM_SNAPSHOT] + [--labels=[KEY=VALUE,...]] [--security-style=SECURITY_STYLE; default="SECURITY_STYLE_UNSPECIFIED"] [--smb-settings=SMB_SETTING,[SMB_SETTING,...]] [--snap-reserve=SNAP_RESERVE] @@ -114,26 +114,6 @@ REQUIRED FLAGS ▸ provide the argument --storage-pool on the command line. OPTIONAL FLAGS - Snapshot resource - The Snapshot to create the Volume from. 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 --from-snapshot on the command line with a fully - specified name; - ◆ provide the argument --project on the command line; - ◆ set the property core/project. To set the location attribute: - ◆ provide the argument --from-snapshot on the command line with a fully - specified name; - ◆ set the property netapp/location; - ◆ set the property netapp/region. To set the volume attribute: - ◆ provide the argument --from-snapshot on the command line with a fully - specified name. - - --from-snapshot=FROM_SNAPSHOT - ID of the snapshot or fully qualified identifier for the snapshot. To - set the snapshot attribute: - ▸ provide the argument --from-snapshot on the command line. - --async Return immediately, without waiting for the operation in progress to complete. @@ -159,6 +139,26 @@ OPTIONAL FLAGS kerberos-5p-read-only=KERBEROS_5P_READ_ONLY, kerberos-5p-read-write=KERBEROS_5P_READ_WRITE + Snapshot resource - The Snapshot to create the Volume from. 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 --from-snapshot on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. To set the location attribute: + ◆ provide the argument --from-snapshot on the command line with a fully + specified name; + ◆ set the property netapp/location; + ◆ set the property netapp/region. To set the volume attribute: + ◆ provide the argument --from-snapshot on the command line with a fully + specified name. + + --from-snapshot=FROM_SNAPSHOT + ID of the snapshot or fully qualified identifier for the snapshot. To + set the snapshot attribute: + ▸ provide the argument --from-snapshot on the command line. + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/alpha/netapp/volumes/update b/gcloud/alpha/netapp/volumes/update index 8792f8a6e..2e6397ca2 100644 --- a/gcloud/alpha/netapp/volumes/update +++ b/gcloud/alpha/netapp/volumes/update @@ -2,8 +2,7 @@ NAME gcloud alpha netapp volumes update - update a Cloud NetApp Volume SYNOPSIS - gcloud alpha netapp volumes update (VOLUME : --location=LOCATION) - --from-snapshot=FROM_SNAPSHOT --storage-pool=STORAGE_POOL [--async] + gcloud alpha netapp volumes update (VOLUME : --location=LOCATION) [--async] [--capacity=CAPACITY] [--description=DESCRIPTION] [--enable-kerberos=ENABLE_KERBEROS] [--enable-ldap=ENABLE_LDAP] [--export-policy=[access-type=ACCESS-TYPE], @@ -14,7 +13,7 @@ SYNOPSIS [kerberos-5i-read-write=KERBEROS-5I-READ-WRITE], [kerberos-5p-read-only=KERBEROS-5P-READ-ONLY], [kerberos-5p-read-write=KERBEROS-5P-READ-WRITE], - [nfsv3=NFSV3],[nfsv4=NFSV4]] + [nfsv3=NFSV3],[nfsv4=NFSV4]] [--from-snapshot=FROM_SNAPSHOT] [--network=[name=NAME],[reserved-ip-range=RESERVED-IP-RANGE]] [--protocols=PROTOCOL,[PROTOCOL,...]] [--security-style=SECURITY_STYLE; default="SECURITY_STYLE_UNSPECIFIED"] @@ -30,7 +29,8 @@ SYNOPSIS [hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--snapshot-weekly=[day=DAY], [hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] - [--unix-permissions=UNIX_PERMISSIONS] [--update-labels=[KEY=VALUE,...]] + [--storage-pool=STORAGE_POOL] [--unix-permissions=UNIX_PERMISSIONS] + [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -65,45 +65,6 @@ POSITIONAL ARGUMENTS ▸ set the property netapp/region. FLAGS - Snapshot resource - The Snapshot to create the Volume from. 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 --from-snapshot on the command line with a fully - specified name; - ◆ provide the argument --project on the command line; - ◆ set the property core/project. To set the location attribute: - ◆ provide the argument --from-snapshot on the command line with a fully - specified name; - ◆ set the property netapp/location; - ◆ set the property netapp/region. To set the volume attribute: - ◆ provide the argument --from-snapshot on the command line with a fully - specified name. - - --from-snapshot=FROM_SNAPSHOT - ID of the snapshot or fully qualified identifier for the snapshot. To - set the snapshot attribute: - ▸ provide the argument --from-snapshot on the command line. - - Storage pool resource - The Storage Pool to associate with Volume. 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 --storage-pool on the command line with a fully - specified name; - ◆ provide the argument --project on the command line; - ◆ set the property core/project. To set the location attribute: - ◆ provide the argument --storage-pool on the command line with a fully - specified name; - ◆ provide the argument --location on the command line; - ◆ set the property netapp/location; - ◆ set the property netapp/region. - - --storage-pool=STORAGE_POOL - ID of the storage_pool or fully qualified identifier for the - storage_pool. To set the storage_pool attribute: - ▸ provide the argument --storage-pool on the command line. - --async Return immediately, without waiting for the operation in progress to complete. @@ -133,6 +94,26 @@ FLAGS kerberos-5p-read-only=KERBEROS_5P_READ_ONLY, kerberos-5p-read-write=KERBEROS_5P_READ_WRITE + Snapshot resource - The Snapshot to create the Volume from. 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 --from-snapshot on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. To set the location attribute: + ◆ provide the argument --from-snapshot on the command line with a fully + specified name; + ◆ set the property netapp/location; + ◆ set the property netapp/region. To set the volume attribute: + ◆ provide the argument --from-snapshot on the command line with a fully + specified name. + + --from-snapshot=FROM_SNAPSHOT + ID of the snapshot or fully qualified identifier for the snapshot. To + set the snapshot attribute: + ▸ provide the argument --from-snapshot on the command line. + --network=[name=NAME],[reserved-ip-range=RESERVED-IP-RANGE] Network configuration for a Cloud NetApp Files Volume. Specifying reserved-ip-range is optional. @@ -198,6 +179,25 @@ FLAGS Make a snapshot every week e.g. at Monday 04:00, Wednesday 05:20, Sunday 23:50 + Storage pool resource - The Storage Pool to associate with Volume. 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 --storage-pool on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. To set the location attribute: + ◆ provide the argument --storage-pool on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --storage-pool=STORAGE_POOL + ID of the storage_pool or fully qualified identifier for the + storage_pool. To set the storage_pool attribute: + ▸ provide the argument --storage-pool on the command line. + --unix-permissions=UNIX_PERMISSIONS Unix permissions the mount point will be created with.Unix permissions are only applicable with NFS protocol only diff --git a/gcloud/alpha/notebooks/instances/create b/gcloud/alpha/notebooks/instances/create index 6f7df9a14..e17cc11d5 100644 --- a/gcloud/alpha/notebooks/instances/create +++ b/gcloud/alpha/notebooks/instances/create @@ -24,7 +24,7 @@ SYNOPSIS [--disk-encryption=DISK_ENCRYPTION [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT]] - [--network=NETWORK : --no-proxy-access --no-public-ip [--subnet=SUBNET + [--network=NETWORK --no-proxy-access --no-public-ip [--subnet=SUBNET : --subnet-region=SUBNET_REGION]] [--reservation=RESERVATION --reservation-affinity=RESERVATION_AFFINITY; default="TYPE_UNSPECIFIED"] [GCLOUD_WIDE_FLAG ...] @@ -264,13 +264,15 @@ OPTIONAL FLAGS ▫ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▫ provide the argument --kms-key on the command line with a fully specified name; ▫ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▫ provide the argument --kms-key on the command line with a fully specified name; ▫ provide the argument --kms-project on the command line; diff --git a/gcloud/alpha/pubsub/subscriptions/config/export b/gcloud/alpha/pubsub/subscriptions/config/export index 2a8f78af4..62d838667 100644 --- a/gcloud/alpha/pubsub/subscriptions/config/export +++ b/gcloud/alpha/pubsub/subscriptions/config/export @@ -3,7 +3,7 @@ NAME for a Pub/Sub subscription SYNOPSIS - gcloud alpha pubsub subscriptions config export (SUBSCRIPTION : --all) + gcloud alpha pubsub subscriptions config export ([SUBSCRIPTION]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] @@ -48,9 +48,6 @@ POSITIONAL ARGUMENTS subscription. To set the subscription attribute: ▸ provide the argument subscription on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/pubsub/topics/config/export b/gcloud/alpha/pubsub/topics/config/export index 5f790ff54..5267f109e 100644 --- a/gcloud/alpha/pubsub/topics/config/export +++ b/gcloud/alpha/pubsub/topics/config/export @@ -3,7 +3,7 @@ NAME Pub/Sub topic SYNOPSIS - gcloud alpha pubsub topics config export (TOPIC : --all) + gcloud alpha pubsub topics config export ([TOPIC]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] @@ -47,9 +47,6 @@ POSITIONAL ARGUMENTS the topic attribute: ▸ provide the argument topic on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/pubsub/topics/create b/gcloud/alpha/pubsub/topics/create index 34cd8a3e3..365317244 100644 --- a/gcloud/alpha/pubsub/topics/create +++ b/gcloud/alpha/pubsub/topics/create @@ -130,14 +130,16 @@ FLAGS command line. --topic-encryption-key-location=TOPIC_ENCRYPTION_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --topic-encryption-key on the command line with a fully specified name; ▸ provide the argument --topic-encryption-key-location on the command line. --topic-encryption-key-project=TOPIC_ENCRYPTION_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --topic-encryption-key on the command line with a fully specified name; ▸ provide the argument --topic-encryption-key-project on the diff --git a/gcloud/alpha/pubsub/topics/update b/gcloud/alpha/pubsub/topics/update index faab8e5f8..39d0df9d9 100644 --- a/gcloud/alpha/pubsub/topics/update +++ b/gcloud/alpha/pubsub/topics/update @@ -211,14 +211,16 @@ FLAGS command line. --topic-encryption-key-location=TOPIC_ENCRYPTION_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --topic-encryption-key on the command line with a fully specified name; ▸ provide the argument --topic-encryption-key-location on the command line. --topic-encryption-key-project=TOPIC_ENCRYPTION_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --topic-encryption-key on the command line with a fully specified name; ▸ provide the argument --topic-encryption-key-project on the diff --git a/gcloud/alpha/resource-manager/liens/config/export b/gcloud/alpha/resource-manager/liens/config/export index a196d7280..f062cc2b4 100644 --- a/gcloud/alpha/resource-manager/liens/config/export +++ b/gcloud/alpha/resource-manager/liens/config/export @@ -3,7 +3,7 @@ NAME configuration for a Cloud Resource Manager lien SYNOPSIS - gcloud alpha resource-manager liens config export (LIEN : --all) + gcloud alpha resource-manager liens config export ([LIEN]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] @@ -47,9 +47,6 @@ POSITIONAL ARGUMENTS lien attribute: ▸ provide the argument lien on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/secrets/config/export b/gcloud/alpha/secrets/config/export index b48725a4a..23234312f 100644 --- a/gcloud/alpha/secrets/config/export +++ b/gcloud/alpha/secrets/config/export @@ -3,7 +3,7 @@ NAME Secretmanager secret SYNOPSIS - gcloud alpha secrets config export (SECRET : --all) + gcloud alpha secrets config export ([SECRET]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] @@ -46,9 +46,6 @@ POSITIONAL ARGUMENTS the secret attribute: ▸ provide the argument secret on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/source/repos/config/export b/gcloud/alpha/source/repos/config/export index 236ccceea..9c704ec8f 100644 --- a/gcloud/alpha/source/repos/config/export +++ b/gcloud/alpha/source/repos/config/export @@ -3,7 +3,7 @@ NAME Cloud Source repo SYNOPSIS - gcloud alpha source repos config export (REPOSITORY_NAME : --all) + gcloud alpha source repos config export ([REPOSITORY_NAME]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] @@ -47,9 +47,6 @@ POSITIONAL ARGUMENTS repository_name attribute: ▸ provide the argument repository_name on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/sql/instances/config/export b/gcloud/alpha/sql/instances/config/export index 4f5706e54..2c2c56747 100644 --- a/gcloud/alpha/sql/instances/config/export +++ b/gcloud/alpha/sql/instances/config/export @@ -3,7 +3,7 @@ NAME Sqladmin instance SYNOPSIS - gcloud alpha sql instances config export (INSTANCE : --all) + gcloud alpha sql instances config export ([INSTANCE]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] @@ -47,9 +47,6 @@ POSITIONAL ARGUMENTS set the instance attribute: ▸ provide the argument instance on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/alpha/sql/instances/create b/gcloud/alpha/sql/instances/create index bd9dd57d5..11680b420 100644 --- a/gcloud/alpha/sql/instances/create +++ b/gcloud/alpha/sql/instances/create @@ -432,14 +432,16 @@ FLAGS line. --disk-encryption-key-location=DISK_ENCRYPTION_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --disk-encryption-key on the command line with a fully specified name; ▸ provide the argument --disk-encryption-key-location on the command line. --disk-encryption-key-project=DISK_ENCRYPTION_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --disk-encryption-key on the command line with a fully specified name; ▸ provide the argument --disk-encryption-key-project on the command diff --git a/gcloud/alpha/transfer/jobs/config/export b/gcloud/alpha/transfer/jobs/config/export index 9fbd5165e..ba1dab149 100644 --- a/gcloud/alpha/transfer/jobs/config/export +++ b/gcloud/alpha/transfer/jobs/config/export @@ -3,7 +3,7 @@ NAME Storagetransfer transfer job SYNOPSIS - gcloud alpha transfer jobs config export (JOB : --all) + gcloud alpha transfer jobs config export ([JOB]] --all) [--path=PATH; default="-"] [--resource-format=RESOURCE_FORMAT] [GCLOUD_WIDE_FLAG ...] @@ -48,9 +48,6 @@ POSITIONAL ARGUMENTS job attribute: ▸ provide the argument job on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - --all Retrieve all resources within the project. If --path is specified and is a valid directory, resources will be output as individual files diff --git a/gcloud/artifacts/help b/gcloud/artifacts/help index d7c4443dd..4eac3511f 100644 --- a/gcloud/artifacts/help +++ b/gcloud/artifacts/help @@ -45,6 +45,10 @@ GROUPS versions Manage Artifact Registry package versions. + vpcsc-config + Manage Artifact Registry VPC Service Controls configuration for remote + repositories. + yum Manage Artifact Registry RPM packages. diff --git a/gcloud/artifacts/repositories/create b/gcloud/artifacts/repositories/create index bf2ec59bf..8f3355a5b 100644 --- a/gcloud/artifacts/repositories/create +++ b/gcloud/artifacts/repositories/create @@ -6,7 +6,12 @@ SYNOPSIS gcloud artifacts repositories create (REPOSITORY : --location=LOCATION) --repository-format=REPOSITORY_FORMAT [--allow-snapshot-overwrites] [--async] [--description=DESCRIPTION] [--kms-key=KMS_KEY] - [--labels=[KEY=VALUE,...]] + [--labels=[KEY=VALUE,...]] [--mode=MODE; default="NONE"] + [--remote-docker-repo=REMOTE_DOCKER_REPO] + [--remote-mvn-repo=REMOTE_MVN_REPO] [--remote-npm-repo=REMOTE_NPM_REPO] + [--remote-python-repo=REMOTE_PYTHON_REPO] + [--remote-repo-config-desc=REMOTE_REPO_CONFIG_DESC] + [--upstream-policy-file=FILE] [--version-policy=VERSION_POLICY; default="NONE"] [GCLOUD_WIDE_FLAG ...] @@ -105,6 +110,46 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --mode=MODE; default="NONE" + Mode is the type of the repository - Standard, Virtual or Remote. MODE + must be one of: + + none + Repository mode not specified. + remote-repository + Remote repository mode - fetches data from upstream and caches it. + standard-repository + Standard repository mode - should be possible to write/read data to + this repo. + virtual-repository + Virtual repository mode - aggregates data from several upstreams. + + --remote-docker-repo=REMOTE_DOCKER_REPO + (Docker only) Repo upstream for docker remote repository. + REMOTE_DOCKER_REPO must be one of: docker-hub, none. + + --remote-mvn-repo=REMOTE_MVN_REPO + (Maven only) Repo upstream for maven remote repository. REMOTE_MVN_REPO + must be one of: maven-central, none. + + --remote-npm-repo=REMOTE_NPM_REPO + (npm only) Repo upstream for npm remote repository. REMOTE_NPM_REPO + must be one of: none, npmjs. + + --remote-python-repo=REMOTE_PYTHON_REPO + (Python only) Repo upstream for python remote repository. + REMOTE_PYTHON_REPO must be one of: none, pypi. + + --remote-repo-config-desc=REMOTE_REPO_CONFIG_DESC + The description for the remote repository config. + + --upstream-policy-file=FILE + (Virtual Repositories only) is the upstreams for the Virtual + Repository. Example of the file contents: [ { "id": "test1", + "repository": "projects/p1/locations/us-central1/repository/repo1", + "priority": 1 }, { "id": "test2", "repository": + "projects/p2/locations/us-west2/repository/repo2", "priority": 2 } ] + --version-policy=VERSION_POLICY; default="NONE" (Maven only) The package versions that the repository will store. VERSION_POLICY must be one of: diff --git a/gcloud/artifacts/repositories/update b/gcloud/artifacts/repositories/update index a67b7ff59..215b7ab03 100644 --- a/gcloud/artifacts/repositories/update +++ b/gcloud/artifacts/repositories/update @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud artifacts repositories update (REPOSITORY : --location=LOCATION) [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] + [--upstream-policy-file=FILE] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -65,6 +66,13 @@ FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --upstream-policy-file=FILE + (Virtual Repositories only) is the upstreams for the Virtual + Repository. Example of the file contents: [ { "id": "test1", + "repository": "projects/p1/locations/us-central1/repository/repo1", + "priority": 1 }, { "id": "test2", "repository": + "projects/p2/locations/us-west2/repository/repo2", "priority": 2 } ] + At most one of these can be specified: --clear-labels diff --git a/gcloud/artifacts/vpcsc-config/allow b/gcloud/artifacts/vpcsc-config/allow new file mode 100644 index 000000000..fe56708bc --- /dev/null +++ b/gcloud/artifacts/vpcsc-config/allow @@ -0,0 +1,62 @@ +NAME + gcloud artifacts vpcsc-config allow - allow Artifact Registry remote + repositories inside a service perimeter to retrieve data from their + upstream sources outside of the perimeter + +SYNOPSIS + gcloud artifacts vpcsc-config allow [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Allow Artifact Registry remote repositories inside a service perimeter to + retrieve data from their upstream sources outside of the perimeter. + + This command can fail for the following reasons: + ▪ Lack of permission - "accesscontextmanager.policies.update". + ▪ The resource could be outside of the VPC SC perimeter. + ▪ Lack of permission - "artifactregistry.vpcscconfigs.update" + +EXAMPLES + The following command allows remote repositories in the project my-project + and in the region us--west1 to retrieve data from upstream sources outside + the perimeter: + + $ gcloud artifacts vpcsc-config allow --project=my-project \ + --location=us-west1 + +FLAGS + Location resource - The Artifact Registry VPC SC config to update. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property artifacts/location with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --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; + ▸ set the property artifacts/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ + +NOTES + These variants are also available: + + $ gcloud alpha artifacts vpcsc-config allow + + $ gcloud beta artifacts vpcsc-config allow + diff --git a/gcloud/artifacts/vpcsc-config/deny b/gcloud/artifacts/vpcsc-config/deny new file mode 100644 index 000000000..ae17ffe29 --- /dev/null +++ b/gcloud/artifacts/vpcsc-config/deny @@ -0,0 +1,62 @@ +NAME + gcloud artifacts vpcsc-config deny - deny access to upstream sources + outside the service perimeter for Artifact Registry remote repositories + inside the perimeter + +SYNOPSIS + gcloud artifacts vpcsc-config deny [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Deny access to upstream sources outside the service perimeter for Artifact + Registry remote repositories inside the perimeter. + + This command can fail for the following reasons: + ▪ Lack of permission - "accesscontextmanager.policies.update". + ▪ The resource could be outside of the VPC SC perimeter. + ▪ Lack of permission - "artifactregistry.vpcscconfigs.update" + +EXAMPLES + The following command denies access to upstream sources outside the service + perimeter for remote repositories in the project my-project and in the + region us--west1: + + $ gcloud artifacts vpcsc-config deny --project=my-project \ + --location=us-west1 + +FLAGS + Location resource - The Artifact Registry VPC SC config to update. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property artifacts/location with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --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; + ▸ set the property artifacts/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ + +NOTES + These variants are also available: + + $ gcloud alpha artifacts vpcsc-config deny + + $ gcloud beta artifacts vpcsc-config deny + diff --git a/gcloud/artifacts/vpcsc-config/describe b/gcloud/artifacts/vpcsc-config/describe new file mode 100644 index 000000000..4ade285f0 --- /dev/null +++ b/gcloud/artifacts/vpcsc-config/describe @@ -0,0 +1,60 @@ +NAME + gcloud artifacts vpcsc-config describe - describe the current Artifact + Registry configuration for VPC Service Controls + +SYNOPSIS + gcloud artifacts vpcsc-config describe [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe the current Artifact Registry configuration for VPC Service + Controls. + + This command can fail for the following reasons: + ▪ Lack of permission - "accesscontextmanager.policies.get". + ▪ The resource could be outside of the VPC SC perimeter. + ▪ Lack of permission - "artifactregistry.vpcscconfigs.get" + +EXAMPLES + The following command returns the current VPC Service Controls + configuration for the project my-project and region us-west1: + + $ gcloud artifacts vpcsc-config describe --project=my-project \ + --location=us-west1 + +FLAGS + Location resource - The Artifact Registry VPC SC configs to describe. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property artifacts/location with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --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; + ▸ set the property artifacts/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ + +NOTES + These variants are also available: + + $ gcloud alpha artifacts vpcsc-config describe + + $ gcloud beta artifacts vpcsc-config describe + diff --git a/gcloud/artifacts/vpcsc-config/help b/gcloud/artifacts/vpcsc-config/help new file mode 100644 index 000000000..592ab76ee --- /dev/null +++ b/gcloud/artifacts/vpcsc-config/help @@ -0,0 +1,38 @@ +NAME + gcloud artifacts vpcsc-config - manage Artifact Registry VPC Service + Controls configuration for remote repositories + +SYNOPSIS + gcloud artifacts vpcsc-config COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Artifact Registry VPC Service Controls configuration for remote + repositories. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + allow + Allow Artifact Registry remote repositories inside a service perimeter + to retrieve data from their upstream sources outside of the perimeter. + + deny + Deny access to upstream sources outside the service perimeter for + Artifact Registry remote repositories inside the perimeter. + + describe + Describe the current Artifact Registry configuration for VPC Service + Controls. + +NOTES + These variants are also available: + + $ gcloud alpha artifacts vpcsc-config + + $ gcloud beta artifacts vpcsc-config + diff --git a/gcloud/auth/help b/gcloud/auth/help index 19bedcec7..df26bb003 100644 --- a/gcloud/auth/help +++ b/gcloud/auth/help @@ -22,6 +22,11 @@ DESCRIPTION global flags, see the gcloud CLI overview (https://cloud.google.com/sdk/gcloud/reference). + See $ gcloud topic client-certificate to learn how to use Mutual TLS when + using gcloud. Mutual TLS can be used for certificate based access + (https://cloud.google.com/beyondcorp-enterprise/docs/securing-resources-with-certificate-based-access) + with gcloud. + EXAMPLES To authenticate a user account with gcloud and minimal user output, run: diff --git a/gcloud/beta/ai-platform/jobs/submit/training b/gcloud/beta/ai-platform/jobs/submit/training index 4981dec84..64f1f0a2a 100644 --- a/gcloud/beta/ai-platform/jobs/submit/training +++ b/gcloud/beta/ai-platform/jobs/submit/training @@ -369,13 +369,15 @@ FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/beta/ai/custom-jobs/create b/gcloud/beta/ai/custom-jobs/create index 8a205352c..12dc0a567 100644 --- a/gcloud/beta/ai/custom-jobs/create +++ b/gcloud/beta/ai/custom-jobs/create @@ -244,13 +244,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/beta/ai/hp-tuning-jobs/create b/gcloud/beta/ai/hp-tuning-jobs/create index 2d3bb08f0..9c62ce185 100644 --- a/gcloud/beta/ai/hp-tuning-jobs/create +++ b/gcloud/beta/ai/hp-tuning-jobs/create @@ -137,13 +137,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/beta/ai/model-monitoring-jobs/create b/gcloud/beta/ai/model-monitoring-jobs/create index 22bd92fcd..76d7e2810 100644 --- a/gcloud/beta/ai/model-monitoring-jobs/create +++ b/gcloud/beta/ai/model-monitoring-jobs/create @@ -175,13 +175,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/beta/ai/models/copy b/gcloud/beta/ai/models/copy index cc96fe133..8d81386c6 100644 --- a/gcloud/beta/ai/models/copy +++ b/gcloud/beta/ai/models/copy @@ -27,8 +27,8 @@ OPTIONAL FLAGS The Cloud KMS resource identifier of the customer managed encryption key used to protect the 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. + The key needs to be in the same region as the destination region of the + model to be copied. Region resource - Cloud region to copy the model into. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this @@ -70,8 +70,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud ai models copy $ gcloud alpha ai models copy diff --git a/gcloud/beta/ai/tensorboards/create b/gcloud/beta/ai/tensorboards/create index e567f8267..aa4301a45 100644 --- a/gcloud/beta/ai/tensorboards/create +++ b/gcloud/beta/ai/tensorboards/create @@ -81,13 +81,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/beta/alloydb/backups/create b/gcloud/beta/alloydb/backups/create index f55719692..1932c638b 100644 --- a/gcloud/beta/alloydb/backups/create +++ b/gcloud/beta/alloydb/backups/create @@ -56,13 +56,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/beta/alloydb/clusters/create b/gcloud/beta/alloydb/clusters/create index 0787d8f18..564e20129 100644 --- a/gcloud/beta/alloydb/clusters/create +++ b/gcloud/beta/alloydb/clusters/create @@ -84,14 +84,16 @@ OPTIONAL FLAGS on the command line. --continuous-backup-encryption-key-location=CONTINUOUS_BACKUP_ENCRYPTION_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▫ provide the argument --continuous-backup-encryption-key on the command line with a fully specified name; ▫ provide the argument --continuous-backup-encryption-key-location on the command line. --continuous-backup-encryption-key-project=CONTINUOUS_BACKUP_ENCRYPTION_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▫ provide the argument --continuous-backup-encryption-key on the command line with a fully specified name; ▫ provide the argument --continuous-backup-encryption-key-project @@ -156,7 +158,7 @@ OPTIONAL FLAGS --automated-backup-encryption-key-keyring on the command line. --automated-backup-encryption-key-location=AUTOMATED_BACKUP_ENCRYPTION_KEY_LOCATION - The Cloud location for the key. To set the kms-location + The Google Cloud location for the key. To set the kms-location attribute: ◇ provide the argument --automated-backup-encryption-key on the command line with a fully specified name; @@ -164,7 +166,8 @@ OPTIONAL FLAGS --automated-backup-encryption-key-location on the command line. --automated-backup-encryption-key-project=AUTOMATED_BACKUP_ENCRYPTION_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ◇ provide the argument --automated-backup-encryption-key on the command line with a fully specified name; ◇ provide the argument @@ -204,13 +207,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/beta/alloydb/clusters/create-secondary b/gcloud/beta/alloydb/clusters/create-secondary index e4d5518a8..c862f69d6 100644 --- a/gcloud/beta/alloydb/clusters/create-secondary +++ b/gcloud/beta/alloydb/clusters/create-secondary @@ -58,13 +58,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/beta/alloydb/clusters/restore b/gcloud/beta/alloydb/clusters/restore index 2d3fc3fb1..8eed72906 100644 --- a/gcloud/beta/alloydb/clusters/restore +++ b/gcloud/beta/alloydb/clusters/restore @@ -6,7 +6,7 @@ SYNOPSIS gcloud beta alloydb clusters restore CLUSTER --region=REGION [--async] [--network=NETWORK] [--backup=BACKUP - : --point-in-time=POINT_IN_TIME --source-cluster=SOURCE_CLUSTER] + | --point-in-time=POINT_IN_TIME --source-cluster=SOURCE_CLUSTER] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] [GCLOUD_WIDE_FLAG ...] @@ -86,13 +86,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/beta/alloydb/clusters/update b/gcloud/beta/alloydb/clusters/update index 21c70119d..3a2be19dc 100644 --- a/gcloud/beta/alloydb/clusters/update +++ b/gcloud/beta/alloydb/clusters/update @@ -11,9 +11,8 @@ SYNOPSIS [--automated-backup-encryption-key=AUTOMATED_BACKUP_ENCRYPTION_KEY : --automated-backup-encryption-key-keyring=AUTOMATED_BACKUP_ENCRYPTION_KEY_KEYRING --automated-backup-encryption-key-location=AUTOMATED_BACKUP_ENCRYPTION_KEY_LOCATION --automated-backup-encryption-key-project=AUTOMATED_BACKUP_ENCRYPTION_KEY_PROJECT] --automated-backup-retention-count=RETENTION_COUNT | --automated-backup-retention-period=RETENTION_PERIOD]] [--continuous-backup-recovery-window-days=RECOVERY_PERIOD - --enable-continuous-backup - [--continuous-backup-encryption-key=CONTINUOUS_BACKUP_ENCRYPTION_KEY - : --continuous-backup-encryption-key-keyring=CONTINUOUS_BACKUP_ENCRYPTION_KEY_KEYRING --continuous-backup-encryption-key-location=CONTINUOUS_BACKUP_ENCRYPTION_KEY_LOCATION --continuous-backup-encryption-key-project=CONTINUOUS_BACKUP_ENCRYPTION_KEY_PROJECT]] + --enable-continuous-backup --clear-continuous-backup-encryption-key + | [--continuous-backup-encryption-key=CONTINUOUS_BACKUP_ENCRYPTION_KEY : --continuous-backup-encryption-key-keyring=CONTINUOUS_BACKUP_ENCRYPTION_KEY_KEYRING --continuous-backup-encryption-key-location=CONTINUOUS_BACKUP_ENCRYPTION_KEY_LOCATION --continuous-backup-encryption-key-project=CONTINUOUS_BACKUP_ENCRYPTION_KEY_PROJECT]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -103,7 +102,7 @@ OPTIONAL FLAGS --automated-backup-encryption-key-keyring on the command line. --automated-backup-encryption-key-location=AUTOMATED_BACKUP_ENCRYPTION_KEY_LOCATION - The Cloud location for the key. To set the kms-location + The Google Cloud location for the key. To set the kms-location attribute: ◇ provide the argument --automated-backup-encryption-key on the command line with a fully specified name; @@ -111,7 +110,8 @@ OPTIONAL FLAGS --automated-backup-encryption-key-location on the command line. --automated-backup-encryption-key-project=AUTOMATED_BACKUP_ENCRYPTION_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ◇ provide the argument --automated-backup-encryption-key on the command line with a fully specified name; ◇ provide the argument @@ -139,42 +139,53 @@ OPTIONAL FLAGS --enable-continuous-backup Enables Continuous Backups on the cluster. - Key resource - The Cloud KMS (Key Management Service) cryptokey that - will be used to protect the continuous backup. The 'AlloyDB Service - Agent's service account must hold permission 'Cloud KMS CryptoKey - Encrypter/Decrypter'. The arguments in this group can be used to specify - the attributes of this resource. + Encryption configuration for Continuous Backups. - --continuous-backup-encryption-key=CONTINUOUS_BACKUP_ENCRYPTION_KEY - ID of the key or fully qualified identifier for the key. To set the - kms-key attribute: - ▫ provide the argument --continuous-backup-encryption-key on the - command line. + At most one of these can be specified: - This flag argument must be specified if any of the other arguments - in this group are specified. + --clear-continuous-backup-encryption-key + Clears the encryption configuration for Continuous Backups. Google + default encryption will be used for future Continuous Backups. - --continuous-backup-encryption-key-keyring=CONTINUOUS_BACKUP_ENCRYPTION_KEY_KEYRING - The KMS keyring of the key. To set the kms-keyring attribute: - ▫ provide the argument --continuous-backup-encryption-key on the - command line with a fully specified name; - ▫ provide the argument --continuous-backup-encryption-key-keyring - on the command line. + Key resource - The Cloud KMS (Key Management Service) cryptokey that + will be used to protect the continuous backup. The 'AlloyDB Service + Agent's service account must hold permission 'Cloud KMS CryptoKey + Encrypter/Decrypter'. The arguments in this group can be used to + specify the attributes of this resource. - --continuous-backup-encryption-key-location=CONTINUOUS_BACKUP_ENCRYPTION_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: - ▫ provide the argument --continuous-backup-encryption-key on the - command line with a fully specified name; - ▫ provide the argument - --continuous-backup-encryption-key-location on the command line. + --continuous-backup-encryption-key=CONTINUOUS_BACKUP_ENCRYPTION_KEY + ID of the key or fully qualified identifier for the key. To set + the kms-key attribute: + ◇ provide the argument --continuous-backup-encryption-key on + the command line. - --continuous-backup-encryption-key-project=CONTINUOUS_BACKUP_ENCRYPTION_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: - ▫ provide the argument --continuous-backup-encryption-key on the - command line with a fully specified name; - ▫ provide the argument --continuous-backup-encryption-key-project - on the command line; - ▫ set the property core/project. + This flag argument must be specified if any of the other + arguments in this group are specified. + + --continuous-backup-encryption-key-keyring=CONTINUOUS_BACKUP_ENCRYPTION_KEY_KEYRING + The KMS keyring of the key. To set the kms-keyring attribute: + ◇ provide the argument --continuous-backup-encryption-key on + the command line with a fully specified name; + ◇ provide the argument + --continuous-backup-encryption-key-keyring on the command line. + + --continuous-backup-encryption-key-location=CONTINUOUS_BACKUP_ENCRYPTION_KEY_LOCATION + The Google Cloud location for the key. To set the kms-location + attribute: + ◇ provide the argument --continuous-backup-encryption-key on + the command line with a fully specified name; + ◇ provide the argument + --continuous-backup-encryption-key-location on the command + line. + + --continuous-backup-encryption-key-project=CONTINUOUS_BACKUP_ENCRYPTION_KEY_PROJECT + The Google Cloud project for the key. To set the kms-project + attribute: + ◇ provide the argument --continuous-backup-encryption-key on + the command line with a fully specified name; + ◇ provide the argument + --continuous-backup-encryption-key-project on the command line; + ◇ set the property core/project. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/alloydb/instances/create b/gcloud/beta/alloydb/instances/create index f76566835..e8987878b 100644 --- a/gcloud/beta/alloydb/instances/create +++ b/gcloud/beta/alloydb/instances/create @@ -7,6 +7,10 @@ SYNOPSIS --cpu-count=CPU_COUNT --instance-type=INSTANCE_TYPE --region=REGION [--async] [--availability-type=AVAILABILITY_TYPE] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] + [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] + [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] + [--[no-]insights-config-record-application-tags] + [--[no-]insights-config-record-client-address] [--read-pool-node-count=READ_POOL_NODE_COUNT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -77,6 +81,27 @@ OPTIONAL FLAGS API for allowed flags. (e.g., --database-flags max_allowed_packet=55555,skip_grant_tables=,log_output=1) + --insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE + Number of query plans to sample every minute. Default value is 5. + Allowed range: 0 to 20. + + --insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH + Query string length in bytes to be stored by the query insights + feature. Default length is 1024 bytes. Allowed range: 256 to 4500 + bytes. + + --[no-]insights-config-record-application-tags + Allow application tags to be recorded by the query insights feature. + + Use --insights-config-record-application-tags to enable and + --no-insights-config-record-application-tags to disable. + + --[no-]insights-config-record-client-address + Allow the client address to be recorded by the query insights feature. + + Use --insights-config-record-client-address to enable and + --no-insights-config-record-client-address to disable. + --read-pool-node-count=READ_POOL_NODE_COUNT Read capacity, i.e. number of nodes in a read pool instance. diff --git a/gcloud/beta/alloydb/instances/update b/gcloud/beta/alloydb/instances/update index 8e6efb52f..a0280e6d0 100644 --- a/gcloud/beta/alloydb/instances/update +++ b/gcloud/beta/alloydb/instances/update @@ -6,6 +6,10 @@ SYNOPSIS gcloud beta alloydb instances update INSTANCE --cluster=CLUSTER --region=REGION [--async] [--availability-type=AVAILABILITY_TYPE] [--cpu-count=CPU_COUNT] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] + [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] + [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] + [--[no-]insights-config-record-application-tags] + [--[no-]insights-config-record-client-address] [--read-pool-node-count=READ_POOL_NODE_COUNT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -58,6 +62,27 @@ OPTIONAL FLAGS API for allowed flags. (e.g., --database-flags max_allowed_packet=55555,skip_grant_tables=,log_output=1) + --insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE + Number of query plans to sample every minute. Default value is 5. + Allowed range: 0 to 20. + + --insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH + Query string length in bytes to be stored by the query insights + feature. Default length is 1024 bytes. Allowed range: 256 to 4500 + bytes. + + --[no-]insights-config-record-application-tags + Allow application tags to be recorded by the query insights feature. + + Use --insights-config-record-application-tags to enable and + --no-insights-config-record-application-tags to disable. + + --[no-]insights-config-record-client-address + Allow the client address to be recorded by the query insights feature. + + Use --insights-config-record-client-address to enable and + --no-insights-config-record-client-address to disable. + --read-pool-node-count=READ_POOL_NODE_COUNT Read capacity, i.e. number of nodes in a read pool instance. diff --git a/gcloud/beta/artifacts/help b/gcloud/beta/artifacts/help index 29e11080c..a3da2e567 100644 --- a/gcloud/beta/artifacts/help +++ b/gcloud/beta/artifacts/help @@ -48,6 +48,10 @@ GROUPS versions (BETA) Manage Artifact Registry package versions. + vpcsc-config + (BETA) Manage Artifact Registry VPC Service Controls configuration for + remote repositories. + yum (BETA) Manage Artifact Registry RPM packages. diff --git a/gcloud/beta/artifacts/vpcsc-config/allow b/gcloud/beta/artifacts/vpcsc-config/allow new file mode 100644 index 000000000..432518b20 --- /dev/null +++ b/gcloud/beta/artifacts/vpcsc-config/allow @@ -0,0 +1,64 @@ +NAME + gcloud beta artifacts vpcsc-config allow - allow Artifact Registry remote + repositories inside a service perimeter to retrieve data from their + upstream sources outside of the perimeter + +SYNOPSIS + gcloud beta artifacts vpcsc-config allow [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Allow Artifact Registry remote repositories inside a service + perimeter to retrieve data from their upstream sources outside of the + perimeter. + + This command can fail for the following reasons: + ▪ Lack of permission - "accesscontextmanager.policies.update". + ▪ The resource could be outside of the VPC SC perimeter. + ▪ Lack of permission - "artifactregistry.vpcscconfigs.update" + +EXAMPLES + The following command allows remote repositories in the project my-project + and in the region us--west1 to retrieve data from upstream sources outside + the perimeter: + + $ gcloud beta artifacts vpcsc-config allow --project=my-project \ + --location=us-west1 + +FLAGS + Location resource - The Artifact Registry VPC SC config to update. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property artifacts/location with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --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; + ▸ set the property artifacts/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud artifacts vpcsc-config allow + + $ gcloud alpha artifacts vpcsc-config allow + diff --git a/gcloud/beta/artifacts/vpcsc-config/deny b/gcloud/beta/artifacts/vpcsc-config/deny new file mode 100644 index 000000000..3eb22bfba --- /dev/null +++ b/gcloud/beta/artifacts/vpcsc-config/deny @@ -0,0 +1,63 @@ +NAME + gcloud beta artifacts vpcsc-config deny - deny access to upstream sources + outside the service perimeter for Artifact Registry remote repositories + inside the perimeter + +SYNOPSIS + gcloud beta artifacts vpcsc-config deny [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Deny access to upstream sources outside the service perimeter for + Artifact Registry remote repositories inside the perimeter. + + This command can fail for the following reasons: + ▪ Lack of permission - "accesscontextmanager.policies.update". + ▪ The resource could be outside of the VPC SC perimeter. + ▪ Lack of permission - "artifactregistry.vpcscconfigs.update" + +EXAMPLES + The following command denies access to upstream sources outside the service + perimeter for remote repositories in the project my-project and in the + region us--west1: + + $ gcloud beta artifacts vpcsc-config deny --project=my-project \ + --location=us-west1 + +FLAGS + Location resource - The Artifact Registry VPC SC config to update. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property artifacts/location with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --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; + ▸ set the property artifacts/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud artifacts vpcsc-config deny + + $ gcloud alpha artifacts vpcsc-config deny + diff --git a/gcloud/beta/artifacts/vpcsc-config/describe b/gcloud/beta/artifacts/vpcsc-config/describe new file mode 100644 index 000000000..af290b7c0 --- /dev/null +++ b/gcloud/beta/artifacts/vpcsc-config/describe @@ -0,0 +1,61 @@ +NAME + gcloud beta artifacts vpcsc-config describe - describe the current Artifact + Registry configuration for VPC Service Controls + +SYNOPSIS + gcloud beta artifacts vpcsc-config describe [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe the current Artifact Registry configuration for VPC Service + Controls. + + This command can fail for the following reasons: + ▪ Lack of permission - "accesscontextmanager.policies.get". + ▪ The resource could be outside of the VPC SC perimeter. + ▪ Lack of permission - "artifactregistry.vpcscconfigs.get" + +EXAMPLES + The following command returns the current VPC Service Controls + configuration for the project my-project and region us-west1: + + $ gcloud beta artifacts vpcsc-config describe --project=my-project \ + --location=us-west1 + +FLAGS + Location resource - The Artifact Registry VPC SC configs to describe. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property artifacts/location with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --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; + ▸ set the property artifacts/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud artifacts vpcsc-config describe + + $ gcloud alpha artifacts vpcsc-config describe + diff --git a/gcloud/beta/artifacts/vpcsc-config/help b/gcloud/beta/artifacts/vpcsc-config/help new file mode 100644 index 000000000..98c80b801 --- /dev/null +++ b/gcloud/beta/artifacts/vpcsc-config/help @@ -0,0 +1,40 @@ +NAME + gcloud beta artifacts vpcsc-config - manage Artifact Registry VPC Service + Controls configuration for remote repositories + +SYNOPSIS + gcloud beta artifacts vpcsc-config COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Artifact Registry VPC Service Controls configuration for + remote repositories. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + allow + (BETA) Allow Artifact Registry remote repositories inside a service + perimeter to retrieve data from their upstream sources outside of the + perimeter. + + deny + (BETA) Deny access to upstream sources outside the service perimeter + for Artifact Registry remote repositories inside the perimeter. + + describe + (BETA) Describe the current Artifact Registry configuration for VPC + Service Controls. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud artifacts vpcsc-config + + $ gcloud alpha artifacts vpcsc-config + diff --git a/gcloud/beta/auth/help b/gcloud/beta/auth/help index 31cc7263f..e7c5d93e9 100644 --- a/gcloud/beta/auth/help +++ b/gcloud/beta/auth/help @@ -22,6 +22,11 @@ DESCRIPTION global flags, see the gcloud CLI overview (https://cloud.google.com/sdk/gcloud/reference). + See $ gcloud topic client-certificate to learn how to use Mutual TLS when + using gcloud. Mutual TLS can be used for certificate based access + (https://cloud.google.com/beyondcorp-enterprise/docs/securing-resources-with-certificate-based-access) + with gcloud. + EXAMPLES To authenticate a user account with gcloud and minimal user output, run: diff --git a/gcloud/beta/bigtable/backups/list b/gcloud/beta/bigtable/backups/list index 52a9fc117..a1a4ec5dc 100644 --- a/gcloud/beta/bigtable/backups/list +++ b/gcloud/beta/bigtable/backups/list @@ -2,7 +2,7 @@ NAME gcloud beta bigtable backups list - list existing Bigtable backups SYNOPSIS - gcloud beta bigtable backups list --cluster=CLUSTER --instance=INSTANCE + gcloud beta bigtable backups list [--cluster=CLUSTER] [--instance=INSTANCE] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/beta/bigtable/clusters/list b/gcloud/beta/bigtable/clusters/list index 782951fb3..aa7aa1649 100644 --- a/gcloud/beta/bigtable/clusters/list +++ b/gcloud/beta/bigtable/clusters/list @@ -2,7 +2,7 @@ NAME gcloud beta bigtable clusters list - list existing Bigtable clusters SYNOPSIS - gcloud beta bigtable clusters list --instances=[INSTANCES,...] + gcloud beta bigtable clusters list [--instances=[INSTANCES,...]] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/beta/bigtable/operations/list b/gcloud/beta/bigtable/operations/list index 44438c01f..8f1e2b90e 100644 --- a/gcloud/beta/bigtable/operations/list +++ b/gcloud/beta/bigtable/operations/list @@ -2,7 +2,7 @@ NAME gcloud beta bigtable operations list - list Cloud Bigtable operations SYNOPSIS - gcloud beta bigtable operations list --instance=INSTANCE + gcloud beta bigtable operations list [--instance=INSTANCE] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/beta/builds/triggers/create/gitlab-enterprise b/gcloud/beta/builds/triggers/create/gitlab-enterprise index 0dc68251b..694b8c806 100644 --- a/gcloud/beta/builds/triggers/create/gitlab-enterprise +++ b/gcloud/beta/builds/triggers/create/gitlab-enterprise @@ -4,18 +4,16 @@ NAME SYNOPSIS gcloud beta builds triggers create gitlab-enterprise - (--trigger-config=PATH - | [--gitlab-config-resource=GITLAB_CONFIG_RESOURCE - --project-namespace=PROJECT_NAMESPACE (--branch-pattern=REGEX - | --tag-pattern=REGEX | [--pull-request-pattern=REGEX - : --comment-control=COMMENT_CONTROL; + (--trigger-config=PATH | [(--branch-pattern=REGEX | --tag-pattern=REGEX + | [--pull-request-pattern=REGEX : --comment-control=COMMENT_CONTROL; default=CommentControlValueValuesEnum(COMMENTS_ENABLED, 1)]) (--build-config=PATH | --inline-config=PATH | [--dockerfile=DOCKERFILE : --dockerfile-dir=DOCKERFILE_DIR; default="/" --dockerfile-image=DOCKERFILE_IMAGE]) - : --description=DESCRIPTION --ignored-files=[GLOB,...] - --included-files=[GLOB,...] --name=NAME --region=REGION - --require-approval + (--gitlab-config-resource=GITLAB_CONFIG_RESOURCE + --project-namespace=PROJECT_NAMESPACE) : --description=DESCRIPTION + --ignored-files=[GLOB,...] --included-files=[GLOB,...] --name=NAME + --region=REGION --require-approval --service-account=SERVICE_ACCOUNT --substitutions=[KEY=VALUE,...]]) [GCLOUD_WIDE_FLAG ...] @@ -23,7 +21,7 @@ DESCRIPTION (BETA) Create a build trigger for a GitLab Enterprise repository. EXAMPLES - To create a push trigger for all branches: + To create a push trigger with a 1st-gen repository for all branches: $ gcloud beta builds triggers create gitlab-enterprise \ --name="my-trigger" \ @@ -33,7 +31,7 @@ EXAMPLES --gitlab-config-resource="projects/1234/locations/global/gitLabC\ onfigs/5678" --branch-pattern=".*" --build-config="cloudbuild.yaml" - To create a pull request trigger for main: + To create a pull request trigger with a 1st-gen repository for main: $ gcloud beta builds triggers create gitlab-enterprise \ --name="my-trigger" \ @@ -54,18 +52,6 @@ REQUIRED FLAGS Flag based trigger configuration - --gitlab-config-resource=GITLAB_CONFIG_RESOURCE - GitLab config resource name. - - This flag argument must be specified if any of the other arguments - in this group are specified. - - --project-namespace=PROJECT_NAMESPACE - GitLab project namespace. - - This flag argument must be specified if any of the other arguments - in this group are specified. - --description=DESCRIPTION Build trigger description. @@ -206,6 +192,22 @@ REQUIRED FLAGS Use a build configuration (cloudbuild.yaml) file for building multiple images in a single trigger. + Exactly one of these must be specified: + + 1st-gen repository settings. + + --gitlab-config-resource=GITLAB_CONFIG_RESOURCE + GitLab config resource name. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --project-namespace=PROJECT_NAMESPACE + GitLab project namespace. + + This flag argument must be specified if any of the other + arguments in this group are specified. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/certificate-manager/maps/entries/create b/gcloud/beta/certificate-manager/maps/entries/create index d368ac4fc..912df885c 100644 --- a/gcloud/beta/certificate-manager/maps/entries/create +++ b/gcloud/beta/certificate-manager/maps/entries/create @@ -6,8 +6,8 @@ SYNOPSIS gcloud beta certificate-manager maps entries create (ENTRY : --location=LOCATION --map=MAP) (--hostname=HOSTNAME | --set-primary) [--description=DESCRIPTION] - --certificates=[CERTIFICATES,...] [--async] [--labels=[KEY=VALUE,...]] - [GCLOUD_WIDE_FLAG ...] + [--async] [--certificates=[CERTIFICATES,...]] + [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) This command creates a certificate map entry. @@ -72,6 +72,10 @@ COMMONLY USED FLAGS Text description of a certificate map entry. OTHER FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + Certificate resource - The certificates to be attached to the entry. 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 @@ -89,10 +93,6 @@ OTHER FLAGS certificates. To set the certificate attribute: ▸ provide the argument --certificates on the command line. - --async - Return immediately, without waiting for the operation in progress to - complete. - --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/beta/certificate-manager/maps/entries/update b/gcloud/beta/certificate-manager/maps/entries/update index de50b1b8c..f60cf361e 100644 --- a/gcloud/beta/certificate-manager/maps/entries/update +++ b/gcloud/beta/certificate-manager/maps/entries/update @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud beta certificate-manager maps entries update (ENTRY : --location=LOCATION --map=MAP) [--description=DESCRIPTION] - --certificates=[CERTIFICATES,...] [--async] + [--async] [--certificates=[CERTIFICATES,...]] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -59,6 +59,10 @@ COMMONLY USED FLAGS Text description of a certificate map entry. OTHER FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + Certificate resource - The certificates to be attached to the entry. 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 @@ -76,10 +80,6 @@ OTHER FLAGS certificates. To set the certificate attribute: ▸ provide the argument --certificates on the command line. - --async - Return immediately, without waiting for the operation in progress to - complete. - --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. diff --git a/gcloud/beta/composer/environments/create b/gcloud/beta/composer/environments/create index 117dd6907..29e61553c 100644 --- a/gcloud/beta/composer/environments/create +++ b/gcloud/beta/composer/environments/create @@ -33,7 +33,7 @@ SYNOPSIS --snapshot-creation-schedule=SNAPSHOT_CREATION_SCHEDULE --snapshot-location=SNAPSHOT_LOCATION --snapshot-schedule-timezone=SNAPSHOT_SCHEDULE_TIMEZONE] - [--enable-triggerer + [--enable-triggerer --triggerer-count=TRIGGERER_COUNT --triggerer-cpu=TRIGGERER_CPU --triggerer-memory=TRIGGERER_MEMORY] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] @@ -413,8 +413,14 @@ FLAGS greater. --enable-triggerer - Enable use of a triggerer, supported in the Environments with - Composer 2.0.31 and Airflow 2.2.5 and greater. + (DEPRECATED) Enable use of a triggerer, supported in the Environments + with Composer 2.0.31 and Airflow 2.2.5 and greater. + + This flag is deprecated. Use --triggerer-count instead. + + --triggerer-count=TRIGGERER_COUNT + Number of triggerers, supported in the Environments with Composer + 2.0.31 and Airflow 2.2.5 and greater. --triggerer-cpu=TRIGGERER_CPU CPU allocated to Airflow triggerer. Supported in the Environments @@ -446,13 +452,15 @@ FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/beta/composer/environments/list b/gcloud/beta/composer/environments/list index 8a5f13db2..73cb83121 100644 --- a/gcloud/beta/composer/environments/list +++ b/gcloud/beta/composer/environments/list @@ -3,7 +3,7 @@ NAME environments under a project and location SYNOPSIS - gcloud beta composer environments list --locations=[LOCATIONS,...] + gcloud beta composer environments list [--locations=[LOCATIONS,...]] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/beta/composer/environments/update b/gcloud/beta/composer/environments/update index 7a9d9fa5a..dd07ddcf9 100644 --- a/gcloud/beta/composer/environments/update +++ b/gcloud/beta/composer/environments/update @@ -30,7 +30,7 @@ SYNOPSIS --web-server-storage=WEB_SERVER_STORAGE --worker-cpu=WORKER_CPU --worker-memory=WORKER_MEMORY --worker-storage=WORKER_STORAGE --disable-triggerer - | --enable-triggerer + | --enable-triggerer --triggerer-count=TRIGGERER_COUNT --triggerer-cpu=TRIGGERER_CPU --triggerer-memory=TRIGGERER_MEMORY | --update-airflow-configs=[KEY=VALUE,...] --clear-airflow-configs | --remove-airflow-configs=[KEY,...] @@ -299,14 +299,23 @@ REQUIRED FLAGS At most one of these can be specified: --disable-triggerer - Disable a triggerer, supported in the Environments with Composer - 2.0.31 and Airflow 2.2.5 and greater. + (DEPRECATED) Disable a triggerer, supported in the Environments + with Composer 2.0.31 and Airflow 2.2.5 and greater. + + This flag is deprecated. Use --triggerer-count 0 instead. Group of arguments for setting triggerer settings during update in Composer 2.0.31 or greater. --enable-triggerer - Enable use of a triggerer, supported in the Environments with + (DEPRECATED) Enable use of a triggerer, supported in the + Environments with Composer 2.0.31 and Airflow 2.2.5 and + greater. + + This flag is deprecated. Use --triggerer-count instead. + + --triggerer-count=TRIGGERER_COUNT + Number of triggerers, supported in the Environments with Composer 2.0.31 and Airflow 2.2.5 and greater. --triggerer-cpu=TRIGGERER_CPU diff --git a/gcloud/beta/composer/operations/list b/gcloud/beta/composer/operations/list index 7a2e924df..b18b6d689 100644 --- a/gcloud/beta/composer/operations/list +++ b/gcloud/beta/composer/operations/list @@ -2,7 +2,7 @@ NAME gcloud beta composer operations list - lists environment operations SYNOPSIS - gcloud beta composer operations list --locations=[LOCATIONS,...] + gcloud beta composer operations list [--locations=[LOCATIONS,...]] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/beta/compute/backend-services/create b/gcloud/beta/compute/backend-services/create index f504d49c4..96f7f5083 100644 --- a/gcloud/beta/compute/backend-services/create +++ b/gcloud/beta/compute/backend-services/create @@ -26,6 +26,8 @@ SYNOPSIS [--idle-timeout-sec=IDLE_TIMEOUT_SEC] [--load-balancing-scheme=LOAD_BALANCING_SCHEME; default="EXTERNAL"] [--locality-lb-policy=LOCALITY_LB_POLICY] + [--logging-optional=LOGGING_OPTIONAL] + [--logging-optional-fields=[LOGGING_OPTIONAL_FIELDS,...]] [--logging-sample-rate=LOGGING_SAMPLE_RATE] [--max-ttl=MAX_TTL] [--[no-]negative-caching] [--negative-caching-policy=[[CODE=TTL],...]] [--network=NETWORK] [--port-name=PORT_NAME] [--protocol=PROTOCOL] @@ -264,9 +266,9 @@ FLAGS --[no-]enable-logging The logging options for the load balancer traffic served by this backend service. If logging is enabled, logs will be exported to Cloud - Logging. This can only be specified if the protocol is HTTP, HTTPS, - HTTP2, TCP, SSL, UDP, or UNSPECIFIED. Disabled by default. Use - --enable-logging to enable and --no-enable-logging to disable. + Logging. Disabled by default. This field cannot be specified for SSL + Proxy and TCP Proxy Load Balancing. Use --enable-logging to enable and + --no-enable-logging to disable. --[no-]enable-strong-affinity Enable or disable strong session affinity. This is only available for @@ -336,14 +338,29 @@ FLAGS LEAST_REQUEST, RING_HASH, RANDOM, ORIGINAL_DESTINATION, MAGLEV, WEIGHTED_MAGLEV. + --logging-optional=LOGGING_OPTIONAL + This field can only be specified if logging is enabled for the backend + service. Configures whether all, none, or a subset of optional fields + should be added to the reported logs. Default is EXCLUDE_ALL_OPTIONAL. + This field can only be specified for Internal TCP/UDP Load Balancing + and External Network Load Balancing. LOGGING_OPTIONAL must be one of: + EXCLUDE_ALL_OPTIONAL, INCLUDE_ALL_OPTIONAL, CUSTOM. + + --logging-optional-fields=[LOGGING_OPTIONAL_FIELDS,...] + This field can only be specified if logging is enabled for the backend + service and "--logging-optional" was set to CUSTOM. Contains a + comma-separated list of optional fields you want to include in the + logs. For example: serverInstance, serverGkeDetails.cluster, + serverGkeDetails.pod.podNamespace. This can only be specified for + Internal TCP/UDP Load Balancing and External Network Load Balancing. + --logging-sample-rate=LOGGING_SAMPLE_RATE This field can only be specified if logging is enabled for the backend service. The value of the field must be a float in the range [0, 1]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no - logged requests are reported. This can only be specified if the - protocol is HTTP, HTTPS, HTTP2, TCP, SSL, UDP, or UNSPECIFIED. The - default value is 0.0. + logged requests are reported. The default value is 1.0 when logging is + enabled and 0.0 otherwise. --max-ttl=MAX_TTL Specifies the maximum allowed TTL for cached content served by this diff --git a/gcloud/beta/compute/backend-services/update b/gcloud/beta/compute/backend-services/update index 26e972f4d..9cfc85486 100644 --- a/gcloud/beta/compute/backend-services/update +++ b/gcloud/beta/compute/backend-services/update @@ -21,6 +21,8 @@ SYNOPSIS oauth2-client-secret=OAUTH2-CLIENT-SECRET]] [--idle-timeout-sec=IDLE_TIMEOUT_SEC] [--locality-lb-policy=LOCALITY_LB_POLICY] + [--logging-optional=LOGGING_OPTIONAL] + [--logging-optional-fields=[LOGGING_OPTIONAL_FIELDS,...]] [--logging-sample-rate=LOGGING_SAMPLE_RATE] [--port-name=PORT_NAME] [--protocol=PROTOCOL] [--[no-]request-coalescing] [--security-policy=SECURITY_POLICY] @@ -177,9 +179,9 @@ FLAGS --[no-]enable-logging The logging options for the load balancer traffic served by this backend service. If logging is enabled, logs will be exported to Cloud - Logging. This can only be specified if the protocol is HTTP, HTTPS, - HTTP2, TCP, SSL, UDP, or UNSPECIFIED. Disabled by default. Use - --enable-logging to enable and --no-enable-logging to disable. + Logging. Disabled by default. This field cannot be specified for SSL + Proxy and TCP Proxy Load Balancing. Use --enable-logging to enable and + --no-enable-logging to disable. --[no-]enable-strong-affinity Enable or disable strong session affinity. This is only available for @@ -244,14 +246,29 @@ FLAGS LEAST_REQUEST, RING_HASH, RANDOM, ORIGINAL_DESTINATION, MAGLEV, WEIGHTED_MAGLEV. + --logging-optional=LOGGING_OPTIONAL + This field can only be specified if logging is enabled for the backend + service. Configures whether all, none, or a subset of optional fields + should be added to the reported logs. Default is EXCLUDE_ALL_OPTIONAL. + This field can only be specified for Internal TCP/UDP Load Balancing + and External Network Load Balancing. LOGGING_OPTIONAL must be one of: + EXCLUDE_ALL_OPTIONAL, INCLUDE_ALL_OPTIONAL, CUSTOM. + + --logging-optional-fields=[LOGGING_OPTIONAL_FIELDS,...] + This field can only be specified if logging is enabled for the backend + service and "--logging-optional" was set to CUSTOM. Contains a + comma-separated list of optional fields you want to include in the + logs. For example: serverInstance, serverGkeDetails.cluster, + serverGkeDetails.pod.podNamespace. This can only be specified for + Internal TCP/UDP Load Balancing and External Network Load Balancing. + --logging-sample-rate=LOGGING_SAMPLE_RATE This field can only be specified if logging is enabled for the backend service. The value of the field must be a float in the range [0, 1]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no - logged requests are reported. This can only be specified if the - protocol is HTTP, HTTPS, HTTP2, TCP, SSL, UDP, or UNSPECIFIED. The - default value is 0.0. + logged requests are reported. The default value is 1.0 when logging is + enabled and 0.0 otherwise. --port-name=PORT_NAME Backend services for external HTTP(S) load balancing, internal HTTP(S) diff --git a/gcloud/beta/compute/reservations/create b/gcloud/beta/compute/reservations/create index 07b557ecd..d80e61e48 100644 --- a/gcloud/beta/compute/reservations/create +++ b/gcloud/beta/compute/reservations/create @@ -59,8 +59,9 @@ REQUIRED FLAGS 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. + The resource policies to include in this reservation. If you omit + this flag, no resource policies are added. You can specify any string + as the key, and specify the name of a resource policy as the value. Manage the instance properties for the SpecificSKU reservation. diff --git a/gcloud/beta/compute/target-https-proxies/create b/gcloud/beta/compute/target-https-proxies/create index 5e109709b..dfa9881f3 100644 --- a/gcloud/beta/compute/target-https-proxies/create +++ b/gcloud/beta/compute/target-https-proxies/create @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta compute target-https-proxies create NAME --url-map=URL_MAP - --certificate-map=CERTIFICATE_MAP [--description=DESCRIPTION] + [--certificate-map=CERTIFICATE_MAP] [--description=DESCRIPTION] [--quic-override=QUIC_OVERRIDE; default="NONE"] [--ssl-certificates=SSL_CERTIFICATE,[...]] [--ssl-policy=SSL_POLICY] [--global | --region=REGION] diff --git a/gcloud/beta/compute/target-https-proxies/update b/gcloud/beta/compute/target-https-proxies/update index f5fef2175..23e41420e 100644 --- a/gcloud/beta/compute/target-https-proxies/update +++ b/gcloud/beta/compute/target-https-proxies/update @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud beta compute target-https-proxies update NAME [--quic-override=QUIC_OVERRIDE] [--url-map=URL_MAP] - [[--certificate-map=CERTIFICATE_MAP : --clear-certificate-map] + [--certificate-map=CERTIFICATE_MAP | --clear-certificate-map | --ssl-certificates=SSL_CERTIFICATE,[...] --global-ssl-certificates | --ssl-certificates-region=SSL_CERTIFICATES_REGION] [--clear-ssl-policy | --ssl-policy=SSL_POLICY --global-ssl-policy diff --git a/gcloud/beta/compute/target-ssl-proxies/create b/gcloud/beta/compute/target-ssl-proxies/create index 15cccd4d3..b9990d0e5 100644 --- a/gcloud/beta/compute/target-ssl-proxies/create +++ b/gcloud/beta/compute/target-ssl-proxies/create @@ -5,8 +5,7 @@ SYNOPSIS gcloud beta compute target-ssl-proxies create NAME --backend-service=BACKEND_SERVICE (--certificate-map=CERTIFICATE_MAP - : --ssl-certificates=SSL_CERTIFICATE,[...]) - [--description=DESCRIPTION] + --ssl-certificates=SSL_CERTIFICATE,[...]) [--description=DESCRIPTION] [--proxy-header=PROXY_HEADER; default="NONE"] [--ssl-policy=SSL_POLICY] [--global-ssl-policy | --ssl-policy-region=SSL_POLICY_REGION] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/beta/compute/target-ssl-proxies/update b/gcloud/beta/compute/target-ssl-proxies/update index ac07055b1..b6e528537 100644 --- a/gcloud/beta/compute/target-ssl-proxies/update +++ b/gcloud/beta/compute/target-ssl-proxies/update @@ -4,11 +4,11 @@ NAME SYNOPSIS gcloud beta compute target-ssl-proxies update NAME [--backend-service=BACKEND_SERVICE] [--proxy-header=PROXY_HEADER] - [--certificate-map=CERTIFICATE_MAP - : --ssl-certificates=SSL_CERTIFICATE,[...] | --clear-ssl-certificates - | --clear-certificate-map] [--clear-ssl-policy | --ssl-policy=SSL_POLICY --global-ssl-policy - | --ssl-policy-region=SSL_POLICY_REGION] [GCLOUD_WIDE_FLAG ...] + | --ssl-policy-region=SSL_POLICY_REGION] + [--ssl-certificates=SSL_CERTIFICATE,[...] | --clear-ssl-certificates + | --certificate-map=CERTIFICATE_MAP | --clear-certificate-map] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta compute target-ssl-proxies update is used to replace the @@ -39,6 +39,26 @@ FLAGS Enables PROXY protocol (version 1) for passing client connection information. + At most one of these can be specified: + + --clear-ssl-policy + Removes any attached SSL policy from the SSL proxy. + + --ssl-policy=SSL_POLICY + A reference to an SSL policy resource that defines the server-side + support for SSL features and affects the connections between clients + and the SSL proxy load balancer. The SSL policy must exist and cannot + be deleted while referenced by a target SSL proxy. + + At most one of these can be specified: + + --global-ssl-policy + If set, the SSL policy is global. + + --ssl-policy-region=SSL_POLICY_REGION + Region of the SSL policy to operate on. Overrides the default + compute/region property value for this command invocation. + At most one of these can be specified: --ssl-certificates=SSL_CERTIFICATE,[...] @@ -71,26 +91,6 @@ FLAGS --clear-certificate-map Removes any attached certificate map from the SSL proxy. - At most one of these can be specified: - - --clear-ssl-policy - Removes any attached SSL policy from the SSL proxy. - - --ssl-policy=SSL_POLICY - A reference to an SSL policy resource that defines the server-side - support for SSL features and affects the connections between clients - and the SSL proxy load balancer. The SSL policy must exist and cannot - be deleted while referenced by a target SSL proxy. - - At most one of these can be specified: - - --global-ssl-policy - If set, the SSL policy is global. - - --ssl-policy-region=SSL_POLICY_REGION - Region of the SSL policy to operate on. Overrides the default - compute/region property value for this command invocation. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/container/backup-restore/restore-plans/create b/gcloud/beta/container/backup-restore/restore-plans/create index 526c8f4cb..0cb009825 100644 --- a/gcloud/beta/container/backup-restore/restore-plans/create +++ b/gcloud/beta/container/backup-restore/restore-plans/create @@ -182,7 +182,7 @@ OPTIONAL FLAGS List of cluster-scoped resource types to be restored. Not specifying this means NO cluster resource will be restored. The format of a resource is "/", e.g. storage.k8s.io/StorageClass for - StorageClass. + StorageClass. Use an empty string for core API group. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/container/backup-restore/restore-plans/update b/gcloud/beta/container/backup-restore/restore-plans/update index 97b885fbc..5ebc95f06 100644 --- a/gcloud/beta/container/backup-restore/restore-plans/update +++ b/gcloud/beta/container/backup-restore/restore-plans/update @@ -187,7 +187,7 @@ FLAGS List of cluster-scoped resource types to be restored. Not specifying this means NO cluster resource will be restored. The format of a resource is "/", e.g. storage.k8s.io/StorageClass for - StorageClass. + StorageClass. Use an empty string for core API group. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/dataproc/clusters/create b/gcloud/beta/dataproc/clusters/create index 0f0fe6400..5cea2ce5e 100644 --- a/gcloud/beta/dataproc/clusters/create +++ b/gcloud/beta/dataproc/clusters/create @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud beta dataproc clusters create (CLUSTER : --region=REGION) - --autoscaling-policy=AUTOSCALING_POLICY [--no-address] [--async] + [--no-address] [--async] [--autoscaling-policy=AUTOSCALING_POLICY] [--bucket=BUCKET] [--dataproc-metastore=DATAPROC_METASTORE] [--driver-pool-accelerator=[type=TYPE,[count=COUNT],...]] [--driver-pool-boot-disk-size=DRIVER_POOL_BOOT_DISK_SIZE] @@ -102,11 +102,6 @@ POSITIONAL ARGUMENTS ▸ set the property dataproc/region. FLAGS - --autoscaling-policy=AUTOSCALING_POLICY - ID of the autoscaling policy or fully qualified identifier for the - autoscaling policy. To set the autoscaling_policy attribute: - ◆ provide the argument --autoscaling-policy on the command line. - --no-address If provided, the instances in the cluster will not be assigned external IP addresses. @@ -122,6 +117,11 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --autoscaling-policy=AUTOSCALING_POLICY + ID of the autoscaling policy or fully qualified identifier for the + autoscaling policy. To set the autoscaling_policy attribute: + ◆ provide the argument --autoscaling-policy on the command line. + --bucket=BUCKET The Google Cloud Storage bucket to use by default to stage job dependencies, miscellaneous config files, and job driver console output @@ -449,14 +449,16 @@ FLAGS line. --gce-pd-kms-key-location=GCE_PD_KMS_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --gce-pd-kms-key on the command line with a fully specified name; ▸ provide the argument --gce-pd-kms-key-location on the command line. --gce-pd-kms-key-project=GCE_PD_KMS_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --gce-pd-kms-key on the command line with a fully specified name; ▸ provide the argument --gce-pd-kms-key-project on the command @@ -710,14 +712,16 @@ FLAGS line. --kerberos-kms-key-location=KERBEROS_KMS_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▫ provide the argument --kerberos-kms-key on the command line with a fully specified name; ▫ provide the argument --kerberos-kms-key-location on the command line. --kerberos-kms-key-project=KERBEROS_KMS_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▫ provide the argument --kerberos-kms-key on the command line with a fully specified name; ▫ provide the argument --kerberos-kms-key-project on the command diff --git a/gcloud/beta/dataproc/clusters/update b/gcloud/beta/dataproc/clusters/update index 156820b71..282d55507 100644 --- a/gcloud/beta/dataproc/clusters/update +++ b/gcloud/beta/dataproc/clusters/update @@ -7,7 +7,7 @@ SYNOPSIS [--graceful-decommission-timeout=GRACEFUL_DECOMMISSION_TIMEOUT] [--num-secondary-workers=NUM_SECONDARY_WORKERS] [--num-workers=NUM_WORKERS] [--update-labels=[KEY=VALUE,...]] - [--autoscaling-policy=AUTOSCALING_POLICY : --disable-autoscaling] + [--autoscaling-policy=AUTOSCALING_POLICY | --disable-autoscaling] [--clear-labels | --remove-labels=[KEY,...]] [--expiration-time=EXPIRATION_TIME | --max-age=MAX_AGE | --no-max-age] [--max-idle=MAX_IDLE | --no-max-idle] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/beta/dataproc/workflow-templates/set-managed-cluster b/gcloud/beta/dataproc/workflow-templates/set-managed-cluster index 2a0d402ee..ac221a8d9 100644 --- a/gcloud/beta/dataproc/workflow-templates/set-managed-cluster +++ b/gcloud/beta/dataproc/workflow-templates/set-managed-cluster @@ -4,9 +4,10 @@ NAME SYNOPSIS gcloud beta dataproc workflow-templates set-managed-cluster - (TEMPLATE : --region=REGION) --autoscaling-policy=AUTOSCALING_POLICY - [--no-address] [--bucket=BUCKET] [--cluster-name=CLUSTER_NAME] - [--dataproc-metastore=DATAPROC_METASTORE] [--enable-component-gateway] + (TEMPLATE : --region=REGION) [--no-address] + [--autoscaling-policy=AUTOSCALING_POLICY] [--bucket=BUCKET] + [--cluster-name=CLUSTER_NAME] [--dataproc-metastore=DATAPROC_METASTORE] + [--enable-component-gateway] [--initialization-action-timeout=TIMEOUT; default="10m"] [--initialization-actions=CLOUD_STORAGE_URI,[...]] [--labels=[KEY=VALUE,...]] @@ -90,11 +91,6 @@ POSITIONAL ARGUMENTS ▸ set the property dataproc/region. FLAGS - --autoscaling-policy=AUTOSCALING_POLICY - ID of the autoscaling policy or fully qualified identifier for the - autoscaling policy. To set the autoscaling_policy attribute: - ◆ provide the argument --autoscaling-policy on the command line. - --no-address If provided, the instances in the cluster will not be assigned external IP addresses. @@ -106,6 +102,11 @@ FLAGS achieved without external IP addresses using Private Google Access (https://cloud.google.com/compute/docs/private-google-access). + --autoscaling-policy=AUTOSCALING_POLICY + ID of the autoscaling policy or fully qualified identifier for the + autoscaling policy. To set the autoscaling_policy attribute: + ◆ provide the argument --autoscaling-policy on the command line. + --bucket=BUCKET The Google Cloud Storage bucket to use by default to stage job dependencies, miscellaneous config files, and job driver console output @@ -470,14 +471,16 @@ FLAGS line. --kerberos-kms-key-location=KERBEROS_KMS_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▫ provide the argument --kerberos-kms-key on the command line with a fully specified name; ▫ provide the argument --kerberos-kms-key-location on the command line. --kerberos-kms-key-project=KERBEROS_KMS_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▫ provide the argument --kerberos-kms-key on the command line with a fully specified name; ▫ provide the argument --kerberos-kms-key-project on the command diff --git a/gcloud/beta/datastream/connection-profiles/create b/gcloud/beta/datastream/connection-profiles/create index eb2964dd9..40f542133 100644 --- a/gcloud/beta/datastream/connection-profiles/create +++ b/gcloud/beta/datastream/connection-profiles/create @@ -21,7 +21,7 @@ SYNOPSIS --postgresql-username=POSTGRESQL_USERNAME (--postgresql-password=POSTGRESQL_PASSWORD | --postgresql-prompt-for-password)] - [--private-connection-name=PRIVATE_CONNECTION_NAME : --no-connectivity + [--no-connectivity | --private-connection-name=PRIVATE_CONNECTION_NAME | --static-ip-connectivity | [--forward-ssh-hostname=FORWARD_SSH_HOSTNAME --forward-ssh-username=FORWARD_SSH_USERNAME @@ -237,6 +237,9 @@ OPTIONAL FLAGS At most one of these can be specified: + --no-connectivity + no connectivity + Private connection resource - Resource ID of the private connection. 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 @@ -255,9 +258,6 @@ OPTIONAL FLAGS ▫ provide the argument --private-connection-name on the command line. - --no-connectivity - no connectivity - --static-ip-connectivity use static ip connectivity diff --git a/gcloud/beta/datastream/connection-profiles/discover b/gcloud/beta/datastream/connection-profiles/discover index fdfc5a7fa..0d8a9f537 100644 --- a/gcloud/beta/datastream/connection-profiles/discover +++ b/gcloud/beta/datastream/connection-profiles/discover @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud beta datastream connection-profiles discover --location=LOCATION (--connection-profile-name=CONNECTION_PROFILE_NAME - : --connection-profile-object-file=CONNECTION_PROFILE_OBJECT_FILE) + | --connection-profile-object-file=CONNECTION_PROFILE_OBJECT_FILE) [--mysql-rdbms-file=MYSQL_RDBMS_FILE | --oracle-rdbms-file=ORACLE_RDBMS_FILE | --postgresql-rdbms-file=POSTGRESQL_RDBMS_FILE] diff --git a/gcloud/beta/datastream/connection-profiles/update b/gcloud/beta/datastream/connection-profiles/update index 2f3f38db6..7fbb9ae7b 100644 --- a/gcloud/beta/datastream/connection-profiles/update +++ b/gcloud/beta/datastream/connection-profiles/update @@ -23,7 +23,7 @@ SYNOPSIS --postgresql-password=POSTGRESQL_PASSWORD | --postgresql-prompt-for-password] [--clear-labels | --remove-labels=[KEY,...]] - [--private-connection-name=PRIVATE_CONNECTION_NAME : --no-connectivity + [--no-connectivity | --private-connection-name=PRIVATE_CONNECTION_NAME | --static-ip-connectivity | --forward-ssh-hostname=FORWARD_SSH_HOSTNAME --forward-ssh-port=FORWARD_SSH_PORT; default=22 @@ -215,6 +215,9 @@ OPTIONAL FLAGS At most one of these can be specified: + --no-connectivity + no connectivity + Private connection resource - Resource ID of the private connection. 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 @@ -233,9 +236,6 @@ OPTIONAL FLAGS ▫ provide the argument --private-connection-name on the command line. - --no-connectivity - no connectivity - --static-ip-connectivity use static ip connectivity diff --git a/gcloud/beta/datastream/streams/create b/gcloud/beta/datastream/streams/create index 9b855c7ca..4d9a27e3e 100644 --- a/gcloud/beta/datastream/streams/create +++ b/gcloud/beta/datastream/streams/create @@ -123,14 +123,14 @@ REQUIRED FLAGS The JSON file is formatted as follows: { - "source_hierarchy_datasets": { - "dataset_template": { + "sourceHierarchyDatasets": { + "datasetTemplate": { "location": "us-central1", - "dataset_id_prefix": "my_prefix", - "kms_key_name": "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{cryptoKey}" + "datasetIdPrefix": "my_prefix", + "kmsKeyName": "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{cryptoKey}" } }, - "data_freshness": 3600 + "dataFreshness": 3600 } --gcs-destination-config=GCS_DESTINATION_CONFIG @@ -141,9 +141,9 @@ REQUIRED FLAGS { "path": "some/path", - "file_rotation_mb":5, - "file_rotation_interval":"15s", - "avro_file_format": {} + "fileRotationMb":5, + "fileRotationInterval":"15s", + "avroFileFormat": {} } This must be specified. @@ -229,19 +229,18 @@ REQUIRED FLAGS Path to a YAML (or JSON) file containing the configuration for PostgreSQL Source Config. - The JSON file is formatted as follows, with snake_case field - naming: + The JSON file is formatted as follows, with camelCase field naming: { - "include_objects": {}, - "exclude_objects": { - "postgresql_schemas": [ + "includeObjects": {}, + "excludeObjects": { + "postgresqlSchemas": [ { "schema": "SAMPLE", - "postgresql_tables": [ + "postgresqlTables": [ { "table": "SAMPLE_TABLE", - "postgresql_columns": [ + "postgresqlColumns": [ { "column": "COL", } @@ -251,7 +250,7 @@ REQUIRED FLAGS } ] }, - "replication_slot": "SAMPLE_REPLICATION_SLOT", + "replicationSlot": "SAMPLE_REPLICATION_SLOT", "publication": "SAMPLE_PUBLICATION" } diff --git a/gcloud/beta/datastream/streams/update b/gcloud/beta/datastream/streams/update index 636399752..c6bcba334 100644 --- a/gcloud/beta/datastream/streams/update +++ b/gcloud/beta/datastream/streams/update @@ -11,10 +11,10 @@ SYNOPSIS | --postgresql-excluded-objects=POSTGRESQL_EXCLUDED_OBJECTS] [--clear-labels | --remove-labels=[KEY,...]] [--destination-name=DESTINATION_NAME - : --bigquery-destination-config=BIGQUERY_DESTINATION_CONFIG + --bigquery-destination-config=BIGQUERY_DESTINATION_CONFIG | --gcs-destination-config=GCS_DESTINATION_CONFIG] [--force | --validate-only] - [--source-name=SOURCE_NAME : --mysql-source-config=MYSQL_SOURCE_CONFIG + [--source-name=SOURCE_NAME --mysql-source-config=MYSQL_SOURCE_CONFIG | --oracle-source-config=ORACLE_SOURCE_CONFIG | --postgresql-source-config=POSTGRESQL_SOURCE_CONFIG] [GCLOUD_WIDE_FLAG ...] @@ -160,14 +160,14 @@ FLAGS The JSON file is formatted as follows: { - "source_hierarchy_datasets": { - "dataset_template": { + "sourceHierarchyDatasets": { + "datasetTemplate": { "location": "us-central1", - "dataset_id_prefix": "my_prefix", - "kms_key_name": "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{cryptoKey}" + "datasetIdPrefix": "my_prefix", + "kmsKeyName": "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{cryptoKey}" } }, - "data_freshness": 3600 + "dataFreshness": 3600 } --gcs-destination-config=GCS_DESTINATION_CONFIG @@ -178,9 +178,9 @@ FLAGS { "path": "some/path", - "file_rotation_mb":5, - "file_rotation_interval":"15s", - "avro_file_format": {} + "fileRotationMb":5, + "fileRotationInterval":"15s", + "avroFileFormat": {} } At most one of these can be specified: @@ -269,18 +269,18 @@ FLAGS Path to a YAML (or JSON) file containing the configuration for PostgreSQL Source Config. - The JSON file is formatted as follows, with snake_case field naming: + The JSON file is formatted as follows, with camelCase field naming: { - "include_objects": {}, - "exclude_objects": { - "postgresql_schemas": [ + "includeObjects": {}, + "excludeObjects": { + "postgresqlSchemas": [ { "schema": "SAMPLE", - "postgresql_tables": [ + "postgresqlTables": [ { "table": "SAMPLE_TABLE", - "postgresql_columns": [ + "postgresqlColumns": [ { "column": "COL", } diff --git a/gcloud/beta/debug/help b/gcloud/beta/debug/help index b0f8f3d5e..f9f92b5e8 100644 --- a/gcloud/beta/debug/help +++ b/gcloud/beta/debug/help @@ -5,7 +5,13 @@ SYNOPSIS gcloud beta debug GROUP [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) The gcloud beta debug command group provides interaction with Cloud + (BETA) (DEPRECATED) Commands for interacting with the Cloud Debugger. + + Cloud Debugger is deprecated and will be shutdown May 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + + The gcloud beta debug command group provides interaction with Cloud Debugger, allowing you to list and manipulate debugging targets, snapshots and logpoints. @@ -54,16 +60,20 @@ GROUPS GROUP is one of the following: logpoints - (BETA) Commands for interacting with Cloud Debugger logpoints. + (BETA) (DEPRECATED) Commands for interacting with Cloud Debugger + logpoints. snapshots - (BETA) Commands for interacting with Cloud Debugger snapshots. + (BETA) (DEPRECATED) Commands for interacting with Cloud Debugger + snapshots. source - (BETA) Commands to manage source information for Cloud Debugger. + (BETA) (DEPRECATED) Commands to manage source information for Cloud + Debugger. targets - (BETA) Commands for interacting with Cloud Debugger debug targets. + (BETA) (DEPRECATED) Commands for interacting with Cloud Debugger debug + targets. NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/debug/logpoints/create b/gcloud/beta/debug/logpoints/create index b4396f129..f0ec9ceef 100644 --- a/gcloud/beta/debug/logpoints/create +++ b/gcloud/beta/debug/logpoints/create @@ -9,8 +9,13 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta debug logpoints create is used to add a debug logpoint - to a debug target (debuggee). Logpoints add logging to your running service + (BETA) (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May + 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + + gcloud beta debug logpoints create is used to add a debug logpoint to a + debug target (debuggee). Logpoints add logging to your running service without changing your code or restarting your application. When you create a logpoint, the message you specify will be added to your logs whenever any instance of your service executes the specified line of code. diff --git a/gcloud/beta/debug/logpoints/delete b/gcloud/beta/debug/logpoints/delete index 07465fbd9..366c59bfe 100644 --- a/gcloud/beta/debug/logpoints/delete +++ b/gcloud/beta/debug/logpoints/delete @@ -8,10 +8,15 @@ SYNOPSIS [--target=(ID|DESCRIPTION_REGEXP)] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta debug logpoints delete is used to delete logpoints from - a Cloud Debugger debug target (debuggee). It will ask for confirmation - before deleting any logpoints. To suppress confirmation, use the global - --quiet option. + (BETA) (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May + 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + + gcloud beta debug logpoints delete is used to delete logpoints from a Cloud + Debugger debug target (debuggee). It will ask for confirmation before + deleting any logpoints. To suppress confirmation, use the global --quiet + option. EXAMPLES To delete all active debug logpoints created by the current user of the diff --git a/gcloud/beta/debug/logpoints/help b/gcloud/beta/debug/logpoints/help index b4b19b13c..435623096 100644 --- a/gcloud/beta/debug/logpoints/help +++ b/gcloud/beta/debug/logpoints/help @@ -7,7 +7,13 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Logpoints allow you to inject logging into running services without + (BETA) (DEPRECATED) Commands for interacting with Cloud Debugger logpoints. + + Cloud Debugger is deprecated and will be shutdown May 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + + Logpoints allow you to inject logging into running services without restarting or interfering with the normal function of the service. Log output will be sent to the appropriate log for the target's environment. On App Engine, for example, output will go to the request log. @@ -71,15 +77,16 @@ COMMANDS COMMAND is one of the following: create - (BETA) Add debug logpoints to a Cloud Debugger debug target (debuggee). + (BETA) (DEPRECATED) Add debug logpoints to a Cloud Debugger debug + target (debuggee). delete - (BETA) Delete debug logpoints for a Cloud Debugger debug target - (debuggee). + (BETA) (DEPRECATED) Delete debug logpoints for a Cloud Debugger debug + target (debuggee). list - (BETA) List the debug logpoints for a Cloud Debugger debug target - (debuggee). + (BETA) (DEPRECATED) List the debug logpoints for a Cloud Debugger debug + target (debuggee). NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/debug/logpoints/list b/gcloud/beta/debug/logpoints/list index 8065b44f3..7203d9ac2 100644 --- a/gcloud/beta/debug/logpoints/list +++ b/gcloud/beta/debug/logpoints/list @@ -10,10 +10,15 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta debug logpoints list is used to display the debug - logpoints for a Cloud Debugger debug target (debuggee). By default all - active logpoints are returned. To obtain older, expired logoints, specify - the --include-inactive option. + (BETA) (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May + 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + + gcloud beta debug logpoints list is used to display the debug logpoints for + a Cloud Debugger debug target (debuggee). By default all active logpoints + are returned. To obtain older, expired logoints, specify the + --include-inactive option. EXAMPLES To list the active and recently completed debug logpoints of the debug diff --git a/gcloud/beta/debug/snapshots/create b/gcloud/beta/debug/snapshots/create index a0a0308cd..eb7172660 100644 --- a/gcloud/beta/debug/snapshots/create +++ b/gcloud/beta/debug/snapshots/create @@ -8,10 +8,15 @@ SYNOPSIS [--wait=WAIT; default=10] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta debug snapshots create is used to create a debug - snapshot on a Cloud Debugger debug target. Snapshots allow you to capture - stack traces and local variables from your running service without - interfering with normal operations. + (BETA) (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May + 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + + gcloud beta debug snapshots create is used to create a debug snapshot on a + Cloud Debugger debug target. Snapshots allow you to capture stack traces + and local variables from your running service without interfering with + normal operations. When any instance of the target executes the snapshot location, the optional condition expression is evaluated. If the result is true (or if diff --git a/gcloud/beta/debug/snapshots/delete b/gcloud/beta/debug/snapshots/delete index 144928f85..aaad77def 100644 --- a/gcloud/beta/debug/snapshots/delete +++ b/gcloud/beta/debug/snapshots/delete @@ -8,10 +8,15 @@ SYNOPSIS [--target=(ID|DESCRIPTION_REGEXP)] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta debug snapshots delete is used to delete snapshots from - a Cloud Debugger debug target (debuggee). It will ask for confirmation - before deleting any snapshots. To suppress confirmation, use the global - --quiet option. + (BETA) (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May + 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + + gcloud beta debug snapshots delete is used to delete snapshots from a Cloud + Debugger debug target (debuggee). It will ask for confirmation before + deleting any snapshots. To suppress confirmation, use the global --quiet + option. EXAMPLES To delete all active snapshots created by the current user of the debug diff --git a/gcloud/beta/debug/snapshots/describe b/gcloud/beta/debug/snapshots/describe index a0c38c3c6..8b1496f53 100644 --- a/gcloud/beta/debug/snapshots/describe +++ b/gcloud/beta/debug/snapshots/describe @@ -7,7 +7,12 @@ SYNOPSIS [--target=(ID|DESCRIPTION_REGEXP)] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta debug snapshots describe is used to describe the debug + (BETA) (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May + 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + + gcloud beta debug snapshots describe is used to describe the debug snapshots for a Cloud Debugger debug target (debuggee). If the snapshot has completed, the output will include details on the stack trace and local variables, stored in a compact form which is primarily intended to be diff --git a/gcloud/beta/debug/snapshots/help b/gcloud/beta/debug/snapshots/help index e6a95d6c1..6fd897988 100644 --- a/gcloud/beta/debug/snapshots/help +++ b/gcloud/beta/debug/snapshots/help @@ -7,9 +7,15 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Commands to interact with debug snapshots. Snapshots allow you to - capture stack traces and local variables from running services without - interfering with the normal function of the service. + (BETA) (DEPRECATED) Commands for interacting with Cloud Debugger snapshots. + + Cloud Debugger is deprecated and will be shutdown May 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + + Commands to interact with debug snapshots. Snapshots allow you to capture + stack traces and local variables from running services without interfering + with the normal function of the service. FLAGS --target=(ID|DESCRIPTION_REGEXP) @@ -28,24 +34,24 @@ COMMANDS COMMAND is one of the following: create - (BETA) Create debug snapshots for a Cloud Debugger debug target - (debuggee). + (BETA) (DEPRECATED) Create debug snapshots for a Cloud Debugger debug + target (debuggee). delete - (BETA) Delete debug snapshots for a Cloud Debugger debug target - (debuggee). + (BETA) (DEPRECATED) Delete debug snapshots for a Cloud Debugger debug + target (debuggee). describe - (BETA) Describe the debug snapshots for a Cloud Debugger debug target - (debuggee). + (BETA) (DEPRECATED) Describe the debug snapshots for a Cloud Debugger + debug target (debuggee). list - (BETA) List the debug snapshots for a Cloud Debugger debug target - (debuggee). + (BETA) (DEPRECATED) List the debug snapshots for a Cloud Debugger debug + target (debuggee). wait - (BETA) Wait for debug snapshots on a Cloud Debugger debug target - (debuggee) to complete. + (BETA) (DEPRECATED) Wait for debug snapshots on a Cloud Debugger debug + target (debuggee) to complete. NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/debug/snapshots/list b/gcloud/beta/debug/snapshots/list index 074e60bed..ef86c94de 100644 --- a/gcloud/beta/debug/snapshots/list +++ b/gcloud/beta/debug/snapshots/list @@ -10,10 +10,15 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta debug snapshots list is used to display the debug - snapshots for a Cloud Debugger debug target (debuggee). By default all - active snapshots as well as any recently completed snapshots are returned. - To obtain older completed snapshots specify the --include-inactive option. + (BETA) (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May + 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + + gcloud beta debug snapshots list is used to display the debug snapshots for + a Cloud Debugger debug target (debuggee). By default all active snapshots + as well as any recently completed snapshots are returned. To obtain older + completed snapshots specify the --include-inactive option. EXAMPLES To list the active and recently completed debug snapshots of the debug diff --git a/gcloud/beta/debug/snapshots/wait b/gcloud/beta/debug/snapshots/wait index f27ff9aa5..d2edf8200 100644 --- a/gcloud/beta/debug/snapshots/wait +++ b/gcloud/beta/debug/snapshots/wait @@ -9,10 +9,15 @@ SYNOPSIS [--limit=LIMIT] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta debug snapshots wait is used to wait for one or more - snapshots on a Cloud Debugger debug target to complete. A snapshot is - considered completed either if there was an error setting the snapshot or - if the snapshot was hit on an instance of the debug target. + (BETA) (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May + 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + + gcloud beta debug snapshots wait is used to wait for one or more snapshots + on a Cloud Debugger debug target to complete. A snapshot is considered + completed either if there was an error setting the snapshot or if the + snapshot was hit on an instance of the debug target. EXAMPLES To wait for either of the snapshots with IDs of 'ID1' or 'ID2' of the debug diff --git a/gcloud/beta/debug/source/gen-repo-info-file b/gcloud/beta/debug/source/gen-repo-info-file index f68adced0..595f59135 100644 --- a/gcloud/beta/debug/source/gen-repo-info-file +++ b/gcloud/beta/debug/source/gen-repo-info-file @@ -9,7 +9,12 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) This command generates a file named source-context.json containing + (BETA) (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May + 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + + This command generates a file named source-context.json containing information on the source revision and remote repository associated with the given source directory. diff --git a/gcloud/beta/debug/source/help b/gcloud/beta/debug/source/help index 820a9db9d..769d3dc3b 100644 --- a/gcloud/beta/debug/source/help +++ b/gcloud/beta/debug/source/help @@ -6,8 +6,15 @@ SYNOPSIS gcloud beta debug source COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) This set of commands allows you to provide Cloud Debugger with - source code version information. + (BETA) (DEPRECATED) Commands to manage source information for Cloud + Debugger. + + Cloud Debugger is deprecated and will be shutdown May 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + + This set of commands allows you to provide Cloud Debugger with source code + version information. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,7 +25,8 @@ COMMANDS COMMAND is one of the following: gen-repo-info-file - (BETA) Generates repository information files for the Cloud Debugger. + (BETA) (DEPRECATED) Generates repository information files for the + Cloud Debugger. NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/debug/targets/help b/gcloud/beta/debug/targets/help index 4af2932e5..70e31f6a6 100644 --- a/gcloud/beta/debug/targets/help +++ b/gcloud/beta/debug/targets/help @@ -6,9 +6,16 @@ SYNOPSIS gcloud beta debug targets COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Commands to interact with debug targets. A debug target can be an - App Engine module version or any other entity enabled for use with the - cloud debugger. + (BETA) (DEPRECATED) Commands for interacting with Cloud Debugger debug + targets. + + Cloud Debugger is deprecated and will be shutdown May 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + + Commands to interact with debug targets. A debug target can be an App + Engine module version or any other entity enabled for use with the cloud + debugger. EXAMPLES To view all available debug targets, run: @@ -24,8 +31,8 @@ COMMANDS COMMAND is one of the following: list - (BETA) List the debug targets (debuggees) registered with the Cloud - Debugger. + (BETA) (DEPRECATED) List the debug targets (debuggees) registered with + the Cloud Debugger. NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/debug/targets/list b/gcloud/beta/debug/targets/list index 94117e2a8..a4bae8842 100644 --- a/gcloud/beta/debug/targets/list +++ b/gcloud/beta/debug/targets/list @@ -8,10 +8,15 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta debug targets list is used to display a list of the - debug targets (debuggees) registered with the Cloud Debugger. By default - only the active targets are shown, the --include-inactive can be provided - to also include the targets that are no longer active. + (BETA) (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May + 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + + gcloud beta debug targets list is used to display a list of the debug + targets (debuggees) registered with the Cloud Debugger. By default only the + active targets are shown, the --include-inactive can be provided to also + include the targets that are no longer active. EXAMPLES To list the active debug targets (debuggees) registered with the Cloud diff --git a/gcloud/beta/dns/record-sets/create b/gcloud/beta/dns/record-sets/create index 42547ec78..47301763a 100644 --- a/gcloud/beta/dns/record-sets/create +++ b/gcloud/beta/dns/record-sets/create @@ -127,16 +127,18 @@ REQUIRED FLAGS For --routing-policy-type = "GEO" this flag indicates the geo-locations policy data. The field accepts a semicolon-delimited list of the format - "${region}=${rrdata},${rrdata}". Each individual rrdata can - either be an ip address or a string of the format - forwarding_config_name@region. + "${region}=${rrdata},${rrdata}". Each rrdata can either be an IP + address or a reference to a forwarding rule of the format + FORWARDING_RULE_NAME", "FORWARDING_RULE_NAME@region", or the full + resource path of the forwarding rule. Configuration for primary backup routing policy --routing-policy-backup-data=ROUTING_POLICY_BACKUP_DATA - The backup config for a primary backup routing policy. This is - the same format as the routing-policy-data arg as this is just - another geo policy. + The backup configuration for a primary backup routing policy. + This configuration has the same format as the + routing-policy-data argument because it is just another + geo-locations policy. This flag argument must be specified if any of the other arguments in this group are specified. @@ -151,9 +153,10 @@ REQUIRED FLAGS arguments in this group are specified. --routing-policy-primary-data=ROUTING_POLICY_PRIMARY_DATA - The primary config for a primary backup routing policy. This is - just a list of forwarding configs of the format "config_name" - or "config_name@scope" + The primary configuration for a primary backup routing policy. + This configuration is a list of forwarding rules of the format + "FORWARDING_RULE_NAME", "FORWARDING_RULE_NAME@scope", or the + full resource path of the forwarding rule. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/beta/dns/record-sets/update b/gcloud/beta/dns/record-sets/update index 473e363ac..e6ce16102 100644 --- a/gcloud/beta/dns/record-sets/update +++ b/gcloud/beta/dns/record-sets/update @@ -94,16 +94,18 @@ REQUIRED FLAGS For --routing-policy-type = "GEO" this flag indicates the geo-locations policy data. The field accepts a semicolon-delimited list of the format - "${region}=${rrdata},${rrdata}". Each individual rrdata can - either be an ip address or a string of the format - forwarding_config_name@region. + "${region}=${rrdata},${rrdata}". Each rrdata can either be an IP + address or a reference to a forwarding rule of the format + FORWARDING_RULE_NAME", "FORWARDING_RULE_NAME@region", or the full + resource path of the forwarding rule. Configuration for primary backup routing policy --routing-policy-backup-data=ROUTING_POLICY_BACKUP_DATA - The backup config for a primary backup routing policy. This is - the same format as the routing-policy-data arg as this is just - another geo policy. + The backup configuration for a primary backup routing policy. + This configuration has the same format as the + routing-policy-data argument because it is just another + geo-locations policy. This flag argument must be specified if any of the other arguments in this group are specified. @@ -118,9 +120,10 @@ REQUIRED FLAGS arguments in this group are specified. --routing-policy-primary-data=ROUTING_POLICY_PRIMARY_DATA - The primary config for a primary backup routing policy. This is - just a list of forwarding configs of the format "config_name" - or "config_name@scope" + The primary configuration for a primary backup routing policy. + This configuration is a list of forwarding rules of the format + "FORWARDING_RULE_NAME", "FORWARDING_RULE_NAME@scope", or the + full resource path of the forwarding rule. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/beta/eventarc/triggers/create b/gcloud/beta/eventarc/triggers/create index c1fc2d013..d28feb2af 100644 --- a/gcloud/beta/eventarc/triggers/create +++ b/gcloud/beta/eventarc/triggers/create @@ -6,9 +6,9 @@ SYNOPSIS --matching-criteria=[ATTRIBUTE=VALUE,...] ([--destination-run-service=DESTINATION_RUN_SERVICE : --destination-run-path=DESTINATION_RUN_PATH - --destination-run-region=DESTINATION_RUN_REGION]) - --transport-topic=TRANSPORT_TOPIC [--async] - [--service-account=SERVICE_ACCOUNT] [GCLOUD_WIDE_FLAG ...] + --destination-run-region=DESTINATION_RUN_REGION]) [--async] + [--service-account=SERVICE_ACCOUNT] [--transport-topic=TRANSPORT_TOPIC] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create an Eventarc trigger. @@ -85,6 +85,13 @@ REQUIRED FLAGS as the trigger. OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --service-account=SERVICE_ACCOUNT + The IAM service account email associated with the trigger. + Pub/Sub topic resource - The Cloud Pub/Sub topic to use for the trigger's transport intermediary. This feature is currently only available for triggers of event type google.cloud.pubsub.topic.v1.messagePublished. The @@ -102,13 +109,6 @@ OPTIONAL FLAGS topic. To set the transport-topic attribute: ▸ provide the argument --transport-topic on the command line. - --async - Return immediately, without waiting for the operation in progress to - complete. - - --service-account=SERVICE_ACCOUNT - The IAM service account email associated with the trigger. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/filestore/instances/create b/gcloud/beta/filestore/instances/create index b2c0d24d8..ff6fa1642 100644 --- a/gcloud/beta/filestore/instances/create +++ b/gcloud/beta/filestore/instances/create @@ -251,13 +251,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/beta/firestore/indexes/composite/create b/gcloud/beta/firestore/indexes/composite/create index 6b630affc..213825162 100644 --- a/gcloud/beta/firestore/indexes/composite/create +++ b/gcloud/beta/firestore/indexes/composite/create @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud beta firestore indexes composite create --field-config=FIELD_CONFIG - (--collection-group=COLLECTION_GROUP : --database=DATABASE) [--async] + (--collection-group=COLLECTION_GROUP : --database=DATABASE) + [--api-scope=API_SCOPE; default="any-api"] [--async] + [--query-scope=QUERY_SCOPE; default="collection"] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -81,10 +83,18 @@ REQUIRED FLAGS ▸ the default value of argument [--database] is (default). OPTIONAL FLAGS + --api-scope=API_SCOPE; default="any-api" + Api scope the index applies to. API_SCOPE must be one of: any-api, + datastore-mode-api. + --async Return immediately, without waiting for the operation in progress to complete. + --query-scope=QUERY_SCOPE; default="collection" + Query scope the index applies to. QUERY_SCOPE must be one of: + collection, collection-group, collection-recursive. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/kms/ekm-connections/create b/gcloud/beta/kms/ekm-connections/create index 37f174d4e..c4d0f9c81 100644 --- a/gcloud/beta/kms/ekm-connections/create +++ b/gcloud/beta/kms/ekm-connections/create @@ -40,7 +40,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --location=LOCATION - The Cloud location for the ekmconnection. To set the location + The Google Cloud location for the ekmconnection. To set the location attribute: ▸ provide the argument ekm_connection on the command line with a fully specified name; diff --git a/gcloud/beta/kms/ekm-connections/describe b/gcloud/beta/kms/ekm-connections/describe index 0d0831993..9174e6e6f 100644 --- a/gcloud/beta/kms/ekm-connections/describe +++ b/gcloud/beta/kms/ekm-connections/describe @@ -36,7 +36,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --location=LOCATION - The Cloud location for the ekmconnection. To set the location + The Google Cloud location for the ekmconnection. To set the location attribute: ▸ provide the argument ekm_connection on the command line with a fully specified name; diff --git a/gcloud/beta/kms/ekm-connections/update b/gcloud/beta/kms/ekm-connections/update index 796c21b3a..918929953 100644 --- a/gcloud/beta/kms/ekm-connections/update +++ b/gcloud/beta/kms/ekm-connections/update @@ -50,7 +50,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --location=LOCATION - The Cloud location for the ekmconnection. To set the location + The Google Cloud location for the ekmconnection. To set the location attribute: ▸ provide the argument ekm_connection on the command line with a fully specified name; diff --git a/gcloud/beta/kms/keyrings/create b/gcloud/beta/kms/keyrings/create index 201f7ff68..95c06ad5c 100644 --- a/gcloud/beta/kms/keyrings/create +++ b/gcloud/beta/kms/keyrings/create @@ -28,7 +28,8 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --location=LOCATION - The Cloud location for the keyring. To set the location attribute: + The Google Cloud location for the keyring. To set the location + attribute: ▸ provide the argument keyring on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/beta/kms/keyrings/describe b/gcloud/beta/kms/keyrings/describe index 518b36ff3..825b7343f 100644 --- a/gcloud/beta/kms/keyrings/describe +++ b/gcloud/beta/kms/keyrings/describe @@ -34,7 +34,8 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --location=LOCATION - The Cloud location for the keyring. To set the location attribute: + The Google Cloud location for the keyring. To set the location + attribute: ▸ provide the argument keyring on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/beta/kms/keys/create b/gcloud/beta/kms/keys/create index 38c31bf04..723159b28 100644 --- a/gcloud/beta/kms/keys/create +++ b/gcloud/beta/kms/keys/create @@ -139,7 +139,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --keyring on the command line. --location=LOCATION - The Cloud location for the key. To set the location attribute: + The Google Cloud location for the key. To set the location attribute: ▸ provide the argument key on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/beta/kms/keys/describe b/gcloud/beta/kms/keys/describe index f8e54b123..76a962898 100644 --- a/gcloud/beta/kms/keys/describe +++ b/gcloud/beta/kms/keys/describe @@ -41,7 +41,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --keyring on the command line. --location=LOCATION - The Cloud location for the key. To set the location attribute: + The Google Cloud location for the key. To set the location attribute: ▸ provide the argument key on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/beta/kms/keys/get-iam-policy b/gcloud/beta/kms/keys/get-iam-policy index 9b78a83cd..7aa5e6586 100644 --- a/gcloud/beta/kms/keys/get-iam-policy +++ b/gcloud/beta/kms/keys/get-iam-policy @@ -2,9 +2,10 @@ NAME gcloud beta kms keys get-iam-policy - get the IAM policy for a key SYNOPSIS - gcloud beta kms keys get-iam-policy KEY [--keyring=KEYRING] - [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + gcloud beta kms keys get-iam-policy + (KEY : --keyring=KEYRING --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Gets the IAM policy for the given key. @@ -19,15 +20,35 @@ EXAMPLES --location=global POSITIONAL ARGUMENTS - KEY - Name of the key whose IAM policy to fetch. + Key resource - The KMS key resource. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument key on the command line with a fully specified + name; + ◆ set the property core/project. -FLAGS - --keyring=KEYRING - Key ring of the key. + This must be specified. - --location=LOCATION - Location of the key. + KEY + ID of the key or fully qualified identifier for the key. To set the + key attribute: + ▸ provide the argument key on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --keyring=KEYRING + The KMS keyring of the key. To set the keyring attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --keyring on the command line. + + --location=LOCATION + The Google Cloud location for the key. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/kms/keys/list b/gcloud/beta/kms/keys/list index 3164d6ce9..fb6ccd171 100644 --- a/gcloud/beta/kms/keys/list +++ b/gcloud/beta/kms/keys/list @@ -35,7 +35,8 @@ REQUIRED FLAGS this group are specified. --location=LOCATION - The Cloud location for the keyring. To set the location attribute: + The Google Cloud location for the keyring. To set the location + attribute: ▸ provide the argument --keyring on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/beta/kms/keys/remove-rotation-schedule b/gcloud/beta/kms/keys/remove-rotation-schedule index 32e62cb0d..683865c58 100644 --- a/gcloud/beta/kms/keys/remove-rotation-schedule +++ b/gcloud/beta/kms/keys/remove-rotation-schedule @@ -3,8 +3,8 @@ NAME schedule for a key SYNOPSIS - gcloud beta kms keys remove-rotation-schedule KEY [--keyring=KEYRING] - [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + gcloud beta kms keys remove-rotation-schedule + (KEY : --keyring=KEYRING --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Removes the rotation schedule for the given key. @@ -17,15 +17,35 @@ EXAMPLES --location=global --keyring=fellowship POSITIONAL ARGUMENTS - KEY - Name of the key from which to clear the rotation schedule. + Key resource - The KMS key resource. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument key on the command line with a fully specified + name; + ◆ set the property core/project. -FLAGS - --keyring=KEYRING - Key ring of the key. + This must be specified. - --location=LOCATION - Location of the key. + KEY + ID of the key or fully qualified identifier for the key. To set the + key attribute: + ▸ provide the argument key on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --keyring=KEYRING + The KMS keyring of the key. To set the keyring attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --keyring on the command line. + + --location=LOCATION + The Google Cloud location for the key. To set the location attribute: + ▸ provide the argument key 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, diff --git a/gcloud/beta/kms/keys/set-iam-policy b/gcloud/beta/kms/keys/set-iam-policy index 08c9b922f..472efcd6a 100644 --- a/gcloud/beta/kms/keys/set-iam-policy +++ b/gcloud/beta/kms/keys/set-iam-policy @@ -2,8 +2,9 @@ NAME gcloud beta kms keys set-iam-policy - set the IAM policy for a key SYNOPSIS - gcloud beta kms keys set-iam-policy KEY POLICY_FILE [--keyring=KEYRING] - [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + gcloud beta kms keys set-iam-policy + (KEY : --keyring=KEYRING --location=LOCATION) POLICY_FILE + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Sets the IAM policy for the given key as defined in a JSON or YAML @@ -21,19 +22,39 @@ EXAMPLES --keyring=fellowship --location=global POSITIONAL ARGUMENTS - KEY - Name of the key whose IAM policy to update. + Key resource - The KMS key resource. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument key on the command line with a fully specified + name; + ◆ set the property core/project. + + This must be specified. + + KEY + ID of the key or fully qualified identifier for the key. To set the + key attribute: + ▸ provide the argument key on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --keyring=KEYRING + The KMS keyring of the key. To set the keyring attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --keyring on the command line. + + --location=LOCATION + The Google Cloud location for the key. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. POLICY_FILE JSON or YAML file with the IAM policy -FLAGS - --keyring=KEYRING - Key ring of the key. - - --location=LOCATION - Location of the key. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/kms/keys/set-primary-version b/gcloud/beta/kms/keys/set-primary-version index 95b0a4761..09a7a6f15 100644 --- a/gcloud/beta/kms/keys/set-primary-version +++ b/gcloud/beta/kms/keys/set-primary-version @@ -2,8 +2,9 @@ NAME gcloud beta kms keys set-primary-version - set the primary version of a key SYNOPSIS - gcloud beta kms keys set-primary-version KEY --version=VERSION - [--keyring=KEYRING] [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + gcloud beta kms keys set-primary-version + (KEY : --keyring=KEYRING --location=LOCATION) --version=VERSION + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Sets the specified version as the primary version of the given key. @@ -17,20 +18,40 @@ EXAMPLES --keyring=fellowship --location=global POSITIONAL ARGUMENTS - KEY - Name of the key to modify. + Key resource - The KMS key resource. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument key on the command line with a fully specified + name; + ◆ set the property core/project. + + This must be specified. + + KEY + ID of the key or fully qualified identifier for the key. To set the + key attribute: + ▸ provide the argument key on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --keyring=KEYRING + The KMS keyring of the key. To set the keyring attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --keyring on the command line. + + --location=LOCATION + The Google Cloud location for the key. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. REQUIRED FLAGS --version=VERSION Version to make primary. -OPTIONAL FLAGS - --keyring=KEYRING - Key ring of the key. - - --location=LOCATION - Location of the key. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/kms/keys/set-rotation-schedule b/gcloud/beta/kms/keys/set-rotation-schedule index 68dde46bb..484416c12 100644 --- a/gcloud/beta/kms/keys/set-rotation-schedule +++ b/gcloud/beta/kms/keys/set-rotation-schedule @@ -3,8 +3,9 @@ NAME for a key SYNOPSIS - gcloud beta kms keys set-rotation-schedule KEY [--keyring=KEYRING] - [--location=LOCATION] [--next-rotation-time=NEXT_ROTATION_TIME] + gcloud beta kms keys set-rotation-schedule + (KEY : --keyring=KEYRING --location=LOCATION) + [--next-rotation-time=NEXT_ROTATION_TIME] [--rotation-period=ROTATION_PERIOD] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -29,16 +30,37 @@ EXAMPLES --next-rotation-time=2017-10-12T12:34:56.1234Z POSITIONAL ARGUMENTS - KEY - Name of the key to update the schedule of. + Key resource - The KMS key resource. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument key on the command line with a fully specified + name; + ◆ set the property core/project. + + This must be specified. + + KEY + ID of the key or fully qualified identifier for the key. To set the + key attribute: + ▸ provide the argument key on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --keyring=KEYRING + The KMS keyring of the key. To set the keyring attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --keyring on the command line. + + --location=LOCATION + The Google Cloud location for the key. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. FLAGS - --keyring=KEYRING - Key ring of the key. - - --location=LOCATION - Location of the key. - --next-rotation-time=NEXT_ROTATION_TIME Next automatic rotation time of the key. See $ gcloud topic datetimes for information on time formats. diff --git a/gcloud/beta/kms/keys/update b/gcloud/beta/kms/keys/update index 90b78089b..035f4b329 100644 --- a/gcloud/beta/kms/keys/update +++ b/gcloud/beta/kms/keys/update @@ -100,7 +100,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --keyring on the command line. --location=LOCATION - The Cloud location for the key. To set the location attribute: + The Google Cloud location for the key. To set the location attribute: ▸ provide the argument key on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/beta/logging/settings/update b/gcloud/beta/logging/settings/update index eaca0c3aa..9a446e8fd 100644 --- a/gcloud/beta/logging/settings/update +++ b/gcloud/beta/logging/settings/update @@ -106,13 +106,15 @@ OPTIONAL FLAGS ▫ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▫ provide the argument --kms-key-name on the command line with a fully specified name; ▫ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▫ provide the argument --kms-key-name on the command line with a fully specified name; ▫ provide the argument --kms-project on the command line; diff --git a/gcloud/beta/ml-engine/jobs/submit/training b/gcloud/beta/ml-engine/jobs/submit/training index 465daf475..241db7f8a 100644 --- a/gcloud/beta/ml-engine/jobs/submit/training +++ b/gcloud/beta/ml-engine/jobs/submit/training @@ -369,13 +369,15 @@ FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/beta/notebooks/instances/create b/gcloud/beta/notebooks/instances/create index 2349f0232..ef189262d 100644 --- a/gcloud/beta/notebooks/instances/create +++ b/gcloud/beta/notebooks/instances/create @@ -24,7 +24,7 @@ SYNOPSIS [--disk-encryption=DISK_ENCRYPTION [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT]] - [--network=NETWORK : --no-proxy-access --no-public-ip [--subnet=SUBNET + [--network=NETWORK --no-proxy-access --no-public-ip [--subnet=SUBNET : --subnet-region=SUBNET_REGION]] [--reservation=RESERVATION --reservation-affinity=RESERVATION_AFFINITY; default="TYPE_UNSPECIFIED"] [GCLOUD_WIDE_FLAG ...] @@ -264,13 +264,15 @@ OPTIONAL FLAGS ▫ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▫ provide the argument --kms-key on the command line with a fully specified name; ▫ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▫ provide the argument --kms-key on the command line with a fully specified name; ▫ provide the argument --kms-project on the command line; diff --git a/gcloud/beta/privateca/certificates/create b/gcloud/beta/privateca/certificates/create index 5a024ff4f..a33445939 100644 --- a/gcloud/beta/privateca/certificates/create +++ b/gcloud/beta/privateca/certificates/create @@ -8,9 +8,9 @@ SYNOPSIS --ip-san=[IP_SAN,...] --subject=[SUBJECT,...] --uri-san=[URI_SAN,...]) (--generate-key --key-output-file=KEY_OUTPUT_FILE) - : [--reusable-config=REUSABLE_CONFIG - : --extended-key-usages=[EXTENDED_KEY_USAGES,...] --is-ca-cert - --key-usages=[KEY_USAGES,...] --max-chain-length=MAX_CHAIN_LENGTH]]) + : --reusable-config=REUSABLE_CONFIG + | --extended-key-usages=[EXTENDED_KEY_USAGES,...] --is-ca-cert + --key-usages=[KEY_USAGES,...] --max-chain-length=MAX_CHAIN_LENGTH]) [--cert-output-file=CERT_OUTPUT_FILE] [--labels=[KEY=VALUE,...]] [--validity=VALIDITY; default="P30D"] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/beta/privateca/certificates/revoke b/gcloud/beta/privateca/certificates/revoke index 1626d6f4a..fc98407d5 100644 --- a/gcloud/beta/privateca/certificates/revoke +++ b/gcloud/beta/privateca/certificates/revoke @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud beta privateca certificates revoke - (--certificate=CERTIFICATE : --serial-number=SERIAL_NUMBER) + (--certificate=CERTIFICATE | --serial-number=SERIAL_NUMBER) [--reason=REASON; default="unspecified"] [--issuer=ISSUER : --issuer-location=ISSUER_LOCATION] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/beta/privateca/roots/create b/gcloud/beta/privateca/roots/create index 202119897..40a03fa90 100644 --- a/gcloud/beta/privateca/roots/create +++ b/gcloud/beta/privateca/roots/create @@ -16,9 +16,9 @@ SYNOPSIS | [--kms-key-version=KMS_KEY_VERSION : --kms-key=KMS_KEY --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT]] - [[--reusable-config=REUSABLE_CONFIG - : --extended-key-usages=[EXTENDED_KEY_USAGES,...] - --key-usages=[KEY_USAGES,...] --max-chain-length=MAX_CHAIN_LENGTH]] + [--reusable-config=REUSABLE_CONFIG + | --extended-key-usages=[EXTENDED_KEY_USAGES,...] + --key-usages=[KEY_USAGES,...] --max-chain-length=MAX_CHAIN_LENGTH] [GCLOUD_WIDE_FLAG ...] EXAMPLES diff --git a/gcloud/beta/privateca/subordinates/create b/gcloud/beta/privateca/subordinates/create index 01e4c8cd1..96dcf844d 100644 --- a/gcloud/beta/privateca/subordinates/create +++ b/gcloud/beta/privateca/subordinates/create @@ -19,9 +19,9 @@ SYNOPSIS | [--kms-key-version=KMS_KEY_VERSION : --kms-key=KMS_KEY --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT]] - [[--reusable-config=REUSABLE_CONFIG - : --extended-key-usages=[EXTENDED_KEY_USAGES,...] - --key-usages=[KEY_USAGES,...] --max-chain-length=MAX_CHAIN_LENGTH]] + [--reusable-config=REUSABLE_CONFIG + | --extended-key-usages=[EXTENDED_KEY_USAGES,...] + --key-usages=[KEY_USAGES,...] --max-chain-length=MAX_CHAIN_LENGTH] [GCLOUD_WIDE_FLAG ...] EXAMPLES diff --git a/gcloud/beta/pubsub/topics/create b/gcloud/beta/pubsub/topics/create index 0a06dee18..caa2b47aa 100644 --- a/gcloud/beta/pubsub/topics/create +++ b/gcloud/beta/pubsub/topics/create @@ -129,14 +129,16 @@ FLAGS command line. --topic-encryption-key-location=TOPIC_ENCRYPTION_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --topic-encryption-key on the command line with a fully specified name; ▸ provide the argument --topic-encryption-key-location on the command line. --topic-encryption-key-project=TOPIC_ENCRYPTION_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --topic-encryption-key on the command line with a fully specified name; ▸ provide the argument --topic-encryption-key-project on the diff --git a/gcloud/beta/pubsub/topics/update b/gcloud/beta/pubsub/topics/update index 8852f4db5..4b705a510 100644 --- a/gcloud/beta/pubsub/topics/update +++ b/gcloud/beta/pubsub/topics/update @@ -211,14 +211,16 @@ FLAGS command line. --topic-encryption-key-location=TOPIC_ENCRYPTION_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --topic-encryption-key on the command line with a fully specified name; ▸ provide the argument --topic-encryption-key-location on the command line. --topic-encryption-key-project=TOPIC_ENCRYPTION_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --topic-encryption-key on the command line with a fully specified name; ▸ provide the argument --topic-encryption-key-project on the diff --git a/gcloud/beta/sql/instances/create b/gcloud/beta/sql/instances/create index 8e2387d2b..4a8fa2992 100644 --- a/gcloud/beta/sql/instances/create +++ b/gcloud/beta/sql/instances/create @@ -432,14 +432,16 @@ FLAGS line. --disk-encryption-key-location=DISK_ENCRYPTION_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --disk-encryption-key on the command line with a fully specified name; ▸ provide the argument --disk-encryption-key-location on the command line. --disk-encryption-key-project=DISK_ENCRYPTION_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --disk-encryption-key on the command line with a fully specified name; ▸ provide the argument --disk-encryption-key-project on the command diff --git a/gcloud/bigtable/backups/list b/gcloud/bigtable/backups/list index f9de468b8..42bfe49b4 100644 --- a/gcloud/bigtable/backups/list +++ b/gcloud/bigtable/backups/list @@ -2,7 +2,7 @@ NAME gcloud bigtable backups list - list existing Bigtable backups SYNOPSIS - gcloud bigtable backups list --cluster=CLUSTER --instance=INSTANCE + gcloud bigtable backups list [--cluster=CLUSTER] [--instance=INSTANCE] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/bigtable/clusters/list b/gcloud/bigtable/clusters/list index 01edc3dc3..2255b446f 100644 --- a/gcloud/bigtable/clusters/list +++ b/gcloud/bigtable/clusters/list @@ -2,7 +2,7 @@ NAME gcloud bigtable clusters list - list existing Bigtable clusters SYNOPSIS - gcloud bigtable clusters list --instances=[INSTANCES,...] + gcloud bigtable clusters list [--instances=[INSTANCES,...]] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/bigtable/operations/list b/gcloud/bigtable/operations/list index 4994f6078..0c7a6d984 100644 --- a/gcloud/bigtable/operations/list +++ b/gcloud/bigtable/operations/list @@ -2,7 +2,7 @@ NAME gcloud bigtable operations list - list Cloud Bigtable operations SYNOPSIS - gcloud bigtable operations list --instance=INSTANCE [--filter=EXPRESSION] + gcloud bigtable operations list [--instance=INSTANCE] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/bms/instances/list b/gcloud/bms/instances/list index 03d7af7a8..0953df5f2 100644 --- a/gcloud/bms/instances/list +++ b/gcloud/bms/instances/list @@ -2,7 +2,7 @@ NAME gcloud bms instances list - list Bare Metal Solution instances in a project SYNOPSIS - gcloud bms instances list --region=REGION [--filter=EXPRESSION] + gcloud bms instances list [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION diff --git a/gcloud/bms/networks/list b/gcloud/bms/networks/list index ab68eddd5..c8f84945f 100644 --- a/gcloud/bms/networks/list +++ b/gcloud/bms/networks/list @@ -2,7 +2,7 @@ NAME gcloud bms networks list - list Bare Metal Solution networks in a project SYNOPSIS - gcloud bms networks list --region=REGION [--filter=EXPRESSION] + gcloud bms networks list [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION diff --git a/gcloud/bms/networks/list-ip-reservations b/gcloud/bms/networks/list-ip-reservations index 9334b8f1c..8296b0976 100644 --- a/gcloud/bms/networks/list-ip-reservations +++ b/gcloud/bms/networks/list-ip-reservations @@ -3,7 +3,7 @@ NAME Bare Metal Solution networks in a project SYNOPSIS - gcloud bms networks list-ip-reservations --region=REGION + gcloud bms networks list-ip-reservations [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION diff --git a/gcloud/bms/nfs-shares/list b/gcloud/bms/nfs-shares/list index ecde9b660..7bb057f9f 100644 --- a/gcloud/bms/nfs-shares/list +++ b/gcloud/bms/nfs-shares/list @@ -3,7 +3,7 @@ NAME project SYNOPSIS - gcloud bms nfs-shares list --region=REGION [--filter=EXPRESSION] + gcloud bms nfs-shares list [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION diff --git a/gcloud/bms/volumes/list b/gcloud/bms/volumes/list index 03c96e211..52bfbba64 100644 --- a/gcloud/bms/volumes/list +++ b/gcloud/bms/volumes/list @@ -2,7 +2,7 @@ NAME gcloud bms volumes list - list Bare Metal Solution volumes in a project SYNOPSIS - gcloud bms volumes list --region=REGION [--filter=EXPRESSION] + gcloud bms volumes list [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION diff --git a/gcloud/builds/triggers/create/gitlab-enterprise b/gcloud/builds/triggers/create/gitlab-enterprise index cd4e9318e..96471b265 100644 --- a/gcloud/builds/triggers/create/gitlab-enterprise +++ b/gcloud/builds/triggers/create/gitlab-enterprise @@ -4,18 +4,16 @@ NAME SYNOPSIS gcloud builds triggers create gitlab-enterprise - (--trigger-config=PATH - | [--gitlab-config-resource=GITLAB_CONFIG_RESOURCE - --project-namespace=PROJECT_NAMESPACE (--branch-pattern=REGEX - | --tag-pattern=REGEX | [--pull-request-pattern=REGEX - : --comment-control=COMMENT_CONTROL; + (--trigger-config=PATH | [(--branch-pattern=REGEX | --tag-pattern=REGEX + | [--pull-request-pattern=REGEX : --comment-control=COMMENT_CONTROL; default=CommentControlValueValuesEnum(COMMENTS_ENABLED, 1)]) (--build-config=PATH | --inline-config=PATH | [--dockerfile=DOCKERFILE : --dockerfile-dir=DOCKERFILE_DIR; default="/" --dockerfile-image=DOCKERFILE_IMAGE]) - : --description=DESCRIPTION --ignored-files=[GLOB,...] - --included-files=[GLOB,...] --name=NAME --region=REGION - --require-approval + (--gitlab-config-resource=GITLAB_CONFIG_RESOURCE + --project-namespace=PROJECT_NAMESPACE) : --description=DESCRIPTION + --ignored-files=[GLOB,...] --included-files=[GLOB,...] --name=NAME + --region=REGION --require-approval --service-account=SERVICE_ACCOUNT --substitutions=[KEY=VALUE,...]]) [GCLOUD_WIDE_FLAG ...] @@ -23,7 +21,7 @@ DESCRIPTION Create a build trigger for a GitLab Enterprise repository. EXAMPLES - To create a push trigger for all branches: + To create a push trigger with a 1st-gen repository for all branches: $ gcloud builds triggers create gitlab-enterprise \ --name="my-trigger" \ @@ -33,7 +31,7 @@ EXAMPLES --gitlab-config-resource="projects/1234/locations/global/gitLabC\ onfigs/5678" --branch-pattern=".*" --build-config="cloudbuild.yaml" - To create a pull request trigger for main: + To create a pull request trigger with a 1st-gen repository for main: $ gcloud builds triggers create gitlab-enterprise \ --name="my-trigger" \ @@ -54,18 +52,6 @@ REQUIRED FLAGS Flag based trigger configuration - --gitlab-config-resource=GITLAB_CONFIG_RESOURCE - GitLab config resource name. - - This flag argument must be specified if any of the other arguments - in this group are specified. - - --project-namespace=PROJECT_NAMESPACE - GitLab project namespace. - - This flag argument must be specified if any of the other arguments - in this group are specified. - --description=DESCRIPTION Build trigger description. @@ -206,6 +192,22 @@ REQUIRED FLAGS Use a build configuration (cloudbuild.yaml) file for building multiple images in a single trigger. + Exactly one of these must be specified: + + 1st-gen repository settings. + + --gitlab-config-resource=GITLAB_CONFIG_RESOURCE + GitLab config resource name. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --project-namespace=PROJECT_NAMESPACE + GitLab project namespace. + + This flag argument must be specified if any of the other + arguments in this group are specified. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/certificate-manager/maps/entries/create b/gcloud/certificate-manager/maps/entries/create index c5fb41b9c..39d1ba43e 100644 --- a/gcloud/certificate-manager/maps/entries/create +++ b/gcloud/certificate-manager/maps/entries/create @@ -6,8 +6,8 @@ SYNOPSIS gcloud certificate-manager maps entries create (ENTRY : --location=LOCATION --map=MAP) (--hostname=HOSTNAME | --set-primary) [--description=DESCRIPTION] - --certificates=[CERTIFICATES,...] [--async] [--labels=[KEY=VALUE,...]] - [GCLOUD_WIDE_FLAG ...] + [--async] [--certificates=[CERTIFICATES,...]] + [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION This command creates a certificate map entry. @@ -72,6 +72,10 @@ COMMONLY USED FLAGS Text description of a certificate map entry. OTHER FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + Certificate resource - The certificates to be attached to the entry. 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 @@ -89,10 +93,6 @@ OTHER FLAGS certificates. To set the certificate attribute: ▸ provide the argument --certificates on the command line. - --async - Return immediately, without waiting for the operation in progress to - complete. - --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/certificate-manager/maps/entries/update b/gcloud/certificate-manager/maps/entries/update index 0f3aaad4f..9947c4171 100644 --- a/gcloud/certificate-manager/maps/entries/update +++ b/gcloud/certificate-manager/maps/entries/update @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud certificate-manager maps entries update (ENTRY : --location=LOCATION --map=MAP) [--description=DESCRIPTION] - --certificates=[CERTIFICATES,...] [--async] + [--async] [--certificates=[CERTIFICATES,...]] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -59,6 +59,10 @@ COMMONLY USED FLAGS Text description of a certificate map entry. OTHER FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + Certificate resource - The certificates to be attached to the entry. 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 @@ -76,10 +80,6 @@ OTHER FLAGS certificates. To set the certificate attribute: ▸ provide the argument --certificates on the command line. - --async - Return immediately, without waiting for the operation in progress to - complete. - --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. diff --git a/gcloud/composer/environments/create b/gcloud/composer/environments/create index 43aa30e37..1f16e2032 100644 --- a/gcloud/composer/environments/create +++ b/gcloud/composer/environments/create @@ -412,13 +412,15 @@ FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/composer/environments/list b/gcloud/composer/environments/list index 59233540c..313db9c53 100644 --- a/gcloud/composer/environments/list +++ b/gcloud/composer/environments/list @@ -3,7 +3,7 @@ NAME under a project and location SYNOPSIS - gcloud composer environments list --locations=[LOCATIONS,...] + gcloud composer environments list [--locations=[LOCATIONS,...]] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/composer/operations/list b/gcloud/composer/operations/list index a927b63f0..23ff23547 100644 --- a/gcloud/composer/operations/list +++ b/gcloud/composer/operations/list @@ -2,7 +2,7 @@ NAME gcloud composer operations list - lists environment operations SYNOPSIS - gcloud composer operations list --locations=[LOCATIONS,...] + gcloud composer operations list [--locations=[LOCATIONS,...]] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/compute/backend-services/create b/gcloud/compute/backend-services/create index 5a29faab5..647844953 100644 --- a/gcloud/compute/backend-services/create +++ b/gcloud/compute/backend-services/create @@ -259,7 +259,8 @@ FLAGS --[no-]enable-logging The logging options for the load balancer traffic served by this backend service. If logging is enabled, logs will be exported to Cloud - Logging. Disabled by default. Use --enable-logging to enable and + Logging. Disabled by default. This field cannot be specified for SSL + Proxy and TCP Proxy Load Balancing. Use --enable-logging to enable and --no-enable-logging to disable. --[no-]enable-strong-affinity @@ -329,7 +330,8 @@ FLAGS service. The value of the field must be a float in the range [0, 1]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no - logged requests are reported. The default value is 1.0. + logged requests are reported. The default value is 1.0 when logging is + enabled and 0.0 otherwise. --max-ttl=MAX_TTL Specifies the maximum allowed TTL for cached content served by this diff --git a/gcloud/compute/backend-services/update b/gcloud/compute/backend-services/update index 421ca001a..d6724617d 100644 --- a/gcloud/compute/backend-services/update +++ b/gcloud/compute/backend-services/update @@ -174,7 +174,8 @@ FLAGS --[no-]enable-logging The logging options for the load balancer traffic served by this backend service. If logging is enabled, logs will be exported to Cloud - Logging. Disabled by default. Use --enable-logging to enable and + Logging. Disabled by default. This field cannot be specified for SSL + Proxy and TCP Proxy Load Balancing. Use --enable-logging to enable and --no-enable-logging to disable. --[no-]enable-strong-affinity @@ -239,7 +240,8 @@ FLAGS service. The value of the field must be a float in the range [0, 1]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no - logged requests are reported. The default value is 1.0. + logged requests are reported. The default value is 1.0 when logging is + enabled and 0.0 otherwise. --port-name=PORT_NAME Backend services for external HTTP(S) load balancing, internal HTTP(S) diff --git a/gcloud/compute/reservations/create b/gcloud/compute/reservations/create index 3a0992858..a5de031cd 100644 --- a/gcloud/compute/reservations/create +++ b/gcloud/compute/reservations/create @@ -9,8 +9,8 @@ SYNOPSIS : --accelerator=[count=COUNT],[type=TYPE] --local-ssd=[interface=INTERFACE],[size=SIZE] --min-cpu-platform=MIN_CPU_PLATFORM]) - : --require-specific-reservation) [--description=DESCRIPTION] - [--zone=ZONE] + : --require-specific-reservation --resource-policies=[KEY=VALUE,...]) + [--description=DESCRIPTION] [--zone=ZONE] [--share-setting=SHARE_SETTING --share-with=SHARE_WITH,[SHARE_WITH,...]] [GCLOUD_WIDE_FLAG ...] @@ -56,6 +56,11 @@ REQUIRED FLAGS reservation by name using --reservation-affinity=specific can consume from this reservation. + --resource-policies=[KEY=VALUE,...] + The resource policies to include in this reservation. If you omit + this flag, no resource policies are added. You can specify any string + as the key, and specify the name of a resource policy as the value. + Manage the instance properties for the SpecificSKU reservation. Exactly one of these must be specified: diff --git a/gcloud/compute/target-https-proxies/create b/gcloud/compute/target-https-proxies/create index 3c72cfe2b..8e0feb110 100644 --- a/gcloud/compute/target-https-proxies/create +++ b/gcloud/compute/target-https-proxies/create @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud compute target-https-proxies create NAME --url-map=URL_MAP - --certificate-map=CERTIFICATE_MAP [--description=DESCRIPTION] + [--certificate-map=CERTIFICATE_MAP] [--description=DESCRIPTION] [--quic-override=QUIC_OVERRIDE; default="NONE"] [--ssl-certificates=SSL_CERTIFICATE,[...]] [--ssl-policy=SSL_POLICY] [--global | --region=REGION] diff --git a/gcloud/compute/target-https-proxies/update b/gcloud/compute/target-https-proxies/update index fc5999d84..b1962dfe1 100644 --- a/gcloud/compute/target-https-proxies/update +++ b/gcloud/compute/target-https-proxies/update @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud compute target-https-proxies update NAME [--quic-override=QUIC_OVERRIDE] [--url-map=URL_MAP] - [[--certificate-map=CERTIFICATE_MAP : --clear-certificate-map] + [--certificate-map=CERTIFICATE_MAP | --clear-certificate-map | --ssl-certificates=SSL_CERTIFICATE,[...] --global-ssl-certificates | --ssl-certificates-region=SSL_CERTIFICATES_REGION] [--clear-ssl-policy | --ssl-policy=SSL_POLICY --global-ssl-policy diff --git a/gcloud/compute/target-ssl-proxies/create b/gcloud/compute/target-ssl-proxies/create index edf7f3ab1..23e5dc983 100644 --- a/gcloud/compute/target-ssl-proxies/create +++ b/gcloud/compute/target-ssl-proxies/create @@ -5,8 +5,7 @@ SYNOPSIS gcloud compute target-ssl-proxies create NAME --backend-service=BACKEND_SERVICE (--certificate-map=CERTIFICATE_MAP - : --ssl-certificates=SSL_CERTIFICATE,[...]) - [--description=DESCRIPTION] + --ssl-certificates=SSL_CERTIFICATE,[...]) [--description=DESCRIPTION] [--proxy-header=PROXY_HEADER; default="NONE"] [--ssl-policy=SSL_POLICY] [--global-ssl-policy | --ssl-policy-region=SSL_POLICY_REGION] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/compute/target-ssl-proxies/update b/gcloud/compute/target-ssl-proxies/update index 82994c59e..f4e7b0e16 100644 --- a/gcloud/compute/target-ssl-proxies/update +++ b/gcloud/compute/target-ssl-proxies/update @@ -4,11 +4,11 @@ NAME SYNOPSIS gcloud compute target-ssl-proxies update NAME [--backend-service=BACKEND_SERVICE] [--proxy-header=PROXY_HEADER] - [--certificate-map=CERTIFICATE_MAP - : --ssl-certificates=SSL_CERTIFICATE,[...] | --clear-ssl-certificates - | --clear-certificate-map] [--clear-ssl-policy | --ssl-policy=SSL_POLICY --global-ssl-policy - | --ssl-policy-region=SSL_POLICY_REGION] [GCLOUD_WIDE_FLAG ...] + | --ssl-policy-region=SSL_POLICY_REGION] + [--ssl-certificates=SSL_CERTIFICATE,[...] | --clear-ssl-certificates + | --certificate-map=CERTIFICATE_MAP | --clear-certificate-map] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION gcloud compute target-ssl-proxies update is used to replace the SSL @@ -39,6 +39,26 @@ FLAGS Enables PROXY protocol (version 1) for passing client connection information. + At most one of these can be specified: + + --clear-ssl-policy + Removes any attached SSL policy from the SSL proxy. + + --ssl-policy=SSL_POLICY + A reference to an SSL policy resource that defines the server-side + support for SSL features and affects the connections between clients + and the SSL proxy load balancer. The SSL policy must exist and cannot + be deleted while referenced by a target SSL proxy. + + At most one of these can be specified: + + --global-ssl-policy + If set, the SSL policy is global. + + --ssl-policy-region=SSL_POLICY_REGION + Region of the SSL policy to operate on. Overrides the default + compute/region property value for this command invocation. + At most one of these can be specified: --ssl-certificates=SSL_CERTIFICATE,[...] @@ -71,26 +91,6 @@ FLAGS --clear-certificate-map Removes any attached certificate map from the SSL proxy. - At most one of these can be specified: - - --clear-ssl-policy - Removes any attached SSL policy from the SSL proxy. - - --ssl-policy=SSL_POLICY - A reference to an SSL policy resource that defines the server-side - support for SSL features and affects the connections between clients - and the SSL proxy load balancer. The SSL policy must exist and cannot - be deleted while referenced by a target SSL proxy. - - At most one of these can be specified: - - --global-ssl-policy - If set, the SSL policy is global. - - --ssl-policy-region=SSL_POLICY_REGION - Region of the SSL policy to operate on. Overrides the default - compute/region property value for this command invocation. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/container/azure/clusters/create b/gcloud/container/azure/clusters/create index dbff7d176..e098d82c6 100644 --- a/gcloud/container/azure/clusters/create +++ b/gcloud/container/azure/clusters/create @@ -9,7 +9,7 @@ SYNOPSIS --resource-group-id=RESOURCE_GROUP_ID --service-address-cidr-blocks=SERVICE_ADDRESS_CIDR_BLOCKS --ssh-public-key=SSH_PUBLIC_KEY --vnet-id=VNET_ID - (--client=CLIENT : --azure-application-id=AZURE_APPLICATION_ID + (--client=CLIENT | --azure-application-id=AZURE_APPLICATION_ID --azure-tenant-id=AZURE_TENANT_ID) [--admin-users=USER,[USER,...]] [--annotations=ANNOTATION,[ANNOTATION,...]] [--async] [--config-encryption-key-id=CONFIG_ENCRYPTION_KEY_ID] diff --git a/gcloud/container/azure/clusters/update b/gcloud/container/azure/clusters/update index ef90d63bd..57e118440 100644 --- a/gcloud/container/azure/clusters/update +++ b/gcloud/container/azure/clusters/update @@ -9,7 +9,7 @@ SYNOPSIS [--validate-only] [--vm-size=VM_SIZE] [--annotations=ANNOTATION,[ANNOTATION,...] | --clear-annotations] [--clear-description | --description=DESCRIPTION] - [--client=CLIENT : --azure-application-id=AZURE_APPLICATION_ID + [--client=CLIENT | --azure-application-id=AZURE_APPLICATION_ID --azure-tenant-id=AZURE_TENANT_ID] [GCLOUD_WIDE_FLAG ...] DESCRIPTION diff --git a/gcloud/database-migration/connection-profiles/list b/gcloud/database-migration/connection-profiles/list index 9db518164..e3b4969e0 100644 --- a/gcloud/database-migration/connection-profiles/list +++ b/gcloud/database-migration/connection-profiles/list @@ -3,7 +3,7 @@ NAME Migration Service connection profiles SYNOPSIS - gcloud database-migration connection-profiles list --region=REGION + gcloud database-migration connection-profiles list [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/database-migration/migration-jobs/update b/gcloud/database-migration/migration-jobs/update index 25a939abe..fd2ad416c 100644 --- a/gcloud/database-migration/migration-jobs/update +++ b/gcloud/database-migration/migration-jobs/update @@ -4,9 +4,10 @@ NAME SYNOPSIS gcloud database-migration migration-jobs update - (MIGRATION_JOB : --region=REGION) --destination=DESTINATION - --source=SOURCE [--no-async] [--display-name=DISPLAY_NAME] - [--dump-path=DUMP_PATH] [--type=TYPE] [--update-labels=[KEY=VALUE,...]] + (MIGRATION_JOB : --region=REGION) [--no-async] + [--destination=DESTINATION] [--display-name=DISPLAY_NAME] + [--dump-path=DUMP_PATH] [--source=SOURCE] [--type=TYPE] + [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [--peer-vpc=PEER_VPC | --static-ip | --vm=VM --vm-ip=VM_IP --vm-port=VM_PORT --vpc=VPC] @@ -57,6 +58,9 @@ POSITIONAL ARGUMENTS ▸ provide the argument --region on the command line. FLAGS + --no-async + Waits for the operation in progress to complete before returning. + Connection profile resource - ID of the destination connection profile, representing the destination database. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be @@ -74,6 +78,15 @@ FLAGS connection_profile. To set the connection_profile attribute: ▸ provide the argument --destination on the command line. + --display-name=DISPLAY_NAME + A user-friendly name for the migration job. The display name can + include letters, numbers, spaces, and hyphens, and must start with a + letter. + + --dump-path=DUMP_PATH + Path to the dump file in Google Cloud Storage, in the format: + gs://[BUCKET_NAME]/[OBJECT_NAME]. + Connection profile resource - ID of the source connection profile, representing the source database. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in @@ -91,18 +104,6 @@ FLAGS connection_profile. To set the connection_profile attribute: ▸ provide the argument --source on the command line. - --no-async - Waits for the operation in progress to complete before returning. - - --display-name=DISPLAY_NAME - A user-friendly name for the migration job. The display name can - include letters, numbers, spaces, and hyphens, and must start with a - letter. - - --dump-path=DUMP_PATH - Path to the dump file in Google Cloud Storage, in the format: - gs://[BUCKET_NAME]/[OBJECT_NAME]. - --type=TYPE Type of the migration job. TYPE must be one of: ONE_TIME, CONTINUOUS. diff --git a/gcloud/dataproc/clusters/create b/gcloud/dataproc/clusters/create index 228107edc..8662a4b0d 100644 --- a/gcloud/dataproc/clusters/create +++ b/gcloud/dataproc/clusters/create @@ -3,9 +3,9 @@ NAME SYNOPSIS gcloud dataproc clusters create (CLUSTER : --region=REGION) - --autoscaling-policy=AUTOSCALING_POLICY [--action-on-failed-primary-workers=ACTION_ON_FAILED_PRIMARY_WORKERS] - [--no-address] [--async] [--bucket=BUCKET] [--confidential-compute] + [--no-address] [--async] [--autoscaling-policy=AUTOSCALING_POLICY] + [--bucket=BUCKET] [--confidential-compute] [--dataproc-metastore=DATAPROC_METASTORE] [--driver-pool-accelerator=[type=TYPE,[count=COUNT],...]] [--driver-pool-boot-disk-size=DRIVER_POOL_BOOT_DISK_SIZE] @@ -108,11 +108,6 @@ POSITIONAL ARGUMENTS ▸ set the property dataproc/region. FLAGS - --autoscaling-policy=AUTOSCALING_POLICY - ID of the autoscaling policy or fully qualified identifier for the - autoscaling policy. To set the autoscaling_policy attribute: - ◆ provide the argument --autoscaling-policy on the command line. - --action-on-failed-primary-workers=ACTION_ON_FAILED_PRIMARY_WORKERS Failure action to take when primary workers fail during cluster creation. ACTION_ON_FAILED_PRIMARY_WORKERS must be one of: @@ -139,6 +134,11 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --autoscaling-policy=AUTOSCALING_POLICY + ID of the autoscaling policy or fully qualified identifier for the + autoscaling policy. To set the autoscaling_policy attribute: + ◆ provide the argument --autoscaling-policy on the command line. + --bucket=BUCKET The Google Cloud Storage bucket to use by default to stage job dependencies, miscellaneous config files, and job driver console output @@ -474,14 +474,16 @@ FLAGS line. --gce-pd-kms-key-location=GCE_PD_KMS_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --gce-pd-kms-key on the command line with a fully specified name; ▸ provide the argument --gce-pd-kms-key-location on the command line. --gce-pd-kms-key-project=GCE_PD_KMS_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --gce-pd-kms-key on the command line with a fully specified name; ▸ provide the argument --gce-pd-kms-key-project on the command @@ -636,14 +638,16 @@ FLAGS line. --kerberos-kms-key-location=KERBEROS_KMS_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▫ provide the argument --kerberos-kms-key on the command line with a fully specified name; ▫ provide the argument --kerberos-kms-key-location on the command line. --kerberos-kms-key-project=KERBEROS_KMS_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▫ provide the argument --kerberos-kms-key on the command line with a fully specified name; ▫ provide the argument --kerberos-kms-key-project on the command diff --git a/gcloud/dataproc/clusters/update b/gcloud/dataproc/clusters/update index ac7f1189a..d93d28b51 100644 --- a/gcloud/dataproc/clusters/update +++ b/gcloud/dataproc/clusters/update @@ -7,7 +7,7 @@ SYNOPSIS [--graceful-decommission-timeout=GRACEFUL_DECOMMISSION_TIMEOUT] [--num-secondary-workers=NUM_SECONDARY_WORKERS] [--num-workers=NUM_WORKERS] [--update-labels=[KEY=VALUE,...]] - [--autoscaling-policy=AUTOSCALING_POLICY : --disable-autoscaling] + [--autoscaling-policy=AUTOSCALING_POLICY | --disable-autoscaling] [--clear-labels | --remove-labels=[KEY,...]] [--expiration-time=EXPIRATION_TIME | --max-age=MAX_AGE | --no-max-age] [--max-idle=MAX_IDLE | --no-max-idle] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/dataproc/workflow-templates/set-managed-cluster b/gcloud/dataproc/workflow-templates/set-managed-cluster index 2deffd1c5..6f7f1214d 100644 --- a/gcloud/dataproc/workflow-templates/set-managed-cluster +++ b/gcloud/dataproc/workflow-templates/set-managed-cluster @@ -4,10 +4,10 @@ NAME SYNOPSIS gcloud dataproc workflow-templates set-managed-cluster - (TEMPLATE : --region=REGION) --autoscaling-policy=AUTOSCALING_POLICY - [--no-address] [--bucket=BUCKET] [--cluster-name=CLUSTER_NAME] - [--confidential-compute] [--dataproc-metastore=DATAPROC_METASTORE] - [--enable-component-gateway] + (TEMPLATE : --region=REGION) [--no-address] + [--autoscaling-policy=AUTOSCALING_POLICY] [--bucket=BUCKET] + [--cluster-name=CLUSTER_NAME] [--confidential-compute] + [--dataproc-metastore=DATAPROC_METASTORE] [--enable-component-gateway] [--initialization-action-timeout=TIMEOUT; default="10m"] [--initialization-actions=CLOUD_STORAGE_URI,[...]] [--labels=[KEY=VALUE,...]] @@ -96,11 +96,6 @@ POSITIONAL ARGUMENTS ▸ set the property dataproc/region. FLAGS - --autoscaling-policy=AUTOSCALING_POLICY - ID of the autoscaling policy or fully qualified identifier for the - autoscaling policy. To set the autoscaling_policy attribute: - ◆ provide the argument --autoscaling-policy on the command line. - --no-address If provided, the instances in the cluster will not be assigned external IP addresses. @@ -112,6 +107,11 @@ FLAGS achieved without external IP addresses using Private Google Access (https://cloud.google.com/compute/docs/private-google-access). + --autoscaling-policy=AUTOSCALING_POLICY + ID of the autoscaling policy or fully qualified identifier for the + autoscaling policy. To set the autoscaling_policy attribute: + ◆ provide the argument --autoscaling-policy on the command line. + --bucket=BUCKET The Google Cloud Storage bucket to use by default to stage job dependencies, miscellaneous config files, and job driver console output @@ -508,14 +508,16 @@ FLAGS line. --kerberos-kms-key-location=KERBEROS_KMS_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▫ provide the argument --kerberos-kms-key on the command line with a fully specified name; ▫ provide the argument --kerberos-kms-key-location on the command line. --kerberos-kms-key-project=KERBEROS_KMS_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▫ provide the argument --kerberos-kms-key on the command line with a fully specified name; ▫ provide the argument --kerberos-kms-key-project on the command diff --git a/gcloud/datastream/connection-profiles/create b/gcloud/datastream/connection-profiles/create index 67914036d..a02f3284d 100644 --- a/gcloud/datastream/connection-profiles/create +++ b/gcloud/datastream/connection-profiles/create @@ -21,7 +21,7 @@ SYNOPSIS --postgresql-username=POSTGRESQL_USERNAME (--postgresql-password=POSTGRESQL_PASSWORD | --postgresql-prompt-for-password)] - [--private-connection=PRIVATE_CONNECTION : --static-ip-connectivity + [--private-connection=PRIVATE_CONNECTION | --static-ip-connectivity | [--forward-ssh-hostname=FORWARD_SSH_HOSTNAME --forward-ssh-username=FORWARD_SSH_USERNAME (--forward-ssh-password=FORWARD_SSH_PASSWORD diff --git a/gcloud/datastream/connection-profiles/discover b/gcloud/datastream/connection-profiles/discover index d48083069..53d1e109d 100644 --- a/gcloud/datastream/connection-profiles/discover +++ b/gcloud/datastream/connection-profiles/discover @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud datastream connection-profiles discover --location=LOCATION (--connection-profile-name=CONNECTION_PROFILE_NAME - : --connection-profile-object-file=CONNECTION_PROFILE_OBJECT_FILE) + | --connection-profile-object-file=CONNECTION_PROFILE_OBJECT_FILE) [--mysql-rdbms-file=MYSQL_RDBMS_FILE | --oracle-rdbms-file=ORACLE_RDBMS_FILE | --postgresql-rdbms-file=POSTGRESQL_RDBMS_FILE] diff --git a/gcloud/datastream/connection-profiles/update b/gcloud/datastream/connection-profiles/update index f90a9e1df..7f05888d6 100644 --- a/gcloud/datastream/connection-profiles/update +++ b/gcloud/datastream/connection-profiles/update @@ -24,7 +24,7 @@ SYNOPSIS --postgresql-password=POSTGRESQL_PASSWORD | --postgresql-prompt-for-password] [--clear-labels | --remove-labels=[KEY,...]] - [--private-connection=PRIVATE_CONNECTION : --static-ip-connectivity + [--private-connection=PRIVATE_CONNECTION | --static-ip-connectivity | --forward-ssh-hostname=FORWARD_SSH_HOSTNAME --forward-ssh-port=FORWARD_SSH_PORT; default=22 --forward-ssh-username=FORWARD_SSH_USERNAME diff --git a/gcloud/datastream/streams/create b/gcloud/datastream/streams/create index 05cc1487c..4ab6fedd7 100644 --- a/gcloud/datastream/streams/create +++ b/gcloud/datastream/streams/create @@ -138,14 +138,14 @@ REQUIRED FLAGS The JSON file is formatted as follows: { - "source_hierarchy_datasets": { - "dataset_template": { + "sourceHierarchyDatasets": { + "datasetTemplate": { "location": "us-central1", - "dataset_id_prefix": "my_prefix", - "kms_key_name": "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{cryptoKey}" + "datasetIdPrefix": "my_prefix", + "kmsKeyName": "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{cryptoKey}" } }, - "data_freshness": 3600 + "dataFreshness": 3600 } --gcs-destination-config=GCS_DESTINATION_CONFIG @@ -156,9 +156,9 @@ REQUIRED FLAGS { "path": "some/path", - "file_rotation_mb":5, - "file_rotation_interval":"15s", - "avro_file_format": {} + "fileRotationMb":5, + "fileRotationInterval":"15s", + "avroFileFormat": {} } This must be specified. @@ -188,19 +188,18 @@ REQUIRED FLAGS Path to a YAML (or JSON) file containing the configuration for MySQL Source Config. - The JSON file is formatted as follows, with snake_case field - naming: + The JSON file is formatted as follows, with camelCase field naming: { - "include_objects": {}, - "exclude_objects": { - "mysql_databases": [ + "includeObjects": {}, + "excludeObjects": { + "mysqlDatabases": [ { "database":"sample_database", - "mysql_tables": [ + "mysqlTables": [ { "table": "sample_table", - "mysql_columns": [ + "mysqlColumns": [ { "column": "sample_column", } @@ -216,19 +215,18 @@ REQUIRED FLAGS Path to a YAML (or JSON) file containing the configuration for Oracle Source Config. - The JSON file is formatted as follows, with snake_case field - naming: + The JSON file is formatted as follows, with camelCase field naming: { - "include_objects": {}, - "exclude_objects": { - "oracle_schemas": [ + "includeObjects": {}, + "excludeObjects": { + "oracleSchemas": [ { "schema": "SAMPLE", - "oracle_tables": [ + "oracleTables": [ { "table": "SAMPLE_TABLE", - "oracle_columns": [ + "oracleColumns": [ { "column": "COL", } @@ -244,19 +242,18 @@ REQUIRED FLAGS Path to a YAML (or JSON) file containing the configuration for PostgreSQL Source Config. - The JSON file is formatted as follows, with snake_case field - naming: + The JSON file is formatted as follows, with camelCase field naming: { - "include_objects": {}, - "exclude_objects": { - "postgresql_schemas": [ + "includeObjects": {}, + "excludeObjects": { + "postgresqlSchemas": [ { "schema": "SAMPLE", - "postgresql_tables": [ + "postgresqlTables": [ { "table": "SAMPLE_TABLE", - "postgresql_columns": [ + "postgresqlColumns": [ { "column": "COL", } @@ -266,7 +263,7 @@ REQUIRED FLAGS } ] }, - "replication_slot": "SAMPLE_REPLICATION_SLOT", + "replicationSlot": "SAMPLE_REPLICATION_SLOT", "publication": "SAMPLE_PUBLICATION" } diff --git a/gcloud/datastream/streams/update b/gcloud/datastream/streams/update index a8cc84e8d..518f0bd01 100644 --- a/gcloud/datastream/streams/update +++ b/gcloud/datastream/streams/update @@ -11,10 +11,10 @@ SYNOPSIS | --postgresql-excluded-objects=POSTGRESQL_EXCLUDED_OBJECTS] [--clear-labels | --remove-labels=[KEY,...]] [--destination=DESTINATION - : --bigquery-destination-config=BIGQUERY_DESTINATION_CONFIG + --bigquery-destination-config=BIGQUERY_DESTINATION_CONFIG | --gcs-destination-config=GCS_DESTINATION_CONFIG] [--force | --validate-only] - [--source=SOURCE : --mysql-source-config=MYSQL_SOURCE_CONFIG + [--source=SOURCE --mysql-source-config=MYSQL_SOURCE_CONFIG | --oracle-source-config=ORACLE_SOURCE_CONFIG | --postgresql-source-config=POSTGRESQL_SOURCE_CONFIG] [GCLOUD_WIDE_FLAG ...] @@ -156,14 +156,14 @@ FLAGS The JSON file is formatted as follows: { - "source_hierarchy_datasets": { - "dataset_template": { + "sourceHierarchyDatasets": { + "datasetTemplate": { "location": "us-central1", - "dataset_id_prefix": "my_prefix", - "kms_key_name": "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{cryptoKey}" + "datasetIdPrefix": "my_prefix", + "kmsKeyName": "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{cryptoKey}" } }, - "data_freshness": 3600 + "dataFreshness": 3600 } --gcs-destination-config=GCS_DESTINATION_CONFIG @@ -174,9 +174,9 @@ FLAGS { "path": "some/path", - "file_rotation_mb":5, - "file_rotation_interval":"15s", - "avro_file_format": {} + "fileRotationMb":5, + "fileRotationInterval":"15s", + "avroFileFormat": {} } At most one of these can be specified: @@ -211,18 +211,18 @@ FLAGS Path to a YAML (or JSON) file containing the configuration for MySQL Source Config. - The JSON file is formatted as follows, with snake_case field naming: + The JSON file is formatted as follows, with camelCase field naming: { - "include_objects": {}, - "exclude_objects": { - "mysql_databases": [ + "includeObjects": {}, + "excludeObjects": { + "mysqlDatabases": [ { "database":"sample_database", - "mysql_tables": [ + "mysqlTables": [ { "table": "sample_table", - "mysql_columns": [ + "mysqlColumns": [ { "column": "sample_column", } @@ -238,18 +238,18 @@ FLAGS Path to a YAML (or JSON) file containing the configuration for Oracle Source Config. - The JSON file is formatted as follows, with snake_case field naming: + The JSON file is formatted as follows, with camelCase field naming: { - "include_objects": {}, - "exclude_objects": { - "oracle_schemas": [ + "includeObjects": {}, + "excludeObjects": { + "oracleSchemas": [ { "schema": "SAMPLE", - "oracle_tables": [ + "oracleTables": [ { "table": "SAMPLE_TABLE", - "oracle_columns": [ + "oracleColumns": [ { "column": "COL", } @@ -265,18 +265,18 @@ FLAGS Path to a YAML (or JSON) file containing the configuration for PostgreSQL Source Config. - The JSON file is formatted as follows, with snake_case field naming: + The JSON file is formatted as follows, with camelCase field naming: { - "include_objects": {}, - "exclude_objects": { - "postgresql_schemas": [ + "includeObjects": {}, + "excludeObjects": { + "postgresqlSchemas": [ { "schema": "SAMPLE", - "postgresql_tables": [ + "postgresqlTables": [ { "table": "SAMPLE_TABLE", - "postgresql_columns": [ + "postgresqlColumns": [ { "column": "COL", } diff --git a/gcloud/debug/help b/gcloud/debug/help index 9d70c0f4c..82b606c46 100644 --- a/gcloud/debug/help +++ b/gcloud/debug/help @@ -5,6 +5,12 @@ SYNOPSIS gcloud debug GROUP [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Commands for interacting with the Cloud Debugger. + + Cloud Debugger is deprecated and will be shutdown May 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + The gcloud debug command group provides interaction with Cloud Debugger, allowing you to list and manipulate debugging targets, snapshots and logpoints. @@ -54,16 +60,17 @@ GROUPS GROUP is one of the following: logpoints - Commands for interacting with Cloud Debugger logpoints. + (DEPRECATED) Commands for interacting with Cloud Debugger logpoints. snapshots - Commands for interacting with Cloud Debugger snapshots. + (DEPRECATED) Commands for interacting with Cloud Debugger snapshots. source - Commands to manage source information for Cloud Debugger. + (DEPRECATED) Commands to manage source information for Cloud Debugger. targets - Commands for interacting with Cloud Debugger debug targets. + (DEPRECATED) Commands for interacting with Cloud Debugger debug + targets. NOTES This variant is also available: diff --git a/gcloud/debug/logpoints/create b/gcloud/debug/logpoints/create index a8ef6275f..f032716c0 100644 --- a/gcloud/debug/logpoints/create +++ b/gcloud/debug/logpoints/create @@ -9,6 +9,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May 31, + 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + gcloud debug logpoints create is used to add a debug logpoint to a debug target (debuggee). Logpoints add logging to your running service without changing your code or restarting your application. When you create a diff --git a/gcloud/debug/logpoints/delete b/gcloud/debug/logpoints/delete index 3ee48e290..5ae1134c8 100644 --- a/gcloud/debug/logpoints/delete +++ b/gcloud/debug/logpoints/delete @@ -8,6 +8,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May 31, + 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + gcloud debug logpoints delete is used to delete logpoints from a Cloud Debugger debug target (debuggee). It will ask for confirmation before deleting any logpoints. To suppress confirmation, use the global --quiet diff --git a/gcloud/debug/logpoints/help b/gcloud/debug/logpoints/help index 9108e127d..b7feba9b1 100644 --- a/gcloud/debug/logpoints/help +++ b/gcloud/debug/logpoints/help @@ -7,6 +7,12 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Commands for interacting with Cloud Debugger logpoints. + + Cloud Debugger is deprecated and will be shutdown May 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + Logpoints allow you to inject logging into running services without restarting or interfering with the normal function of the service. Log output will be sent to the appropriate log for the target's environment. On @@ -71,13 +77,16 @@ COMMANDS COMMAND is one of the following: create - Add debug logpoints to a Cloud Debugger debug target (debuggee). + (DEPRECATED) Add debug logpoints to a Cloud Debugger debug target + (debuggee). delete - Delete debug logpoints for a Cloud Debugger debug target (debuggee). + (DEPRECATED) Delete debug logpoints for a Cloud Debugger debug target + (debuggee). list - List the debug logpoints for a Cloud Debugger debug target (debuggee). + (DEPRECATED) List the debug logpoints for a Cloud Debugger debug target + (debuggee). NOTES This variant is also available: diff --git a/gcloud/debug/logpoints/list b/gcloud/debug/logpoints/list index 8756450af..de96b0140 100644 --- a/gcloud/debug/logpoints/list +++ b/gcloud/debug/logpoints/list @@ -10,6 +10,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May 31, + 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + gcloud debug logpoints list is used to display the debug logpoints for a Cloud Debugger debug target (debuggee). By default all active logpoints are returned. To obtain older, expired logoints, specify the --include-inactive diff --git a/gcloud/debug/snapshots/create b/gcloud/debug/snapshots/create index ce47b08c4..865856c82 100644 --- a/gcloud/debug/snapshots/create +++ b/gcloud/debug/snapshots/create @@ -8,6 +8,11 @@ SYNOPSIS [--wait=WAIT; default=10] [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May 31, + 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + gcloud debug snapshots create is used to create a debug snapshot on a Cloud Debugger debug target. Snapshots allow you to capture stack traces and local variables from your running service without interfering with normal diff --git a/gcloud/debug/snapshots/delete b/gcloud/debug/snapshots/delete index 7a9e31cef..b4b314a38 100644 --- a/gcloud/debug/snapshots/delete +++ b/gcloud/debug/snapshots/delete @@ -8,6 +8,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May 31, + 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + gcloud debug snapshots delete is used to delete snapshots from a Cloud Debugger debug target (debuggee). It will ask for confirmation before deleting any snapshots. To suppress confirmation, use the global --quiet diff --git a/gcloud/debug/snapshots/describe b/gcloud/debug/snapshots/describe index be3da6ec8..1b0cb40ca 100644 --- a/gcloud/debug/snapshots/describe +++ b/gcloud/debug/snapshots/describe @@ -7,6 +7,11 @@ SYNOPSIS [--target=(ID|DESCRIPTION_REGEXP)] [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May 31, + 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + gcloud debug snapshots describe is used to describe the debug snapshots for a Cloud Debugger debug target (debuggee). If the snapshot has completed, the output will include details on the stack trace and local variables, diff --git a/gcloud/debug/snapshots/help b/gcloud/debug/snapshots/help index 0e25a3246..050ebf6df 100644 --- a/gcloud/debug/snapshots/help +++ b/gcloud/debug/snapshots/help @@ -7,6 +7,12 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Commands for interacting with Cloud Debugger snapshots. + + Cloud Debugger is deprecated and will be shutdown May 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + Commands to interact with debug snapshots. Snapshots allow you to capture stack traces and local variables from running services without interfering with the normal function of the service. @@ -28,21 +34,24 @@ COMMANDS COMMAND is one of the following: create - Create debug snapshots for a Cloud Debugger debug target (debuggee). - - delete - Delete debug snapshots for a Cloud Debugger debug target (debuggee). - - describe - Describe the debug snapshots for a Cloud Debugger debug target + (DEPRECATED) Create debug snapshots for a Cloud Debugger debug target (debuggee). + delete + (DEPRECATED) Delete debug snapshots for a Cloud Debugger debug target + (debuggee). + + describe + (DEPRECATED) Describe the debug snapshots for a Cloud Debugger debug + target (debuggee). + list - List the debug snapshots for a Cloud Debugger debug target (debuggee). + (DEPRECATED) List the debug snapshots for a Cloud Debugger debug target + (debuggee). wait - Wait for debug snapshots on a Cloud Debugger debug target (debuggee) to - complete. + (DEPRECATED) Wait for debug snapshots on a Cloud Debugger debug target + (debuggee) to complete. NOTES This variant is also available: diff --git a/gcloud/debug/snapshots/list b/gcloud/debug/snapshots/list index edc2390b2..1354def54 100644 --- a/gcloud/debug/snapshots/list +++ b/gcloud/debug/snapshots/list @@ -10,6 +10,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May 31, + 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + gcloud debug snapshots list is used to display the debug snapshots for a Cloud Debugger debug target (debuggee). By default all active snapshots as well as any recently completed snapshots are returned. To obtain older diff --git a/gcloud/debug/snapshots/wait b/gcloud/debug/snapshots/wait index 9b930e493..d3de9a305 100644 --- a/gcloud/debug/snapshots/wait +++ b/gcloud/debug/snapshots/wait @@ -9,6 +9,11 @@ SYNOPSIS [--limit=LIMIT] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May 31, + 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + gcloud debug snapshots wait is used to wait for one or more snapshots on a Cloud Debugger debug target to complete. A snapshot is considered completed either if there was an error setting the snapshot or if the snapshot was diff --git a/gcloud/debug/source/gen-repo-info-file b/gcloud/debug/source/gen-repo-info-file index 99370f148..09f1482ed 100644 --- a/gcloud/debug/source/gen-repo-info-file +++ b/gcloud/debug/source/gen-repo-info-file @@ -9,6 +9,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May 31, + 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + This command generates a file named source-context.json containing information on the source revision and remote repository associated with the given source directory. diff --git a/gcloud/debug/source/help b/gcloud/debug/source/help index bd9180ae1..b1ef991a7 100644 --- a/gcloud/debug/source/help +++ b/gcloud/debug/source/help @@ -6,6 +6,12 @@ SYNOPSIS gcloud debug source COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Commands to manage source information for Cloud Debugger. + + Cloud Debugger is deprecated and will be shutdown May 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + This set of commands allows you to provide Cloud Debugger with source code version information. @@ -18,7 +24,8 @@ COMMANDS COMMAND is one of the following: gen-repo-info-file - Generates repository information files for the Cloud Debugger. + (DEPRECATED) Generates repository information files for the Cloud + Debugger. NOTES This variant is also available: diff --git a/gcloud/debug/targets/help b/gcloud/debug/targets/help index 9246d0820..130a96bbf 100644 --- a/gcloud/debug/targets/help +++ b/gcloud/debug/targets/help @@ -6,6 +6,12 @@ SYNOPSIS gcloud debug targets COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Commands for interacting with Cloud Debugger debug targets. + + Cloud Debugger is deprecated and will be shutdown May 31, 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + Commands to interact with debug targets. A debug target can be an App Engine module version or any other entity enabled for use with the cloud debugger. @@ -24,7 +30,8 @@ COMMANDS COMMAND is one of the following: list - List the debug targets (debuggees) registered with the Cloud Debugger. + (DEPRECATED) List the debug targets (debuggees) registered with the + Cloud Debugger. NOTES This variant is also available: diff --git a/gcloud/debug/targets/list b/gcloud/debug/targets/list index 694c6a4f6..c56674435 100644 --- a/gcloud/debug/targets/list +++ b/gcloud/debug/targets/list @@ -8,6 +8,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May 31, + 2023. + + See: https://cloud.google.com/debugger/docs/deprecations + gcloud debug targets list is used to display a list of the debug targets (debuggees) registered with the Cloud Debugger. By default only the active targets are shown, the --include-inactive can be provided to also include diff --git a/gcloud/dns/record-sets/create b/gcloud/dns/record-sets/create index 7a2621652..169f548a1 100644 --- a/gcloud/dns/record-sets/create +++ b/gcloud/dns/record-sets/create @@ -125,16 +125,18 @@ REQUIRED FLAGS For --routing-policy-type = "GEO" this flag indicates the geo-locations policy data. The field accepts a semicolon-delimited list of the format - "${region}=${rrdata},${rrdata}". Each individual rrdata can - either be an ip address or a string of the format - forwarding_config_name@region. + "${region}=${rrdata},${rrdata}". Each rrdata can either be an IP + address or a reference to a forwarding rule of the format + FORWARDING_RULE_NAME", "FORWARDING_RULE_NAME@region", or the full + resource path of the forwarding rule. Configuration for primary backup routing policy --routing-policy-backup-data=ROUTING_POLICY_BACKUP_DATA - The backup config for a primary backup routing policy. This is - the same format as the routing-policy-data arg as this is just - another geo policy. + The backup configuration for a primary backup routing policy. + This configuration has the same format as the + routing-policy-data argument because it is just another + geo-locations policy. This flag argument must be specified if any of the other arguments in this group are specified. @@ -149,9 +151,10 @@ REQUIRED FLAGS arguments in this group are specified. --routing-policy-primary-data=ROUTING_POLICY_PRIMARY_DATA - The primary config for a primary backup routing policy. This is - just a list of forwarding configs of the format "config_name" - or "config_name@scope" + The primary configuration for a primary backup routing policy. + This configuration is a list of forwarding rules of the format + "FORWARDING_RULE_NAME", "FORWARDING_RULE_NAME@scope", or the + full resource path of the forwarding rule. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/dns/record-sets/update b/gcloud/dns/record-sets/update index 1d05408c9..88a4f3ae8 100644 --- a/gcloud/dns/record-sets/update +++ b/gcloud/dns/record-sets/update @@ -93,16 +93,18 @@ REQUIRED FLAGS For --routing-policy-type = "GEO" this flag indicates the geo-locations policy data. The field accepts a semicolon-delimited list of the format - "${region}=${rrdata},${rrdata}". Each individual rrdata can - either be an ip address or a string of the format - forwarding_config_name@region. + "${region}=${rrdata},${rrdata}". Each rrdata can either be an IP + address or a reference to a forwarding rule of the format + FORWARDING_RULE_NAME", "FORWARDING_RULE_NAME@region", or the full + resource path of the forwarding rule. Configuration for primary backup routing policy --routing-policy-backup-data=ROUTING_POLICY_BACKUP_DATA - The backup config for a primary backup routing policy. This is - the same format as the routing-policy-data arg as this is just - another geo policy. + The backup configuration for a primary backup routing policy. + This configuration has the same format as the + routing-policy-data argument because it is just another + geo-locations policy. This flag argument must be specified if any of the other arguments in this group are specified. @@ -117,9 +119,10 @@ REQUIRED FLAGS arguments in this group are specified. --routing-policy-primary-data=ROUTING_POLICY_PRIMARY_DATA - The primary config for a primary backup routing policy. This is - just a list of forwarding configs of the format "config_name" - or "config_name@scope" + The primary configuration for a primary backup routing policy. + This configuration is a list of forwarding rules of the format + "FORWARDING_RULE_NAME", "FORWARDING_RULE_NAME@scope", or the + full resource path of the forwarding rule. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/edge-cloud/help b/gcloud/edge-cloud/help index faf00b78c..e02f50c90 100644 --- a/gcloud/edge-cloud/help +++ b/gcloud/edge-cloud/help @@ -18,6 +18,9 @@ GROUPS container Manage Edge Container resources. + networking + Manage Distributed Cloud Edge Network resources. + NOTES This variant is also available: diff --git a/gcloud/edge-cloud/networking/help b/gcloud/edge-cloud/networking/help new file mode 100644 index 000000000..0230ac855 --- /dev/null +++ b/gcloud/edge-cloud/networking/help @@ -0,0 +1,42 @@ +NAME + gcloud edge-cloud networking - manage Distributed Cloud Edge Network + resources + +SYNOPSIS + gcloud edge-cloud networking GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Distributed Cloud Edge Network resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + interconnects + Manage Distributed Cloud Edge Network interconnects. + + networks + Manage Distributed Cloud Edge Network networks. + + operations + Command group for working with Distributed Cloud Edge Network + operations. + + routers + Manage Distributed Cloud Edge Network routers. + + subnets + Manage Distributed Cloud Edge Network subnets. + + zones + Manage Distributed Cloud Edge Network zones. + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking + diff --git a/gcloud/edge-cloud/networking/interconnects/attachments/dedicated/create b/gcloud/edge-cloud/networking/interconnects/attachments/dedicated/create new file mode 100644 index 000000000..7683483b1 --- /dev/null +++ b/gcloud/edge-cloud/networking/interconnects/attachments/dedicated/create @@ -0,0 +1,109 @@ +NAME + gcloud edge-cloud networking interconnects attachments dedicated create - + create a Distributed Cloud Edge Network interconnect attachment + +SYNOPSIS + gcloud edge-cloud networking interconnects attachments dedicated create + (INTERCONNECT_ATTACHMENT : --location=LOCATION --zone=ZONE) + --interconnect=INTERCONNECT [--async] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] [--mtu=MTU; default=1500] + [--network=NETWORK] [--vlan-id=VLAN_ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a new dedicated Distributed Cloud Edge Network interconnect + attachment. + +EXAMPLES + To create a dedicated interconnect attachment called 'my-attachment' in + edge zone 'us-central1-edge-den1', run: + + $ gcloud edge-cloud networking interconnects attachments dedicated \ + create my-attachment --location=us-central1 \ + --zone=us-central1-edge-den1 --interconnect=INTERCONNECT-LINK1 \ + --network=my-edge-network --vlan-id=200 --mtu=1500 + +POSITIONAL ARGUMENTS + Interconnect attachment resource - Distributed Cloud Edge Network + interconnectAttachment to create. The arguments in this group can be used + to specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. To set the + project attribute: + ◆ provide the argument interconnect_attachment 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. + + INTERCONNECT_ATTACHMENT + ID of the interconnect attachment or fully qualified identifier for + the interconnect attachment. To set the interconnect_attachment + attribute: + ▸ provide the argument interconnect_attachment on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument interconnect_attachment on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument interconnect_attachment on the command line + with a fully specified name; + ▸ provide the argument --zone on the command line. + +REQUIRED FLAGS + --interconnect=INTERCONNECT + The underlying interconnect object that this attachment's traffic will + traverse through. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + An optional, textual description for the interconnect attachment. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + --mtu=MTU; default=1500 + Maximum transmission unit (MTU) is the size of the largest IP packet + that can be transmitted on this attachment. Default value is 1500 + bytes, and the valid values are 1500 and 9000. + + --network=NETWORK + The network to use for dynamic routing. + + --vlan-id=VLAN_ID + The ID of the vlan to tag the subnetwork. Default value is 0. + +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 edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking interconnects attachments \ + dedicated create + diff --git a/gcloud/edge-cloud/networking/interconnects/attachments/dedicated/help b/gcloud/edge-cloud/networking/interconnects/attachments/dedicated/help new file mode 100644 index 000000000..cca699bdd --- /dev/null +++ b/gcloud/edge-cloud/networking/interconnects/attachments/dedicated/help @@ -0,0 +1,28 @@ +NAME + gcloud edge-cloud networking interconnects attachments dedicated - manage + Distributed Cloud Edge Network dedicated interconnect attachments + +SYNOPSIS + gcloud edge-cloud networking interconnects attachments dedicated COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Distributed Cloud Edge Network dedicated interconnect attachments. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a Distributed Cloud Edge Network interconnect attachment. + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking interconnects attachments \ + dedicated + diff --git a/gcloud/edge-cloud/networking/interconnects/attachments/delete b/gcloud/edge-cloud/networking/interconnects/attachments/delete new file mode 100644 index 000000000..9c75edf7c --- /dev/null +++ b/gcloud/edge-cloud/networking/interconnects/attachments/delete @@ -0,0 +1,77 @@ +NAME + gcloud edge-cloud networking interconnects attachments delete - delete a + Distributed Cloud Edge Network interconnect attachment + +SYNOPSIS + gcloud edge-cloud networking interconnects attachments delete + (INTERCONNECT_ATTACHMENT : --location=LOCATION --zone=ZONE) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a Distributed Cloud Edge Network interconnect attachment. + +EXAMPLES + To delete an interconnect attachment called 'my-attachment' in edge zone + 'us-central1-edge-den1', run: + + $ gcloud edge-cloud networking interconnects attachments delete \ + my-attachment --location=us-central1 \ + --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Interconnect attachment resource - Distributed Cloud Edge Network + interconnectAttachment 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 interconnect_attachment 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. + + INTERCONNECT_ATTACHMENT + ID of the interconnect attachment or fully qualified identifier for + the interconnect attachment. To set the interconnect_attachment + attribute: + ▸ provide the argument interconnect_attachment on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument interconnect_attachment on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument interconnect_attachment on the command line + with a fully specified name; + ▸ provide the argument --zone 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 edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking interconnects attachments delete + diff --git a/gcloud/edge-cloud/networking/interconnects/attachments/describe b/gcloud/edge-cloud/networking/interconnects/attachments/describe new file mode 100644 index 000000000..dff55e6c5 --- /dev/null +++ b/gcloud/edge-cloud/networking/interconnects/attachments/describe @@ -0,0 +1,74 @@ +NAME + gcloud edge-cloud networking interconnects attachments describe - show + details about a Distributed Cloud Edge Network interconnect attachment + +SYNOPSIS + gcloud edge-cloud networking interconnects attachments describe + (INTERCONNECT_ATTACHMENT : --location=LOCATION --zone=ZONE) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details about a Distributed Cloud Edge Network interconnect + attachment. + +EXAMPLES + To show details about an interconnect attachment called 'my-attachment' in + edge zone 'us-central1-edge-den1', run: + + $ gcloud edge-cloud networking interconnects attachments describe \ + my-attachment --location=us-central1 \ + --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Interconnect attachment resource - The interconnect attachment you want to + describe. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument interconnect_attachment 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. + + INTERCONNECT_ATTACHMENT + ID of the interconnect attachment or fully qualified identifier for + the interconnect attachment. To set the interconnect_attachment + attribute: + ▸ provide the argument interconnect_attachment on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument interconnect_attachment on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument interconnect_attachment on the command line + with a fully specified name; + ▸ provide the argument --zone 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 edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking interconnects attachments \ + describe + diff --git a/gcloud/edge-cloud/networking/interconnects/attachments/help b/gcloud/edge-cloud/networking/interconnects/attachments/help new file mode 100644 index 000000000..b502cd07b --- /dev/null +++ b/gcloud/edge-cloud/networking/interconnects/attachments/help @@ -0,0 +1,41 @@ +NAME + gcloud edge-cloud networking interconnects attachments - manage Distributed + Cloud Edge Network interconnect attachments + +SYNOPSIS + gcloud edge-cloud networking interconnects attachments GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Distributed Cloud Edge Network interconnect attachments. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + dedicated + Manage Distributed Cloud Edge Network dedicated interconnect + attachments. + +COMMANDS + COMMAND is one of the following: + + delete + Delete a Distributed Cloud Edge Network interconnect attachment. + + describe + Show details about a Distributed Cloud Edge Network interconnect + attachment. + + list + List Distributed Cloud Edge Network interconnect attachments. + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking interconnects attachments + diff --git a/gcloud/edge-cloud/networking/interconnects/attachments/list b/gcloud/edge-cloud/networking/interconnects/attachments/list new file mode 100644 index 000000000..f1dc771de --- /dev/null +++ b/gcloud/edge-cloud/networking/interconnects/attachments/list @@ -0,0 +1,96 @@ +NAME + gcloud edge-cloud networking interconnects attachments list - list + Distributed Cloud Edge Network interconnect attachments + +SYNOPSIS + gcloud edge-cloud networking interconnects attachments list + (--zone=ZONE : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Distributed Cloud Edge Network interconnect attachments. + +EXAMPLES + To list the interconnect attachments in edge zone 'us-central1-edge-den1', + run: + + $ gcloud edge-cloud networking interconnects attachments list \ + --location=us-central1 --zone=us-central1-edge-den1 + +REQUIRED FLAGS + Zone resource - Parent Distributed Cloud Edge Network zone to list all + contained Distributed Cloud Edge Network interconnect attachments. 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 --zone 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. + + --zone=ZONE + ID of the zone or fully qualified identifier for the zone. To set the + zone attribute: + ▸ provide the argument --zone on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument --zone on the command line with a fully + specified name; + ▸ 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 edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking interconnects attachments list + diff --git a/gcloud/edge-cloud/networking/interconnects/describe b/gcloud/edge-cloud/networking/interconnects/describe new file mode 100644 index 000000000..0685631a6 --- /dev/null +++ b/gcloud/edge-cloud/networking/interconnects/describe @@ -0,0 +1,69 @@ +NAME + gcloud edge-cloud networking interconnects describe - show details about + the Distributed Cloud Edge Network interconnect + +SYNOPSIS + gcloud edge-cloud networking interconnects describe + (INTERCONNECT : --location=LOCATION --zone=ZONE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details about the Distributed Cloud Edge Network interconnect. + +EXAMPLES + To show details about an interconnect called 'my-interconnect1' in edge + zone 'us-central1-edge-den1', run: + + $ gcloud edge-cloud networking interconnects describe \ + my-interconnect1 --location=us-central1 \ + --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Interconnect resource - The interconnect you want to describe. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument interconnect 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. + + INTERCONNECT + ID of the interconnect or fully qualified identifier for the + interconnect. To set the interconnect attribute: + ▸ provide the argument interconnect on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument interconnect on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument interconnect on the command line with a + fully specified name; + ▸ provide the argument --zone 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 edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking interconnects describe + diff --git a/gcloud/edge-cloud/networking/interconnects/get-diagnostics b/gcloud/edge-cloud/networking/interconnects/get-diagnostics new file mode 100644 index 000000000..1640c4686 --- /dev/null +++ b/gcloud/edge-cloud/networking/interconnects/get-diagnostics @@ -0,0 +1,66 @@ +NAME + gcloud edge-cloud networking interconnects get-diagnostics - get the + diagnostics of a specified Distributed Cloud Edge Network interconnect + +SYNOPSIS + gcloud edge-cloud networking interconnects get-diagnostics + (INTERCONNECT : --location=LOCATION --zone=ZONE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get the diagnostics of a specified Distributed Cloud Edge Network + interconnect. + +EXAMPLES + To get the diagnostics of the Distributed Cloud Edge Network interconnect + 'my-interconnect' in edge zone 'us-central1-edge-den1' , run: + + $ gcloud edge-cloud networking interconnects get-diagnostics \ + my-interconnect --location=us-central1 \ + --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Interconnect resource - The interconnect to get diagnostics. 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 interconnect on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + INTERCONNECT + ID of the interconnect or fully qualified identifier for the + interconnect. To set the interconnect attribute: + ▸ provide the argument interconnect on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the interconnect. To set the location + attribute: + ▸ provide the argument interconnect on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The zone of the interconnect. To set the zone attribute: + ▸ provide the argument interconnect on the command line with a + fully specified name; + ▸ provide the argument --zone on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking interconnects get-diagnostics + diff --git a/gcloud/edge-cloud/networking/interconnects/help b/gcloud/edge-cloud/networking/interconnects/help new file mode 100644 index 000000000..4ffba89b1 --- /dev/null +++ b/gcloud/edge-cloud/networking/interconnects/help @@ -0,0 +1,40 @@ +NAME + gcloud edge-cloud networking interconnects - manage Distributed Cloud Edge + Network interconnects + +SYNOPSIS + gcloud edge-cloud networking interconnects GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Distributed Cloud Edge Network interconnects. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + attachments + Manage Distributed Cloud Edge Network interconnect attachments. + +COMMANDS + COMMAND is one of the following: + + describe + Show details about the Distributed Cloud Edge Network interconnect. + + get-diagnostics + Get the diagnostics of a specified Distributed Cloud Edge Network + interconnect. + + list + List Distributed Cloud Edge Network interconnects. + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking interconnects + diff --git a/gcloud/edge-cloud/networking/interconnects/list b/gcloud/edge-cloud/networking/interconnects/list new file mode 100644 index 000000000..a7f8044bc --- /dev/null +++ b/gcloud/edge-cloud/networking/interconnects/list @@ -0,0 +1,96 @@ +NAME + gcloud edge-cloud networking interconnects list - list Distributed Cloud + Edge Network interconnects + +SYNOPSIS + gcloud edge-cloud networking interconnects list + (--zone=ZONE : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Distributed Cloud Edge Network interconnects. + +EXAMPLES + To list the Distributed Cloud Edge Network interconnects in edge zone + 'us-central1-edge-den1', run: + + $ gcloud edge-cloud networking interconnects list \ + --location=us-central1 --zone=us-central1-edge-den1 + +REQUIRED FLAGS + Zone resource - Parent Distributed Cloud Edge Network zone to list all + contained Distributed Cloud Edge Network interconnects. 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 --zone 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. + + --zone=ZONE + ID of the zone or fully qualified identifier for the zone. To set the + zone attribute: + ▸ provide the argument --zone on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument --zone on the command line with a fully + specified name; + ▸ 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 edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking interconnects list + diff --git a/gcloud/edge-cloud/networking/networks/create b/gcloud/edge-cloud/networking/networks/create new file mode 100644 index 000000000..7b58de806 --- /dev/null +++ b/gcloud/edge-cloud/networking/networks/create @@ -0,0 +1,91 @@ +NAME + gcloud edge-cloud networking networks create - create a Distributed Cloud + Edge Network network + +SYNOPSIS + gcloud edge-cloud networking networks create + (NETWORK : --location=LOCATION --zone=ZONE) [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--mtu=MTU] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a new Distributed Cloud Edge Network network resource. + +EXAMPLES + To create a network called 'my-network' with MTU value of 9000 bytes in + edge zone 'us-central1-edge-den1', run: + + $ gcloud edge-cloud networking networks create my-network \ + --location=us-central1 --zone=us-central1-edge-den1 --mtu=9000 + +POSITIONAL ARGUMENTS + Network resource - Distributed Cloud Edge Network network to create. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument network 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. + + NETWORK + ID of the network or fully qualified identifier for the network. To + set the network attribute: + ▸ provide the argument network on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument network on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument network on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + An optional, textual description for the network. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + --mtu=MTU + Maximum transmission unit (MTU) is the size of the largest IP packet + that can be transmitted on this network. Default value is 1500 bytes, + and the valid values are 1500 and 9000. + +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 edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking networks create + diff --git a/gcloud/edge-cloud/networking/networks/delete b/gcloud/edge-cloud/networking/networks/delete new file mode 100644 index 000000000..dc49e02c4 --- /dev/null +++ b/gcloud/edge-cloud/networking/networks/delete @@ -0,0 +1,74 @@ +NAME + gcloud edge-cloud networking networks delete - delete a Distributed Cloud + Edge Network network + +SYNOPSIS + gcloud edge-cloud networking networks delete + (NETWORK : --location=LOCATION --zone=ZONE) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a Distributed Cloud Edge Network network. + +EXAMPLES + To delete a Distributed Cloud Edge Network network called 'my-network' in + edge zone 'us-central1-edge-den1', run: + + $ gcloud edge-cloud networking networks delete my-network \ + --location=us-central1 --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Network resource - Distributed Cloud Edge Network network 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 network 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. + + NETWORK + ID of the network or fully qualified identifier for the network. To + set the network attribute: + ▸ provide the argument network on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument network on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument network on the command line with a fully + specified name; + ▸ provide the argument --zone 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 edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking networks delete + diff --git a/gcloud/edge-cloud/networking/networks/describe b/gcloud/edge-cloud/networking/networks/describe new file mode 100644 index 000000000..b206efa57 --- /dev/null +++ b/gcloud/edge-cloud/networking/networks/describe @@ -0,0 +1,69 @@ +NAME + gcloud edge-cloud networking networks describe - show details about the + Distributed Cloud Edge Network network + +SYNOPSIS + gcloud edge-cloud networking networks describe + (NETWORK : --location=LOCATION --zone=ZONE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details about the Distributed Cloud Edge Network network. + +EXAMPLES + To show details about a network called 'my-network' in edge zone + 'us-central1-edge-den1', run: + + $ gcloud edge-cloud networking networks describe my-network \ + --location=us-central1 --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Network resource - The Distributed Cloud Edge Network network you want to + describe. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument network 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. + + NETWORK + ID of the network or fully qualified identifier for the network. To + set the network attribute: + ▸ provide the argument network on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument network on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument network on the command line with a fully + specified name; + ▸ provide the argument --zone 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 edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking networks describe + diff --git a/gcloud/edge-cloud/networking/networks/get-status b/gcloud/edge-cloud/networking/networks/get-status new file mode 100644 index 000000000..43c414114 --- /dev/null +++ b/gcloud/edge-cloud/networking/networks/get-status @@ -0,0 +1,63 @@ +NAME + gcloud edge-cloud networking networks get-status - get the status of a + specified Distributed Cloud Edge Network network + +SYNOPSIS + gcloud edge-cloud networking networks get-status + (NETWORK : --location=LOCATION --zone=ZONE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get the status of a specified Distributed Cloud Edge Network network. + +EXAMPLES + To get the status of the Distributed Cloud Edge Network network + 'my-network' in edge zone 'us-central1-edge-den1' , run: + + $ gcloud edge-cloud networking networks get-status my-network \ + --location=us-central1 --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Network resource - The network to get status. 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 network on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + NETWORK + ID of the network or fully qualified identifier for the network. To + set the network attribute: + ▸ provide the argument network on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the network. To set the location attribute: + ▸ provide the argument network on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The zone of the network. To set the zone attribute: + ▸ provide the argument network on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking networks get-status + diff --git a/gcloud/edge-cloud/networking/networks/help b/gcloud/edge-cloud/networking/networks/help new file mode 100644 index 000000000..964973062 --- /dev/null +++ b/gcloud/edge-cloud/networking/networks/help @@ -0,0 +1,38 @@ +NAME + gcloud edge-cloud networking networks - manage Distributed Cloud Edge + Network networks + +SYNOPSIS + gcloud edge-cloud networking networks COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Distributed Cloud Edge Network networks. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a Distributed Cloud Edge Network network. + + delete + Delete a Distributed Cloud Edge Network network. + + describe + Show details about the Distributed Cloud Edge Network network. + + get-status + Get the status of a specified Distributed Cloud Edge Network network. + + list + List Distributed Cloud Edge Network networks. + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking networks + diff --git a/gcloud/edge-cloud/networking/networks/list b/gcloud/edge-cloud/networking/networks/list new file mode 100644 index 000000000..096973bca --- /dev/null +++ b/gcloud/edge-cloud/networking/networks/list @@ -0,0 +1,96 @@ +NAME + gcloud edge-cloud networking networks list - list Distributed Cloud Edge + Network networks + +SYNOPSIS + gcloud edge-cloud networking networks list + (--zone=ZONE : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Distributed Cloud Edge Network networks. + +EXAMPLES + To list the Distributed Cloud Edge Network networks in edge zone + 'us-central1-edge-den1', run: + + $ gcloud edge-cloud networking networks list \ + --location=us-central1 --zone=us-central1-edge-den1 + +REQUIRED FLAGS + Zone resource - Parent Distributed Cloud Edge Network zone to list all + contained Distributed Cloud Edge Network networks. 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 --zone 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. + + --zone=ZONE + ID of the zone or fully qualified identifier for the zone. To set the + zone attribute: + ▸ provide the argument --zone on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument --zone on the command line with a fully + specified name; + ▸ 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 edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking networks list + diff --git a/gcloud/edge-cloud/networking/operations/describe b/gcloud/edge-cloud/networking/operations/describe new file mode 100644 index 000000000..bba2dbe9d --- /dev/null +++ b/gcloud/edge-cloud/networking/operations/describe @@ -0,0 +1,62 @@ +NAME + gcloud edge-cloud networking operations describe - get description of a + long-running edge network operation + +SYNOPSIS + gcloud edge-cloud networking operations describe + (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get information about a long-running edge network operation. + +EXAMPLES + To get information about a long-running operation with name + 'projects/my-project/locations/us-east1/operations/123', run the following + command: + + $ gcloud edge-cloud networking operations describe \ + projects/my-project/locations/us-east1/operations/123 + +POSITIONAL ARGUMENTS + Operation resource - The ID of the operation to describe. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. To set the project attribute: + ◆ provide the argument operation 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. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument operation 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 edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking operations describe + diff --git a/gcloud/edge-cloud/networking/operations/help b/gcloud/edge-cloud/networking/operations/help new file mode 100644 index 000000000..63110f515 --- /dev/null +++ b/gcloud/edge-cloud/networking/operations/help @@ -0,0 +1,29 @@ +NAME + gcloud edge-cloud networking operations - command group for working with + Distributed Cloud Edge Network operations + +SYNOPSIS + gcloud edge-cloud networking operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Command group for working with Distributed Cloud Edge Network operations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Get description of a long-running edge network operation. + + wait + Poll long-running edge network operation until it completes. + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking operations + diff --git a/gcloud/edge-cloud/networking/operations/wait b/gcloud/edge-cloud/networking/operations/wait new file mode 100644 index 000000000..81cbf3004 --- /dev/null +++ b/gcloud/edge-cloud/networking/operations/wait @@ -0,0 +1,64 @@ +NAME + gcloud edge-cloud networking operations wait - poll long-running edge + network operation until it completes + +SYNOPSIS + gcloud edge-cloud networking operations wait + (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Poll a long-running edge network operation until it completes. When the + operation is complete, this command will display the results of the + analysis. + +EXAMPLES + To poll a long-running edge network operation named + 'projects/my-project/locations/us-east1/operations/123' until it completes, + run the following: + + $ gcloud edge-cloud networking operations wait \ + projects/my-project/locations/us-east1/operations/123 + +POSITIONAL ARGUMENTS + Operation resource - ID for the operation to poll until complete. 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 operation 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. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument operation 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 edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking operations wait + diff --git a/gcloud/edge-cloud/networking/routers/add-bgp-peer b/gcloud/edge-cloud/networking/routers/add-bgp-peer new file mode 100644 index 000000000..3c107b9ec --- /dev/null +++ b/gcloud/edge-cloud/networking/routers/add-bgp-peer @@ -0,0 +1,87 @@ +NAME + gcloud edge-cloud networking routers add-bgp-peer - add a BGP peer to a + Distributed Cloud Edge Network router + +SYNOPSIS + gcloud edge-cloud networking routers add-bgp-peer + (ROUTER : --location=LOCATION --zone=ZONE) --interface=INTERFACE + --peer-asn=PEER_ASN --peer-ipv4-range=PEER_IPV4_RANGE + --peer-name=PEER_NAME [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a BGP peer to a Distributed Cloud Edge Network router + +EXAMPLES + To create and add a BGP peer for the Distributed Cloud Edge Network router + 'my-router' in edge zone 'us-central1-edge-den1' , run: + + $ gcloud edge-cloud networking routers add-bgp-peer my-router \ + --interface=my-int-r1 --peer-asn=33333 --peer-name=peer1 \ + --peer-ipv4-range=208.117.254.232/31 --location=us-central1 \ + --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Router resource - The router to which we add a bgp peer. 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 router on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + ROUTER + ID of the router or fully qualified identifier for the router. To set + the router attribute: + ▸ provide the argument router on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the router. To set the location attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The zone of the router. To set the zone attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +REQUIRED FLAGS + --interface=INTERFACE + The name of the interface for this BGP peer. + + --peer-asn=PEER_ASN + The BGP autonomous system number (ASN) for this BGP peer. Must be a + 16-bit or 32-bit private ASN as defined in + https://tools.ietf.org/html/rfc6996, for example --asn=64512. + + --peer-ipv4-range=PEER_IPV4_RANGE + The link-local address range of the peer router. + + --peer-name=PEER_NAME + The name of the new BGP peer being added. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking routers add-bgp-peer + diff --git a/gcloud/edge-cloud/networking/routers/add-interface b/gcloud/edge-cloud/networking/routers/add-interface new file mode 100644 index 000000000..2ffe5e553 --- /dev/null +++ b/gcloud/edge-cloud/networking/routers/add-interface @@ -0,0 +1,115 @@ +NAME + gcloud edge-cloud networking routers add-interface - add an interface to a + Distributed Cloud Edge Network router + +SYNOPSIS + gcloud edge-cloud networking routers add-interface + (ROUTER : --location=LOCATION --zone=ZONE) + --interface-name=INTERFACE_NAME + (--loopback-ip-addresses=[LOOPBACK_IP_ADDRESSES,...] + | --subnetwork=SUBNETWORK + | --interconnect-attachment=INTERCONNECT_ATTACHMENT + --ip-address=IP_ADDRESS --ip-mask-length=IP_MASK_LENGTH) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create an interface to a Distributed Cloud Edge Network router. + +EXAMPLES + To create and add a northbound interface for Distributed Cloud Edge Network + router 'my-router' in edge zone 'us-central1-edge-den1' , run: + + $ gcloud edge-cloud networking routers add-interface my-router \ + --interface-name=my-int-r1 \ + --interconnect-attachment=my-link-attachment \ + --ip-address=208.117.254.233 --ip-mask-length=31 \ + --location=us-central1 --zone=us-central1-edge-den1 + + To create and add a southbound interface for Distributed Cloud Edge Network + router 'my-router' in edge zone 'us-central1-edge-den1', run: + + $ gcloud edge-cloud networking routers add-interface my-router \ + --interface-name=my-int-r2 --subnetwork=my-subnet \ + --location=us-central1 --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Router resource - The router to which we add an interface. 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 router on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + ROUTER + ID of the router or fully qualified identifier for the router. To set + the router attribute: + ▸ provide the argument router on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the router. To set the location attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The zone of the router. To set the zone attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +REQUIRED FLAGS + --interface-name=INTERFACE_NAME + The name of the interface being added. + + The argument group for configuring the interface for the router. + + Exactly one of these must be specified: + + The argument group for adding loopback interfaces to edge router. + + --loopback-ip-addresses=[LOOPBACK_IP_ADDRESSES,...] + The list of ip ranges for the loopback interface. + + The argument group for adding southbound interfaces to edge router. + + --subnetwork=SUBNETWORK + The subnetwork of the interface being added. + + The argument group for adding northbound interfaces to edge router. + + --interconnect-attachment=INTERCONNECT_ATTACHMENT + The interconnect attachment of the interface being added. + + --ip-address=IP_ADDRESS + The link local address of the router for this interface. + + --ip-mask-length=IP_MASK_LENGTH + The subnet mask for the link-local IP range of the interface. The + interface IP address and BGP peer IP address must be selected from + the subnet defined by this link-local range. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking routers add-interface + diff --git a/gcloud/edge-cloud/networking/routers/create b/gcloud/edge-cloud/networking/routers/create new file mode 100644 index 000000000..8f762d99f --- /dev/null +++ b/gcloud/edge-cloud/networking/routers/create @@ -0,0 +1,94 @@ +NAME + gcloud edge-cloud networking routers create - create a Distributed Cloud + Edge Network router + +SYNOPSIS + gcloud edge-cloud networking routers create + (ROUTER : --location=LOCATION --zone=ZONE) --asn=ASN --network=NETWORK + [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a new Distributed Cloud Edge Network router. + +EXAMPLES + To create a router called 'my-router' with asn 65555 in edge zone + 'us-central1-edge-den1', run: + + $ gcloud edge-cloud networking routers create my-router \ + --network=my-network --location=us-central1 \ + --zone=us-central1-edge-den1 --asn=65555 + +POSITIONAL ARGUMENTS + Router resource - Distributed Cloud Edge Network router to create. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument router 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. + + ROUTER + ID of the router or fully qualified identifier for the router. To set + the router attribute: + ▸ provide the argument router on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +REQUIRED FLAGS + --asn=ASN + The locally assigned BGP ASN. + + --network=NETWORK + The network that this subnetwork belongs to. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + An optional, textual description for the router. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking routers create + diff --git a/gcloud/edge-cloud/networking/routers/delete b/gcloud/edge-cloud/networking/routers/delete new file mode 100644 index 000000000..e9ff19ed6 --- /dev/null +++ b/gcloud/edge-cloud/networking/routers/delete @@ -0,0 +1,74 @@ +NAME + gcloud edge-cloud networking routers delete - delete a Distributed Cloud + Edge Network router + +SYNOPSIS + gcloud edge-cloud networking routers delete + (ROUTER : --location=LOCATION --zone=ZONE) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a Distributed Cloud Edge Network router. + +EXAMPLES + To delete a router called 'my-router' in edge zone 'us-central1-edge-den1', + run: + + $ gcloud edge-cloud networking routers delete my-router \ + --location=us-central1 --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Router resource - Distributed Cloud Edge Network router 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 router 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. + + ROUTER + ID of the router or fully qualified identifier for the router. To set + the router attribute: + ▸ provide the argument router on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --zone 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 edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking routers delete + diff --git a/gcloud/edge-cloud/networking/routers/describe b/gcloud/edge-cloud/networking/routers/describe new file mode 100644 index 000000000..56d65b8d9 --- /dev/null +++ b/gcloud/edge-cloud/networking/routers/describe @@ -0,0 +1,68 @@ +NAME + gcloud edge-cloud networking routers describe - show details about the + Distributed Cloud Edge Network router + +SYNOPSIS + gcloud edge-cloud networking routers describe + (ROUTER : --location=LOCATION --zone=ZONE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details about the Distributed Cloud Edge Network router. + +EXAMPLES + To show details about a router named 'my-router' in edge zone + 'us-central1-edge-den1', run: + + $ gcloud edge-cloud networking routers describe my-router \ + --location=us-central1 --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Router resource - The router you want to describe. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. To set the project attribute: + ◆ provide the argument router 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. + + ROUTER + ID of the router or fully qualified identifier for the router. To set + the router attribute: + ▸ provide the argument router on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --zone 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 edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking routers describe + diff --git a/gcloud/edge-cloud/networking/routers/get-status b/gcloud/edge-cloud/networking/routers/get-status new file mode 100644 index 000000000..e60785e98 --- /dev/null +++ b/gcloud/edge-cloud/networking/routers/get-status @@ -0,0 +1,63 @@ +NAME + gcloud edge-cloud networking routers get-status - get the status of a + specified Distributed Cloud Edge Network router + +SYNOPSIS + gcloud edge-cloud networking routers get-status + (ROUTER : --location=LOCATION --zone=ZONE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get the status of a specified Distributed Cloud Edge Network router. + +EXAMPLES + To get the status of the Distributed Cloud Edge Network router 'my-router' + in edge zone 'us-central1-edge-den1' , run: + + $ gcloud edge-cloud networking routers get-status my-router \ + --location=us-central1 --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Router resource - The router to get status. 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 router on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + ROUTER + ID of the router or fully qualified identifier for the router. To set + the router attribute: + ▸ provide the argument router on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the router. To set the location attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The zone of the router. To set the zone attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking routers get-status + diff --git a/gcloud/edge-cloud/networking/routers/help b/gcloud/edge-cloud/networking/routers/help new file mode 100644 index 000000000..72f246951 --- /dev/null +++ b/gcloud/edge-cloud/networking/routers/help @@ -0,0 +1,50 @@ +NAME + gcloud edge-cloud networking routers - manage Distributed Cloud Edge + Network routers + +SYNOPSIS + gcloud edge-cloud networking routers COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Distributed Cloud Edge Network routers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + add-bgp-peer + Add a BGP peer to a Distributed Cloud Edge Network router. + + add-interface + Add an interface to a Distributed Cloud Edge Network router. + + create + Create a Distributed Cloud Edge Network router. + + delete + Delete a Distributed Cloud Edge Network router. + + describe + Show details about the Distributed Cloud Edge Network router. + + get-status + Get the status of a specified Distributed Cloud Edge Network router. + + list + List Distributed Cloud Edge Network routers. + + remove-bgp-peer + Remove a BGP peer from a Distributed Cloud Edge Network router. + + remove-interface + remove an interface on a Distributed Cloud Edge Network router. + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking routers + diff --git a/gcloud/edge-cloud/networking/routers/list b/gcloud/edge-cloud/networking/routers/list new file mode 100644 index 000000000..41492c21b --- /dev/null +++ b/gcloud/edge-cloud/networking/routers/list @@ -0,0 +1,95 @@ +NAME + gcloud edge-cloud networking routers list - list Distributed Cloud Edge + Network routers + +SYNOPSIS + gcloud edge-cloud networking routers list + (--zone=ZONE : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Distributed Cloud Edge Network routers. + +EXAMPLES + To list the routers in edge zone 'us-central1-edge-den1', run: + + $ gcloud edge-cloud networking routers list --location=us-central1 \ + --zone=us-central1-edge-den1 + +REQUIRED FLAGS + Zone resource - Parent Distributed Cloud Edge Network zone to list all + contained Distributed Cloud Edge Network routers. 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 --zone 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. + + --zone=ZONE + ID of the zone or fully qualified identifier for the zone. To set the + zone attribute: + ▸ provide the argument --zone on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument --zone on the command line with a fully + specified name; + ▸ 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 edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking routers list + diff --git a/gcloud/edge-cloud/networking/routers/remove-bgp-peer b/gcloud/edge-cloud/networking/routers/remove-bgp-peer new file mode 100644 index 000000000..3874d2140 --- /dev/null +++ b/gcloud/edge-cloud/networking/routers/remove-bgp-peer @@ -0,0 +1,81 @@ +NAME + gcloud edge-cloud networking routers remove-bgp-peer - remove a BGP peer + from a Distributed Cloud Edge Network router + +SYNOPSIS + gcloud edge-cloud networking routers remove-bgp-peer + (ROUTER : --location=LOCATION --zone=ZONE) + (--peer-name=PEER_NAME | --peer-names=[PEER_NAME,...]) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a list of BGP peer from a Distributed Cloud Edge Network router + +EXAMPLES + To delete a BGP peer 'peer1' from the Distributed Cloud Edge Network router + 'my-router' in edge zone 'us-central1-edge-den1' , run: + + $ gcloud edge-cloud networking routers remove-bgp-peer my-router \ + --peer-name=peer1 --location=us-central1 \ + --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Router resource - The router from which we delete a BGP peer. 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 router on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + ROUTER + ID of the router or fully qualified identifier for the router. To set + the router attribute: + ▸ provide the argument router on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the router. To set the location attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The zone of the router. To set the zone attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +REQUIRED FLAGS + Exactly one of these must be specified: + + --peer-name=PEER_NAME + The name of the BGP peer being removed. + + --peer-names=[PEER_NAME,...] + The list of names for peers being removed. Only single value allowed + currently. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking routers remove-bgp-peer + diff --git a/gcloud/edge-cloud/networking/routers/remove-interface b/gcloud/edge-cloud/networking/routers/remove-interface new file mode 100644 index 000000000..8fe95044a --- /dev/null +++ b/gcloud/edge-cloud/networking/routers/remove-interface @@ -0,0 +1,81 @@ +NAME + gcloud edge-cloud networking routers remove-interface - remove an interface + on a Distributed Cloud Edge Network router + +SYNOPSIS + gcloud edge-cloud networking routers remove-interface + (ROUTER : --location=LOCATION --zone=ZONE) + (--interface-name=INTERFACE_NAME + | --interface-names=[INTERFACE_NAME,...]) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Remove an interface on a Distributed Cloud Edge Network router. + +EXAMPLES + To remove the interface 'my-int-r1' on Distributed Cloud Edge Network + router 'my-router' in edge zone 'us-central1-edge-den1' , run: + + $ gcloud edge-cloud networking routers remove-interface my-router \ + --interface-name=my-int-r1 --location=us-central1 \ + --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Router resource - The router from which we remove an interface. 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 router on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + ROUTER + ID of the router or fully qualified identifier for the router. To set + the router attribute: + ▸ provide the argument router on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the router. To set the location attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The zone of the router. To set the zone attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +REQUIRED FLAGS + Exactly one of these must be specified: + + --interface-name=INTERFACE_NAME + The name of the interface being removed. + + --interface-names=[INTERFACE_NAME,...] + The list of names for interfaces being removed. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking routers remove-interface + diff --git a/gcloud/edge-cloud/networking/subnets/create b/gcloud/edge-cloud/networking/subnets/create new file mode 100644 index 000000000..5dc48d8a2 --- /dev/null +++ b/gcloud/edge-cloud/networking/subnets/create @@ -0,0 +1,107 @@ +NAME + gcloud edge-cloud networking subnets create - create a Distributed Cloud + Edge Network subnet + +SYNOPSIS + gcloud edge-cloud networking subnets create + (SUBNET : --location=LOCATION --zone=ZONE) + --ipv4-range=[IPV4_RANGE,...] --network=NETWORK [--async] + [--description=DESCRIPTION] [--ipv6-range=[IPV6_RANGE,...]] + [--labels=[KEY=VALUE,...]] [--vlan-id=VLAN_ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a new Distributed Cloud Edge Network subnet. + +EXAMPLES + To create a Distributed Cloud Edge Network subnet called 'my-subnet' with + vlan id and owned ip ranges specified in the edge zone + 'us-central1-edge-den1', run: + + $ gcloud edge-cloud networking subnets create my-subnet \ + --network=my-network --location=us-central1 \ + --zone=us-central1-edge-den1 \ + --ipv4-range=192.168.1.1/24,172.10.10.1/24 \ + --ipv6-range=2001:db8::1/64,4001:230::1/64 --vlan-id=100 + +POSITIONAL ARGUMENTS + Subnet resource - Distributed Cloud Edge Network subnet to create. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument subnet 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. + + SUBNET + ID of the subnet or fully qualified identifier for the subnet. To set + the subnet attribute: + ▸ provide the argument subnet on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument subnet on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument subnet on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +REQUIRED FLAGS + --ipv4-range=[IPV4_RANGE,...] + The ranges of ipv4 addresses that are owned by this subnetwork in CIDR + format. + + --network=NETWORK + The network that this subnetwork belongs to. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + An optional, textual description for the subnet. + + --ipv6-range=[IPV6_RANGE,...] + The ranges of ipv6 addresses that are owned by this subnetwork in CIDR + format. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + --vlan-id=VLAN_ID + The ID of the vlan to tag the subnetwork. If not specified we assign + one automatically. + +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 edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking subnets create + diff --git a/gcloud/edge-cloud/networking/subnets/delete b/gcloud/edge-cloud/networking/subnets/delete new file mode 100644 index 000000000..d61f1e255 --- /dev/null +++ b/gcloud/edge-cloud/networking/subnets/delete @@ -0,0 +1,74 @@ +NAME + gcloud edge-cloud networking subnets delete - delete a Distributed Cloud + Edge Network subnet + +SYNOPSIS + gcloud edge-cloud networking subnets delete + (SUBNET : --location=LOCATION --zone=ZONE) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a Distributed Cloud Edge Network subnet. + +EXAMPLES + To delete a subnet called 'my-subnet' in the edge zone + 'us-central1-edge-den1', run: + + $ gcloud edge-cloud networking subnets delete my-subnet \ + --location=us-central1 --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Subnet resource - Distributed Cloud Edge Network subnet 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 subnet 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. + + SUBNET + ID of the subnet or fully qualified identifier for the subnet. To set + the subnet attribute: + ▸ provide the argument subnet on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument subnet on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument subnet on the command line with a fully + specified name; + ▸ provide the argument --zone 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 edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking subnets delete + diff --git a/gcloud/edge-cloud/networking/subnets/describe b/gcloud/edge-cloud/networking/subnets/describe new file mode 100644 index 000000000..03aa02005 --- /dev/null +++ b/gcloud/edge-cloud/networking/subnets/describe @@ -0,0 +1,68 @@ +NAME + gcloud edge-cloud networking subnets describe - show details about the + Distributed Cloud Edge Network subnet + +SYNOPSIS + gcloud edge-cloud networking subnets describe + (SUBNET : --location=LOCATION --zone=ZONE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details about the Distributed Cloud Edge Network subnet. + +EXAMPLES + To show details about a subnet named 'my-subnet' in the edge zone + 'us-central1-edge-den1', run: + + $ gcloud edge-cloud networking subnets describe my-subnet \ + --location=us-central1 --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Subnet resource - The subnet you want to describe. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. To set the project attribute: + ◆ provide the argument subnet 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. + + SUBNET + ID of the subnet or fully qualified identifier for the subnet. To set + the subnet attribute: + ▸ provide the argument subnet on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument subnet on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument subnet on the command line with a fully + specified name; + ▸ provide the argument --zone 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 edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking subnets describe + diff --git a/gcloud/edge-cloud/networking/subnets/help b/gcloud/edge-cloud/networking/subnets/help new file mode 100644 index 000000000..0c1f9ca6e --- /dev/null +++ b/gcloud/edge-cloud/networking/subnets/help @@ -0,0 +1,35 @@ +NAME + gcloud edge-cloud networking subnets - manage Distributed Cloud Edge + Network subnets + +SYNOPSIS + gcloud edge-cloud networking subnets COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Distributed Cloud Edge Network subnets. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a Distributed Cloud Edge Network subnet. + + delete + Delete a Distributed Cloud Edge Network subnet. + + describe + Show details about the Distributed Cloud Edge Network subnet. + + list + List Distributed Cloud Edge Network subnets. + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking subnets + diff --git a/gcloud/edge-cloud/networking/subnets/list b/gcloud/edge-cloud/networking/subnets/list new file mode 100644 index 000000000..cde2806dc --- /dev/null +++ b/gcloud/edge-cloud/networking/subnets/list @@ -0,0 +1,95 @@ +NAME + gcloud edge-cloud networking subnets list - list Distributed Cloud Edge + Network subnets + +SYNOPSIS + gcloud edge-cloud networking subnets list + (--zone=ZONE : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Distributed Cloud Edge Network subnets. + +EXAMPLES + To list the subnets in the edge zone 'us-central1-edge-den1', run: + + $ gcloud edge-cloud networking subnets list --location=us-central1 \ + --zone=us-central1-edge-den1 + +REQUIRED FLAGS + Zone resource - Parent Distributed Cloud Edge Network zone to list all + contained Distributed Cloud Edge Network subnets. 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 --zone 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. + + --zone=ZONE + ID of the zone or fully qualified identifier for the zone. To set the + zone attribute: + ▸ provide the argument --zone on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument --zone on the command line with a fully + specified name; + ▸ 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 edgenetwork/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/distributed-cloud-edge/docs + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking subnets list + diff --git a/gcloud/edge-cloud/networking/zones/help b/gcloud/edge-cloud/networking/zones/help new file mode 100644 index 000000000..5b8cb0279 --- /dev/null +++ b/gcloud/edge-cloud/networking/zones/help @@ -0,0 +1,26 @@ +NAME + gcloud edge-cloud networking zones - manage Distributed Cloud Edge Network + zones + +SYNOPSIS + gcloud edge-cloud networking zones COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Distributed Cloud Edge Network zones. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + init + Initialize a specified Distributed Cloud Edge Network zone. + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking zones + diff --git a/gcloud/edge-cloud/networking/zones/init b/gcloud/edge-cloud/networking/zones/init new file mode 100644 index 000000000..d70fd0a2d --- /dev/null +++ b/gcloud/edge-cloud/networking/zones/init @@ -0,0 +1,57 @@ +NAME + gcloud edge-cloud networking zones init - initialize a specified + Distributed Cloud Edge Network zone + +SYNOPSIS + gcloud edge-cloud networking zones init (ZONE : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Initialize a specified Distributed Cloud Edge Network zone. + +EXAMPLES + To initialize a Distributed Cloud Edge Network zone called + 'us-central1-edge-den1', run: + + $ gcloud edge-cloud networking zones init us-central1-edge-den1 \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Zone resource - The zone to initialize. 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 zone on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + ZONE + ID of the zone or fully qualified identifier for the zone. To set the + zone attribute: + ▸ provide the argument zone on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the zone. To set the location attribute: + ▸ provide the argument zone 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. + +NOTES + This variant is also available: + + $ gcloud alpha edge-cloud networking zones init + diff --git a/gcloud/eventarc/channels/create b/gcloud/eventarc/channels/create index 0b2ad9916..9854ab18c 100644 --- a/gcloud/eventarc/channels/create +++ b/gcloud/eventarc/channels/create @@ -2,9 +2,8 @@ NAME gcloud eventarc channels create - create an Eventarc channel SYNOPSIS - gcloud eventarc channels create (CHANNEL : --location=LOCATION) - --provider=PROVIDER [--async] [--crypto-key=CRYPTO_KEY] - [GCLOUD_WIDE_FLAG ...] + gcloud eventarc channels create (CHANNEL : --location=LOCATION) [--async] + [--crypto-key=CRYPTO_KEY] [--provider=PROVIDER] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create an Eventarc channel. @@ -52,6 +51,15 @@ POSITIONAL ARGUMENTS ▸ set the property eventarc/location. FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --crypto-key=CRYPTO_KEY + Fully qualified name of the crypto key to use for customer-managed + encryption. If this is unspecified, Google-managed keys will be used + for encryption. + Provider resource - Provider to use for the channel. 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: @@ -69,15 +77,6 @@ FLAGS set the provider attribute: ▸ provide the argument --provider on the command line. - --async - Return immediately, without waiting for the operation in progress to - complete. - - --crypto-key=CRYPTO_KEY - Fully qualified name of the crypto key to use for customer-managed - encryption. If this is unspecified, Google-managed keys will be used - for encryption. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/eventarc/triggers/create b/gcloud/eventarc/triggers/create index be465c809..8d2c6bf6b 100644 --- a/gcloud/eventarc/triggers/create +++ b/gcloud/eventarc/triggers/create @@ -11,10 +11,11 @@ SYNOPSIS --destination-gke-path=DESTINATION_GKE_PATH] | [--destination-run-service=DESTINATION_RUN_SERVICE : --destination-run-path=DESTINATION_RUN_PATH - --destination-run-region=DESTINATION_RUN_REGION]) --channel=CHANNEL - --transport-topic=TRANSPORT_TOPIC [--async] + --destination-run-region=DESTINATION_RUN_REGION]) [--async] + [--channel=CHANNEL] [--event-filters-path-pattern=[ATTRIBUTE=PATH_PATTERN,...]] - [--service-account=SERVICE_ACCOUNT] [GCLOUD_WIDE_FLAG ...] + [--service-account=SERVICE_ACCOUNT] [--transport-topic=TRANSPORT_TOPIC] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create an Eventarc trigger. @@ -120,6 +121,10 @@ REQUIRED FLAGS as the trigger. OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + Channel resource - The channel to use in the trigger. The channel is needed only if trigger is created for a third-party provider. This represents a Cloud resource. (NOTE) Some attributes are not given @@ -139,6 +144,16 @@ OPTIONAL FLAGS set the channel attribute: ▸ provide the argument --channel on the command line. + --event-filters-path-pattern=[ATTRIBUTE=PATH_PATTERN,...] + The trigger's list of filters in path pattern format that apply to + CloudEvent attributes. This flag can be repeated to add more filters to + the list. Only events that match all these filters will be sent to the + destination. Currently, path pattern format is only available for the + resourceName attribute for Cloud Audit Log events. + + --service-account=SERVICE_ACCOUNT + The IAM service account email associated with the trigger. + Pub/Sub topic resource - The Cloud Pub/Sub topic to use for the trigger's transport intermediary. This feature is currently only available for triggers of event type google.cloud.pubsub.topic.v1.messagePublished. The @@ -156,20 +171,6 @@ OPTIONAL FLAGS topic. To set the transport-topic attribute: ▸ provide the argument --transport-topic on the command line. - --async - Return immediately, without waiting for the operation in progress to - complete. - - --event-filters-path-pattern=[ATTRIBUTE=PATH_PATTERN,...] - The trigger's list of filters in path pattern format that apply to - CloudEvent attributes. This flag can be repeated to add more filters to - the list. Only events that match all these filters will be sent to the - destination. Currently, path pattern format is only available for the - resourceName attribute for Cloud Audit Log events. - - --service-account=SERVICE_ACCOUNT - The IAM service account email associated with the trigger. - 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/filestore/instances/create b/gcloud/filestore/instances/create index c4e9e6617..4a6d9df1c 100644 --- a/gcloud/filestore/instances/create +++ b/gcloud/filestore/instances/create @@ -239,13 +239,15 @@ OPTIONAL FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/firestore/indexes/composite/create b/gcloud/firestore/indexes/composite/create index 77d6e364e..1fca7f606 100644 --- a/gcloud/firestore/indexes/composite/create +++ b/gcloud/firestore/indexes/composite/create @@ -3,7 +3,9 @@ NAME SYNOPSIS gcloud firestore indexes composite create --field-config=FIELD_CONFIG - (--collection-group=COLLECTION_GROUP : --database=DATABASE) [--async] + (--collection-group=COLLECTION_GROUP : --database=DATABASE) + [--api-scope=API_SCOPE; default="any-api"] [--async] + [--query-scope=QUERY_SCOPE; default="collection"] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -80,10 +82,18 @@ REQUIRED FLAGS ▸ the default value of argument [--database] is (default). OPTIONAL FLAGS + --api-scope=API_SCOPE; default="any-api" + Api scope the index applies to. API_SCOPE must be one of: any-api, + datastore-mode-api. + --async Return immediately, without waiting for the operation in progress to complete. + --query-scope=QUERY_SCOPE; default="collection" + Query scope the index applies to. QUERY_SCOPE must be one of: + collection, collection-group, collection-recursive. + 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/kms/ekm-connections/create b/gcloud/kms/ekm-connections/create index 6f01a47b6..d2b97b5c3 100644 --- a/gcloud/kms/ekm-connections/create +++ b/gcloud/kms/ekm-connections/create @@ -40,7 +40,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --location=LOCATION - The Cloud location for the ekmconnection. To set the location + The Google Cloud location for the ekmconnection. To set the location attribute: ▸ provide the argument ekm_connection on the command line with a fully specified name; diff --git a/gcloud/kms/ekm-connections/describe b/gcloud/kms/ekm-connections/describe index c1f62b0d5..9e1823dfa 100644 --- a/gcloud/kms/ekm-connections/describe +++ b/gcloud/kms/ekm-connections/describe @@ -34,7 +34,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --location=LOCATION - The Cloud location for the ekmconnection. To set the location + The Google Cloud location for the ekmconnection. To set the location attribute: ▸ provide the argument ekm_connection on the command line with a fully specified name; diff --git a/gcloud/kms/ekm-connections/update b/gcloud/kms/ekm-connections/update index 89372f80a..76c044450 100644 --- a/gcloud/kms/ekm-connections/update +++ b/gcloud/kms/ekm-connections/update @@ -48,7 +48,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --location=LOCATION - The Cloud location for the ekmconnection. To set the location + The Google Cloud location for the ekmconnection. To set the location attribute: ▸ provide the argument ekm_connection on the command line with a fully specified name; diff --git a/gcloud/kms/keyrings/create b/gcloud/kms/keyrings/create index 9fe264266..303ca4a14 100644 --- a/gcloud/kms/keyrings/create +++ b/gcloud/kms/keyrings/create @@ -28,7 +28,8 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --location=LOCATION - The Cloud location for the keyring. To set the location attribute: + The Google Cloud location for the keyring. To set the location + attribute: ▸ provide the argument keyring on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/kms/keyrings/describe b/gcloud/kms/keyrings/describe index 214347a12..27745e351 100644 --- a/gcloud/kms/keyrings/describe +++ b/gcloud/kms/keyrings/describe @@ -34,7 +34,8 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --location=LOCATION - The Cloud location for the keyring. To set the location attribute: + The Google Cloud location for the keyring. To set the location + attribute: ▸ provide the argument keyring on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/kms/keys/create b/gcloud/kms/keys/create index dc4055051..bc454db39 100644 --- a/gcloud/kms/keys/create +++ b/gcloud/kms/keys/create @@ -139,7 +139,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --keyring on the command line. --location=LOCATION - The Cloud location for the key. To set the location attribute: + The Google Cloud location for the key. To set the location attribute: ▸ provide the argument key on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/kms/keys/describe b/gcloud/kms/keys/describe index f5531ecd3..45a986a51 100644 --- a/gcloud/kms/keys/describe +++ b/gcloud/kms/keys/describe @@ -41,7 +41,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --keyring on the command line. --location=LOCATION - The Cloud location for the key. To set the location attribute: + The Google Cloud location for the key. To set the location attribute: ▸ provide the argument key on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/kms/keys/get-iam-policy b/gcloud/kms/keys/get-iam-policy index 6b0e7bd54..47f15c09d 100644 --- a/gcloud/kms/keys/get-iam-policy +++ b/gcloud/kms/keys/get-iam-policy @@ -2,9 +2,10 @@ NAME gcloud kms keys get-iam-policy - get the IAM policy for a key SYNOPSIS - gcloud kms keys get-iam-policy KEY [--keyring=KEYRING] - [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + gcloud kms keys get-iam-policy + (KEY : --keyring=KEYRING --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Gets the IAM policy for the given key. @@ -19,15 +20,35 @@ EXAMPLES --location=global POSITIONAL ARGUMENTS - KEY - Name of the key whose IAM policy to fetch. + Key resource - The KMS key resource. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument key on the command line with a fully specified + name; + ◆ set the property core/project. -FLAGS - --keyring=KEYRING - Key ring of the key. + This must be specified. - --location=LOCATION - Location of the key. + KEY + ID of the key or fully qualified identifier for the key. To set the + key attribute: + ▸ provide the argument key on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --keyring=KEYRING + The KMS keyring of the key. To set the keyring attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --keyring on the command line. + + --location=LOCATION + The Google Cloud location for the key. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/kms/keys/list b/gcloud/kms/keys/list index 2a73be95a..06accc292 100644 --- a/gcloud/kms/keys/list +++ b/gcloud/kms/keys/list @@ -35,7 +35,8 @@ REQUIRED FLAGS this group are specified. --location=LOCATION - The Cloud location for the keyring. To set the location attribute: + The Google Cloud location for the keyring. To set the location + attribute: ▸ provide the argument --keyring on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/kms/keys/remove-rotation-schedule b/gcloud/kms/keys/remove-rotation-schedule index c85b05f48..0a7d6e3bc 100644 --- a/gcloud/kms/keys/remove-rotation-schedule +++ b/gcloud/kms/keys/remove-rotation-schedule @@ -3,8 +3,8 @@ NAME a key SYNOPSIS - gcloud kms keys remove-rotation-schedule KEY [--keyring=KEYRING] - [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + gcloud kms keys remove-rotation-schedule + (KEY : --keyring=KEYRING --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION Removes the rotation schedule for the given key. @@ -17,15 +17,35 @@ EXAMPLES --keyring=fellowship POSITIONAL ARGUMENTS - KEY - Name of the key from which to clear the rotation schedule. + Key resource - The KMS key resource. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument key on the command line with a fully specified + name; + ◆ set the property core/project. -FLAGS - --keyring=KEYRING - Key ring of the key. + This must be specified. - --location=LOCATION - Location of the key. + KEY + ID of the key or fully qualified identifier for the key. To set the + key attribute: + ▸ provide the argument key on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --keyring=KEYRING + The KMS keyring of the key. To set the keyring attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --keyring on the command line. + + --location=LOCATION + The Google Cloud location for the key. To set the location attribute: + ▸ provide the argument key 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, diff --git a/gcloud/kms/keys/set-iam-policy b/gcloud/kms/keys/set-iam-policy index 40b7d101d..edeb50ab2 100644 --- a/gcloud/kms/keys/set-iam-policy +++ b/gcloud/kms/keys/set-iam-policy @@ -2,8 +2,9 @@ NAME gcloud kms keys set-iam-policy - set the IAM policy for a key SYNOPSIS - gcloud kms keys set-iam-policy KEY POLICY_FILE [--keyring=KEYRING] - [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + gcloud kms keys set-iam-policy + (KEY : --keyring=KEYRING --location=LOCATION) POLICY_FILE + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Sets the IAM policy for the given key as defined in a JSON or YAML file. @@ -20,19 +21,39 @@ EXAMPLES --keyring=fellowship --location=global POSITIONAL ARGUMENTS - KEY - Name of the key whose IAM policy to update. + Key resource - The KMS key resource. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument key on the command line with a fully specified + name; + ◆ set the property core/project. + + This must be specified. + + KEY + ID of the key or fully qualified identifier for the key. To set the + key attribute: + ▸ provide the argument key on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --keyring=KEYRING + The KMS keyring of the key. To set the keyring attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --keyring on the command line. + + --location=LOCATION + The Google Cloud location for the key. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. POLICY_FILE JSON or YAML file with the IAM policy -FLAGS - --keyring=KEYRING - Key ring of the key. - - --location=LOCATION - Location of the key. - 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/kms/keys/set-primary-version b/gcloud/kms/keys/set-primary-version index 3956e1fc0..af1b4000b 100644 --- a/gcloud/kms/keys/set-primary-version +++ b/gcloud/kms/keys/set-primary-version @@ -2,8 +2,9 @@ NAME gcloud kms keys set-primary-version - set the primary version of a key SYNOPSIS - gcloud kms keys set-primary-version KEY --version=VERSION - [--keyring=KEYRING] [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + gcloud kms keys set-primary-version + (KEY : --keyring=KEYRING --location=LOCATION) --version=VERSION + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Sets the specified version as the primary version of the given key. The @@ -17,20 +18,40 @@ EXAMPLES --keyring=fellowship --location=global POSITIONAL ARGUMENTS - KEY - Name of the key to modify. + Key resource - The KMS key resource. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument key on the command line with a fully specified + name; + ◆ set the property core/project. + + This must be specified. + + KEY + ID of the key or fully qualified identifier for the key. To set the + key attribute: + ▸ provide the argument key on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --keyring=KEYRING + The KMS keyring of the key. To set the keyring attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --keyring on the command line. + + --location=LOCATION + The Google Cloud location for the key. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. REQUIRED FLAGS --version=VERSION Version to make primary. -OPTIONAL FLAGS - --keyring=KEYRING - Key ring of the key. - - --location=LOCATION - Location of the key. - 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/kms/keys/set-rotation-schedule b/gcloud/kms/keys/set-rotation-schedule index 40a493268..4b63e6c08 100644 --- a/gcloud/kms/keys/set-rotation-schedule +++ b/gcloud/kms/keys/set-rotation-schedule @@ -3,8 +3,9 @@ NAME key SYNOPSIS - gcloud kms keys set-rotation-schedule KEY [--keyring=KEYRING] - [--location=LOCATION] [--next-rotation-time=NEXT_ROTATION_TIME] + gcloud kms keys set-rotation-schedule + (KEY : --keyring=KEYRING --location=LOCATION) + [--next-rotation-time=NEXT_ROTATION_TIME] [--rotation-period=ROTATION_PERIOD] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -29,16 +30,37 @@ EXAMPLES --next-rotation-time=2017-10-12T12:34:56.1234Z POSITIONAL ARGUMENTS - KEY - Name of the key to update the schedule of. + Key resource - The KMS key resource. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument key on the command line with a fully specified + name; + ◆ set the property core/project. + + This must be specified. + + KEY + ID of the key or fully qualified identifier for the key. To set the + key attribute: + ▸ provide the argument key on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --keyring=KEYRING + The KMS keyring of the key. To set the keyring attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --keyring on the command line. + + --location=LOCATION + The Google Cloud location for the key. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. FLAGS - --keyring=KEYRING - Key ring of the key. - - --location=LOCATION - Location of the key. - --next-rotation-time=NEXT_ROTATION_TIME Next automatic rotation time of the key. See $ gcloud topic datetimes for information on time formats. diff --git a/gcloud/kms/keys/update b/gcloud/kms/keys/update index 05492f412..401a9b1e7 100644 --- a/gcloud/kms/keys/update +++ b/gcloud/kms/keys/update @@ -100,7 +100,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --keyring on the command line. --location=LOCATION - The Cloud location for the key. To set the location attribute: + The Google Cloud location for the key. To set the location attribute: ▸ provide the argument key on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/logging/settings/update b/gcloud/logging/settings/update index 47ea1f0f6..74dda7a42 100644 --- a/gcloud/logging/settings/update +++ b/gcloud/logging/settings/update @@ -104,13 +104,15 @@ OPTIONAL FLAGS ▫ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▫ provide the argument --kms-key-name on the command line with a fully specified name; ▫ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▫ provide the argument --kms-key-name on the command line with a fully specified name; ▫ provide the argument --kms-project on the command line; diff --git a/gcloud/ml-engine/jobs/submit/training b/gcloud/ml-engine/jobs/submit/training index a36cc618f..2b8a7985d 100644 --- a/gcloud/ml-engine/jobs/submit/training +++ b/gcloud/ml-engine/jobs/submit/training @@ -351,13 +351,15 @@ FLAGS ▸ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --kms-key on the command line with a fully specified name; ▸ provide the argument --kms-project on the command line; diff --git a/gcloud/notebooks/instances/create b/gcloud/notebooks/instances/create index 29a04db8b..943b39524 100644 --- a/gcloud/notebooks/instances/create +++ b/gcloud/notebooks/instances/create @@ -24,7 +24,7 @@ SYNOPSIS [--disk-encryption=DISK_ENCRYPTION [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT]] - [--network=NETWORK : --no-proxy-access --no-public-ip [--subnet=SUBNET + [--network=NETWORK --no-proxy-access --no-public-ip [--subnet=SUBNET : --subnet-region=SUBNET_REGION]] [--reservation=RESERVATION --reservation-affinity=RESERVATION_AFFINITY; default="TYPE_UNSPECIFIED"] [GCLOUD_WIDE_FLAG ...] @@ -261,13 +261,15 @@ OPTIONAL FLAGS ▫ provide the argument --kms-keyring on the command line. --kms-location=KMS_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▫ provide the argument --kms-key on the command line with a fully specified name; ▫ provide the argument --kms-location on the command line. --kms-project=KMS_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▫ provide the argument --kms-key on the command line with a fully specified name; ▫ provide the argument --kms-project on the command line; diff --git a/gcloud/privateca/certificates/revoke b/gcloud/privateca/certificates/revoke index 374d796be..eaffe155d 100644 --- a/gcloud/privateca/certificates/revoke +++ b/gcloud/privateca/certificates/revoke @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud privateca certificates revoke - (--certificate=CERTIFICATE : --serial-number=SERIAL_NUMBER) + (--certificate=CERTIFICATE | --serial-number=SERIAL_NUMBER) [--reason=REASON; default="unspecified"] [--issuer-pool=ISSUER_POOL : --issuer-location=ISSUER_LOCATION] [GCLOUD_WIDE_FLAG ...] diff --git a/gcloud/privateca/roots/create b/gcloud/privateca/roots/create index ec6202722..e2d7702b5 100644 --- a/gcloud/privateca/roots/create +++ b/gcloud/privateca/roots/create @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud privateca roots create (CERTIFICATE_AUTHORITY : --location=LOCATION --pool=POOL) - --from-ca=FROM_CA [--auto-enable] [--bucket=BUCKET] - [--dns-san=[DNS_SAN,...]] [--email-san=[EMAIL_SAN,...]] + [--auto-enable] [--bucket=BUCKET] [--dns-san=[DNS_SAN,...]] + [--email-san=[EMAIL_SAN,...]] [--from-ca=FROM_CA] [--ip-san=[IP_SAN,...]] [--labels=[KEY=VALUE,...]] [--subject=[SUBJECT,...]] [--uri-san=[URI_SAN,...]] [--validity=VALIDITY; default="P10Y"] @@ -76,6 +76,21 @@ POSITIONAL ARGUMENTS ▸ provide the argument --pool on the command line. FLAGS + --auto-enable + If this flag is set, the Certificate Authority will be automatically + enabled upon creation. + + --bucket=BUCKET + The name of an existing storage bucket to use for storing the CA + certificates and CRLs for CAs in this pool. If omitted, a new bucket + will be created and managed by the service on your behalf. + + --dns-san=[DNS_SAN,...] + One or more comma-separated DNS Subject Alternative Names. + + --email-san=[EMAIL_SAN,...] + One or more comma-separated email Subject Alternative Names. + Source CA resource - An existing CA from which to copy configuration values for the new CA. You can still override any of those values by explicitly providing the appropriate flags. The specified existing CA must @@ -99,21 +114,6 @@ FLAGS To set the certificate_authority attribute: ▸ provide the argument --from-ca on the command line. - --auto-enable - If this flag is set, the Certificate Authority will be automatically - enabled upon creation. - - --bucket=BUCKET - The name of an existing storage bucket to use for storing the CA - certificates and CRLs for CAs in this pool. If omitted, a new bucket - will be created and managed by the service on your behalf. - - --dns-san=[DNS_SAN,...] - One or more comma-separated DNS Subject Alternative Names. - - --email-san=[EMAIL_SAN,...] - One or more comma-separated email Subject Alternative Names. - --ip-san=[IP_SAN,...] One or more comma-separated IP Subject Alternative Names. diff --git a/gcloud/privateca/subordinates/create b/gcloud/privateca/subordinates/create index 3730dff50..7b643c3e3 100644 --- a/gcloud/privateca/subordinates/create +++ b/gcloud/privateca/subordinates/create @@ -7,11 +7,12 @@ SYNOPSIS (CERTIFICATE_AUTHORITY : --location=LOCATION --pool=POOL) (--create-csr --csr-output-file=CSR_OUTPUT_FILE | --issuer-ca=ISSUER_CA [--issuer-pool=ISSUER_POOL - : --issuer-location=ISSUER_LOCATION]) --from-ca=FROM_CA - [--auto-enable] [--bucket=BUCKET] [--dns-san=[DNS_SAN,...]] - [--email-san=[EMAIL_SAN,...]] [--ip-san=[IP_SAN,...]] - [--labels=[KEY=VALUE,...]] [--subject=[SUBJECT,...]] - [--uri-san=[URI_SAN,...]] [--validity=VALIDITY; default="P3Y"] + : --issuer-location=ISSUER_LOCATION]) [--auto-enable] + [--bucket=BUCKET] [--dns-san=[DNS_SAN,...]] + [--email-san=[EMAIL_SAN,...]] [--from-ca=FROM_CA] + [--ip-san=[IP_SAN,...]] [--labels=[KEY=VALUE,...]] + [--subject=[SUBJECT,...]] [--uri-san=[URI_SAN,...]] + [--validity=VALIDITY; default="P3Y"] [--key-algorithm=KEY_ALGORITHM; default="rsa-pkcs1-2048-sha256" | [--kms-key-version=KMS_KEY_VERSION : --kms-key=KMS_KEY --kms-keyring=KMS_KEYRING @@ -140,6 +141,21 @@ REQUIRED FLAGS ◇ set the property privateca/location. OPTIONAL FLAGS + --auto-enable + If this flag is set, the Certificate Authority will be automatically + enabled upon creation. + + --bucket=BUCKET + The name of an existing storage bucket to use for storing the CA + certificates and CRLs for CAs in this pool. If omitted, a new bucket + will be created and managed by the service on your behalf. + + --dns-san=[DNS_SAN,...] + One or more comma-separated DNS Subject Alternative Names. + + --email-san=[EMAIL_SAN,...] + One or more comma-separated email Subject Alternative Names. + Source CA resource - An existing CA from which to copy configuration values for the new CA. You can still override any of those values by explicitly providing the appropriate flags. The specified existing CA must @@ -163,21 +179,6 @@ OPTIONAL FLAGS To set the certificate_authority attribute: ▸ provide the argument --from-ca on the command line. - --auto-enable - If this flag is set, the Certificate Authority will be automatically - enabled upon creation. - - --bucket=BUCKET - The name of an existing storage bucket to use for storing the CA - certificates and CRLs for CAs in this pool. If omitted, a new bucket - will be created and managed by the service on your behalf. - - --dns-san=[DNS_SAN,...] - One or more comma-separated DNS Subject Alternative Names. - - --email-san=[EMAIL_SAN,...] - One or more comma-separated email Subject Alternative Names. - --ip-san=[IP_SAN,...] One or more comma-separated IP Subject Alternative Names. diff --git a/gcloud/pubsub/topics/create b/gcloud/pubsub/topics/create index 772ad0fc6..5dcf1d20c 100644 --- a/gcloud/pubsub/topics/create +++ b/gcloud/pubsub/topics/create @@ -128,14 +128,16 @@ FLAGS command line. --topic-encryption-key-location=TOPIC_ENCRYPTION_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --topic-encryption-key on the command line with a fully specified name; ▸ provide the argument --topic-encryption-key-location on the command line. --topic-encryption-key-project=TOPIC_ENCRYPTION_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --topic-encryption-key on the command line with a fully specified name; ▸ provide the argument --topic-encryption-key-project on the diff --git a/gcloud/pubsub/topics/update b/gcloud/pubsub/topics/update index 3090253bc..0cf6795d0 100644 --- a/gcloud/pubsub/topics/update +++ b/gcloud/pubsub/topics/update @@ -211,14 +211,16 @@ FLAGS command line. --topic-encryption-key-location=TOPIC_ENCRYPTION_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --topic-encryption-key on the command line with a fully specified name; ▸ provide the argument --topic-encryption-key-location on the command line. --topic-encryption-key-project=TOPIC_ENCRYPTION_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --topic-encryption-key on the command line with a fully specified name; ▸ provide the argument --topic-encryption-key-project on the diff --git a/gcloud/sql/instances/create b/gcloud/sql/instances/create index 959628b6f..46fc9e978 100644 --- a/gcloud/sql/instances/create +++ b/gcloud/sql/instances/create @@ -409,14 +409,16 @@ FLAGS line. --disk-encryption-key-location=DISK_ENCRYPTION_KEY_LOCATION - The Cloud location for the key. To set the kms-location attribute: + The Google Cloud location for the key. To set the kms-location + attribute: ▸ provide the argument --disk-encryption-key on the command line with a fully specified name; ▸ provide the argument --disk-encryption-key-location on the command line. --disk-encryption-key-project=DISK_ENCRYPTION_KEY_PROJECT - The Cloud project for the key. To set the kms-project attribute: + The Google Cloud project for the key. To set the kms-project + attribute: ▸ provide the argument --disk-encryption-key on the command line with a fully specified name; ▸ provide the argument --disk-encryption-key-project on the command