From 6dc93282dfcb5245bfceffbfc58ad0764103f890 Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 5 Mar 2025 10:41:25 +0000 Subject: [PATCH] gcloud: Wed Mar 5 10:41:25 UTC 2025 --- gcloud/_version | 10 +- gcloud/alloydb/clusters/help | 3 + gcloud/alloydb/clusters/upgrade | 50 +++++ gcloud/alloydb/instances/create | 2 +- gcloud/alloydb/instances/update | 2 +- gcloud/alpha/alloydb/clusters/upgrade | 4 +- gcloud/alpha/alloydb/instances/create | 2 +- gcloud/alpha/alloydb/instances/update | 2 +- gcloud/alpha/batch/jobs/cancel | 6 +- .../alpha/compute/instance-templates/create | 3 + gcloud/alpha/compute/instances/create | 3 + .../compute/instances/create-with-container | 3 + gcloud/alpha/compute/instances/help | 3 +- .../compute/instances/network-interfaces/add | 16 +- .../instances/network-interfaces/delete | 12 +- .../compute/instances/network-interfaces/help | 13 +- .../attachments/dedicated/create | 12 +- .../attachments/dedicated/update | 15 +- .../interconnects/groups/create-members | 135 +++++++++++++ .../alpha/compute/interconnects/groups/help | 4 + gcloud/alpha/compute/queued-resources/create | 3 + gcloud/alpha/compute/routers/add-route-policy | 12 +- .../compute/routers/add-route-policy-term | 13 +- .../compute/routers/download-route-policy | 12 +- gcloud/alpha/compute/routers/get-route-policy | 11 +- gcloud/alpha/compute/routers/list-bgp-routes | 12 +- .../alpha/compute/routers/list-route-policies | 10 +- .../alpha/compute/routers/remove-route-policy | 11 +- .../compute/routers/remove-route-policy-term | 11 +- .../compute/routers/update-route-policy-term | 18 +- .../alpha/compute/routers/upload-route-policy | 12 +- .../url-maps/list-cdn-cache-invalidations | 3 +- gcloud/alpha/config/get | 4 - gcloud/alpha/config/help | 4 - gcloud/alpha/config/list | 4 - gcloud/alpha/config/set | 4 - gcloud/alpha/config/unset | 4 - gcloud/alpha/container/clusters/create | 19 +- gcloud/alpha/container/clusters/create-auto | 2 +- gcloud/alpha/container/clusters/update | 31 ++- gcloud/alpha/data-catalog/entries/create | 5 +- gcloud/alpha/data-catalog/entries/delete | 5 +- gcloud/alpha/data-catalog/entries/describe | 5 +- gcloud/alpha/data-catalog/entries/help | 12 +- gcloud/alpha/data-catalog/entries/list | 5 +- gcloud/alpha/data-catalog/entries/lookup | 5 +- gcloud/alpha/data-catalog/entries/update | 9 +- .../entry-groups/add-iam-policy-binding | 5 +- gcloud/alpha/data-catalog/entry-groups/create | 5 +- gcloud/alpha/data-catalog/entry-groups/delete | 5 +- .../alpha/data-catalog/entry-groups/describe | 5 +- .../data-catalog/entry-groups/get-iam-policy | 15 +- gcloud/alpha/data-catalog/entry-groups/help | 25 ++- gcloud/alpha/data-catalog/entry-groups/list | 5 +- .../entry-groups/remove-iam-policy-binding | 5 +- .../data-catalog/entry-groups/set-iam-policy | 7 +- gcloud/alpha/data-catalog/entry-groups/update | 5 +- gcloud/alpha/data-catalog/help | 9 +- gcloud/alpha/data-catalog/search | 5 +- .../tag-templates/add-iam-policy-binding | 5 +- .../alpha/data-catalog/tag-templates/create | 5 +- .../alpha/data-catalog/tag-templates/delete | 5 +- .../alpha/data-catalog/tag-templates/describe | 5 +- .../data-catalog/tag-templates/fields/create | 5 +- .../data-catalog/tag-templates/fields/delete | 5 +- .../tag-templates/fields/enum-values/help | 8 +- .../tag-templates/fields/enum-values/rename | 5 +- .../data-catalog/tag-templates/fields/help | 15 +- .../data-catalog/tag-templates/fields/rename | 5 +- .../data-catalog/tag-templates/fields/update | 5 +- .../data-catalog/tag-templates/get-iam-policy | 15 +- gcloud/alpha/data-catalog/tag-templates/help | 27 ++- .../tag-templates/remove-iam-policy-binding | 5 +- .../data-catalog/tag-templates/set-iam-policy | 7 +- .../alpha/data-catalog/tag-templates/update | 5 +- gcloud/alpha/data-catalog/tags/create | 6 +- gcloud/alpha/data-catalog/tags/delete | 6 +- gcloud/alpha/data-catalog/tags/help | 14 +- gcloud/alpha/data-catalog/tags/list | 6 +- gcloud/alpha/data-catalog/tags/update | 8 +- gcloud/alpha/kms/keys/versions/get-public-key | 6 +- gcloud/alpha/memorystore/instances/create | 41 +++- gcloud/alpha/memorystore/instances/update | 36 +++- gcloud/alpha/metastore/services/create | 30 ++- .../alpha/migration/vms/image-imports/create | 13 +- .../vms/machine-image-imports/create | 11 +- .../internal-ranges/create | 9 +- gcloud/alpha/pubsub/help | 3 + gcloud/alpha/pubsub/message-transforms/help | 30 +++ gcloud/alpha/pubsub/message-transforms/test | 88 +++++++++ .../alpha/pubsub/message-transforms/validate | 29 +++ gcloud/alpha/pubsub/subscriptions/create | 4 + gcloud/alpha/pubsub/subscriptions/update | 11 ++ gcloud/alpha/pubsub/topics/create | 4 + gcloud/alpha/pubsub/topics/update | 11 ++ gcloud/alpha/redis/clusters/update | 9 + gcloud/alpha/run/worker-pools/help | 3 + gcloud/alpha/run/worker-pools/logs/help | 38 ++++ gcloud/alpha/run/worker-pools/logs/read | 79 ++++++++ gcloud/alpha/run/worker-pools/logs/tail | 50 +++++ gcloud/alpha/run/worker-pools/revisions/help | 9 +- .../run/worker-pools/revisions/logs/help | 41 ++++ .../run/worker-pools/revisions/logs/read | 80 ++++++++ .../run/worker-pools/revisions/logs/tail | 50 +++++ gcloud/batch/jobs/cancel | 65 +++++++ gcloud/batch/jobs/help | 3 + gcloud/beta/alloydb/clusters/upgrade | 6 +- gcloud/beta/alloydb/instances/create | 2 +- gcloud/beta/alloydb/instances/update | 2 +- gcloud/beta/batch/jobs/cancel | 67 +++++++ gcloud/beta/batch/jobs/help | 3 + gcloud/beta/colab/runtime-templates/create | 25 ++- gcloud/beta/compute/commitments/create | 5 +- gcloud/beta/compute/instances/help | 3 +- .../compute/instances/network-interfaces/add | 178 ++++++++++++++++++ .../instances/network-interfaces/delete | 65 +++++++ .../compute/instances/network-interfaces/help | 15 +- gcloud/beta/compute/routers/add-route-policy | 14 +- .../compute/routers/add-route-policy-term | 15 +- .../compute/routers/download-route-policy | 14 +- gcloud/beta/compute/routers/get-route-policy | 13 +- gcloud/beta/compute/routers/list-bgp-routes | 14 +- .../beta/compute/routers/list-route-policies | 12 +- .../beta/compute/routers/remove-route-policy | 13 +- .../compute/routers/remove-route-policy-term | 13 +- .../compute/routers/update-route-policy-term | 20 +- .../beta/compute/routers/upload-route-policy | 14 +- .../url-maps/list-cdn-cache-invalidations | 3 +- gcloud/beta/config/get | 4 - gcloud/beta/config/help | 4 - gcloud/beta/config/list | 4 - gcloud/beta/config/set | 4 - gcloud/beta/config/unset | 4 - gcloud/beta/container/clusters/create | 19 +- gcloud/beta/container/clusters/create-auto | 2 +- gcloud/beta/container/clusters/update | 31 ++- gcloud/beta/data-catalog/entries/create | 5 +- gcloud/beta/data-catalog/entries/delete | 5 +- gcloud/beta/data-catalog/entries/describe | 5 +- gcloud/beta/data-catalog/entries/help | 12 +- gcloud/beta/data-catalog/entries/list | 5 +- gcloud/beta/data-catalog/entries/lookup | 5 +- gcloud/beta/data-catalog/entries/update | 9 +- .../entry-groups/add-iam-policy-binding | 5 +- gcloud/beta/data-catalog/entry-groups/create | 5 +- gcloud/beta/data-catalog/entry-groups/delete | 5 +- .../beta/data-catalog/entry-groups/describe | 5 +- .../data-catalog/entry-groups/get-iam-policy | 15 +- gcloud/beta/data-catalog/entry-groups/help | 25 ++- gcloud/beta/data-catalog/entry-groups/list | 5 +- .../entry-groups/remove-iam-policy-binding | 5 +- .../data-catalog/entry-groups/set-iam-policy | 7 +- gcloud/beta/data-catalog/entry-groups/update | 5 +- gcloud/beta/data-catalog/help | 9 +- gcloud/beta/data-catalog/search | 5 +- .../tag-templates/add-iam-policy-binding | 5 +- gcloud/beta/data-catalog/tag-templates/create | 5 +- gcloud/beta/data-catalog/tag-templates/delete | 5 +- .../beta/data-catalog/tag-templates/describe | 5 +- .../data-catalog/tag-templates/fields/create | 5 +- .../data-catalog/tag-templates/fields/delete | 5 +- .../tag-templates/fields/enum-values/help | 8 +- .../tag-templates/fields/enum-values/rename | 5 +- .../data-catalog/tag-templates/fields/help | 15 +- .../data-catalog/tag-templates/fields/rename | 5 +- .../data-catalog/tag-templates/fields/update | 5 +- .../data-catalog/tag-templates/get-iam-policy | 15 +- gcloud/beta/data-catalog/tag-templates/help | 25 ++- .../tag-templates/remove-iam-policy-binding | 5 +- .../data-catalog/tag-templates/set-iam-policy | 7 +- gcloud/beta/data-catalog/tag-templates/update | 5 +- gcloud/beta/data-catalog/tags/create | 6 +- gcloud/beta/data-catalog/tags/delete | 6 +- gcloud/beta/data-catalog/tags/help | 14 +- gcloud/beta/data-catalog/tags/list | 6 +- gcloud/beta/data-catalog/tags/update | 8 +- gcloud/beta/dataflow/flex-template/build | 17 +- gcloud/beta/dataflow/jobs/run | 9 + .../datastream/connection-profiles/create | 72 ++++++- .../datastream/connection-profiles/update | 63 ++++++- gcloud/beta/datastream/streams/create | 154 +++++++++------ gcloud/beta/datastream/streams/update | 158 ++++++++++------ gcloud/beta/filestore/instances/create | 20 +- gcloud/beta/kms/keys/versions/get-public-key | 6 +- gcloud/beta/memorystore/instances/create | 41 +++- gcloud/beta/memorystore/instances/update | 36 +++- gcloud/beta/metastore/services/create | 30 ++- gcloud/beta/redis/clusters/update | 9 + gcloud/colab/runtime-templates/create | 25 ++- gcloud/compute/instance-templates/create | 6 + gcloud/compute/instances/bulk/create | 6 + gcloud/compute/instances/create | 6 + .../compute/instances/create-with-container | 6 + gcloud/compute/instances/help | 2 +- .../compute/instances/network-interfaces/help | 8 +- gcloud/compute/instances/set-scheduling | 6 + gcloud/compute/routers/add-bgp-peer | 12 +- gcloud/compute/routers/add-route-policy | 72 +++++++ gcloud/compute/routers/add-route-policy-term | 75 ++++++++ gcloud/compute/routers/download-route-policy | 72 +++++++ gcloud/compute/routers/get-route-policy | 63 +++++++ gcloud/compute/routers/help | 31 +++ gcloud/compute/routers/list-bgp-routes | 125 ++++++++++++ gcloud/compute/routers/list-route-policies | 91 +++++++++ gcloud/compute/routers/remove-route-policy | 63 +++++++ .../compute/routers/remove-route-policy-term | 68 +++++++ gcloud/compute/routers/update-bgp-peer | 12 +- .../compute/routers/update-route-policy-term | 78 ++++++++ gcloud/compute/routers/upload-route-policy | 72 +++++++ .../url-maps/list-cdn-cache-invalidations | 3 +- gcloud/config/get | 4 - gcloud/config/help | 4 - gcloud/config/list | 4 - gcloud/config/set | 4 - gcloud/config/unset | 4 - gcloud/container/clusters/create | 19 +- gcloud/container/clusters/create-auto | 2 +- gcloud/container/clusters/update | 31 ++- gcloud/data-catalog/entries/create | 3 + gcloud/data-catalog/entries/delete | 3 + gcloud/data-catalog/entries/describe | 3 + gcloud/data-catalog/entries/help | 16 +- gcloud/data-catalog/entries/list | 3 + gcloud/data-catalog/entries/lookup | 3 + gcloud/data-catalog/entries/star | 2 + gcloud/data-catalog/entries/unstar | 2 + gcloud/data-catalog/entries/update | 3 + .../entry-groups/add-iam-policy-binding | 3 + gcloud/data-catalog/entry-groups/create | 3 + gcloud/data-catalog/entry-groups/delete | 3 + gcloud/data-catalog/entry-groups/describe | 3 + .../data-catalog/entry-groups/get-iam-policy | 3 + gcloud/data-catalog/entry-groups/help | 24 ++- gcloud/data-catalog/entry-groups/list | 3 + .../entry-groups/remove-iam-policy-binding | 3 + .../data-catalog/entry-groups/set-iam-policy | 3 + gcloud/data-catalog/entry-groups/update | 3 + gcloud/data-catalog/help | 8 +- gcloud/data-catalog/search | 3 + .../tag-templates/add-iam-policy-binding | 3 + gcloud/data-catalog/tag-templates/create | 3 + gcloud/data-catalog/tag-templates/delete | 3 + gcloud/data-catalog/tag-templates/describe | 3 + .../data-catalog/tag-templates/fields/create | 3 + .../data-catalog/tag-templates/fields/delete | 3 + .../tag-templates/fields/enum-values/help | 8 +- .../tag-templates/fields/enum-values/rename | 3 + gcloud/data-catalog/tag-templates/fields/help | 15 +- .../data-catalog/tag-templates/fields/rename | 3 + .../data-catalog/tag-templates/fields/update | 3 + .../data-catalog/tag-templates/get-iam-policy | 3 + gcloud/data-catalog/tag-templates/help | 24 ++- .../tag-templates/remove-iam-policy-binding | 3 + .../data-catalog/tag-templates/set-iam-policy | 3 + gcloud/data-catalog/tag-templates/update | 3 + gcloud/data-catalog/tags/create | 4 + gcloud/data-catalog/tags/delete | 4 + gcloud/data-catalog/tags/help | 14 +- gcloud/data-catalog/tags/list | 4 + gcloud/data-catalog/tags/update | 4 + gcloud/dataflow/flex-template/build | 17 +- gcloud/dataflow/jobs/run | 9 + gcloud/datastream/connection-profiles/create | 103 +++++++++- gcloud/datastream/connection-profiles/update | 83 +++++++- gcloud/datastream/objects/lookup | 17 +- gcloud/datastream/streams/create | 154 +++++++++------ gcloud/datastream/streams/update | 158 ++++++++++------ gcloud/kms/keys/versions/get-public-key | 6 +- gcloud/memorystore/instances/create | 41 +++- gcloud/memorystore/instances/update | 36 +++- gcloud/metastore/services/create | 14 +- gcloud/migration/vms/image-imports/create | 13 +- .../vms/machine-image-imports/create | 11 +- .../threat-prevention/add-override | 19 +- .../threat-prevention/delete-override | 15 +- .../threat-prevention/list-overrides | 3 +- .../threat-prevention/update-override | 21 ++- gcloud/redis/clusters/update | 9 + gcloud/workflows/deploy | 8 +- 279 files changed, 4198 insertions(+), 801 deletions(-) create mode 100644 gcloud/alloydb/clusters/upgrade create mode 100644 gcloud/alpha/compute/interconnects/groups/create-members create mode 100644 gcloud/alpha/pubsub/message-transforms/help create mode 100644 gcloud/alpha/pubsub/message-transforms/test create mode 100644 gcloud/alpha/pubsub/message-transforms/validate create mode 100644 gcloud/alpha/run/worker-pools/logs/help create mode 100644 gcloud/alpha/run/worker-pools/logs/read create mode 100644 gcloud/alpha/run/worker-pools/logs/tail create mode 100644 gcloud/alpha/run/worker-pools/revisions/logs/help create mode 100644 gcloud/alpha/run/worker-pools/revisions/logs/read create mode 100644 gcloud/alpha/run/worker-pools/revisions/logs/tail create mode 100644 gcloud/batch/jobs/cancel create mode 100644 gcloud/beta/batch/jobs/cancel create mode 100644 gcloud/beta/compute/instances/network-interfaces/add create mode 100644 gcloud/beta/compute/instances/network-interfaces/delete create mode 100644 gcloud/compute/routers/add-route-policy create mode 100644 gcloud/compute/routers/add-route-policy-term create mode 100644 gcloud/compute/routers/download-route-policy create mode 100644 gcloud/compute/routers/get-route-policy create mode 100644 gcloud/compute/routers/list-bgp-routes create mode 100644 gcloud/compute/routers/list-route-policies create mode 100644 gcloud/compute/routers/remove-route-policy create mode 100644 gcloud/compute/routers/remove-route-policy-term create mode 100644 gcloud/compute/routers/update-route-policy-term create mode 100644 gcloud/compute/routers/upload-route-policy diff --git a/gcloud/_version b/gcloud/_version index 3c7e0bffc..d20778e32 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 512.0.0 -alpha 2025.02.21 -beta 2025.02.21 -bq 2.1.13 +Google Cloud SDK 513.0.0 +alpha 2025.02.28 +beta 2025.02.28 +bq 2.1.14 bundled-python3-unix 3.12.8 -core 2025.02.21 +core 2025.02.28 gcloud-crc32c 1.0.0 gsutil 5.33 diff --git a/gcloud/alloydb/clusters/help b/gcloud/alloydb/clusters/help index 60f1b08c5..ba5ee74b0 100644 --- a/gcloud/alloydb/clusters/help +++ b/gcloud/alloydb/clusters/help @@ -50,6 +50,9 @@ COMMANDS update Update an AlloyDB cluster within a given project and region. + upgrade + Upgrade an AlloyDB cluster within a given project and region. + NOTES These variants are also available: diff --git a/gcloud/alloydb/clusters/upgrade b/gcloud/alloydb/clusters/upgrade new file mode 100644 index 000000000..f92832868 --- /dev/null +++ b/gcloud/alloydb/clusters/upgrade @@ -0,0 +1,50 @@ +NAME + gcloud alloydb clusters upgrade - upgrade an AlloyDB cluster within a given + project and region + +SYNOPSIS + gcloud alloydb clusters upgrade CLUSTER --region=REGION --version=VERSION + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Upgrade an AlloyDB cluster within a given project and region. + +EXAMPLES + To upgrade a cluster, run: + + $ gcloud alloydb clusters upgrade my-cluster --region=us-central1 \ + --version=POSTGRES_15 + +POSITIONAL ARGUMENTS + CLUSTER + AlloyDB cluster ID + +REQUIRED FLAGS + --region=REGION + Regional location (e.g. asia-east1, us-east1). See the full list of + regions at https://cloud.google.com/sql/docs/instance-locations. + + --version=VERSION + Target database version for the upgrade. VERSION must be one of: + POSTGRES_14, POSTGRES_15, POSTGRES_16. + +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 + These variants are also available: + + $ gcloud alpha alloydb clusters upgrade + + $ gcloud beta alloydb clusters upgrade + diff --git a/gcloud/alloydb/instances/create b/gcloud/alloydb/instances/create index 496cf00a9..8268fa20b 100644 --- a/gcloud/alloydb/instances/create +++ b/gcloud/alloydb/instances/create @@ -47,7 +47,7 @@ REQUIRED FLAGS Whole number value indicating how many vCPUs the machine should contain. Each vCPU count corresponds to a N2 high-mem machine: (https://cloud.google.com/compute/docs/general-purpose-machines#n2_machines). - CPU_COUNT must be one of: 2, 4, 8, 16, 32, 64, 96, 128. + CPU_COUNT must be one of: 1, 2, 4, 8, 16, 32, 64, 96, 128. --instance-type=INSTANCE_TYPE Specifies instance type. INSTANCE_TYPE must be one of: diff --git a/gcloud/alloydb/instances/update b/gcloud/alloydb/instances/update index 137a1ee2d..cad637a80 100644 --- a/gcloud/alloydb/instances/update +++ b/gcloud/alloydb/instances/update @@ -90,7 +90,7 @@ OPTIONAL FLAGS Whole number value indicating how many vCPUs the machine should contain. Each vCPU count corresponds to a N2 high-mem machine: (https://cloud.google.com/compute/docs/general-purpose-machines#n2_machines). - CPU_COUNT must be one of: 2, 4, 8, 16, 32, 64, 96, 128. + CPU_COUNT must be one of: 1, 2, 4, 8, 16, 32, 64, 96, 128. --database-flags=FLAG=VALUE,[FLAG=VALUE,...] Comma-separated list of database flags to set on the instance. Use an diff --git a/gcloud/alpha/alloydb/clusters/upgrade b/gcloud/alpha/alloydb/clusters/upgrade index f907dd8ab..d45e562aa 100644 --- a/gcloud/alpha/alloydb/clusters/upgrade +++ b/gcloud/alpha/alloydb/clusters/upgrade @@ -45,7 +45,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 alloydb clusters upgrade $ gcloud beta alloydb clusters upgrade diff --git a/gcloud/alpha/alloydb/instances/create b/gcloud/alpha/alloydb/instances/create index 24db2df62..fa05fbc4e 100644 --- a/gcloud/alpha/alloydb/instances/create +++ b/gcloud/alpha/alloydb/instances/create @@ -64,7 +64,7 @@ REQUIRED FLAGS Whole number value indicating how many vCPUs the machine should contain. Each vCPU count corresponds to a N2 high-mem machine: (https://cloud.google.com/compute/docs/general-purpose-machines#n2_machines). - CPU_COUNT must be one of: 2, 4, 8, 16, 32, 64, 96, 128. + CPU_COUNT must be one of: 1, 2, 4, 8, 16, 32, 64, 96, 128. --instance-type=INSTANCE_TYPE Specifies instance type. INSTANCE_TYPE must be one of: diff --git a/gcloud/alpha/alloydb/instances/update b/gcloud/alpha/alloydb/instances/update index 76e318a18..878174f31 100644 --- a/gcloud/alpha/alloydb/instances/update +++ b/gcloud/alpha/alloydb/instances/update @@ -138,7 +138,7 @@ OPTIONAL FLAGS Whole number value indicating how many vCPUs the machine should contain. Each vCPU count corresponds to a N2 high-mem machine: (https://cloud.google.com/compute/docs/general-purpose-machines#n2_machines). - CPU_COUNT must be one of: 2, 4, 8, 16, 32, 64, 96, 128. + CPU_COUNT must be one of: 1, 2, 4, 8, 16, 32, 64, 96, 128. --database-flags=FLAG=VALUE,[FLAG=VALUE,...] Comma-separated list of database flags to set on the instance. Use an diff --git a/gcloud/alpha/batch/jobs/cancel b/gcloud/alpha/batch/jobs/cancel index a79bd709d..ef86bba06 100644 --- a/gcloud/alpha/batch/jobs/cancel +++ b/gcloud/alpha/batch/jobs/cancel @@ -61,5 +61,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. + access allowlist. These variants are also available: + + $ gcloud batch jobs cancel + + $ gcloud beta batch jobs cancel diff --git a/gcloud/alpha/compute/instance-templates/create b/gcloud/alpha/compute/instance-templates/create index 2bf3c8d3f..62863b4e2 100644 --- a/gcloud/alpha/compute/instance-templates/create +++ b/gcloud/alpha/compute/instance-templates/create @@ -861,6 +861,9 @@ FLAGS affects the price, availability, and how long your VM instances can run. PROVISIONING_MODEL must be one of: + FLEX_START + Instance is provisioned using the Flex Start provisioning model and + has a limited runtime. RESERVATION_BOUND The VM instances run for the entire duration of their associated reservation. You can only specify this provisioning model if you diff --git a/gcloud/alpha/compute/instances/create b/gcloud/alpha/compute/instances/create index 33ff9356f..6312adc5e 100644 --- a/gcloud/alpha/compute/instances/create +++ b/gcloud/alpha/compute/instances/create @@ -878,6 +878,9 @@ FLAGS affects the price, availability, and how long your VM instances can run. PROVISIONING_MODEL must be one of: + FLEX_START + Instance is provisioned using the Flex Start provisioning model and + has a limited runtime. RESERVATION_BOUND The VM instances run for the entire duration of their associated reservation. You can only specify this provisioning model if you diff --git a/gcloud/alpha/compute/instances/create-with-container b/gcloud/alpha/compute/instances/create-with-container index 199eeafd9..3b86d7b09 100644 --- a/gcloud/alpha/compute/instances/create-with-container +++ b/gcloud/alpha/compute/instances/create-with-container @@ -831,6 +831,9 @@ FLAGS affects the price, availability, and how long your VM instances can run. PROVISIONING_MODEL must be one of: + FLEX_START + Instance is provisioned using the Flex Start provisioning model and + has a limited runtime. RESERVATION_BOUND The VM instances run for the entire duration of their associated reservation. You can only specify this provisioning model if you diff --git a/gcloud/alpha/compute/instances/help b/gcloud/alpha/compute/instances/help index e54817e49..e8ce7ce03 100644 --- a/gcloud/alpha/compute/instances/help +++ b/gcloud/alpha/compute/instances/help @@ -31,8 +31,7 @@ GROUPS (ALPHA) Manage Compute Engine instance configurations. network-interfaces - (ALPHA) Read and manipulate Compute Engine VM instance network - interfaces. + (ALPHA) Read and manipulate Compute Engine instance network interfaces. ops-agents (ALPHA) Manage Google Cloud Observability agents for Compute Engine VM diff --git a/gcloud/alpha/compute/instances/network-interfaces/add b/gcloud/alpha/compute/instances/network-interfaces/add index a112f96a2..b7266898a 100644 --- a/gcloud/alpha/compute/instances/network-interfaces/add +++ b/gcloud/alpha/compute/instances/network-interfaces/add @@ -1,6 +1,6 @@ NAME - gcloud alpha compute instances network-interfaces add - add a Compute - Engine virtual machine network interface + gcloud alpha compute instances network-interfaces add - add a dynamic + network interface to a Compute Engine instance SYNOPSIS gcloud alpha compute instances network-interfaces add INSTANCE_NAME @@ -18,8 +18,12 @@ SYNOPSIS [--address=ADDRESS | --no-address] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) gcloud alpha compute instances network-interfaces add adds network - interface to a Compute Engine virtual machine. + (ALPHA) gcloud alpha compute instances network-interfaces add adds a + dynamic network interface to a Compute Engine instance. For example: + + $ gcloud alpha compute instances network-interfaces add \ + instance-name --parent-nic-name nic1 --vlan 2 + --network network-1 --subnetwork subnetwork-1 POSITIONAL ARGUMENTS INSTANCE_NAME @@ -192,5 +196,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta compute instances network-interfaces add diff --git a/gcloud/alpha/compute/instances/network-interfaces/delete b/gcloud/alpha/compute/instances/network-interfaces/delete index 3ca5333b9..165396c25 100644 --- a/gcloud/alpha/compute/instances/network-interfaces/delete +++ b/gcloud/alpha/compute/instances/network-interfaces/delete @@ -1,6 +1,6 @@ NAME - gcloud alpha compute instances network-interfaces delete - delete a Compute - Engine virtual machine network interface + gcloud alpha compute instances network-interfaces delete - delete a dynamic + network interface from a Compute Engine instance SYNOPSIS gcloud alpha compute instances network-interfaces delete INSTANCE_NAME @@ -8,8 +8,8 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) gcloud alpha compute instances network-interfaces delete deletes - network interface of a Compute Engine virtual machine. For example: + (ALPHA) gcloud alpha compute instances network-interfaces delete deletes a + dynamic network interface from a Compute Engine instance. For example: $ gcloud alpha compute instances network-interfaces delete \ instance-name --network-interface nic1.2 @@ -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 beta compute instances network-interfaces delete diff --git a/gcloud/alpha/compute/instances/network-interfaces/help b/gcloud/alpha/compute/instances/network-interfaces/help index 2b55c0b38..7316891a4 100644 --- a/gcloud/alpha/compute/instances/network-interfaces/help +++ b/gcloud/alpha/compute/instances/network-interfaces/help @@ -1,19 +1,19 @@ NAME gcloud alpha compute instances network-interfaces - read and manipulate - Compute Engine VM instance network interfaces + Compute Engine instance network interfaces SYNOPSIS gcloud alpha compute instances network-interfaces COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Read and manipulate Compute Engine VM instance network interfaces. + (ALPHA) Read and manipulate Compute Engine instance network interfaces. - For more information about VM instance network interfaces, see the network + For more information about instance network interfaces, see the network interfaces documentation (https://cloud.google.com/vpc/docs/multiple-interfaces-concepts). - See also: VM instance network interfaces API + See also: instance network interfaces API (https://cloud.google.com/compute/docs/reference/rest/v1/instances/updateNetworkInterface). GCLOUD WIDE FLAGS @@ -25,10 +25,11 @@ COMMANDS COMMAND is one of the following: add - (ALPHA) Add a Compute Engine virtual machine network interface. + (ALPHA) Add a dynamic network interface to a Compute Engine instance. delete - (ALPHA) Delete a Compute Engine virtual machine network interface. + (ALPHA) Delete a dynamic network interface from a Compute Engine + instance. get-effective-firewalls (ALPHA) Get the effective firewalls for a Compute Engine virtual diff --git a/gcloud/alpha/compute/interconnects/attachments/dedicated/create b/gcloud/alpha/compute/interconnects/attachments/dedicated/create index 1cc74996f..151d852d3 100644 --- a/gcloud/alpha/compute/interconnects/attachments/dedicated/create +++ b/gcloud/alpha/compute/interconnects/attachments/dedicated/create @@ -69,19 +69,23 @@ OPTIONAL FLAGS --candidate-cloud-router-ip-address=CANDIDATE_CLOUD_ROUTER_IP_ADDRESS Single IPv4 address + prefix length to be configured on the cloud - router interface for this interconnect attachment + router interface for this interconnect attachment. Example: + 74.133.16.1/30 --candidate-cloud-router-ipv6-address=CANDIDATE_CLOUD_ROUTER_IPV6_ADDRESS Single IPv6 address + prefix length to be configured on the cloud - router interface for this interconnect attachment + router interface for this interconnect attachment. Example: + 2fff:eec0:3201:0:0:0:0:1/125 --candidate-customer-router-ip-address=CANDIDATE_CUSTOMER_ROUTER_IP_ADDRESS Single IPv4 address + prefix length to be configured on the customer - router interface for this interconnect attachment + router interface for this interconnect attachment. Example: + 74.133.16.2/30 --candidate-customer-router-ipv6-address=CANDIDATE_CUSTOMER_ROUTER_IPV6_ADDRESS Single IPv6 address + prefix length to be configured on the customer - router interface for this interconnect attachment + router interface for this interconnect attachment. Example: + 2fff:eec0:3201:0:0:0:0:2/125 --candidate-ipv6-subnets=[IPV6_SUBNET,...] The candididate-ipv6-subnets field is not available. diff --git a/gcloud/alpha/compute/interconnects/attachments/dedicated/update b/gcloud/alpha/compute/interconnects/attachments/dedicated/update index 5e74a51b8..4ac7960e7 100644 --- a/gcloud/alpha/compute/interconnects/attachments/dedicated/update +++ b/gcloud/alpha/compute/interconnects/attachments/dedicated/update @@ -4,7 +4,10 @@ NAME SYNOPSIS gcloud alpha compute interconnects attachments dedicated update NAME - [--bandwidth=BANDWIDTH] [--candidate-ipv6-subnets=[IPV6_SUBNET,...]] + [--bandwidth=BANDWIDTH] + [--candidate-cloud-router-ipv6-address=CANDIDATE_CLOUD_ROUTER_IPV6_ADDRESS] + [--candidate-customer-router-ipv6-address=CANDIDATE_CUSTOMER_ROUTER_IPV6_ADDRESS] + [--candidate-ipv6-subnets=[IPV6_SUBNET,...]] [--cloud-router-ipv6-interface-id=INTERFACE_ID] [--customer-router-ipv6-interface-id=PEER_INTERFACE_ID] [--description=DESCRIPTION] [--enable-admin] [--enable-multicast] @@ -53,6 +56,16 @@ FLAGS 100g 100 Gbit/s + --candidate-cloud-router-ipv6-address=CANDIDATE_CLOUD_ROUTER_IPV6_ADDRESS + Single IPv6 address + prefix length to be configured on the cloud + router interface for this interconnect attachment. Example: + 2fff:eec0:3201:0:0:0:0:1/125 + + --candidate-customer-router-ipv6-address=CANDIDATE_CUSTOMER_ROUTER_IPV6_ADDRESS + Single IPv6 address + prefix length to be configured on the customer + router interface for this interconnect attachment. Example: + 2fff:eec0:3201:0:0:0:0:2/125 + --candidate-ipv6-subnets=[IPV6_SUBNET,...] The candididate-ipv6-subnets field is not available. diff --git a/gcloud/alpha/compute/interconnects/groups/create-members b/gcloud/alpha/compute/interconnects/groups/create-members new file mode 100644 index 000000000..f232c39b4 --- /dev/null +++ b/gcloud/alpha/compute/interconnects/groups/create-members @@ -0,0 +1,135 @@ +NAME + gcloud alpha compute interconnects groups create-members - create new + member interconnects in a Compute Engine interconnect group + +SYNOPSIS + gcloud alpha compute interconnects groups create-members NAME + --interconnect=[INTERCONNECT,...] [--admin-enabled] + [--customer-name=CUSTOMER_NAME] [--description=DESCRIPTION] + [--facility=FACILITY] + [--intent-mismatch-behavior=INTENT_MISMATCH_BEHAVIOR] + [--interconnect-type=INTERCONNECT_TYPE] [--link-type=LINK_TYPE] + [--noc-contact-email=NOC_CONTACT_EMAIL] + [--requested-features=[FEATURES,...]] + [--requested-link-count=REQUESTED_LINK_COUNT] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute interconnects groups create-members is used to + create new member interconnects in an interconnect group. + + For an example, refer to the EXAMPLES section below. + +EXAMPLES + To create interconnects interconnect1 and interconnect2 in interconnect + group example-interconnect-group, run: + + $ gcloud alpha compute interconnects groups create-members \ + example-interconnect-group --interconnect-type DEDICATED \ + --link-speed LINK_TYPE_ETHERNET_10G_LR \ + --requested-link-count 1 --facility iad-1 \ + --interconnect="name=interconnect1" \ + --interconnect="name=interconnect2" + +POSITIONAL ARGUMENTS + NAME + Name of the interconnect group to create members. + +REQUIRED FLAGS + --interconnect=[INTERCONNECT,...] + New member interconnects to create in the interconnect group. To create + multiple interconnects, this flag should be specified multiple times. + + Each interconnect takes in the same set of flags as the gcloud compute + interconnects create command, except instead of a location, a facility + must be specified. These flags are defined as a comma separated list of + flag=value pairs. + + Example: --interconnect + name=interconnect1,facility=iad-1,description="my + interconnect",link-type=LINK_TYPE_ETHERNET_10G_LR,requested-link-count=1, + interconnect-type=DEDICATED,admin-enabled, + noc-contact-email=noc@google.com,customer-name=customer-name + requested-features=MACSEC:CROSS_SITE_NETWORK + + Note that for multiple requested-features, use a colon (:) as the + delimiter, as the comma is used to separate the flags. Similarly, if + you need to use a comma in another flag value, you should set an + alternative delimiter for the --interconnect flag. Run gcloud topic + escaping for more information. + +OPTIONAL FLAGS + --admin-enabled + Administrative status of the interconnect. If not provided on creation, + defaults to enabled. When this is enabled, the interconnect is + operational and will carry traffic across any functioning linked + interconnect attachments. Use --no-admin-enabled to disable it. + + --customer-name=CUSTOMER_NAME + Customer name to put in the Letter of Authorization as the party + authorized to request an interconnect. This field is required for most + interconnects, however it is prohibited when creating a Cross-Cloud + Interconnect. + + --description=DESCRIPTION + An optional, textual description for the interconnect. + + --facility=FACILITY + The facility (zone free location) to create the interconnect in. + + --intent-mismatch-behavior=INTENT_MISMATCH_BEHAVIOR + The behavior when the intent of the interconnect group does not match + the topology capability of the member interconnects. + INTENT_MISMATCH_BEHAVIOR must be one of: REJECT, CREATE. + + --interconnect-type=INTERCONNECT_TYPE + Type of the interconnect. INTERCONNECT_TYPE must be one of: + + DEDICATED + Dedicated private interconnect. + PARTNER + Partner interconnect. Only available to approved partners. + + --link-type=LINK_TYPE + Type of the link for the interconnect. LINK_TYPE must be one of: + + LINK_TYPE_ETHERNET_100G_LR + 100Gbps Ethernet, LR Optics. + LINK_TYPE_ETHERNET_10G_LR + 10Gbps Ethernet, LR Optics. + + --noc-contact-email=NOC_CONTACT_EMAIL + Email address to contact the customer NOC for operations and + maintenance notifications regarding this interconnect. + + --requested-features=[FEATURES,...] + List of features requested for this interconnect. FEATURES must be one + of: + + CROSS_SITE_NETWORK + If specified then the interconnect is created on Cross-Site Network + capable hardware ports. This parameter can only be provided during + interconnect INSERT and cannot be changed using interconnect PATCH. + MACSEC + If specified then the interconnect is created on MACsec capable + hardware ports. If not specified, the interconnect is created on + non-MACsec capable ports first, if available. This parameter can + only be provided during interconnect INSERT and cannot be changed + using interconnect PATCH. + + --requested-link-count=REQUESTED_LINK_COUNT + Target number of physical links in the link bundle. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/compute/interconnects/groups/help b/gcloud/alpha/compute/interconnects/groups/help index 4b350bb14..1283337c1 100644 --- a/gcloud/alpha/compute/interconnects/groups/help +++ b/gcloud/alpha/compute/interconnects/groups/help @@ -23,6 +23,10 @@ COMMANDS create (ALPHA) Create a Compute Engine interconnect group. + create-members + (ALPHA) Create new member interconnects in a Compute Engine + interconnect group. + delete (ALPHA) Delete Compute Engine interconnect groups. diff --git a/gcloud/alpha/compute/queued-resources/create b/gcloud/alpha/compute/queued-resources/create index a84eae6ac..4fd5eb4fb 100644 --- a/gcloud/alpha/compute/queued-resources/create +++ b/gcloud/alpha/compute/queued-resources/create @@ -734,6 +734,9 @@ OPTIONAL FLAGS affects the price, availability, and how long your VM instances can run. PROVISIONING_MODEL must be one of: + FLEX_START + Instance is provisioned using the Flex Start provisioning model and + has a limited runtime. SPOT Compute Engine may stop a Spot VM instance whenever it needs capacity. Because Spot VM instances don't have a guaranteed diff --git a/gcloud/alpha/compute/routers/add-route-policy b/gcloud/alpha/compute/routers/add-route-policy index 5f177bb7e..9c2b350ba 100644 --- a/gcloud/alpha/compute/routers/add-route-policy +++ b/gcloud/alpha/compute/routers/add-route-policy @@ -11,6 +11,14 @@ DESCRIPTION (ALPHA) gcloud alpha compute routers add-route-policy adds an empty route policy to a Compute Engine router. +EXAMPLES + To add an import route policy my-policy to a router my-router in region + us-central1, run: + + $ gcloud alpha compute routers add-route-policy my-router \ + --region=us-central1 --policy-name=my-policy \ + --policy-type=IMPORT + POSITIONAL ARGUMENTS NAME Name of the router to update. @@ -60,7 +68,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 compute routers add-route-policy $ gcloud beta compute routers add-route-policy diff --git a/gcloud/alpha/compute/routers/add-route-policy-term b/gcloud/alpha/compute/routers/add-route-policy-term index c63060dee..2749ef077 100644 --- a/gcloud/alpha/compute/routers/add-route-policy-term +++ b/gcloud/alpha/compute/routers/add-route-policy-term @@ -11,6 +11,15 @@ DESCRIPTION (ALPHA) gcloud alpha compute routers add-route-policy-term adds a term to a route policy. +EXAMPLES + To add a term with priority 0 with match destination == '192.168.0.0/16' + and actions drop() to a route policy my-policy of a router my-router in + region us-central1, run: + + $ gcloud alpha compute routers add-route-policy-term my-router \ + --region=us-central1 --policy-name=my-policy --priority=0 \ + --match="destination == '192.168.0.0/16'" --actions="drop()" + POSITIONAL ARGUMENTS NAME Name of the router to update. @@ -62,7 +71,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 compute routers add-route-policy-term $ gcloud beta compute routers add-route-policy-term diff --git a/gcloud/alpha/compute/routers/download-route-policy b/gcloud/alpha/compute/routers/download-route-policy index 1a8b1cd3d..a7795e9f1 100644 --- a/gcloud/alpha/compute/routers/download-route-policy +++ b/gcloud/alpha/compute/routers/download-route-policy @@ -11,6 +11,14 @@ DESCRIPTION (ALPHA) gcloud alpha compute routers download-route-policy downloads a route policy from a Compute Engine router. +EXAMPLES + To download a route policy my-export-policy to a file my-export-policy.yaml + from a router my-router in region us-central1, run: + + $ gcloud alpha compute routers download-route-policy my-router \ + --region=us-central1 --policy-name=my-export-policy \ + --file-name=my-export-policy.yaml" + POSITIONAL ARGUMENTS NAME Name of the router to export. @@ -59,7 +67,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 compute routers download-route-policy $ gcloud beta compute routers download-route-policy diff --git a/gcloud/alpha/compute/routers/get-route-policy b/gcloud/alpha/compute/routers/get-route-policy index 7a9dc709f..10d4b8439 100644 --- a/gcloud/alpha/compute/routers/get-route-policy +++ b/gcloud/alpha/compute/routers/get-route-policy @@ -10,6 +10,13 @@ DESCRIPTION (ALPHA) gcloud alpha compute routers get-route-policy gets a route policy from a Compute Engine router. +EXAMPLES + To get a route policy my-policy from a router my-router in region + us-central1, run: + + $ gcloud alpha compute routers get-route-policy my-router \ + --region=us-central1 --policy-name=my-policy + POSITIONAL ARGUMENTS NAME Name of the router to get. @@ -51,7 +58,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 compute routers get-route-policy $ gcloud beta compute routers get-route-policy diff --git a/gcloud/alpha/compute/routers/list-bgp-routes b/gcloud/alpha/compute/routers/list-bgp-routes index 21c7965aa..df176e579 100644 --- a/gcloud/alpha/compute/routers/list-bgp-routes +++ b/gcloud/alpha/compute/routers/list-bgp-routes @@ -16,6 +16,14 @@ DESCRIPTION advertised and learned on individual BGP sessions, both pre- and post-policy evaluation. +EXAMPLES + To list inbound BGP routes limited to IPv4 addess family from a router + my-router BGP peer my-bgp-peer in region us-central1, run: + + $ gcloud alpha compute routers list-bgp-routes my-router \ + --region=us-central1 --address-family=IPV4 --peer=my-bgp-peer \ + --route-direction=INBOUND" + POSITIONAL ARGUMENTS NAME Name of the router to list. @@ -114,7 +122,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 compute routers list-bgp-routes $ gcloud beta compute routers list-bgp-routes diff --git a/gcloud/alpha/compute/routers/list-route-policies b/gcloud/alpha/compute/routers/list-route-policies index 33a9c32b3..6b9e73392 100644 --- a/gcloud/alpha/compute/routers/list-route-policies +++ b/gcloud/alpha/compute/routers/list-route-policies @@ -11,6 +11,12 @@ DESCRIPTION (ALPHA) gcloud alpha compute routers list-route-policies lists all route policies from a Compute Engine router. +EXAMPLES + To list route policies from a router my-router in region us-central1, run: + + $ gcloud alpha compute routers list-route-policies my-router \ + --region=us-central1 + POSITIONAL ARGUMENTS NAME Name of the router to list. @@ -80,7 +86,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 compute routers list-route-policies $ gcloud beta compute routers list-route-policies diff --git a/gcloud/alpha/compute/routers/remove-route-policy b/gcloud/alpha/compute/routers/remove-route-policy index 7232cd11a..48c62783d 100644 --- a/gcloud/alpha/compute/routers/remove-route-policy +++ b/gcloud/alpha/compute/routers/remove-route-policy @@ -10,6 +10,13 @@ DESCRIPTION (ALPHA) gcloud alpha compute routers remove-route-policy removes a route policy from a Compute Engine router. +EXAMPLES + To remove a route policy my-policy from a router my-router in region + us-central1, run: + + $ gcloud alpha compute routers remove-route-policy my-router \ + --region=us-central1 --policy-name=my-policy + POSITIONAL ARGUMENTS NAME Name of the router to delete. @@ -51,7 +58,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 compute routers remove-route-policy $ gcloud beta compute routers remove-route-policy diff --git a/gcloud/alpha/compute/routers/remove-route-policy-term b/gcloud/alpha/compute/routers/remove-route-policy-term index dd1bf1b65..f00d2ceb6 100644 --- a/gcloud/alpha/compute/routers/remove-route-policy-term +++ b/gcloud/alpha/compute/routers/remove-route-policy-term @@ -11,6 +11,13 @@ DESCRIPTION (ALPHA) gcloud alpha compute routers remove-route-policy-term removes a term of a route policy. +EXAMPLES + To remove a route policy term with priority 0 from a route policy my-policy + from a router my-router in region us-central1, run: + + $ gcloud alpha compute routers remove-route-policy-term my-router \ + --region=us-central1 --policy-name=my-policy --priority=0 + POSITIONAL ARGUMENTS NAME Name of the router to remove a route policy term from. @@ -56,7 +63,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 compute routers remove-route-policy-term $ gcloud beta compute routers remove-route-policy-term diff --git a/gcloud/alpha/compute/routers/update-route-policy-term b/gcloud/alpha/compute/routers/update-route-policy-term index d8d5e1776..c1fbf209c 100644 --- a/gcloud/alpha/compute/routers/update-route-policy-term +++ b/gcloud/alpha/compute/routers/update-route-policy-term @@ -8,16 +8,14 @@ SYNOPSIS --priority=PRIORITY [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Updates a term of an existing route policy of a Comute Engine - router. - - gcloud alpha compute routers update-route-policy-term updates a term of a - route policy. - - For an example, refer to the EXAMPLES section below. + (ALPHA) gcloud alpha compute routers update-route-policy-term updates a + term of a route policy. EXAMPLES - To update a term of a route policy, run: + To update a term with priority 128 with match destination == + '192.168.0.0/24' and actions med.set(12345);asPath.prependSequence([1, 2]) + of a route policy example-policy-name of a router example-router in region + router-region, run: $ gcloud alpha compute routers update-route-policy-term \ example-router --region=router-region \ @@ -76,7 +74,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 compute routers update-route-policy-term $ gcloud beta compute routers update-route-policy-term diff --git a/gcloud/alpha/compute/routers/upload-route-policy b/gcloud/alpha/compute/routers/upload-route-policy index 838f102c3..bc3c167ea 100644 --- a/gcloud/alpha/compute/routers/upload-route-policy +++ b/gcloud/alpha/compute/routers/upload-route-policy @@ -11,6 +11,14 @@ DESCRIPTION (ALPHA) gcloud alpha compute routers upload-route-policy uploads a route policy into a Compute Engine router. +EXAMPLES + To upload a route policy my-import-policy from a file my-import-policy.yaml + into a router my-router in region us-central1, run: + + $ gcloud alpha compute routers upload-route-policy my-router \ + --region=us-central1 --policy-name=my-import-policy \ + --file-name=my-import-policy.yaml" + POSITIONAL ARGUMENTS NAME Name of the router to upload. @@ -59,7 +67,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 compute routers upload-route-policy $ gcloud beta compute routers upload-route-policy diff --git a/gcloud/alpha/compute/url-maps/list-cdn-cache-invalidations b/gcloud/alpha/compute/url-maps/list-cdn-cache-invalidations index c9573b6d2..c0d2f2191 100644 --- a/gcloud/alpha/compute/url-maps/list-cdn-cache-invalidations +++ b/gcloud/alpha/compute/url-maps/list-cdn-cache-invalidations @@ -20,7 +20,8 @@ FLAGS (Default) The URL map is global. Regional URL maps are not supported. --limit=LIMIT - The maximum number of invalidations to list. + The maximum number of invalidations to list. This has an upper limit of + 1000. For more results, use Cloud Logging. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/config/get b/gcloud/alpha/config/get index e54fa8cfe..9bb3625eb 100644 --- a/gcloud/alpha/config/get +++ b/gcloud/alpha/config/get @@ -517,10 +517,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud redis command group. Defaults to https://redis.googleapis.com/ - resourcesettings - Overrides API endpoint for gcloud resource-settings command group. - Defaults to https://resourcesettings.googleapis.com/ - run Overrides API endpoint for gcloud run command group. Defaults to https://run.googleapis.com/ diff --git a/gcloud/alpha/config/help b/gcloud/alpha/config/help index 4c71681cb..2b65f72b8 100644 --- a/gcloud/alpha/config/help +++ b/gcloud/alpha/config/help @@ -549,10 +549,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud redis command group. Defaults to https://redis.googleapis.com/ - resourcesettings - Overrides API endpoint for gcloud resource-settings command group. - Defaults to https://resourcesettings.googleapis.com/ - run Overrides API endpoint for gcloud run command group. Defaults to https://run.googleapis.com/ diff --git a/gcloud/alpha/config/list b/gcloud/alpha/config/list index 4af461005..cba1cecac 100644 --- a/gcloud/alpha/config/list +++ b/gcloud/alpha/config/list @@ -561,10 +561,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud redis command group. Defaults to https://redis.googleapis.com/ - resourcesettings - Overrides API endpoint for gcloud resource-settings command group. - Defaults to https://resourcesettings.googleapis.com/ - run Overrides API endpoint for gcloud run command group. Defaults to https://run.googleapis.com/ diff --git a/gcloud/alpha/config/set b/gcloud/alpha/config/set index 5d72014b9..01cbec4be 100644 --- a/gcloud/alpha/config/set +++ b/gcloud/alpha/config/set @@ -564,10 +564,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud redis command group. Defaults to https://redis.googleapis.com/ - resourcesettings - Overrides API endpoint for gcloud resource-settings command group. - Defaults to https://resourcesettings.googleapis.com/ - run Overrides API endpoint for gcloud run command group. Defaults to https://run.googleapis.com/ diff --git a/gcloud/alpha/config/unset b/gcloud/alpha/config/unset index 6ef8cedc3..23dc3db9f 100644 --- a/gcloud/alpha/config/unset +++ b/gcloud/alpha/config/unset @@ -525,10 +525,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud redis command group. Defaults to https://redis.googleapis.com/ - resourcesettings - Overrides API endpoint for gcloud resource-settings command group. - Defaults to https://resourcesettings.googleapis.com/ - run Overrides API endpoint for gcloud run command group. Defaults to https://run.googleapis.com/ diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index e81bf652d..d9581cfad 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -997,7 +997,7 @@ FLAGS Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM, JOBSET For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/configure-metrics#available-metrics @@ -1089,7 +1089,7 @@ FLAGS on how to manage Pub/Sub topics and subscriptions. You can also use the filter option to specify which event types you'd like to receive from the following options: SecurityBulletinEvent, UpgradeEvent, - UpgradeAvailableEvent. + UpgradeInfoEvent, UpgradeAvailableEvent. Examples: @@ -2308,10 +2308,17 @@ FLAGS --maintenance-window-recurrence=FREQ=DAILY --maintenance-window-end=TIME_STAMP - End time of the first window (can occur in the past). Must take - place after the start time. The difference in start and end time - specifies the length of each recurrence. See $ gcloud topic - datetimes for information on time formats. + The end time for calculating the duration of the maintenance + window, as expressed by the amount of time after the START_TIME, in + the same format. The value for END_TIME must be in the future, + relative to START_TIME. This only calculates the duration of the + window, and doesn't set when the maintenance window stops + recurring. Maintenance windows only stop recurring when they're + removed. See $ gcloud topic datetimes for information on time + formats. + + This flag argument must be specified if any of the other arguments + in this group are specified. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/alpha/container/clusters/create-auto b/gcloud/alpha/container/clusters/create-auto index 1803a91f5..abb770181 100644 --- a/gcloud/alpha/container/clusters/create-auto +++ b/gcloud/alpha/container/clusters/create-auto @@ -350,7 +350,7 @@ FLAGS Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM, JOBSET For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/configure-metrics#available-metrics diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index 962cb7798..99a93a396 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -13,7 +13,9 @@ SYNOPSIS | --containerd-config-from-file=PATH_TO_FILE | --database-encryption-key=DATABASE_ENCRYPTION_KEY | --disable-database-encryption | --disable-default-snat - | --disable-workload-identity | --enable-autoscaling + | --disable-workload-identity + | --[no-]enable-autopilot-compatibility-auditing + | --enable-autoscaling | --[no-]enable-cilium-clusterwide-network-policy | --enable-cost-allocation | --enable-fleet | --enable-fqdn-network-policy | --enable-gke-oidc @@ -308,6 +310,13 @@ REQUIRED FLAGS https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity + --[no-]enable-autopilot-compatibility-auditing + Enables the Autopilot Compatibility Auditing Feature. See + https://cloud.google.com/sdk/gcloud/reference/container/clusters/check-autopilot-compatibility. + Only applicable to clusters with version >= 1.32. Use + --enable-autopilot-compatibility-auditing to enable and + --no-enable-autopilot-compatibility-auditing to disable. + --enable-autoscaling Enables autoscaling for a node pool. @@ -580,7 +589,8 @@ REQUIRED FLAGS https://cloud.google.com/pubsub/docs/admin on how to manage Pub/Sub topics and subscriptions. You can also use the filter option to specify which event types you'd like to receive from the following - options: SecurityBulletinEvent, UpgradeEvent, UpgradeAvailableEvent. + options: SecurityBulletinEvent, UpgradeEvent, UpgradeInfoEvent, + UpgradeAvailableEvent. Examples: @@ -910,7 +920,7 @@ REQUIRED FLAGS Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM, JOBSET For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/configure-metrics#available-metrics @@ -1036,10 +1046,17 @@ REQUIRED FLAGS --maintenance-window-recurrence=FREQ=DAILY --maintenance-window-end=TIME_STAMP - End time of the first window (can occur in the past). Must take - place after the start time. The difference in start and end time - specifies the length of each recurrence. See $ gcloud topic - datetimes for information on time formats. + The end time for calculating the duration of the maintenance + window, as expressed by the amount of time after the START_TIME, + in the same format. The value for END_TIME must be in the future, + relative to START_TIME. This only calculates the duration of the + window, and doesn't set when the maintenance window stops + recurring. Maintenance windows only stop recurring when they're + removed. See $ gcloud topic datetimes for information on time + formats. + + This flag argument must be specified if any of the other + arguments in this group are specified. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/alpha/data-catalog/entries/create b/gcloud/alpha/data-catalog/entries/create index d05a4d7d8..223522516 100644 --- a/gcloud/alpha/data-catalog/entries/create +++ b/gcloud/alpha/data-catalog/entries/create @@ -10,7 +10,10 @@ SYNOPSIS | --schema-from-file=PATH_TO_FILE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a Data Catalog entry. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. + + Create a Data Catalog entry. EXAMPLES To create an entry for a Google Cloud Storage fileset, run: diff --git a/gcloud/alpha/data-catalog/entries/delete b/gcloud/alpha/data-catalog/entries/delete index e04288b5b..8fecf9ec7 100644 --- a/gcloud/alpha/data-catalog/entries/delete +++ b/gcloud/alpha/data-catalog/entries/delete @@ -7,7 +7,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete a Data Catalog entry. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. + + Delete a Data Catalog entry. EXAMPLES To delete the entry 'entry1' in the group 'group1', run: diff --git a/gcloud/alpha/data-catalog/entries/describe b/gcloud/alpha/data-catalog/entries/describe index f8f9c6759..f23b21f88 100644 --- a/gcloud/alpha/data-catalog/entries/describe +++ b/gcloud/alpha/data-catalog/entries/describe @@ -7,7 +7,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Describe a Data Catalog entry. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. + + Describe a Data Catalog entry. EXAMPLES To describe the entry 'entry1' in the group 'group1', run: diff --git a/gcloud/alpha/data-catalog/entries/help b/gcloud/alpha/data-catalog/entries/help index 72185c2d8..ab0580032 100644 --- a/gcloud/alpha/data-catalog/entries/help +++ b/gcloud/alpha/data-catalog/entries/help @@ -16,22 +16,22 @@ COMMANDS COMMAND is one of the following: create - (ALPHA) Create a Data Catalog entry. + (ALPHA) (DEPRECATED) Create a Data Catalog entry. delete - (ALPHA) Delete a Data Catalog entry. + (ALPHA) (DEPRECATED) Delete a Data Catalog entry. describe - (ALPHA) Describe a Data Catalog entry. + (ALPHA) (DEPRECATED) Describe a Data Catalog entry. list - (ALPHA) List all entries in a Data Catalog entry group. + (ALPHA) (DEPRECATED) List all entries in a Data Catalog entry group. lookup - (ALPHA) Lookup a Data Catalog entry by its target name. + (ALPHA) (DEPRECATED) Lookup a Data Catalog entry by its target name. update - (ALPHA) Update a Data Catalog entry. + (ALPHA) (DEPRECATED) Update a Data Catalog entry. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/data-catalog/entries/list b/gcloud/alpha/data-catalog/entries/list index 5dd8b0713..efa501386 100644 --- a/gcloud/alpha/data-catalog/entries/list +++ b/gcloud/alpha/data-catalog/entries/list @@ -9,7 +9,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List all entries in a Data Catalog entry group. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. + + List all entries in a Data Catalog entry group. EXAMPLES To list all entry in the group 'group1', run: diff --git a/gcloud/alpha/data-catalog/entries/lookup b/gcloud/alpha/data-catalog/entries/lookup index 85e79fefd..6a8caf502 100644 --- a/gcloud/alpha/data-catalog/entries/lookup +++ b/gcloud/alpha/data-catalog/entries/lookup @@ -6,7 +6,10 @@ SYNOPSIS gcloud alpha data-catalog entries lookup RESOURCE [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Lookup a Data Catalog entry by its target name. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. + + Lookup a Data Catalog entry by its target name. EXAMPLES To lookup the entry for a Cloud Pub/Sub topic by its Google Cloud Platform diff --git a/gcloud/alpha/data-catalog/entries/update b/gcloud/alpha/data-catalog/entries/update index 333985016..ad252b88a 100644 --- a/gcloud/alpha/data-catalog/entries/update +++ b/gcloud/alpha/data-catalog/entries/update @@ -12,9 +12,12 @@ SYNOPSIS | --schema-from-file=PATH_TO_FILE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update a Data Catalog entry. The entry to update can either be - specified directly, or the --lookup-entry flag may be used to update the - entry corresponding to the lookup of the given resource. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. + + Update a Data Catalog entry. The entry to update can either be specified + directly, or the --lookup-entry flag may be used to update the entry + corresponding to the lookup of the given resource. EXAMPLES To update the schema of a Cloud Pub/Sub entry inline, run: diff --git a/gcloud/alpha/data-catalog/entry-groups/add-iam-policy-binding b/gcloud/alpha/data-catalog/entry-groups/add-iam-policy-binding index 68e4f0c67..a92e34b3d 100644 --- a/gcloud/alpha/data-catalog/entry-groups/add-iam-policy-binding +++ b/gcloud/alpha/data-catalog/entry-groups/add-iam-policy-binding @@ -8,7 +8,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Add an IAM policy binding to a Data Catalog entry group. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + + Add an IAM policy binding to a Data Catalog entry group. EXAMPLES To add an IAM policy binding for the role of 'roles/editor' for the user diff --git a/gcloud/alpha/data-catalog/entry-groups/create b/gcloud/alpha/data-catalog/entry-groups/create index bb4e18436..2d6e95ed3 100644 --- a/gcloud/alpha/data-catalog/entry-groups/create +++ b/gcloud/alpha/data-catalog/entry-groups/create @@ -8,7 +8,10 @@ SYNOPSIS [--display-name=DISPLAY_NAME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a Data Catalog entry group. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + + Create a Data Catalog entry group. EXAMPLES To create an entry group for some data, run: diff --git a/gcloud/alpha/data-catalog/entry-groups/delete b/gcloud/alpha/data-catalog/entry-groups/delete index e4ff2c43b..21d3961d9 100644 --- a/gcloud/alpha/data-catalog/entry-groups/delete +++ b/gcloud/alpha/data-catalog/entry-groups/delete @@ -7,7 +7,10 @@ SYNOPSIS (ENTRY_GROUP : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete a Data Catalog entry group. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + + Delete a Data Catalog entry group. EXAMPLES To delete an entry group for some data, run: diff --git a/gcloud/alpha/data-catalog/entry-groups/describe b/gcloud/alpha/data-catalog/entry-groups/describe index c481e33f6..d16919f56 100644 --- a/gcloud/alpha/data-catalog/entry-groups/describe +++ b/gcloud/alpha/data-catalog/entry-groups/describe @@ -7,7 +7,10 @@ SYNOPSIS (ENTRY_GROUP : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Describe a Data Catalog entry group. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + + Describe a Data Catalog entry group. EXAMPLES To describe an entry group for some data, run: diff --git a/gcloud/alpha/data-catalog/entry-groups/get-iam-policy b/gcloud/alpha/data-catalog/entry-groups/get-iam-policy index c3411de6c..feb6dd5b2 100644 --- a/gcloud/alpha/data-catalog/entry-groups/get-iam-policy +++ b/gcloud/alpha/data-catalog/entry-groups/get-iam-policy @@ -9,12 +9,15 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) gcloud alpha data-catalog entry-groups get-iam-policy displays the - IAM policy associated with a Data Catalog entry group. If formatted as - JSON, the output can be edited and used as a policy file for - set-iam-policy. The output includes an "etag" field identifying the version - emitted and allowing detection of concurrent policy updates; see $ gcloud - alpha data-catalog entry-groups set-iam-policy for additional details. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + + gcloud alpha data-catalog entry-groups get-iam-policy displays the IAM + policy associated with a Data Catalog entry group. If formatted as JSON, + the output can be edited and used as a policy file for set-iam-policy. The + output includes an "etag" field identifying the version emitted and + allowing detection of concurrent policy updates; see $ gcloud alpha + data-catalog entry-groups set-iam-policy for additional details. EXAMPLES To print the IAM policy for entry group 'group1' in 'us-central1', run: diff --git a/gcloud/alpha/data-catalog/entry-groups/help b/gcloud/alpha/data-catalog/entry-groups/help index 3cc9a896d..53f412620 100644 --- a/gcloud/alpha/data-catalog/entry-groups/help +++ b/gcloud/alpha/data-catalog/entry-groups/help @@ -6,7 +6,10 @@ SYNOPSIS gcloud alpha data-catalog entry-groups COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage entry groups in Data Catalog. + (ALPHA) (DEPRECATED) Manage entry groups in Data Catalog. + + This command is deprecated. Please use gcloud dataplex entry-groups + instead. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -17,31 +20,33 @@ COMMANDS COMMAND is one of the following: add-iam-policy-binding - (ALPHA) Add an IAM policy binding to a Data Catalog entry group. + (ALPHA) (DEPRECATED) Add an IAM policy binding to a Data Catalog entry + group. create - (ALPHA) Create a Data Catalog entry group. + (ALPHA) (DEPRECATED) Create a Data Catalog entry group. delete - (ALPHA) Delete a Data Catalog entry group. + (ALPHA) (DEPRECATED) Delete a Data Catalog entry group. describe - (ALPHA) Describe a Data Catalog entry group. + (ALPHA) (DEPRECATED) Describe a Data Catalog entry group. get-iam-policy - (ALPHA) Get the IAM policy for a Data Catalog entry group. + (ALPHA) (DEPRECATED) Get the IAM policy for a Data Catalog entry group. list - (ALPHA) List all entry groups in a Data Catalog location. + (ALPHA) (DEPRECATED) List all entry groups in a Data Catalog location. remove-iam-policy-binding - (ALPHA) Remove an IAM policy binding from a Data Catalog entry group. + (ALPHA) (DEPRECATED) Remove an IAM policy binding from a Data Catalog + entry group. set-iam-policy - (ALPHA) Set the IAM policy for a Data Catalog entry group. + (ALPHA) (DEPRECATED) Set the IAM policy for a Data Catalog entry group. update - (ALPHA) Update a Data Catalog entry group. + (ALPHA) (DEPRECATED) Update a Data Catalog entry group. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/data-catalog/entry-groups/list b/gcloud/alpha/data-catalog/entry-groups/list index ee694d6dd..ae8e5e460 100644 --- a/gcloud/alpha/data-catalog/entry-groups/list +++ b/gcloud/alpha/data-catalog/entry-groups/list @@ -8,7 +8,10 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List all entries in a Data Catalog location. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + + List all entries in a Data Catalog location. EXAMPLES To list all entry groups in us-central1, run: diff --git a/gcloud/alpha/data-catalog/entry-groups/remove-iam-policy-binding b/gcloud/alpha/data-catalog/entry-groups/remove-iam-policy-binding index 5f1231e89..b9c6fce6c 100644 --- a/gcloud/alpha/data-catalog/entry-groups/remove-iam-policy-binding +++ b/gcloud/alpha/data-catalog/entry-groups/remove-iam-policy-binding @@ -8,7 +8,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Remove an IAM policy binding from a Data Catalog entry group. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + + Remove an IAM policy binding from a Data Catalog entry group. EXAMPLES To remove an IAM policy binding for the role of 'roles/editor' for the user diff --git a/gcloud/alpha/data-catalog/entry-groups/set-iam-policy b/gcloud/alpha/data-catalog/entry-groups/set-iam-policy index 21a3a1555..c94c33584 100644 --- a/gcloud/alpha/data-catalog/entry-groups/set-iam-policy +++ b/gcloud/alpha/data-catalog/entry-groups/set-iam-policy @@ -7,8 +7,11 @@ SYNOPSIS (ENTRY_GROUP : --location=LOCATION) POLICY_FILE [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Set the IAM policy for the given Data Catalog entry group as - defined in a JSON or YAML file. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + + Set the IAM policy for the given Data Catalog entry group as defined in a + JSON or YAML file. EXAMPLES The following command will read am IAM policy defined in a JSON file diff --git a/gcloud/alpha/data-catalog/entry-groups/update b/gcloud/alpha/data-catalog/entry-groups/update index f1fd7fb32..4c9668ab8 100644 --- a/gcloud/alpha/data-catalog/entry-groups/update +++ b/gcloud/alpha/data-catalog/entry-groups/update @@ -8,7 +8,10 @@ SYNOPSIS [--display-name=DISPLAY_NAME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update a Data Catalog entry group. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + + Update a Data Catalog entry group. EXAMPLES To update the description of entry group 'group1' , run: diff --git a/gcloud/alpha/data-catalog/help b/gcloud/alpha/data-catalog/help index 2b550ad95..3351128fa 100644 --- a/gcloud/alpha/data-catalog/help +++ b/gcloud/alpha/data-catalog/help @@ -25,13 +25,13 @@ GROUPS (ALPHA) Manage entries in Data Catalog. entry-groups - (ALPHA) Manage entry groups in Data Catalog. + (ALPHA) (DEPRECATED) Manage entry groups in Data Catalog. tag-templates - (ALPHA) Manage tag templates in Data Catalog. + (ALPHA) (DEPRECATED) Manage tag templates in Data Catalog. tags - (ALPHA) Manage tags in Data Catalog. + (ALPHA) (DEPRECATED) Manage tags in Data Catalog. taxonomies (ALPHA) Manage taxonomies in Data Catalog. @@ -40,7 +40,8 @@ COMMANDS COMMAND is one of the following: search - (ALPHA) Search Data Catalog for resources that match a query. + (ALPHA) (DEPRECATED) Search Data Catalog for resources that match a + query. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/data-catalog/search b/gcloud/alpha/data-catalog/search index 7245d6fb8..196d2eec5 100644 --- a/gcloud/alpha/data-catalog/search +++ b/gcloud/alpha/data-catalog/search @@ -11,7 +11,10 @@ SYNOPSIS [--order-by=ORDER_BY] [--page-size=PAGE_SIZE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Search Data Catalog for resources that match a query. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries search instead. + + Search Data Catalog for resources that match a query. EXAMPLES To search project 'my-project' for Data Catalog resources that match the diff --git a/gcloud/alpha/data-catalog/tag-templates/add-iam-policy-binding b/gcloud/alpha/data-catalog/tag-templates/add-iam-policy-binding index e9020d92f..da1e3d7c6 100644 --- a/gcloud/alpha/data-catalog/tag-templates/add-iam-policy-binding +++ b/gcloud/alpha/data-catalog/tag-templates/add-iam-policy-binding @@ -8,7 +8,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Add IAM policy binding to a Data Catalog tag template. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Add IAM policy binding to a Data Catalog tag template. EXAMPLES To add an IAM policy binding for the role of 'roles/editor' for the user diff --git a/gcloud/alpha/data-catalog/tag-templates/create b/gcloud/alpha/data-catalog/tag-templates/create index cd0567c5d..1844a875a 100644 --- a/gcloud/alpha/data-catalog/tag-templates/create +++ b/gcloud/alpha/data-catalog/tag-templates/create @@ -10,7 +10,10 @@ SYNOPSIS [--display-name=DISPLAY_NAME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a Data Catalog tag template. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Create a Data Catalog tag template. EXAMPLES Create a string tag template with a required string field: diff --git a/gcloud/alpha/data-catalog/tag-templates/delete b/gcloud/alpha/data-catalog/tag-templates/delete index 63868ed85..2d3775083 100644 --- a/gcloud/alpha/data-catalog/tag-templates/delete +++ b/gcloud/alpha/data-catalog/tag-templates/delete @@ -7,7 +7,10 @@ SYNOPSIS (TAG_TEMPLATE : --location=LOCATION) [--force] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete a Data Catalog tag template. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Delete a Data Catalog tag template. EXAMPLES Delete a tag template: diff --git a/gcloud/alpha/data-catalog/tag-templates/describe b/gcloud/alpha/data-catalog/tag-templates/describe index 956d0344c..4fced63c6 100644 --- a/gcloud/alpha/data-catalog/tag-templates/describe +++ b/gcloud/alpha/data-catalog/tag-templates/describe @@ -7,7 +7,10 @@ SYNOPSIS (TAG_TEMPLATE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Describe a Data Catalog tag template. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Describe a Data Catalog tag template. EXAMPLES Describe a tag template: diff --git a/gcloud/alpha/data-catalog/tag-templates/fields/create b/gcloud/alpha/data-catalog/tag-templates/fields/create index 775697c9e..627dd8100 100644 --- a/gcloud/alpha/data-catalog/tag-templates/fields/create +++ b/gcloud/alpha/data-catalog/tag-templates/fields/create @@ -8,7 +8,10 @@ SYNOPSIS [--display-name=DISPLAY_NAME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a Data Catalog tag template field. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Create a Data Catalog tag template field. EXAMPLES Create a string tag template field: diff --git a/gcloud/alpha/data-catalog/tag-templates/fields/delete b/gcloud/alpha/data-catalog/tag-templates/fields/delete index db40f84ae..f6c016b68 100644 --- a/gcloud/alpha/data-catalog/tag-templates/fields/delete +++ b/gcloud/alpha/data-catalog/tag-templates/fields/delete @@ -8,7 +8,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete a Data Catalog tag template field. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Delete a Data Catalog tag template field. EXAMPLES Delete a tag template field: diff --git a/gcloud/alpha/data-catalog/tag-templates/fields/enum-values/help b/gcloud/alpha/data-catalog/tag-templates/fields/enum-values/help index 440425ee5..bf56a8fde 100644 --- a/gcloud/alpha/data-catalog/tag-templates/fields/enum-values/help +++ b/gcloud/alpha/data-catalog/tag-templates/fields/enum-values/help @@ -7,7 +7,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage tag template enum values in Data Catalog. + (ALPHA) (DEPRECATED) Manage tag template enum values in Data Catalog. + + This command is deprecated. Please use gcloud dataplex aspect-types + instead. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,7 +21,8 @@ COMMANDS COMMAND is one of the following: rename - (ALPHA) Rename an enum value in Data Catalog tag template enum field. + (ALPHA) (DEPRECATED) Rename an enum value in Data Catalog tag template + enum field. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/data-catalog/tag-templates/fields/enum-values/rename b/gcloud/alpha/data-catalog/tag-templates/fields/enum-values/rename index cb6f50373..ba46daa56 100644 --- a/gcloud/alpha/data-catalog/tag-templates/fields/enum-values/rename +++ b/gcloud/alpha/data-catalog/tag-templates/fields/enum-values/rename @@ -9,7 +9,10 @@ SYNOPSIS --new-id=NEW_ID [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Rename an enum value in Data Catalog tag template enum field. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Rename an enum value in Data Catalog tag template enum field. EXAMPLES Rename an enum value in tag template enum field: diff --git a/gcloud/alpha/data-catalog/tag-templates/fields/help b/gcloud/alpha/data-catalog/tag-templates/fields/help index 9dba50996..b815c83a8 100644 --- a/gcloud/alpha/data-catalog/tag-templates/fields/help +++ b/gcloud/alpha/data-catalog/tag-templates/fields/help @@ -7,7 +7,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage tag template fields in Data Catalog. + (ALPHA) (DEPRECATED) Manage tag template fields in Data Catalog. + + This command is deprecated. Please use gcloud dataplex aspect-types + instead. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,22 +21,22 @@ GROUPS GROUP is one of the following: enum-values - (ALPHA) Manage tag template enum values in Data Catalog. + (ALPHA) (DEPRECATED) Manage tag template enum values in Data Catalog. COMMANDS COMMAND is one of the following: create - (ALPHA) Create a Data Catalog tag template field. + (ALPHA) (DEPRECATED) Create a Data Catalog tag template field. delete - (ALPHA) Delete a Data Catalog tag template field. + (ALPHA) (DEPRECATED) Delete a Data Catalog tag template field. rename - (ALPHA) Rename a Data Catalog tag template field. + (ALPHA) (DEPRECATED) Rename a Data Catalog tag template field. update - (ALPHA) Update a Data Catalog tag template field. + (ALPHA) (DEPRECATED) Update a Data Catalog tag template field. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/data-catalog/tag-templates/fields/rename b/gcloud/alpha/data-catalog/tag-templates/fields/rename index e3e86cb42..1075d72dd 100644 --- a/gcloud/alpha/data-catalog/tag-templates/fields/rename +++ b/gcloud/alpha/data-catalog/tag-templates/fields/rename @@ -8,7 +8,10 @@ SYNOPSIS --new-id=NEW_ID [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Rename a Data Catalog tag template field. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Rename a Data Catalog tag template field. EXAMPLES Update the ID of a tag template field: diff --git a/gcloud/alpha/data-catalog/tag-templates/fields/update b/gcloud/alpha/data-catalog/tag-templates/fields/update index 9c46ffea0..d086763ce 100644 --- a/gcloud/alpha/data-catalog/tag-templates/fields/update +++ b/gcloud/alpha/data-catalog/tag-templates/fields/update @@ -9,7 +9,10 @@ SYNOPSIS [--required] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update a Data Catalog tag template field. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Update a Data Catalog tag template field. EXAMPLES Update the display name of a tag template field: diff --git a/gcloud/alpha/data-catalog/tag-templates/get-iam-policy b/gcloud/alpha/data-catalog/tag-templates/get-iam-policy index 8a58bf712..64da9882d 100644 --- a/gcloud/alpha/data-catalog/tag-templates/get-iam-policy +++ b/gcloud/alpha/data-catalog/tag-templates/get-iam-policy @@ -9,12 +9,15 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) gcloud alpha data-catalog tag-templates get-iam-policy displays the - IAM policy associated with a Data Catalog. If formatted as JSON, the output - can be edited and used as a policy file for set-iam-policy. The output - includes an "etag" field identifying the version emitted and allowing - detection of concurrent policy updates; see $ gcloud alpha data-catalog - tag-templates set-iam-policy for additional details. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + gcloud alpha data-catalog tag-templates get-iam-policy displays the IAM + policy associated with a Data Catalog. If formatted as JSON, the output can + be edited and used as a policy file for set-iam-policy. The output includes + an "etag" field identifying the version emitted and allowing detection of + concurrent policy updates; see $ gcloud alpha data-catalog tag-templates + set-iam-policy for additional details. EXAMPLES To print the IAM policy for a given tag template, run: diff --git a/gcloud/alpha/data-catalog/tag-templates/help b/gcloud/alpha/data-catalog/tag-templates/help index 989a6992b..97a0481d3 100644 --- a/gcloud/alpha/data-catalog/tag-templates/help +++ b/gcloud/alpha/data-catalog/tag-templates/help @@ -7,7 +7,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage tag templates in Data Catalog. + (ALPHA) (DEPRECATED) Manage tag templates in Data Catalog. + + This command is deprecated. Please use gcloud dataplex aspect-types + instead. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,34 +21,38 @@ GROUPS GROUP is one of the following: fields - (ALPHA) Manage tag template fields in Data Catalog. + (ALPHA) (DEPRECATED) Manage tag template fields in Data Catalog. COMMANDS COMMAND is one of the following: add-iam-policy-binding - (ALPHA) Add IAM policy binding to a Data Catalog tag template. + (ALPHA) (DEPRECATED) Add IAM policy binding to a Data Catalog tag + template. create - (ALPHA) Create a Data Catalog tag template. + (ALPHA) (DEPRECATED) Create a Data Catalog tag template. delete - (ALPHA) Delete a Data Catalog tag template. + (ALPHA) (DEPRECATED) Delete a Data Catalog tag template. describe - (ALPHA) Describe a Data Catalog tag template. + (ALPHA) (DEPRECATED) Describe a Data Catalog tag template. get-iam-policy - (ALPHA) Get the IAM policy for a Data Catalog tag template. + (ALPHA) (DEPRECATED) Get the IAM policy for a Data Catalog tag + template. remove-iam-policy-binding - (ALPHA) Remove IAM policy binding from a Data Catalog tag template. + (ALPHA) (DEPRECATED) Remove IAM policy binding from a Data Catalog tag + template. set-iam-policy - (ALPHA) Set the IAM policy for a Data Catalog tag template. + (ALPHA) (DEPRECATED) Set the IAM policy for a Data Catalog tag + template. update - (ALPHA) Update a Data Catalog tag template. + (ALPHA) (DEPRECATED) Update a Data Catalog tag template. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/data-catalog/tag-templates/remove-iam-policy-binding b/gcloud/alpha/data-catalog/tag-templates/remove-iam-policy-binding index c81102ea1..4475c6ea3 100644 --- a/gcloud/alpha/data-catalog/tag-templates/remove-iam-policy-binding +++ b/gcloud/alpha/data-catalog/tag-templates/remove-iam-policy-binding @@ -8,7 +8,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Removes a policy binding from the IAM policy of a Data Catalog tag + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Removes a policy binding from the IAM policy of a Data Catalog tag template, given a project ID and the binding. EXAMPLES diff --git a/gcloud/alpha/data-catalog/tag-templates/set-iam-policy b/gcloud/alpha/data-catalog/tag-templates/set-iam-policy index 63deeca2b..320b6ed5f 100644 --- a/gcloud/alpha/data-catalog/tag-templates/set-iam-policy +++ b/gcloud/alpha/data-catalog/tag-templates/set-iam-policy @@ -7,8 +7,11 @@ SYNOPSIS (TAG_TEMPLATE : --location=LOCATION) POLICY_FILE [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Sets the IAM policy for the given Data Catalog tag template as - defined in a JSON or YAML file. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Sets the IAM policy for the given Data Catalog tag template as defined in a + JSON or YAML file. EXAMPLES The following command will read am IAM policy defined in a JSON file diff --git a/gcloud/alpha/data-catalog/tag-templates/update b/gcloud/alpha/data-catalog/tag-templates/update index 6301b9518..ba239af7e 100644 --- a/gcloud/alpha/data-catalog/tag-templates/update +++ b/gcloud/alpha/data-catalog/tag-templates/update @@ -8,7 +8,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update a Data Catalog tag template. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Update a Data Catalog tag template. EXAMPLES Update the display name of a tag template: diff --git a/gcloud/alpha/data-catalog/tags/create b/gcloud/alpha/data-catalog/tags/create index 92c0e8894..b5f9f4058 100644 --- a/gcloud/alpha/data-catalog/tags/create +++ b/gcloud/alpha/data-catalog/tags/create @@ -10,7 +10,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a Data Catalog entry tag. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. Note that aspects - successors of tags - are part of the + entry resource and are managed by gcloud dataplex entries command. + + Create a Data Catalog entry tag. EXAMPLES Create a Data Catalog entry tag: diff --git a/gcloud/alpha/data-catalog/tags/delete b/gcloud/alpha/data-catalog/tags/delete index 43d82835b..20c36996b 100644 --- a/gcloud/alpha/data-catalog/tags/delete +++ b/gcloud/alpha/data-catalog/tags/delete @@ -7,7 +7,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete a Data Catalog entry tag. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. Note that aspects - successors of tags - are part of the + entry resource and are managed by gcloud dataplex entries command. + + Delete a Data Catalog entry tag. EXAMPLES Delete a Data Catalog entry tag: diff --git a/gcloud/alpha/data-catalog/tags/help b/gcloud/alpha/data-catalog/tags/help index c5fda27a1..a537e88b7 100644 --- a/gcloud/alpha/data-catalog/tags/help +++ b/gcloud/alpha/data-catalog/tags/help @@ -5,7 +5,11 @@ SYNOPSIS gcloud alpha data-catalog tags COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage tags in Data Catalog. + (ALPHA) (DEPRECATED) Manage tags in Data Catalog. + + This command is deprecated. Please use gcloud dataplex entries instead. + Note that aspects - successors of tags - are part of the entry resource and + are managed by gcloud dataplex entries command. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -16,16 +20,16 @@ COMMANDS COMMAND is one of the following: create - (ALPHA) Create a Data Catalog entry tag. + (ALPHA) (DEPRECATED) Create a Data Catalog entry tag. delete - (ALPHA) Delete a Data Catalog entry tag. + (ALPHA) (DEPRECATED) Delete a Data Catalog entry tag. list - (ALPHA) List Data Catalog entry tags. + (ALPHA) (DEPRECATED) List Data Catalog entry tags. update - (ALPHA) Update a Data Catalog entry tag. + (ALPHA) (DEPRECATED) Update a Data Catalog entry tag. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/data-catalog/tags/list b/gcloud/alpha/data-catalog/tags/list index df0b593d0..442fa25b6 100644 --- a/gcloud/alpha/data-catalog/tags/list +++ b/gcloud/alpha/data-catalog/tags/list @@ -8,7 +8,11 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List Data Catalog entry tags. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. Note that aspects - successors of tags - are part of the + entry resource and are managed by gcloud dataplex entries command. + + List Data Catalog entry tags. EXAMPLES List the tags for a Data Catalog entry: diff --git a/gcloud/alpha/data-catalog/tags/update b/gcloud/alpha/data-catalog/tags/update index d4133564f..5a6967f26 100644 --- a/gcloud/alpha/data-catalog/tags/update +++ b/gcloud/alpha/data-catalog/tags/update @@ -10,8 +10,12 @@ SYNOPSIS --tag-template-project=TAG_TEMPLATE_PROJECT) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update a Data Catalog entry tag. This will overwrite the current - values of the tag. + (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. Note that aspects - successors of tags - are part of the + entry resource and are managed by gcloud dataplex entries command. + + Update a Data Catalog entry tag. This will overwrite the current values of + the tag. EXAMPLES Update a Data Catalog entry tag: diff --git a/gcloud/alpha/kms/keys/versions/get-public-key b/gcloud/alpha/kms/keys/versions/get-public-key index 6d2c38b91..f887bc21c 100644 --- a/gcloud/alpha/kms/keys/versions/get-public-key +++ b/gcloud/alpha/kms/keys/versions/get-public-key @@ -16,8 +16,8 @@ DESCRIPTION The optional flag public-key-format indicates the format in which the public key will be returned. For the PQC algorithms, this must be specified - and set to NIST_PQC. For all other algorithms, this flag is optional and - defaults to PEM. See "Retrieve a public key" in the Cloud KMS documentation + and set to nist-pqc. For all other algorithms, this flag is optional and + defaults to pem. See "Retrieve a public key" in the Cloud KMS documentation (https://cloud.google.com/kms/docs/retrieve-public-key) for more information about the supported formats. @@ -27,7 +27,7 @@ EXAMPLES $ gcloud alpha kms keys versions get-public-key 2 --key=frodo \ --keyring=fellowship --location=us-east1 \ - --public-key-format=PEM --output-file=/tmp/my/public_key.file + --public-key-format=pem --output-file=/tmp/my/public_key.file POSITIONAL ARGUMENTS VERSION diff --git a/gcloud/alpha/memorystore/instances/create b/gcloud/alpha/memorystore/instances/create index 753573f38..2fa2a020e 100644 --- a/gcloud/alpha/memorystore/instances/create +++ b/gcloud/alpha/memorystore/instances/create @@ -3,14 +3,15 @@ NAME SYNOPSIS gcloud alpha memorystore instances create (INSTANCE : --location=LOCATION) - [--async] [--authorization-mode=AUTHORIZATION_MODE] + [--async] [--async-instance-endpoints-deletion-enabled] + [--authorization-mode=AUTHORIZATION_MODE] [--deletion-protection-enabled] [--endpoints=[connections=CONNECTIONS]] [--engine-configs=[ENGINE_CONFIGS,...]] [--engine-version=ENGINE_VERSION] [--labels=[LABELS,...]] [--mode=MODE] - [--node-type=NODE_TYPE] - [--psc-auto-connections=[network=NETWORK],[projectId=PROJECTID]] - [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] - [--shard-count=SHARD_COUNT] + [--node-type=NODE_TYPE] [--ondemand-maintenance] + [--psc-auto-connections=[network=NETWORK], + [port=PORT],[projectId=PROJECTID]] [--replica-count=REPLICA_COUNT] + [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] [--transit-encryption-mode=TRANSIT_ENCRYPTION_MODE] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC --persistence-config-mode=PERSISTENCE_CONFIG_MODE @@ -83,6 +84,14 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + Arguments for the async instance endpoints deletion enabled. + + --async-instance-endpoints-deletion-enabled + If true, instance endpoints that are created and registered by + customers can be deleted asynchronously. That is, such an instance + endpoint can be de-registered before the forwarding rules in the + instance endpoint are deleted. + --authorization-mode=AUTHORIZATION_MODE Authorization mode of the instance. AUTHORIZATION_MODE must be one of: @@ -111,6 +120,10 @@ FLAGS The network where the PSC endpoints are created, in the form of projects/{project_id}/global/networks/{network_id}. + port + port will only be set for Primary/Reader or Discovery + endpoint. + projectId The consumer project_id where PSC connections are established. This should be the same project_id that the @@ -118,11 +131,11 @@ FLAGS Shorthand Example: - --endpoints=connections=[{pscAutoConnection={network=string,projectId=string}}] --endpoints=connections=[{pscAutoConnection={network=string,projectId=string}}] + --endpoints=connections=[{pscAutoConnection={network=string,port=int,projectId=string}}] --endpoints=connections=[{pscAutoConnection={network=string,port=int,projectId=string}}] JSON Example: - --endpoints='[{"connections": [{"pscAutoConnection": {"network": "string", "projectId": "string"}}]}]' + --endpoints='[{"connections": [{"pscAutoConnection": {"network": "string", "port": int, "projectId": "string"}}]}]' File Example: @@ -198,13 +211,21 @@ FLAGS standard-small Standard small. - --psc-auto-connections=[network=NETWORK],[projectId=PROJECTID] + Arguments for the ondemand maintenance. + + --ondemand-maintenance + Ondemand maintenance for the instance. + + --psc-auto-connections=[network=NETWORK],[port=PORT],[projectId=PROJECTID] User inputs and resource details of the auto-created PSC connections. network The network where the PSC endpoints are created, in the form of projects/{project_id}/global/networks/{network_id}. + port + port will only be set for Primary/Reader or Discovery endpoint. + projectId The consumer project_id where PSC connections are established. This should be the same project_id that the instance is being created @@ -212,11 +233,11 @@ FLAGS Shorthand Example: - --psc-auto-connections=network=string,projectId=string --psc-auto-connections=network=string,projectId=string + --psc-auto-connections=network=string,port=int,projectId=string --psc-auto-connections=network=string,port=int,projectId=string JSON Example: - --psc-auto-connections='[{"network": "string", "projectId": "string"}]' + --psc-auto-connections='[{"network": "string", "port": int, "projectId": "string"}]' File Example: diff --git a/gcloud/alpha/memorystore/instances/update b/gcloud/alpha/memorystore/instances/update index 5ed001fc2..85b1c08fa 100644 --- a/gcloud/alpha/memorystore/instances/update +++ b/gcloud/alpha/memorystore/instances/update @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud alpha memorystore instances update (INSTANCE : --location=LOCATION) - [--async] [--[no-]deletion-protection-enabled] [--mode=MODE] + [--async] [--[no-]async-instance-endpoints-deletion-enabled] + [--[no-]deletion-protection-enabled] [--engine-version=ENGINE_VERSION] + [--mode=MODE] [--node-type=NODE_TYPE] [--[no-]ondemand-maintenance] [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC @@ -77,6 +79,16 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + Arguments for the async instance endpoints deletion enabled. + + --[no-]async-instance-endpoints-deletion-enabled + If true, instance endpoints that are created and registered by + customers can be deleted asynchronously. That is, such an instance + endpoint can be de-registered before the forwarding rules in the + instance endpoint are deleted. Use + --async-instance-endpoints-deletion-enabled to enable and + --no-async-instance-endpoints-deletion-enabled to disable. + Arguments for the deletion protection enabled. --[no-]deletion-protection-enabled @@ -84,6 +96,9 @@ FLAGS --deletion-protection-enabled to enable and --no-deletion-protection-enabled to disable. + --engine-version=ENGINE_VERSION + Engine version of the instance. + --mode=MODE The mode config for the instance. MODE must be one of: @@ -94,6 +109,25 @@ FLAGS standalone Deprecated: Use CLUSTER_DISABLED instead. + --node-type=NODE_TYPE + Machine type for individual nodes of the instance. NODE_TYPE must be + one of: + + highmem-medium + High memory medium. + highmem-xlarge + High memory extra large. + shared-core-nano + Shared core nano. + standard-small + Standard small. + + Arguments for the ondemand maintenance. + + --[no-]ondemand-maintenance + Ondemand maintenance for the instance. Use --ondemand-maintenance to + enable and --no-ondemand-maintenance to disable. + Arguments for the replica count. --replica-count=REPLICA_COUNT diff --git a/gcloud/alpha/metastore/services/create b/gcloud/alpha/metastore/services/create index c5eef972a..9da023ff0 100644 --- a/gcloud/alpha/metastore/services/create +++ b/gcloud/alpha/metastore/services/create @@ -6,7 +6,7 @@ SYNOPSIS gcloud alpha metastore services create (SERVICE : --location=LOCATION) [--async] [--autoscaling-enabled] [--data-catalog-sync] [--database-type=DATABASE_TYPE; default="mysql"] - [--deletion-protection] [--encryption-kms-key=ENCRYPTION_KMS_KEY] + [--deletion-protection] [--endpoint-protocol=ENDPOINT_PROTOCOL; default="thrift"] [--hive-metastore-version=HIVE_METASTORE_VERSION] [--labels=[KEY=VALUE,...]] [--port=PORT; default=9083] @@ -15,6 +15,8 @@ SYNOPSIS | --auxiliary-versions-from-file=AUXILIARY_VERSIONS_FROM_FILE] [--consumer-subnetworks=[CONSUMER_SUBNETWORKS,...] | --network=NETWORK | --network-config-from-file=NETWORK_CONFIG_FROM_FILE] + [--encryption-kms-key=ENCRYPTION_KMS_KEY + | --encryption-kms-keys=[ENCRYPTION_KMS_KEYS,...]] [--hive-metastore-configs=[KEY=VALUE,...] | --hive-metastore-configs-from-file=PATH_TO_FILE] [--instance-size=INSTANCE_SIZE | --scaling-factor=SCALING_FACTOR @@ -125,13 +127,6 @@ FLAGS prevent accidental deletions of the instance. Use --deletion-protection to enable. - --encryption-kms-key=ENCRYPTION_KMS_KEY - The name of the Cloud KMS key to use for customer data encryption. - Cannot be changed once the service is created. Mutually exclusive with - flag --data-catalog-sync. This can be provided as a fully-qualified - URL, or a relative name in the form - projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{crypto_key_id}. - --endpoint-protocol=ENDPOINT_PROTOCOL; default="thrift" The protocol to use for the metastore service endpoint. If unspecified, defaults to THRIFT. ENDPOINT_PROTOCOL must be one of: @@ -243,6 +238,25 @@ FLAGS projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork_id} ... + Encryption configuration for the metastore service. + + At most one of these can be specified: + + --encryption-kms-key=ENCRYPTION_KMS_KEY + The name of the Cloud KMS key to use for customer data encryption. + Cannot be changed once the service is created. Mutually exclusive + with flag --data-catalog-sync. This can be provided as a + fully-qualified URL, or a relative name in the form + projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{crypto_key_id}. + + --encryption-kms-keys=[ENCRYPTION_KMS_KEYS,...] + Comma-separated list of the Cloud KMS keys to use for customer data + encryption. Cannot be changed once the service is created. Mutually + exclusive with flag --data-catalog-sync and --encryption-kms-key. + Each key can be provided as a fully-qualified URL, or a relative name + in the form + projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{crypto_key_id}. + Configuration properties specific to running Hive metastore software as the metastore service. diff --git a/gcloud/alpha/migration/vms/image-imports/create b/gcloud/alpha/migration/vms/image-imports/create index 0a77d080d..3db6a1c64 100644 --- a/gcloud/alpha/migration/vms/image-imports/create +++ b/gcloud/alpha/migration/vms/image-imports/create @@ -10,8 +10,8 @@ SYNOPSIS [--image-name=IMAGE_NAME] [--kms-key=KMS_KEY] [--labels=[KEY=VALUE,...]] [--single-region-storage] [--target-project=TARGET_PROJECT] - [--skip-os-adaptation | --generalize --license-type=LICENSE_TYPE] - [GCLOUD_WIDE_FLAG ...] + [--skip-os-adaptation | --boot-conversion=BOOT_CONVERSION + --generalize --license-type=LICENSE_TYPE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha migration vms image-imports create imports images such @@ -108,6 +108,15 @@ OPTIONAL FLAGS --skip-os-adaptation If true, skip OS adaptation. Default false. + --boot-conversion=BOOT_CONVERSION + This property will trigger an internal process which will convert the + image from using the existing boot option to another. The size of the + boot disk might be increased to allow the conversion. Currently only + support BIOS_TO_EFI. + + BOOT_CONVERSION must be one of: bios-to-efi, + boot-conversion-unspecified, none. + --generalize If true, generalize the imported image. Default false. The generalization process enables co-existence of multiple VMs created diff --git a/gcloud/alpha/migration/vms/machine-image-imports/create b/gcloud/alpha/migration/vms/machine-image-imports/create index 2953c5ed0..7ea1ecb70 100644 --- a/gcloud/alpha/migration/vms/machine-image-imports/create +++ b/gcloud/alpha/migration/vms/machine-image-imports/create @@ -15,8 +15,8 @@ SYNOPSIS [--target-project=TARGET_PROJECT] [--enable-integrity-monitoring --enable-vtpm --secure-boot=SECURE_BOOT] [--scopes=[SCOPES,...] --service-account=SERVICE_ACCOUNT] - [--skip-os-adaptation | --generalize --license-type=LICENSE_TYPE] - [GCLOUD_WIDE_FLAG ...] + [--skip-os-adaptation | --boot-conversion=BOOT_CONVERSION + --generalize --license-type=LICENSE_TYPE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha migration vms machine-image-imports create Imports @@ -157,6 +157,13 @@ OPTIONAL FLAGS --skip-os-adaptation If true, skip OS adaptation. Default false. + --boot-conversion=BOOT_CONVERSION + This property will trigger an internal process which will convert the + image from using the existing boot option to another. The size of the + boot disk might be increased to allow the conversion. Currently only + support BIOS_TO_EFI. BOOT_CONVERSION must be one of: bios-to-efi, + boot-conversion-unspecified, none. + --generalize If true, generalize the imported machine image. Default false. The generalization process enables co-existence of multiple VMs created diff --git a/gcloud/alpha/network-connectivity/internal-ranges/create b/gcloud/alpha/network-connectivity/internal-ranges/create index a751b5a78..339d7a8e1 100644 --- a/gcloud/alpha/network-connectivity/internal-ranges/create +++ b/gcloud/alpha/network-connectivity/internal-ranges/create @@ -6,7 +6,8 @@ SYNOPSIS gcloud alpha network-connectivity internal-ranges create (INTERNAL_RANGE : --region=REGION) --network=NETWORK (--ip-cidr-range=IP_CIDR_RANGE | [--prefix-length=PREFIX_LENGTH - : --target-cidr-range=[TARGET_CIDR_RANGE,...]]) [--async] + : --exclude-cidr-ranges=[EXCLUDE_CIDR_RANGES,...] + --target-cidr-range=[TARGET_CIDR_RANGE,...]]) [--async] [--description=DESCRIPTION] [--immutable] [--labels=[KEY=VALUE,...]] [--overlaps=[OVERLAPS,...]] [--peering=PEERING; default="for-self"] [--usage=USAGE; default="for-vpc"] @@ -89,6 +90,12 @@ REQUIRED FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --exclude-cidr-ranges=[EXCLUDE_CIDR_RANGES,...] + A list of CIDR ranges to exclude from the search for a free range. + This can be used to exclude specific ranges that are already intended + to have some other use. This option can only be used if prefix length + is also set. + --target-cidr-range=[TARGET_CIDR_RANGE,...] Can be set to narrow down or pick a different address space while searching for a free range. If not set, defaults to the "10.0.0.0/8" diff --git a/gcloud/alpha/pubsub/help b/gcloud/alpha/pubsub/help index a0fad6654..8d95a9e56 100644 --- a/gcloud/alpha/pubsub/help +++ b/gcloud/alpha/pubsub/help @@ -28,6 +28,9 @@ GROUPS lite-topics (ALPHA) Manage Pub/Sub Lite topics. + message-transforms + (ALPHA) Manage Cloud Pub/Sub message transforms. + schemas (ALPHA) Manage Pub/Sub schemas. diff --git a/gcloud/alpha/pubsub/message-transforms/help b/gcloud/alpha/pubsub/message-transforms/help new file mode 100644 index 000000000..b0742708c --- /dev/null +++ b/gcloud/alpha/pubsub/message-transforms/help @@ -0,0 +1,30 @@ +NAME + gcloud alpha pubsub message-transforms - manage Cloud Pub/Sub message + transforms + +SYNOPSIS + gcloud alpha pubsub message-transforms COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Cloud Pub/Sub message transforms. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + test + (ALPHA) Tests messages transforms against a given message. + + validate + (ALPHA) Validates a message transform. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/pubsub/message-transforms/test b/gcloud/alpha/pubsub/message-transforms/test new file mode 100644 index 000000000..71a8fcb91 --- /dev/null +++ b/gcloud/alpha/pubsub/message-transforms/test @@ -0,0 +1,88 @@ +NAME + gcloud alpha pubsub message-transforms test - tests messages transforms + against a given message + +SYNOPSIS + gcloud alpha pubsub message-transforms test + (--attribute=[ATTRIBUTE,...] --message=MESSAGE) + (--message-transforms-file=MESSAGE_TRANSFORMS_FILE + | --subscription=SUBSCRIPTION + | [--topic=TOPIC : --topic-project=TOPIC_PROJECT]) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Tests messages transforms against a given message. + +REQUIRED FLAGS + Message to test the message transforms against. + + At least one of these must be specified: + + --attribute=[ATTRIBUTE,...] + Comma-separated list of attributes to attach to the message. Each + ATTRIBUTE has the form name="value". You can specify up to 100 + attributes. + + --message=MESSAGE + Message body to test the message transforms against. + + Exactly one of these must be specified: + + --message-transforms-file=MESSAGE_TRANSFORMS_FILE + Path to YAML or JSON file containing message transforms. + + Subscription resource - Name of the subscription from which the message + transforms are taken to be applied to the message. 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 --subscription on the command line with a + fully specified name; + â–¸ provide the argument --project on the command line; + â–¸ set the property core/project. + + --subscription=SUBSCRIPTION + ID of the subscription or fully qualified identifier for the + subscription. + + To set the subscription attribute: + â–« provide the argument --subscription on the command line. + + Topic resource - Name of the topic from which the message transforms are + taken to be applied to the message. The arguments in this group can be + used to specify the attributes of this resource. + + --topic=TOPIC + ID of the topic or fully qualified identifier for the topic. + + To set the topic attribute: + â–« provide the argument --topic on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --topic-project=TOPIC_PROJECT + Project ID of the Google Cloud project for the topic. + + To set the project attribute: + â–« provide the argument --topic on the command line with a fully + specified name; + â–« provide the argument --topic-project on the command line; + â–« provide the argument --project on the command line; + â–« set the property core/project. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/pubsub/message-transforms/validate b/gcloud/alpha/pubsub/message-transforms/validate new file mode 100644 index 000000000..8b3a92153 --- /dev/null +++ b/gcloud/alpha/pubsub/message-transforms/validate @@ -0,0 +1,29 @@ +NAME + gcloud alpha pubsub message-transforms validate - validates a message + transform + +SYNOPSIS + gcloud alpha pubsub message-transforms validate + --message-transform-file=MESSAGE_TRANSFORM_FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Validates a message transform. + +REQUIRED FLAGS + --message-transform-file=MESSAGE_TRANSFORM_FILE + Path to YAML or JSON file containing a message transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/pubsub/subscriptions/create b/gcloud/alpha/pubsub/subscriptions/create index bf0ef3f4c..190199fa3 100644 --- a/gcloud/alpha/pubsub/subscriptions/create +++ b/gcloud/alpha/pubsub/subscriptions/create @@ -9,6 +9,7 @@ SYNOPSIS [--enable-message-ordering] [--expiration-period=EXPIRATION_PERIOD] [--labels=[KEY=VALUE,...]] [--message-filter=MESSAGE_FILTER] [--message-retention-duration=MESSAGE_RETENTION_DURATION] + [--message-transforms-file=MESSAGE_TRANSFORMS_FILE] [--retain-acked-messages] [[--bigquery-table=BIGQUERY_TABLE : --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL @@ -128,6 +129,9 @@ OPTIONAL FLAGS seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. + --message-transforms-file=MESSAGE_TRANSFORMS_FILE + Path to YAML or JSON file containing message transforms. + --retain-acked-messages Whether or not to retain acknowledged messages. If true, messages are not expunged from the subscription's backlog until they fall out of the diff --git a/gcloud/alpha/pubsub/subscriptions/update b/gcloud/alpha/pubsub/subscriptions/update index 59ed1f2e7..2f31669cf 100644 --- a/gcloud/alpha/pubsub/subscriptions/update +++ b/gcloud/alpha/pubsub/subscriptions/update @@ -19,6 +19,8 @@ SYNOPSIS [--dead-letter-topic=DEAD_LETTER_TOPIC : --dead-letter-topic-project=DEAD_LETTER_TOPIC_PROJECT]] [--clear-labels | --remove-labels=[KEY,...]] + [--clear-message-transforms + | --message-transforms-file=MESSAGE_TRANSFORMS_FILE] [--clear-retry-policy | --max-retry-delay=MAX_RETRY_DELAY --min-retry-delay=MIN_RETRY_DELAY] [--push-auth-service-account=SERVICE_ACCOUNT_EMAIL @@ -307,6 +309,15 @@ FLAGS silently ignored. If --update-labels is also specified then --update-labels is applied first. + At most one of these can be specified: + + --clear-message-transforms + If set, clears the message transforms field. Use + --no-clear-message-transforms to disable this flag. + + --message-transforms-file=MESSAGE_TRANSFORMS_FILE + Path to YAML or JSON file containing message transforms. + At most one of these can be specified: --clear-retry-policy diff --git a/gcloud/alpha/pubsub/topics/create b/gcloud/alpha/pubsub/topics/create index 304fef2ae..b771c3c69 100644 --- a/gcloud/alpha/pubsub/topics/create +++ b/gcloud/alpha/pubsub/topics/create @@ -6,6 +6,7 @@ SYNOPSIS gcloud alpha pubsub topics create TOPIC [TOPIC ...] [--labels=[KEY=VALUE,...]] [--message-retention-duration=MESSAGE_RETENTION_DURATION] + [--message-transforms-file=MESSAGE_TRANSFORMS_FILE] [--ingestion-log-severity=INGESTION_LOG_SEVERITY --aws-msk-ingestion-aws-role-arn=AWS_MSK_INGESTION_AWS_ROLE_ARN --aws-msk-ingestion-cluster-arn=AWS_MSK_INGESTION_CLUSTER_ARN @@ -72,6 +73,9 @@ FLAGS is one of "s", "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. + --message-transforms-file=MESSAGE_TRANSFORMS_FILE + Path to YAML or JSON file containing message transforms. + Following flags are for specifying the data source settings for an import topic diff --git a/gcloud/alpha/pubsub/topics/update b/gcloud/alpha/pubsub/topics/update index 62c15321e..3d11905fb 100644 --- a/gcloud/alpha/pubsub/topics/update +++ b/gcloud/alpha/pubsub/topics/update @@ -13,6 +13,8 @@ SYNOPSIS [--clear-labels | --remove-labels=[KEY,...]] [--clear-message-retention-duration | --message-retention-duration=MESSAGE_RETENTION_DURATION] + [--clear-message-transforms + | --message-transforms-file=MESSAGE_TRANSFORMS_FILE] [--clear-schema-settings | [--message-encoding=ENCODING (--schema=SCHEMA : --schema-project=SCHEMA_PROJECT) @@ -356,6 +358,15 @@ FLAGS seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. + At most one of these can be specified: + + --clear-message-transforms + If set, clears the message transforms field. Use + --no-clear-message-transforms to disable this flag. + + --message-transforms-file=MESSAGE_TRANSFORMS_FILE + Path to YAML or JSON file containing message transforms. + At most one of these can be specified: --clear-schema-settings diff --git a/gcloud/alpha/redis/clusters/update b/gcloud/alpha/redis/clusters/update index ad6f5e5aa..2300104b8 100644 --- a/gcloud/alpha/redis/clusters/update +++ b/gcloud/alpha/redis/clusters/update @@ -8,6 +8,7 @@ SYNOPSIS [--automated-backup-mode=AUTOMATED_BACKUP_MODE] [--automated-backup-start-time=AUTOMATED_BACKUP_START_TIME] [--automated-backup-ttl=AUTOMATED_BACKUP_TTL] [--deletion-protection] + [--node-type=NODE_TYPE] [--ondemand-maintenance] [--persistence-mode=PERSISTENCE_MODE] [--rdb-snapshot-period=RDB_SNAPSHOT_PERIOD] [--rdb-snapshot-start-time=RDB_SNAPSHOT_START_TIME] @@ -106,6 +107,14 @@ FLAGS Enable deletion protection for the Redis Cluster. Use --deletion-protection/--no-deletion-protection to enable/disable it. + --node-type=NODE_TYPE + Node Type of the redis cluster Node. NODE_TYPE must be one of: + redis-highmem-medium, redis-highmem-xlarge, redis-shared-core-nano, + redis-standard-small. + + --ondemand-maintenance + Trigger an on-demand maintenance. + --persistence-mode=PERSISTENCE_MODE Operation mode for persistence. PERSISTENCE_MODE must be one of: diff --git a/gcloud/alpha/run/worker-pools/help b/gcloud/alpha/run/worker-pools/help index 0956d1491..0b80bdbd4 100644 --- a/gcloud/alpha/run/worker-pools/help +++ b/gcloud/alpha/run/worker-pools/help @@ -21,6 +21,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + logs + (ALPHA) Read logs for Cloud Run worker pools. + revisions (ALPHA) View and manage your Cloud Run WorkerPools revisions. diff --git a/gcloud/alpha/run/worker-pools/logs/help b/gcloud/alpha/run/worker-pools/logs/help new file mode 100644 index 000000000..3a252ba86 --- /dev/null +++ b/gcloud/alpha/run/worker-pools/logs/help @@ -0,0 +1,38 @@ +NAME + gcloud alpha run worker-pools logs - read logs for Cloud Run worker pools + +SYNOPSIS + gcloud alpha run worker-pools logs COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Read logs for Cloud Run worker pools. + +EXAMPLES + To tail logs for a worker pool, run: + + $ gcloud alpha run worker-pools logs tail my-worker-pool + + To read logs for a worker pool, run: + + $ gcloud alpha run worker-pools logs read my-worker-pool + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + read + (ALPHA) Read logs for a Cloud Run worker pool. + + tail + (ALPHA) Tail logs for a Cloud Run worker pool. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/run/worker-pools/logs/read b/gcloud/alpha/run/worker-pools/logs/read new file mode 100644 index 000000000..c67b28db0 --- /dev/null +++ b/gcloud/alpha/run/worker-pools/logs/read @@ -0,0 +1,79 @@ +NAME + gcloud alpha run worker-pools logs read - read logs for a Cloud Run worker + pool + +SYNOPSIS + gcloud alpha run worker-pools logs read WORKER_POOL + [--freshness=FRESHNESS; default="1d"] [--log-filter=LOG_FILTER] + [--order=ORDER; default="desc"] [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha run worker-pools logs read reads log entries. Log + entries matching --log-filter are returned according to the specified + --order. If the log entries come from multiple logs, then entries from + different logs might be intermingled in the results. + +EXAMPLES + To read log entries from for a Cloud Run Worker Pool, run: + + $ gcloud alpha run worker-pools logs read my-worker-pool + + To read log entries with severity ERROR or higher, run: + + $ gcloud alpha run worker-pools logs read my-worker-pool \ + --log-filter="severity>=ERROR" + + To read log entries written in a specific time window, run: + + $ gcloud alpha run worker-pools logs read my-worker-pool \ + --log-filter='timestamp<="2015-05-31T23:59:59Z" AND + timestamp>="2015-05-31T00:00:00Z"' + + To read up to 10 log entries in your worker pool payloads that include the + word SearchText and format the output in JSON format, run: + + $ gcloud alpha run worker-pools logs read my-worker-pool \ + --log-filter="textPayload:SearchText" --limit=10 --format=json + + Detailed information about filters can be found at: + https://cloud.google.com/logging/docs/view/advanced_filters + +POSITIONAL ARGUMENTS + WORKER_POOL + Name for a Cloud Run worker pool. + +FLAGS + --freshness=FRESHNESS; default="1d" + Return entries that are not older than this value. Works only with DESC + ordering and filters without a timestamp. See $ gcloud topic datetimes + for information on duration formats. + + --log-filter=LOG_FILTER + Filter expression that specifies the log entries to return. Detailed + information about filters can be found at: + https://cloud.google.com/logging/docs/view/logging-query-language + + --order=ORDER; default="desc" + Ordering of returned log entries based on timestamp field. ORDER must + be one of: desc, asc. + +LIST COMMAND FLAGS + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/run/worker-pools/logs/tail b/gcloud/alpha/run/worker-pools/logs/tail new file mode 100644 index 000000000..c2e3b6ff7 --- /dev/null +++ b/gcloud/alpha/run/worker-pools/logs/tail @@ -0,0 +1,50 @@ +NAME + gcloud alpha run worker-pools logs tail - tail logs for a Cloud Run worker + pool + +SYNOPSIS + gcloud alpha run worker-pools logs tail WORKER_POOL + [--log-filter=LOG_FILTER] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha run worker-pools logs tail tails log-entries for a + particular Cloud Run worker pool in real time. The log entries are + formatted for consumption in a terminal. + +EXAMPLES + To tail log entries for a Cloud Run Worker Pool, run: + + $ gcloud alpha run worker-pools logs tail my-worker-pool + + To tail log entries with severity ERROR or higher, run: + + $ gcloud alpha run worker-pools logs tail my-worker-pool \ + --log-filter="severity>=ERROR" + + Detailed information about filters can be found at: + https://cloud.google.com/logging/docs/view/advanced_filters + +POSITIONAL ARGUMENTS + WORKER_POOL + Name for a Cloud Run worker pool. + +FLAGS + --log-filter=LOG_FILTER + Filter expression that specifies the log entries to return. Detailed + information about filters can be found at: + https://cloud.google.com/logging/docs/view/logging-query-language + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/run/worker-pools/revisions/help b/gcloud/alpha/run/worker-pools/revisions/help index 91290d455..eac745e26 100644 --- a/gcloud/alpha/run/worker-pools/revisions/help +++ b/gcloud/alpha/run/worker-pools/revisions/help @@ -3,7 +3,8 @@ NAME WorkerPools revisions SYNOPSIS - gcloud alpha run worker-pools revisions COMMAND [GCLOUD_WIDE_FLAG ...] + gcloud alpha run worker-pools revisions GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) This set of commands can be used to view and manage your existing @@ -19,6 +20,12 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +GROUPS + GROUP is one of the following: + + logs + (ALPHA) Read logs for Cloud Run worker pools revisions. + COMMANDS COMMAND is one of the following: diff --git a/gcloud/alpha/run/worker-pools/revisions/logs/help b/gcloud/alpha/run/worker-pools/revisions/logs/help new file mode 100644 index 000000000..c460dea2c --- /dev/null +++ b/gcloud/alpha/run/worker-pools/revisions/logs/help @@ -0,0 +1,41 @@ +NAME + gcloud alpha run worker-pools revisions logs - read logs for Cloud Run + worker pools revisions + +SYNOPSIS + gcloud alpha run worker-pools revisions logs COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Read logs for Cloud Run worker pools revisions. + +EXAMPLES + To tail logs for a worker pool revision, run: + + $ gcloud alpha run worker-pools revisions logs tail \ + my-worker-pool-revision + + To read logs for a worker pool revision, run: + + $ gcloud alpha run worker-pools revisions logs read \ + my-worker-pool-revision + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + read + (ALPHA) Read logs for a Cloud Run worker pool revision. + + tail + (ALPHA) Tail logs for a Cloud Run worker pool revision. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/run/worker-pools/revisions/logs/read b/gcloud/alpha/run/worker-pools/revisions/logs/read new file mode 100644 index 000000000..1bb683344 --- /dev/null +++ b/gcloud/alpha/run/worker-pools/revisions/logs/read @@ -0,0 +1,80 @@ +NAME + gcloud alpha run worker-pools revisions logs read - read logs for a Cloud + Run worker pool revision + +SYNOPSIS + gcloud alpha run worker-pools revisions logs read REVISION + [--freshness=FRESHNESS; default="1d"] [--log-filter=LOG_FILTER] + [--order=ORDER; default="desc"] [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha run worker-pools revisions logs read reads log + entries. Log entries matching --log-filter are returned in order of + decreasing timestamps, most-recent entries first. If the log entries come + from multiple logs, then entries from different logs might be intermingled + in the results. + +EXAMPLES + To read log entries from for a Cloud Run worker pool revision, run: + + $ gcloud alpha run worker-pools revisions logs read my-revision + + To read log entries with severity ERROR or higher, run: + + $ gcloud alpha run worker-pools revisions logs read my-revision \ + --log-filter="severity>=ERROR" + + To read log entries written in a specific time window, run: + + $ gcloud alpha run worker-pools revisions logs read my-revision \ + --log-filter='timestamp<="2015-05-31T23:59:59Z" AND + timestamp>="2015-05-31T00:00:00Z"' + + To read up to 10 log entries in your revision payloads that include the + word SearchText and format the output in JSON format, run: + + $ gcloud alpha run worker-pools revisions logs read my-revision \ + --log-filter="textPayload:SearchText" --limit=10 --format=json + + Detailed information about filters can be found at: + https://cloud.google.com/logging/docs/view/advanced_filters + +POSITIONAL ARGUMENTS + REVISION + Name for a Cloud Run worker pool revision. + +FLAGS + --freshness=FRESHNESS; default="1d" + Return entries that are not older than this value. Works only with DESC + ordering and filters without a timestamp. See $ gcloud topic datetimes + for information on duration formats. + + --log-filter=LOG_FILTER + Filter expression that specifies the log entries to return. Detailed + information about filters can be found at: + https://cloud.google.com/logging/docs/view/logging-query-language + + --order=ORDER; default="desc" + Ordering of returned log entries based on timestamp field. ORDER must + be one of: desc, asc. + +LIST COMMAND FLAGS + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/run/worker-pools/revisions/logs/tail b/gcloud/alpha/run/worker-pools/revisions/logs/tail new file mode 100644 index 000000000..a511cb4ba --- /dev/null +++ b/gcloud/alpha/run/worker-pools/revisions/logs/tail @@ -0,0 +1,50 @@ +NAME + gcloud alpha run worker-pools revisions logs tail - tail logs for a Cloud + Run worker pool revision + +SYNOPSIS + gcloud alpha run worker-pools revisions logs tail REVISION + [--log-filter=LOG_FILTER] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha run worker-pools revisions logs tail tails log-entries + for a particular Cloud Run worker pool revision in real time. The log + entries are formatted for consumption in a terminal. + +EXAMPLES + To tail log entries for a Cloud Run worker pool revision, run: + + $ gcloud alpha run worker-pools revisions logs tail my-revision + + To tail log entries with severity ERROR or higher, run: + + $ gcloud alpha run worker-pools revisions logs tail my-revision \ + --log-filter="severity>=ERROR" + + Detailed information about filters can be found at: + https://cloud.google.com/logging/docs/view/advanced_filters + +POSITIONAL ARGUMENTS + REVISION + Name for a Cloud Run worker pool revision. + +FLAGS + --log-filter=LOG_FILTER + Filter expression that specifies the log entries to return. Detailed + information about filters can be found at: + https://cloud.google.com/logging/docs/view/logging-query-language + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/batch/jobs/cancel b/gcloud/batch/jobs/cancel new file mode 100644 index 000000000..c295a4d3e --- /dev/null +++ b/gcloud/batch/jobs/cancel @@ -0,0 +1,65 @@ +NAME + gcloud batch jobs cancel - cancel a job + +SYNOPSIS + gcloud batch jobs cancel (JOB : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command can fail for the following reasons: + â–ª The job specified does not exist. + â–ª The active account does not have permission to cancel the given job. + +EXAMPLES + To cancel the job with name projects/foo/locations/us-central1/jobs/bar, + run: + + $ gcloud batch jobs cancel \ + projects/foo/locations/us-central1/jobs/bar + +POSITIONAL ARGUMENTS + Job resource - The Batch job resource. If --location not specified,the + current batch/location is used. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + â—† provide the argument JOB on the command line with a fully specified + name; + â—† provide the argument --project on the command line; + â—† set the property core/project. + + This must be specified. + + JOB + ID of the job or fully qualified identifier for the job. + + To set the job attribute: + â–¸ provide the argument JOB on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the job. + + To set the location attribute: + â–¸ provide the argument JOB on the command line with a fully + specified name; + â–¸ provide the argument --location on the command line; + â–¸ set the property batch/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha batch jobs cancel + + $ gcloud beta batch jobs cancel + diff --git a/gcloud/batch/jobs/help b/gcloud/batch/jobs/help index c2455ee8d..a99dbd2bc 100644 --- a/gcloud/batch/jobs/help +++ b/gcloud/batch/jobs/help @@ -23,6 +23,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + cancel + Cancel a job. + delete Delete a job. diff --git a/gcloud/beta/alloydb/clusters/upgrade b/gcloud/beta/alloydb/clusters/upgrade index a9636ae85..c6ba2b5c7 100644 --- a/gcloud/beta/alloydb/clusters/upgrade +++ b/gcloud/beta/alloydb/clusters/upgrade @@ -42,8 +42,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 alloydb clusters upgrade $ gcloud alpha alloydb clusters upgrade diff --git a/gcloud/beta/alloydb/instances/create b/gcloud/beta/alloydb/instances/create index 71e0ca20a..cc3009e6b 100644 --- a/gcloud/beta/alloydb/instances/create +++ b/gcloud/beta/alloydb/instances/create @@ -54,7 +54,7 @@ REQUIRED FLAGS Whole number value indicating how many vCPUs the machine should contain. Each vCPU count corresponds to a N2 high-mem machine: (https://cloud.google.com/compute/docs/general-purpose-machines#n2_machines). - CPU_COUNT must be one of: 2, 4, 8, 16, 32, 64, 96, 128. + CPU_COUNT must be one of: 1, 2, 4, 8, 16, 32, 64, 96, 128. --instance-type=INSTANCE_TYPE Specifies instance type. INSTANCE_TYPE must be one of: diff --git a/gcloud/beta/alloydb/instances/update b/gcloud/beta/alloydb/instances/update index d5577a8af..2d15f6832 100644 --- a/gcloud/beta/alloydb/instances/update +++ b/gcloud/beta/alloydb/instances/update @@ -96,7 +96,7 @@ OPTIONAL FLAGS Whole number value indicating how many vCPUs the machine should contain. Each vCPU count corresponds to a N2 high-mem machine: (https://cloud.google.com/compute/docs/general-purpose-machines#n2_machines). - CPU_COUNT must be one of: 2, 4, 8, 16, 32, 64, 96, 128. + CPU_COUNT must be one of: 1, 2, 4, 8, 16, 32, 64, 96, 128. --database-flags=FLAG=VALUE,[FLAG=VALUE,...] Comma-separated list of database flags to set on the instance. Use an diff --git a/gcloud/beta/batch/jobs/cancel b/gcloud/beta/batch/jobs/cancel new file mode 100644 index 000000000..34a046daf --- /dev/null +++ b/gcloud/beta/batch/jobs/cancel @@ -0,0 +1,67 @@ +NAME + gcloud beta batch jobs cancel - cancel a job + +SYNOPSIS + gcloud beta batch jobs cancel (JOB : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command can fail for the following reasons: + â–ª The job specified does not exist. + â–ª The active account does not have permission to cancel the given job. + +EXAMPLES + To cancel the job with name projects/foo/locations/us-central1/jobs/bar, + run: + + $ gcloud beta batch jobs cancel \ + projects/foo/locations/us-central1/jobs/bar + +POSITIONAL ARGUMENTS + Job resource - The Batch job resource. If --location not specified,the + current batch/location is used. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + â—† provide the argument JOB on the command line with a fully specified + name; + â—† provide the argument --project on the command line; + â—† set the property core/project. + + This must be specified. + + JOB + ID of the job or fully qualified identifier for the job. + + To set the job attribute: + â–¸ provide the argument JOB on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the job. + + To set the location attribute: + â–¸ provide the argument JOB on the command line with a fully + specified name; + â–¸ provide the argument --location on the command line; + â–¸ set the property batch/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud batch jobs cancel + + $ gcloud alpha batch jobs cancel + diff --git a/gcloud/beta/batch/jobs/help b/gcloud/beta/batch/jobs/help index 18ad3188a..df226d6ed 100644 --- a/gcloud/beta/batch/jobs/help +++ b/gcloud/beta/batch/jobs/help @@ -23,6 +23,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + cancel + (BETA) Cancel a job. + delete (BETA) Delete a job. diff --git a/gcloud/beta/colab/runtime-templates/create b/gcloud/beta/colab/runtime-templates/create index 500c5a9c9..1012d9cbb 100644 --- a/gcloud/beta/colab/runtime-templates/create +++ b/gcloud/beta/colab/runtime-templates/create @@ -14,7 +14,11 @@ SYNOPSIS : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] --no-enable-internet-access --network=NETWORK [--subnetwork=SUBNETWORK - : --subnetwork-region=SUBNETWORK_REGION]] [GCLOUD_WIDE_FLAG ...] + : --subnetwork-region=SUBNETWORK_REGION] + --post-startup-script=POST_STARTUP_SCRIPT + --post-startup-script-behavior=POST_STARTUP_SCRIPT_BEHAVIOR + --post-startup-script-url=POST_STARTUP_SCRIPT_URL + --set-env-vars=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a Colab Enterprise runtime template, a VM configuration for @@ -212,6 +216,25 @@ OPTIONAL FLAGS fully specified name; â—‡ provide the argument --subnetwork-region on the command line. + The software configuration of the runtime template. + + --post-startup-script=POST_STARTUP_SCRIPT + Post startup script in raw string to execute on the runtime. + + --post-startup-script-behavior=POST_STARTUP_SCRIPT_BEHAVIOR + The behavior of the post startup script. The default if passing a + post-startup-script-url is RUN_ONCE. POST_STARTUP_SCRIPT_BEHAVIOR + must be one of: POST_STARTUP_SCRIPT_BEHAVIOR_UNSPECIFIED, RUN_ONCE, + RUN_EVERY_START, DOWNLOAD_AND_RUN_EVERY_START. + + --post-startup-script-url=POST_STARTUP_SCRIPT_URL + Post startup script URL to execute on the runtime. This can be a + public or private Google Cloud Storage object. In the form of + gs://bucket/object or https://storage.googleapis.com/bucket/object. + + --set-env-vars=[KEY=VALUE,...] + Set environment variables used by the runtime. + 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/compute/commitments/create b/gcloud/beta/compute/commitments/create index 2d5f2cfc2..0c46d46a6 100644 --- a/gcloud/beta/compute/commitments/create +++ b/gcloud/beta/compute/commitments/create @@ -113,8 +113,9 @@ OPTIONAL FLAGS general-purpose-c4a, general-purpose-e2, general-purpose-n2, general-purpose-n2d, general-purpose-n4, general-purpose-t2d, graphics-optimized, memory-optimized, memory-optimized-m3, - memory-optimized-x4-16tb, memory-optimized-x4-24tb, - memory-optimized-x4-32tb, storage-optimized-z3. + memory-optimized-m4, memory-optimized-x4-16tb, + memory-optimized-x4-24tb, memory-optimized-x4-32tb, + storage-optimized-z3. Manage the reservations to be created with the commitment. diff --git a/gcloud/beta/compute/instances/help b/gcloud/beta/compute/instances/help index 13d05a8d6..53589daaf 100644 --- a/gcloud/beta/compute/instances/help +++ b/gcloud/beta/compute/instances/help @@ -28,8 +28,7 @@ GROUPS command executions. network-interfaces - (BETA) Read and manipulate Compute Engine VM instance network - interfaces. + (BETA) Read and manipulate Compute Engine instance network interfaces. ops-agents (BETA) Manage Google Cloud Observability agents for Compute Engine VM diff --git a/gcloud/beta/compute/instances/network-interfaces/add b/gcloud/beta/compute/instances/network-interfaces/add new file mode 100644 index 000000000..04208c3f5 --- /dev/null +++ b/gcloud/beta/compute/instances/network-interfaces/add @@ -0,0 +1,178 @@ +NAME + gcloud beta compute instances network-interfaces add - add a dynamic + network interface to a Compute Engine instance + +SYNOPSIS + gcloud beta compute instances network-interfaces add INSTANCE_NAME + [--aliases=ALIASES] [--external-ipv6-address=EXTERNAL_IPV6_ADDRESS] + [--external-ipv6-prefix-length=EXTERNAL_IPV6_PREFIX_LENGTH] + [--internal-ipv6-address=INTERNAL_IPV6_ADDRESS] + [--internal-ipv6-prefix-length=INTERNAL_IPV6_PREFIX_LENGTH] + [--ipv6-network-tier=IPV6_NETWORK_TIER] [--network=NETWORK] + [--network-attachment=NETWORK_ATTACHMENT] [--network-tier=NETWORK_TIER] + [--parent-nic-name=PARENT_NIC_NAME] + [--private-network-ip=PRIVATE_NETWORK_IP] [--stack-type=STACK_TYPE] + [--subnetwork=SUBNETWORK] [--vlan=VLAN] [--zone=ZONE] + [--address=ADDRESS | --no-address] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute instances network-interfaces add adds a dynamic + network interface to a Compute Engine instance. For example: + + $ gcloud beta compute instances network-interfaces add \ + instance-name --parent-nic-name nic1 --vlan 2 + --network network-1 --subnetwork subnetwork-1 + +POSITIONAL ARGUMENTS + INSTANCE_NAME + Name of the instance to operate on. For details on valid instance + names, refer to the criteria documented under the field 'name' at: + https://cloud.google.com/compute/docs/reference/rest/v1/instances + +FLAGS + --aliases=ALIASES + The IP alias ranges to allocate for this interface. If there are + multiple IP alias ranges, they are separated by semicolons. + + For example: + + --aliases="10.128.1.0/24;range1:/32" + + Each IP alias range consists of a range name and an IP range separated + by a colon, or just the IP range. The range name is the name of the + range within the network interface's subnet from which to allocate an + IP alias range. If unspecified, it defaults to the primary IP range of + the subnet. The IP range can be a CIDR range (e.g. 192.168.100.0/24), a + single IP address (e.g. 192.168.100.1), or a netmask in CIDR format + (e.g. /24). If the IP range is specified by CIDR range or single IP + address, it must belong to the CIDR range specified by the range name + on the subnet. If the IP range is specified by netmask, the IP + allocator will pick an available range with the specified netmask and + allocate it to this network interface. + + --external-ipv6-address=EXTERNAL_IPV6_ADDRESS + Assigns the given external IPv6 address to an instance. The address + must be the first IP in the range. This option is applicable only to + dual-stack instances with stack-type=IPV4_ONLY. + + --external-ipv6-prefix-length=EXTERNAL_IPV6_PREFIX_LENGTH + The prefix length of the external IPv6 address range. This flag should + be used together with --external-ipv6-address. Currently only /96 is + supported and the default value is 96. + + --internal-ipv6-address=INTERNAL_IPV6_ADDRESS + Assigns the given internal IPv6 address or range to an instance. The + address must be the first IP address in the range or a /96 IP address + range. This option can only be used on a dual stack instance network + interface. + + --internal-ipv6-prefix-length=INTERNAL_IPV6_PREFIX_LENGTH + Optional field that indicates the prefix length of the internal IPv6 + address range, should be used together with + --internal-ipv6-address=fd20::. Only /96 IP address range is supported + and the default value is 96. If not set, then either the prefix length + from --internal-ipv6-address=fd20::/96 will be used or the default + value of 96 will be assigned. + + --ipv6-network-tier=IPV6_NETWORK_TIER + Specifies the IPv6 network tier that will be used to configure the + instance network interface IPv6 access config. IPV6_NETWORK_TIER must + be (only one value is supported): + + PREMIUM + High quality, Google-grade network tier. + + --network=NETWORK + Specifies the network this network interface belongs to. + + --network-attachment=NETWORK_ATTACHMENT + The network attachment URL this network interface should connect to. + + --network-tier=NETWORK_TIER + Specifies the network tier that will be used to configure the instance + network interface. NETWORK_TIER must be one of: PREMIUM, STANDARD, + FIXED_STANDARD. The default value is PREMIUM. NETWORK_TIER must be one + of: + + FIXED_STANDARD + Public internet quality with fixed bandwidth. + PREMIUM + High quality, Google-grade network tier. + STANDARD + Public internet quality. + + --parent-nic-name=PARENT_NIC_NAME + Name of the parent network interface of a dynamic network interface. + + --private-network-ip=PRIVATE_NETWORK_IP + Specifies the RFC1918 IP to assign to the network interface. The IP + should be in the subnet IP range. + + --stack-type=STACK_TYPE + The stack type for the default network interface. Determines if IPv6 is + enabled on the default network interface. STACK_TYPE must be one of: + + IPV4_IPV6 + The network interface can have both IPv4 and IPv6 addresses. + IPV4_ONLY + The network interface will be assigned IPv4 addresses. + + --subnetwork=SUBNETWORK + Specifies the subnetwork this network interface belongs to. + + --vlan=VLAN + VLAN tag of a dynamic network interface, must be in range from 2 to + 4094 inclusively. + + --zone=ZONE + Zone of the instance to operate on. If not specified, you might be + prompted to select a zone (interactive mode only). gcloud attempts to + identify the appropriate zone by searching for resources in your + currently active project. If the zone cannot be determined, gcloud + prompts you for a selection with all available Google Cloud Platform + zones. + + To avoid prompting when this flag is omitted, the user can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + + At most one of these can be specified: + + --address=ADDRESS + Assigns the given external address to the network interface. The + address might be an IP address or the name or URI of an address + resource. Specifying an empty string will assign an ephemeral IP. + Mutually exclusive with no-address. If neither key is present the + network interface will get an ephemeral IP. + + --no-address + If specified the network interface will have no external IP. Mutually + exclusive with address. If neither key is present the network + interfaces will get an ephemeral IP. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute instances network-interfaces add + diff --git a/gcloud/beta/compute/instances/network-interfaces/delete b/gcloud/beta/compute/instances/network-interfaces/delete new file mode 100644 index 000000000..18be0c685 --- /dev/null +++ b/gcloud/beta/compute/instances/network-interfaces/delete @@ -0,0 +1,65 @@ +NAME + gcloud beta compute instances network-interfaces delete - delete a dynamic + network interface from a Compute Engine instance + +SYNOPSIS + gcloud beta compute instances network-interfaces delete INSTANCE_NAME + --network-interface=NETWORK_INTERFACE [--zone=ZONE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute instances network-interfaces delete deletes a + dynamic network interface from a Compute Engine instance. For example: + + $ gcloud beta compute instances network-interfaces delete \ + instance-name --network-interface nic1.2 + +POSITIONAL ARGUMENTS + INSTANCE_NAME + Name of the instance to operate on. For details on valid instance + names, refer to the criteria documented under the field 'name' at: + https://cloud.google.com/compute/docs/reference/rest/v1/instances + +REQUIRED FLAGS + --network-interface=NETWORK_INTERFACE + The name of the network interface to delete, e.g. nic1.2 + +OPTIONAL FLAGS + --zone=ZONE + Zone of the instance to operate on. If not specified, you might be + prompted to select a zone (interactive mode only). gcloud attempts to + identify the appropriate zone by searching for resources in your + currently active project. If the zone cannot be determined, gcloud + prompts you for a selection with all available Google Cloud Platform + zones. + + To avoid prompting when this flag is omitted, the user can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute instances network-interfaces delete + diff --git a/gcloud/beta/compute/instances/network-interfaces/help b/gcloud/beta/compute/instances/network-interfaces/help index a8382c808..c88020061 100644 --- a/gcloud/beta/compute/instances/network-interfaces/help +++ b/gcloud/beta/compute/instances/network-interfaces/help @@ -1,19 +1,19 @@ NAME gcloud beta compute instances network-interfaces - read and manipulate - Compute Engine VM instance network interfaces + Compute Engine instance network interfaces SYNOPSIS gcloud beta compute instances network-interfaces COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Read and manipulate Compute Engine VM instance network interfaces. + (BETA) Read and manipulate Compute Engine instance network interfaces. - For more information about VM instance network interfaces, see the network + For more information about instance network interfaces, see the network interfaces documentation (https://cloud.google.com/vpc/docs/multiple-interfaces-concepts). - See also: VM instance network interfaces API + See also: instance network interfaces API (https://cloud.google.com/compute/docs/reference/rest/v1/instances/updateNetworkInterface). GCLOUD WIDE FLAGS @@ -24,6 +24,13 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + add + (BETA) Add a dynamic network interface to a Compute Engine instance. + + delete + (BETA) Delete a dynamic network interface from a Compute Engine + instance. + get-effective-firewalls (BETA) Get the effective firewalls for a Compute Engine virtual machine network interface. diff --git a/gcloud/beta/compute/routers/add-route-policy b/gcloud/beta/compute/routers/add-route-policy index bd2ca6e21..e5f12cfb7 100644 --- a/gcloud/beta/compute/routers/add-route-policy +++ b/gcloud/beta/compute/routers/add-route-policy @@ -10,6 +10,14 @@ DESCRIPTION (BETA) gcloud beta compute routers add-route-policy adds an empty route policy to a Compute Engine router. +EXAMPLES + To add an import route policy my-policy to a router my-router in region + us-central1, run: + + $ gcloud beta compute routers add-route-policy my-router \ + --region=us-central1 --policy-name=my-policy \ + --policy-type=IMPORT + POSITIONAL ARGUMENTS NAME Name of the router to update. @@ -56,8 +64,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 compute routers add-route-policy $ gcloud alpha compute routers add-route-policy diff --git a/gcloud/beta/compute/routers/add-route-policy-term b/gcloud/beta/compute/routers/add-route-policy-term index e3ce78fcb..e9b144024 100644 --- a/gcloud/beta/compute/routers/add-route-policy-term +++ b/gcloud/beta/compute/routers/add-route-policy-term @@ -11,6 +11,15 @@ DESCRIPTION (BETA) gcloud beta compute routers add-route-policy-term adds a term to a route policy. +EXAMPLES + To add a term with priority 0 with match destination == '192.168.0.0/16' + and actions drop() to a route policy my-policy of a router my-router in + region us-central1, run: + + $ gcloud beta compute routers add-route-policy-term my-router \ + --region=us-central1 --policy-name=my-policy --priority=0 \ + --match="destination == '192.168.0.0/16'" --actions="drop()" + POSITIONAL ARGUMENTS NAME Name of the router to update. @@ -59,8 +68,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute routers add-route-policy-term $ gcloud alpha compute routers add-route-policy-term diff --git a/gcloud/beta/compute/routers/download-route-policy b/gcloud/beta/compute/routers/download-route-policy index ea3bdcc80..4f4d44244 100644 --- a/gcloud/beta/compute/routers/download-route-policy +++ b/gcloud/beta/compute/routers/download-route-policy @@ -11,6 +11,14 @@ DESCRIPTION (BETA) gcloud beta compute routers download-route-policy downloads a route policy from a Compute Engine router. +EXAMPLES + To download a route policy my-export-policy to a file my-export-policy.yaml + from a router my-router in region us-central1, run: + + $ gcloud beta compute routers download-route-policy my-router \ + --region=us-central1 --policy-name=my-export-policy \ + --file-name=my-export-policy.yaml" + POSITIONAL ARGUMENTS NAME Name of the router to export. @@ -56,8 +64,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 compute routers download-route-policy $ gcloud alpha compute routers download-route-policy diff --git a/gcloud/beta/compute/routers/get-route-policy b/gcloud/beta/compute/routers/get-route-policy index 720a37102..d13fc001d 100644 --- a/gcloud/beta/compute/routers/get-route-policy +++ b/gcloud/beta/compute/routers/get-route-policy @@ -10,6 +10,13 @@ DESCRIPTION (BETA) gcloud beta compute routers get-route-policy gets a route policy from a Compute Engine router. +EXAMPLES + To get a route policy my-policy from a router my-router in region + us-central1, run: + + $ gcloud beta compute routers get-route-policy my-router \ + --region=us-central1 --policy-name=my-policy + POSITIONAL ARGUMENTS NAME Name of the router to get. @@ -48,8 +55,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 compute routers get-route-policy $ gcloud alpha compute routers get-route-policy diff --git a/gcloud/beta/compute/routers/list-bgp-routes b/gcloud/beta/compute/routers/list-bgp-routes index 959a1cbcc..97f7879dd 100644 --- a/gcloud/beta/compute/routers/list-bgp-routes +++ b/gcloud/beta/compute/routers/list-bgp-routes @@ -16,6 +16,14 @@ DESCRIPTION and learned on individual BGP sessions, both pre- and post-policy evaluation. +EXAMPLES + To list inbound BGP routes limited to IPv4 addess family from a router + my-router BGP peer my-bgp-peer in region us-central1, run: + + $ gcloud beta compute routers list-bgp-routes my-router \ + --region=us-central1 --address-family=IPV4 --peer=my-bgp-peer \ + --route-direction=INBOUND" + POSITIONAL ARGUMENTS NAME Name of the router to list. @@ -111,8 +119,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 compute routers list-bgp-routes $ gcloud alpha compute routers list-bgp-routes diff --git a/gcloud/beta/compute/routers/list-route-policies b/gcloud/beta/compute/routers/list-route-policies index eb3e062d3..7a3cc8fd0 100644 --- a/gcloud/beta/compute/routers/list-route-policies +++ b/gcloud/beta/compute/routers/list-route-policies @@ -11,6 +11,12 @@ DESCRIPTION (BETA) gcloud beta compute routers list-route-policies lists all route policies from a Compute Engine router. +EXAMPLES + To list route policies from a router my-router in region us-central1, run: + + $ gcloud beta compute routers list-route-policies my-router \ + --region=us-central1 + POSITIONAL ARGUMENTS NAME Name of the router to list. @@ -77,8 +83,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 compute routers list-route-policies $ gcloud alpha compute routers list-route-policies diff --git a/gcloud/beta/compute/routers/remove-route-policy b/gcloud/beta/compute/routers/remove-route-policy index d41996b7b..f73a38600 100644 --- a/gcloud/beta/compute/routers/remove-route-policy +++ b/gcloud/beta/compute/routers/remove-route-policy @@ -10,6 +10,13 @@ DESCRIPTION (BETA) gcloud beta compute routers remove-route-policy removes a route policy from a Compute Engine router. +EXAMPLES + To remove a route policy my-policy from a router my-router in region + us-central1, run: + + $ gcloud beta compute routers remove-route-policy my-router \ + --region=us-central1 --policy-name=my-policy + POSITIONAL ARGUMENTS NAME Name of the router to delete. @@ -48,8 +55,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 compute routers remove-route-policy $ gcloud alpha compute routers remove-route-policy diff --git a/gcloud/beta/compute/routers/remove-route-policy-term b/gcloud/beta/compute/routers/remove-route-policy-term index 0257f3f5b..4aab8b6cb 100644 --- a/gcloud/beta/compute/routers/remove-route-policy-term +++ b/gcloud/beta/compute/routers/remove-route-policy-term @@ -11,6 +11,13 @@ DESCRIPTION (BETA) gcloud beta compute routers remove-route-policy-term removes a term of a route policy. +EXAMPLES + To remove a route policy term with priority 0 from a route policy my-policy + from a router my-router in region us-central1, run: + + $ gcloud beta compute routers remove-route-policy-term my-router \ + --region=us-central1 --policy-name=my-policy --priority=0 + POSITIONAL ARGUMENTS NAME Name of the router to remove a route policy term from. @@ -53,8 +60,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 compute routers remove-route-policy-term $ gcloud alpha compute routers remove-route-policy-term diff --git a/gcloud/beta/compute/routers/update-route-policy-term b/gcloud/beta/compute/routers/update-route-policy-term index 54993ea37..cd1aba194 100644 --- a/gcloud/beta/compute/routers/update-route-policy-term +++ b/gcloud/beta/compute/routers/update-route-policy-term @@ -8,16 +8,14 @@ SYNOPSIS --priority=PRIORITY [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Updates a term of an existing route policy of a Comute Engine - router. - - gcloud beta compute routers update-route-policy-term updates a term of a - route policy. - - For an example, refer to the EXAMPLES section below. + (BETA) gcloud beta compute routers update-route-policy-term updates a term + of a route policy. EXAMPLES - To update a term of a route policy, run: + To update a term with priority 128 with match destination == + '192.168.0.0/24' and actions med.set(12345);asPath.prependSequence([1, 2]) + of a route policy example-policy-name of a router example-router in region + router-region, run: $ gcloud beta compute routers update-route-policy-term \ example-router --region=router-region \ @@ -73,8 +71,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 compute routers update-route-policy-term $ gcloud alpha compute routers update-route-policy-term diff --git a/gcloud/beta/compute/routers/upload-route-policy b/gcloud/beta/compute/routers/upload-route-policy index 61a0cf48d..9b7c80a1e 100644 --- a/gcloud/beta/compute/routers/upload-route-policy +++ b/gcloud/beta/compute/routers/upload-route-policy @@ -11,6 +11,14 @@ DESCRIPTION (BETA) gcloud beta compute routers upload-route-policy uploads a route policy into a Compute Engine router. +EXAMPLES + To upload a route policy my-import-policy from a file my-import-policy.yaml + into a router my-router in region us-central1, run: + + $ gcloud beta compute routers upload-route-policy my-router \ + --region=us-central1 --policy-name=my-import-policy \ + --file-name=my-import-policy.yaml" + POSITIONAL ARGUMENTS NAME Name of the router to upload. @@ -56,8 +64,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 compute routers upload-route-policy $ gcloud alpha compute routers upload-route-policy diff --git a/gcloud/beta/compute/url-maps/list-cdn-cache-invalidations b/gcloud/beta/compute/url-maps/list-cdn-cache-invalidations index a91b60096..0dcbc27a1 100644 --- a/gcloud/beta/compute/url-maps/list-cdn-cache-invalidations +++ b/gcloud/beta/compute/url-maps/list-cdn-cache-invalidations @@ -20,7 +20,8 @@ FLAGS (Default) The URL map is global. Regional URL maps are not supported. --limit=LIMIT - The maximum number of invalidations to list. + The maximum number of invalidations to list. This has an upper limit of + 1000. For more results, use Cloud Logging. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/config/get b/gcloud/beta/config/get index 32092eb77..1ab7a5cb9 100644 --- a/gcloud/beta/config/get +++ b/gcloud/beta/config/get @@ -517,10 +517,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud redis command group. Defaults to https://redis.googleapis.com/ - resourcesettings - Overrides API endpoint for gcloud resource-settings command group. - Defaults to https://resourcesettings.googleapis.com/ - run Overrides API endpoint for gcloud run command group. Defaults to https://run.googleapis.com/ diff --git a/gcloud/beta/config/help b/gcloud/beta/config/help index 47e862b5f..6a523c41e 100644 --- a/gcloud/beta/config/help +++ b/gcloud/beta/config/help @@ -549,10 +549,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud redis command group. Defaults to https://redis.googleapis.com/ - resourcesettings - Overrides API endpoint for gcloud resource-settings command group. - Defaults to https://resourcesettings.googleapis.com/ - run Overrides API endpoint for gcloud run command group. Defaults to https://run.googleapis.com/ diff --git a/gcloud/beta/config/list b/gcloud/beta/config/list index 0b8a75a68..5a6856300 100644 --- a/gcloud/beta/config/list +++ b/gcloud/beta/config/list @@ -561,10 +561,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud redis command group. Defaults to https://redis.googleapis.com/ - resourcesettings - Overrides API endpoint for gcloud resource-settings command group. - Defaults to https://resourcesettings.googleapis.com/ - run Overrides API endpoint for gcloud run command group. Defaults to https://run.googleapis.com/ diff --git a/gcloud/beta/config/set b/gcloud/beta/config/set index 4fc9fec48..5612e7eb3 100644 --- a/gcloud/beta/config/set +++ b/gcloud/beta/config/set @@ -564,10 +564,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud redis command group. Defaults to https://redis.googleapis.com/ - resourcesettings - Overrides API endpoint for gcloud resource-settings command group. - Defaults to https://resourcesettings.googleapis.com/ - run Overrides API endpoint for gcloud run command group. Defaults to https://run.googleapis.com/ diff --git a/gcloud/beta/config/unset b/gcloud/beta/config/unset index 528d420b4..86cf30661 100644 --- a/gcloud/beta/config/unset +++ b/gcloud/beta/config/unset @@ -525,10 +525,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud redis command group. Defaults to https://redis.googleapis.com/ - resourcesettings - Overrides API endpoint for gcloud resource-settings command group. - Defaults to https://resourcesettings.googleapis.com/ - run Overrides API endpoint for gcloud run command group. Defaults to https://run.googleapis.com/ diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index 26e64e7a4..5f4753f64 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -977,7 +977,7 @@ FLAGS Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM, JOBSET For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/configure-metrics#available-metrics @@ -1055,7 +1055,7 @@ FLAGS on how to manage Pub/Sub topics and subscriptions. You can also use the filter option to specify which event types you'd like to receive from the following options: SecurityBulletinEvent, UpgradeEvent, - UpgradeAvailableEvent. + UpgradeInfoEvent, UpgradeAvailableEvent. Examples: @@ -2237,10 +2237,17 @@ FLAGS --maintenance-window-recurrence=FREQ=DAILY --maintenance-window-end=TIME_STAMP - End time of the first window (can occur in the past). Must take - place after the start time. The difference in start and end time - specifies the length of each recurrence. See $ gcloud topic - datetimes for information on time formats. + The end time for calculating the duration of the maintenance + window, as expressed by the amount of time after the START_TIME, in + the same format. The value for END_TIME must be in the future, + relative to START_TIME. This only calculates the duration of the + window, and doesn't set when the maintenance window stops + recurring. Maintenance windows only stop recurring when they're + removed. See $ gcloud topic datetimes for information on time + formats. + + This flag argument must be specified if any of the other arguments + in this group are specified. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/beta/container/clusters/create-auto b/gcloud/beta/container/clusters/create-auto index 7f8a1faf2..1af73a55f 100644 --- a/gcloud/beta/container/clusters/create-auto +++ b/gcloud/beta/container/clusters/create-auto @@ -349,7 +349,7 @@ FLAGS Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM, JOBSET For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/configure-metrics#available-metrics diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index 13b5db347..b8ec61c14 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -13,7 +13,9 @@ SYNOPSIS | --containerd-config-from-file=PATH_TO_FILE | --database-encryption-key=DATABASE_ENCRYPTION_KEY | --disable-database-encryption | --disable-default-snat - | --disable-workload-identity | --enable-autoscaling + | --disable-workload-identity + | --[no-]enable-autopilot-compatibility-auditing + | --enable-autoscaling | --[no-]enable-cilium-clusterwide-network-policy | --enable-cost-allocation | --enable-fleet | --enable-fqdn-network-policy | --enable-gke-oidc @@ -306,6 +308,13 @@ REQUIRED FLAGS https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity + --[no-]enable-autopilot-compatibility-auditing + Enables the Autopilot Compatibility Auditing Feature. See + https://cloud.google.com/sdk/gcloud/reference/container/clusters/check-autopilot-compatibility. + Only applicable to clusters with version >= 1.32. Use + --enable-autopilot-compatibility-auditing to enable and + --no-enable-autopilot-compatibility-auditing to disable. + --enable-autoscaling Enables autoscaling for a node pool. @@ -578,7 +587,8 @@ REQUIRED FLAGS https://cloud.google.com/pubsub/docs/admin on how to manage Pub/Sub topics and subscriptions. You can also use the filter option to specify which event types you'd like to receive from the following - options: SecurityBulletinEvent, UpgradeEvent, UpgradeAvailableEvent. + options: SecurityBulletinEvent, UpgradeEvent, UpgradeInfoEvent, + UpgradeAvailableEvent. Examples: @@ -898,7 +908,7 @@ REQUIRED FLAGS Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM, JOBSET For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/configure-metrics#available-metrics @@ -1015,10 +1025,17 @@ REQUIRED FLAGS --maintenance-window-recurrence=FREQ=DAILY --maintenance-window-end=TIME_STAMP - End time of the first window (can occur in the past). Must take - place after the start time. The difference in start and end time - specifies the length of each recurrence. See $ gcloud topic - datetimes for information on time formats. + The end time for calculating the duration of the maintenance + window, as expressed by the amount of time after the START_TIME, + in the same format. The value for END_TIME must be in the future, + relative to START_TIME. This only calculates the duration of the + window, and doesn't set when the maintenance window stops + recurring. Maintenance windows only stop recurring when they're + removed. See $ gcloud topic datetimes for information on time + formats. + + This flag argument must be specified if any of the other + arguments in this group are specified. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/beta/data-catalog/entries/create b/gcloud/beta/data-catalog/entries/create index 27521ce3a..f1c192298 100644 --- a/gcloud/beta/data-catalog/entries/create +++ b/gcloud/beta/data-catalog/entries/create @@ -10,7 +10,10 @@ SYNOPSIS | --schema-from-file=PATH_TO_FILE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Create a Data Catalog entry. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. + + Create a Data Catalog entry. EXAMPLES To create an entry for a Google Cloud Storage fileset, run: diff --git a/gcloud/beta/data-catalog/entries/delete b/gcloud/beta/data-catalog/entries/delete index 6adeb7134..a2cff22a6 100644 --- a/gcloud/beta/data-catalog/entries/delete +++ b/gcloud/beta/data-catalog/entries/delete @@ -7,7 +7,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Delete a Data Catalog entry. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. + + Delete a Data Catalog entry. EXAMPLES To delete the entry 'entry1' in the group 'group1', run: diff --git a/gcloud/beta/data-catalog/entries/describe b/gcloud/beta/data-catalog/entries/describe index 78b348093..7a59bd7a7 100644 --- a/gcloud/beta/data-catalog/entries/describe +++ b/gcloud/beta/data-catalog/entries/describe @@ -7,7 +7,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Describe a Data Catalog entry. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. + + Describe a Data Catalog entry. EXAMPLES To describe the entry 'entry1' in the group 'group1', run: diff --git a/gcloud/beta/data-catalog/entries/help b/gcloud/beta/data-catalog/entries/help index d5edb0136..a01da8e43 100644 --- a/gcloud/beta/data-catalog/entries/help +++ b/gcloud/beta/data-catalog/entries/help @@ -16,22 +16,22 @@ COMMANDS COMMAND is one of the following: create - (BETA) Create a Data Catalog entry. + (BETA) (DEPRECATED) Create a Data Catalog entry. delete - (BETA) Delete a Data Catalog entry. + (BETA) (DEPRECATED) Delete a Data Catalog entry. describe - (BETA) Describe a Data Catalog entry. + (BETA) (DEPRECATED) Describe a Data Catalog entry. list - (BETA) List all entries in a Data Catalog entry group. + (BETA) (DEPRECATED) List all entries in a Data Catalog entry group. lookup - (BETA) Lookup a Data Catalog entry by its target name. + (BETA) (DEPRECATED) Lookup a Data Catalog entry by its target name. update - (BETA) Update a Data Catalog entry. + (BETA) (DEPRECATED) Update a Data Catalog entry. NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/data-catalog/entries/list b/gcloud/beta/data-catalog/entries/list index 7d904805c..ec976c918 100644 --- a/gcloud/beta/data-catalog/entries/list +++ b/gcloud/beta/data-catalog/entries/list @@ -9,7 +9,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) List all entries in a Data Catalog entry group. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. + + List all entries in a Data Catalog entry group. EXAMPLES To list all entry in the group 'group1', run: diff --git a/gcloud/beta/data-catalog/entries/lookup b/gcloud/beta/data-catalog/entries/lookup index 424bac6d1..8d8a159f8 100644 --- a/gcloud/beta/data-catalog/entries/lookup +++ b/gcloud/beta/data-catalog/entries/lookup @@ -6,7 +6,10 @@ SYNOPSIS gcloud beta data-catalog entries lookup RESOURCE [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Lookup a Data Catalog entry by its target name. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. + + Lookup a Data Catalog entry by its target name. EXAMPLES To lookup the entry for a Cloud Pub/Sub topic by its Google Cloud Platform diff --git a/gcloud/beta/data-catalog/entries/update b/gcloud/beta/data-catalog/entries/update index e0ca6d69b..30c74aca5 100644 --- a/gcloud/beta/data-catalog/entries/update +++ b/gcloud/beta/data-catalog/entries/update @@ -12,9 +12,12 @@ SYNOPSIS | --schema-from-file=PATH_TO_FILE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Update a Data Catalog entry. The entry to update can either be - specified directly, or the --lookup-entry flag may be used to update the - entry corresponding to the lookup of the given resource. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. + + Update a Data Catalog entry. The entry to update can either be specified + directly, or the --lookup-entry flag may be used to update the entry + corresponding to the lookup of the given resource. EXAMPLES To update the schema of a Cloud Pub/Sub entry inline, run: diff --git a/gcloud/beta/data-catalog/entry-groups/add-iam-policy-binding b/gcloud/beta/data-catalog/entry-groups/add-iam-policy-binding index 09dcb305f..4326028e4 100644 --- a/gcloud/beta/data-catalog/entry-groups/add-iam-policy-binding +++ b/gcloud/beta/data-catalog/entry-groups/add-iam-policy-binding @@ -8,7 +8,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Add an IAM policy binding to a Data Catalog entry group. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + + Add an IAM policy binding to a Data Catalog entry group. EXAMPLES To add an IAM policy binding for the role of 'roles/editor' for the user diff --git a/gcloud/beta/data-catalog/entry-groups/create b/gcloud/beta/data-catalog/entry-groups/create index 16c4ab81b..d21af43ed 100644 --- a/gcloud/beta/data-catalog/entry-groups/create +++ b/gcloud/beta/data-catalog/entry-groups/create @@ -8,7 +8,10 @@ SYNOPSIS [--display-name=DISPLAY_NAME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Create a Data Catalog entry group. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + + Create a Data Catalog entry group. EXAMPLES To create an entry group for some data, run: diff --git a/gcloud/beta/data-catalog/entry-groups/delete b/gcloud/beta/data-catalog/entry-groups/delete index f42ba5ec0..a023f4704 100644 --- a/gcloud/beta/data-catalog/entry-groups/delete +++ b/gcloud/beta/data-catalog/entry-groups/delete @@ -7,7 +7,10 @@ SYNOPSIS (ENTRY_GROUP : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Delete a Data Catalog entry group. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + + Delete a Data Catalog entry group. EXAMPLES To delete an entry group for some data, run: diff --git a/gcloud/beta/data-catalog/entry-groups/describe b/gcloud/beta/data-catalog/entry-groups/describe index 2e019a6e6..85dcfbda0 100644 --- a/gcloud/beta/data-catalog/entry-groups/describe +++ b/gcloud/beta/data-catalog/entry-groups/describe @@ -7,7 +7,10 @@ SYNOPSIS (ENTRY_GROUP : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Describe a Data Catalog entry group. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + + Describe a Data Catalog entry group. EXAMPLES To describe an entry group for some data, run: diff --git a/gcloud/beta/data-catalog/entry-groups/get-iam-policy b/gcloud/beta/data-catalog/entry-groups/get-iam-policy index d46444d81..05a06f8ac 100644 --- a/gcloud/beta/data-catalog/entry-groups/get-iam-policy +++ b/gcloud/beta/data-catalog/entry-groups/get-iam-policy @@ -9,12 +9,15 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta data-catalog entry-groups get-iam-policy displays the - IAM policy associated with a Data Catalog entry group. If formatted as - JSON, the output can be edited and used as a policy file for - set-iam-policy. The output includes an "etag" field identifying the version - emitted and allowing detection of concurrent policy updates; see $ gcloud - beta data-catalog entry-groups set-iam-policy for additional details. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + + gcloud beta data-catalog entry-groups get-iam-policy displays the IAM + policy associated with a Data Catalog entry group. If formatted as JSON, + the output can be edited and used as a policy file for set-iam-policy. The + output includes an "etag" field identifying the version emitted and + allowing detection of concurrent policy updates; see $ gcloud beta + data-catalog entry-groups set-iam-policy for additional details. EXAMPLES To print the IAM policy for entry group 'group1' in 'us-central1', run: diff --git a/gcloud/beta/data-catalog/entry-groups/help b/gcloud/beta/data-catalog/entry-groups/help index 34fdbf383..03c7b8a6a 100644 --- a/gcloud/beta/data-catalog/entry-groups/help +++ b/gcloud/beta/data-catalog/entry-groups/help @@ -5,7 +5,10 @@ SYNOPSIS gcloud beta data-catalog entry-groups COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Manage entry groups in Data Catalog. + (BETA) (DEPRECATED) Manage entry groups in Data Catalog. + + This command is deprecated. Please use gcloud dataplex entry-groups + instead. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -16,31 +19,33 @@ COMMANDS COMMAND is one of the following: add-iam-policy-binding - (BETA) Add an IAM policy binding to a Data Catalog entry group. + (BETA) (DEPRECATED) Add an IAM policy binding to a Data Catalog entry + group. create - (BETA) Create a Data Catalog entry group. + (BETA) (DEPRECATED) Create a Data Catalog entry group. delete - (BETA) Delete a Data Catalog entry group. + (BETA) (DEPRECATED) Delete a Data Catalog entry group. describe - (BETA) Describe a Data Catalog entry group. + (BETA) (DEPRECATED) Describe a Data Catalog entry group. get-iam-policy - (BETA) Get the IAM policy for a Data Catalog entry group. + (BETA) (DEPRECATED) Get the IAM policy for a Data Catalog entry group. list - (BETA) List all entry groups in a Data Catalog location. + (BETA) (DEPRECATED) List all entry groups in a Data Catalog location. remove-iam-policy-binding - (BETA) Remove an IAM policy binding from a Data Catalog entry group. + (BETA) (DEPRECATED) Remove an IAM policy binding from a Data Catalog + entry group. set-iam-policy - (BETA) Set the IAM policy for a Data Catalog entry group. + (BETA) (DEPRECATED) Set the IAM policy for a Data Catalog entry group. update - (BETA) Update a Data Catalog entry group. + (BETA) (DEPRECATED) Update a Data Catalog entry group. NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/data-catalog/entry-groups/list b/gcloud/beta/data-catalog/entry-groups/list index 045eafc11..579a85652 100644 --- a/gcloud/beta/data-catalog/entry-groups/list +++ b/gcloud/beta/data-catalog/entry-groups/list @@ -8,7 +8,10 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) List all entries in a Data Catalog location. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + + List all entries in a Data Catalog location. EXAMPLES To list all entry groups in us-central1, run: diff --git a/gcloud/beta/data-catalog/entry-groups/remove-iam-policy-binding b/gcloud/beta/data-catalog/entry-groups/remove-iam-policy-binding index 93527a246..aec47b4db 100644 --- a/gcloud/beta/data-catalog/entry-groups/remove-iam-policy-binding +++ b/gcloud/beta/data-catalog/entry-groups/remove-iam-policy-binding @@ -8,7 +8,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Remove an IAM policy binding from a Data Catalog entry group. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + + Remove an IAM policy binding from a Data Catalog entry group. EXAMPLES To remove an IAM policy binding for the role of 'roles/editor' for the user diff --git a/gcloud/beta/data-catalog/entry-groups/set-iam-policy b/gcloud/beta/data-catalog/entry-groups/set-iam-policy index fc735c65f..192659a81 100644 --- a/gcloud/beta/data-catalog/entry-groups/set-iam-policy +++ b/gcloud/beta/data-catalog/entry-groups/set-iam-policy @@ -7,8 +7,11 @@ SYNOPSIS (ENTRY_GROUP : --location=LOCATION) POLICY_FILE [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Set the IAM policy for the given Data Catalog entry group as defined - in a JSON or YAML file. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + + Set the IAM policy for the given Data Catalog entry group as defined in a + JSON or YAML file. EXAMPLES The following command will read am IAM policy defined in a JSON file diff --git a/gcloud/beta/data-catalog/entry-groups/update b/gcloud/beta/data-catalog/entry-groups/update index e4f81834d..547967ffc 100644 --- a/gcloud/beta/data-catalog/entry-groups/update +++ b/gcloud/beta/data-catalog/entry-groups/update @@ -8,7 +8,10 @@ SYNOPSIS [--display-name=DISPLAY_NAME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Update a Data Catalog entry group. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + + Update a Data Catalog entry group. EXAMPLES To update the description of entry group 'group1' , run: diff --git a/gcloud/beta/data-catalog/help b/gcloud/beta/data-catalog/help index e5206280f..9e6d95134 100644 --- a/gcloud/beta/data-catalog/help +++ b/gcloud/beta/data-catalog/help @@ -19,13 +19,13 @@ GROUPS (BETA) Manage entries in Data Catalog. entry-groups - (BETA) Manage entry groups in Data Catalog. + (BETA) (DEPRECATED) Manage entry groups in Data Catalog. tag-templates - (BETA) Manage tag templates in Data Catalog. + (BETA) (DEPRECATED) Manage tag templates in Data Catalog. tags - (BETA) Manage tags in Data Catalog. + (BETA) (DEPRECATED) Manage tags in Data Catalog. taxonomies (BETA) Manage taxonomies in Data Catalog. @@ -34,7 +34,8 @@ COMMANDS COMMAND is one of the following: search - (BETA) Search Data Catalog for resources that match a query. + (BETA) (DEPRECATED) Search Data Catalog for resources that match a + query. NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/data-catalog/search b/gcloud/beta/data-catalog/search index abfbca440..211213250 100644 --- a/gcloud/beta/data-catalog/search +++ b/gcloud/beta/data-catalog/search @@ -11,7 +11,10 @@ SYNOPSIS [--order-by=ORDER_BY] [--page-size=PAGE_SIZE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Search Data Catalog for resources that match a query. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries search instead. + + Search Data Catalog for resources that match a query. EXAMPLES To search project 'my-project' for Data Catalog resources that match the diff --git a/gcloud/beta/data-catalog/tag-templates/add-iam-policy-binding b/gcloud/beta/data-catalog/tag-templates/add-iam-policy-binding index 89b8281c6..e75156213 100644 --- a/gcloud/beta/data-catalog/tag-templates/add-iam-policy-binding +++ b/gcloud/beta/data-catalog/tag-templates/add-iam-policy-binding @@ -8,7 +8,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Add IAM policy binding to a Data Catalog tag template. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Add IAM policy binding to a Data Catalog tag template. EXAMPLES To add an IAM policy binding for the role of 'roles/editor' for the user diff --git a/gcloud/beta/data-catalog/tag-templates/create b/gcloud/beta/data-catalog/tag-templates/create index 1b6e94718..29f492524 100644 --- a/gcloud/beta/data-catalog/tag-templates/create +++ b/gcloud/beta/data-catalog/tag-templates/create @@ -10,7 +10,10 @@ SYNOPSIS [--display-name=DISPLAY_NAME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Create a Data Catalog tag template. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Create a Data Catalog tag template. EXAMPLES Create a string tag template with a required string field: diff --git a/gcloud/beta/data-catalog/tag-templates/delete b/gcloud/beta/data-catalog/tag-templates/delete index 4534ac142..aaaa745b0 100644 --- a/gcloud/beta/data-catalog/tag-templates/delete +++ b/gcloud/beta/data-catalog/tag-templates/delete @@ -7,7 +7,10 @@ SYNOPSIS (TAG_TEMPLATE : --location=LOCATION) [--force] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Delete a Data Catalog tag template. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Delete a Data Catalog tag template. EXAMPLES Delete a tag template: diff --git a/gcloud/beta/data-catalog/tag-templates/describe b/gcloud/beta/data-catalog/tag-templates/describe index 83bff8817..2fee0fd6a 100644 --- a/gcloud/beta/data-catalog/tag-templates/describe +++ b/gcloud/beta/data-catalog/tag-templates/describe @@ -7,7 +7,10 @@ SYNOPSIS (TAG_TEMPLATE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Describe a Data Catalog tag template. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Describe a Data Catalog tag template. EXAMPLES Describe a tag template: diff --git a/gcloud/beta/data-catalog/tag-templates/fields/create b/gcloud/beta/data-catalog/tag-templates/fields/create index be19734c1..1226f4057 100644 --- a/gcloud/beta/data-catalog/tag-templates/fields/create +++ b/gcloud/beta/data-catalog/tag-templates/fields/create @@ -8,7 +8,10 @@ SYNOPSIS [--display-name=DISPLAY_NAME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Create a Data Catalog tag template field. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Create a Data Catalog tag template field. EXAMPLES Create a string tag template field: diff --git a/gcloud/beta/data-catalog/tag-templates/fields/delete b/gcloud/beta/data-catalog/tag-templates/fields/delete index 0c9535fc0..9a7930bbe 100644 --- a/gcloud/beta/data-catalog/tag-templates/fields/delete +++ b/gcloud/beta/data-catalog/tag-templates/fields/delete @@ -8,7 +8,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Delete a Data Catalog tag template field. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Delete a Data Catalog tag template field. EXAMPLES Delete a tag template field: diff --git a/gcloud/beta/data-catalog/tag-templates/fields/enum-values/help b/gcloud/beta/data-catalog/tag-templates/fields/enum-values/help index acc08d86f..8b7dd5c72 100644 --- a/gcloud/beta/data-catalog/tag-templates/fields/enum-values/help +++ b/gcloud/beta/data-catalog/tag-templates/fields/enum-values/help @@ -7,7 +7,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Manage tag template enum values in Data Catalog. + (BETA) (DEPRECATED) Manage tag template enum values in Data Catalog. + + This command is deprecated. Please use gcloud dataplex aspect-types + instead. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,7 +21,8 @@ COMMANDS COMMAND is one of the following: rename - (BETA) Rename an enum value in Data Catalog tag template enum field. + (BETA) (DEPRECATED) Rename an enum value in Data Catalog tag template + enum field. NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/data-catalog/tag-templates/fields/enum-values/rename b/gcloud/beta/data-catalog/tag-templates/fields/enum-values/rename index 53c6d6719..e35df0e3f 100644 --- a/gcloud/beta/data-catalog/tag-templates/fields/enum-values/rename +++ b/gcloud/beta/data-catalog/tag-templates/fields/enum-values/rename @@ -9,7 +9,10 @@ SYNOPSIS --new-id=NEW_ID [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Rename an enum value in Data Catalog tag template enum field. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Rename an enum value in Data Catalog tag template enum field. EXAMPLES Rename an enum value in tag template enum field: diff --git a/gcloud/beta/data-catalog/tag-templates/fields/help b/gcloud/beta/data-catalog/tag-templates/fields/help index cfdf09a51..2ed1b6718 100644 --- a/gcloud/beta/data-catalog/tag-templates/fields/help +++ b/gcloud/beta/data-catalog/tag-templates/fields/help @@ -7,7 +7,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Manage tag template fields in Data Catalog. + (BETA) (DEPRECATED) Manage tag template fields in Data Catalog. + + This command is deprecated. Please use gcloud dataplex aspect-types + instead. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,22 +21,22 @@ GROUPS GROUP is one of the following: enum-values - (BETA) Manage tag template enum values in Data Catalog. + (BETA) (DEPRECATED) Manage tag template enum values in Data Catalog. COMMANDS COMMAND is one of the following: create - (BETA) Create a Data Catalog tag template field. + (BETA) (DEPRECATED) Create a Data Catalog tag template field. delete - (BETA) Delete a Data Catalog tag template field. + (BETA) (DEPRECATED) Delete a Data Catalog tag template field. rename - (BETA) Rename a Data Catalog tag template field. + (BETA) (DEPRECATED) Rename a Data Catalog tag template field. update - (BETA) Update a Data Catalog tag template field. + (BETA) (DEPRECATED) Update a Data Catalog tag template field. NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/data-catalog/tag-templates/fields/rename b/gcloud/beta/data-catalog/tag-templates/fields/rename index eeceaf807..29deac008 100644 --- a/gcloud/beta/data-catalog/tag-templates/fields/rename +++ b/gcloud/beta/data-catalog/tag-templates/fields/rename @@ -8,7 +8,10 @@ SYNOPSIS --new-id=NEW_ID [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Rename a Data Catalog tag template field. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Rename a Data Catalog tag template field. EXAMPLES Update the ID of a tag template field: diff --git a/gcloud/beta/data-catalog/tag-templates/fields/update b/gcloud/beta/data-catalog/tag-templates/fields/update index 5d2ed4dfb..bdeebd6ff 100644 --- a/gcloud/beta/data-catalog/tag-templates/fields/update +++ b/gcloud/beta/data-catalog/tag-templates/fields/update @@ -9,7 +9,10 @@ SYNOPSIS [--required] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Update a Data Catalog tag template field. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Update a Data Catalog tag template field. EXAMPLES Update the display name of a tag template field: diff --git a/gcloud/beta/data-catalog/tag-templates/get-iam-policy b/gcloud/beta/data-catalog/tag-templates/get-iam-policy index 50b158ba8..3b6637a1d 100644 --- a/gcloud/beta/data-catalog/tag-templates/get-iam-policy +++ b/gcloud/beta/data-catalog/tag-templates/get-iam-policy @@ -9,12 +9,15 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta data-catalog tag-templates get-iam-policy displays the - IAM policy associated with a Data Catalog. If formatted as JSON, the output - can be edited and used as a policy file for set-iam-policy. The output - includes an "etag" field identifying the version emitted and allowing - detection of concurrent policy updates; see $ gcloud beta data-catalog - tag-templates set-iam-policy for additional details. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + gcloud beta data-catalog tag-templates get-iam-policy displays the IAM + policy associated with a Data Catalog. If formatted as JSON, the output can + be edited and used as a policy file for set-iam-policy. The output includes + an "etag" field identifying the version emitted and allowing detection of + concurrent policy updates; see $ gcloud beta data-catalog tag-templates + set-iam-policy for additional details. EXAMPLES To print the IAM policy for a given tag template, run: diff --git a/gcloud/beta/data-catalog/tag-templates/help b/gcloud/beta/data-catalog/tag-templates/help index d04fc60a3..3e94203a3 100644 --- a/gcloud/beta/data-catalog/tag-templates/help +++ b/gcloud/beta/data-catalog/tag-templates/help @@ -7,7 +7,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Manage tag templates in Data Catalog. + (BETA) (DEPRECATED) Manage tag templates in Data Catalog. + + This command is deprecated. Please use gcloud dataplex aspect-types + instead. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,34 +21,36 @@ GROUPS GROUP is one of the following: fields - (BETA) Manage tag template fields in Data Catalog. + (BETA) (DEPRECATED) Manage tag template fields in Data Catalog. COMMANDS COMMAND is one of the following: add-iam-policy-binding - (BETA) Add IAM policy binding to a Data Catalog tag template. + (BETA) (DEPRECATED) Add IAM policy binding to a Data Catalog tag + template. create - (BETA) Create a Data Catalog tag template. + (BETA) (DEPRECATED) Create a Data Catalog tag template. delete - (BETA) Delete a Data Catalog tag template. + (BETA) (DEPRECATED) Delete a Data Catalog tag template. describe - (BETA) Describe a Data Catalog tag template. + (BETA) (DEPRECATED) Describe a Data Catalog tag template. get-iam-policy - (BETA) Get the IAM policy for a Data Catalog tag template. + (BETA) (DEPRECATED) Get the IAM policy for a Data Catalog tag template. remove-iam-policy-binding - (BETA) Remove IAM policy binding from a Data Catalog tag template. + (BETA) (DEPRECATED) Remove IAM policy binding from a Data Catalog tag + template. set-iam-policy - (BETA) Set the IAM policy for a Data Catalog tag template. + (BETA) (DEPRECATED) Set the IAM policy for a Data Catalog tag template. update - (BETA) Update a Data Catalog tag template. + (BETA) (DEPRECATED) Update a Data Catalog tag template. NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/data-catalog/tag-templates/remove-iam-policy-binding b/gcloud/beta/data-catalog/tag-templates/remove-iam-policy-binding index f26431ae4..22cddae76 100644 --- a/gcloud/beta/data-catalog/tag-templates/remove-iam-policy-binding +++ b/gcloud/beta/data-catalog/tag-templates/remove-iam-policy-binding @@ -8,7 +8,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Removes a policy binding from the IAM policy of a Data Catalog tag + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Removes a policy binding from the IAM policy of a Data Catalog tag template, given a project ID and the binding. EXAMPLES diff --git a/gcloud/beta/data-catalog/tag-templates/set-iam-policy b/gcloud/beta/data-catalog/tag-templates/set-iam-policy index 3be97b465..0f16c8c6b 100644 --- a/gcloud/beta/data-catalog/tag-templates/set-iam-policy +++ b/gcloud/beta/data-catalog/tag-templates/set-iam-policy @@ -7,8 +7,11 @@ SYNOPSIS (TAG_TEMPLATE : --location=LOCATION) POLICY_FILE [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Sets the IAM policy for the given Data Catalog tag template as - defined in a JSON or YAML file. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Sets the IAM policy for the given Data Catalog tag template as defined in a + JSON or YAML file. EXAMPLES The following command will read am IAM policy defined in a JSON file diff --git a/gcloud/beta/data-catalog/tag-templates/update b/gcloud/beta/data-catalog/tag-templates/update index 483d117d9..e900739e2 100644 --- a/gcloud/beta/data-catalog/tag-templates/update +++ b/gcloud/beta/data-catalog/tag-templates/update @@ -8,7 +8,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Update a Data Catalog tag template. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + + Update a Data Catalog tag template. EXAMPLES Update the display name of a tag template: diff --git a/gcloud/beta/data-catalog/tags/create b/gcloud/beta/data-catalog/tags/create index 34ce43e4c..562b074af 100644 --- a/gcloud/beta/data-catalog/tags/create +++ b/gcloud/beta/data-catalog/tags/create @@ -10,7 +10,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Create a Data Catalog entry tag. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. Note that aspects - successors of tags - are part of the + entry resource and are managed by gcloud dataplex entries command. + + Create a Data Catalog entry tag. EXAMPLES Create a Data Catalog entry tag: diff --git a/gcloud/beta/data-catalog/tags/delete b/gcloud/beta/data-catalog/tags/delete index af2dd7c0c..1730f1308 100644 --- a/gcloud/beta/data-catalog/tags/delete +++ b/gcloud/beta/data-catalog/tags/delete @@ -7,7 +7,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Delete a Data Catalog entry tag. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. Note that aspects - successors of tags - are part of the + entry resource and are managed by gcloud dataplex entries command. + + Delete a Data Catalog entry tag. EXAMPLES Delete a Data Catalog entry tag: diff --git a/gcloud/beta/data-catalog/tags/help b/gcloud/beta/data-catalog/tags/help index bdad9890c..441b22b42 100644 --- a/gcloud/beta/data-catalog/tags/help +++ b/gcloud/beta/data-catalog/tags/help @@ -5,7 +5,11 @@ SYNOPSIS gcloud beta data-catalog tags COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Manage tags in Data Catalog. + (BETA) (DEPRECATED) Manage tags in Data Catalog. + + This command is deprecated. Please use gcloud dataplex entries instead. + Note that aspects - successors of tags - are part of the entry resource and + are managed by gcloud dataplex entries command. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -16,16 +20,16 @@ COMMANDS COMMAND is one of the following: create - (BETA) Create a Data Catalog entry tag. + (BETA) (DEPRECATED) Create a Data Catalog entry tag. delete - (BETA) Delete a Data Catalog entry tag. + (BETA) (DEPRECATED) Delete a Data Catalog entry tag. list - (BETA) List Data Catalog entry tags. + (BETA) (DEPRECATED) List Data Catalog entry tags. update - (BETA) Update a Data Catalog entry tag. + (BETA) (DEPRECATED) Update a Data Catalog entry tag. NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/data-catalog/tags/list b/gcloud/beta/data-catalog/tags/list index e44328b15..6e07053c5 100644 --- a/gcloud/beta/data-catalog/tags/list +++ b/gcloud/beta/data-catalog/tags/list @@ -8,7 +8,11 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) List Data Catalog entry tags. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. Note that aspects - successors of tags - are part of the + entry resource and are managed by gcloud dataplex entries command. + + List Data Catalog entry tags. EXAMPLES List the tags for a Data Catalog entry: diff --git a/gcloud/beta/data-catalog/tags/update b/gcloud/beta/data-catalog/tags/update index 8512efb2a..ad065f756 100644 --- a/gcloud/beta/data-catalog/tags/update +++ b/gcloud/beta/data-catalog/tags/update @@ -10,8 +10,12 @@ SYNOPSIS --tag-template-project=TAG_TEMPLATE_PROJECT) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Update a Data Catalog entry tag. This will overwrite the current - values of the tag. + (BETA) (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entries instead. Note that aspects - successors of tags - are part of the + entry resource and are managed by gcloud dataplex entries command. + + Update a Data Catalog entry tag. This will overwrite the current values of + the tag. EXAMPLES Update a Data Catalog entry tag: diff --git a/gcloud/beta/dataflow/flex-template/build b/gcloud/beta/dataflow/flex-template/build index 0588f361b..10ac9e758 100644 --- a/gcloud/beta/dataflow/flex-template/build +++ b/gcloud/beta/dataflow/flex-template/build @@ -8,7 +8,9 @@ SYNOPSIS (--image=IMAGE | --env=[ENV,...] --flex-template-base-image=FLEX_TEMPLATE_BASE_IMAGE --image-gcr-path=IMAGE_GCR_PATH (--go-binary-path=GO_BINARY_PATH - | --jar=[JAR,...] | --py-path=[PY_PATH,...])) + | --jar=[JAR,...] | --py-path=[PY_PATH,...]) + | [--yaml-pipeline-path=YAML_PIPELINE_PATH + : --yaml-image=YAML_IMAGE]) [--additional-experiments=[ADDITIONAL_EXPERIMENTS,...]] [--additional-user-labels=[ADDITIONAL_USER_LABELS,...]] [--cloud-build-service-account=CLOUD_BUILD_SERVICE_ACCOUNT] @@ -65,7 +67,7 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --sdk-language=SDK_LANGUAGE SDK language of the flex template job. SDK_LANGUAGE must be one of: - JAVA, PYTHON, GO. + JAVA, PYTHON, GO, YAML. Exactly one of these must be specified: @@ -127,6 +129,17 @@ REQUIRED FLAGS --py-path flag. Ex: --py-path="path/pipleline/,path/dependency/" or --py-path path/pipleline/, --py-path path/dependency/. + --yaml-pipeline-path=YAML_PIPELINE_PATH + Local path to your YAML pipeline file. Use a full or relative path to + a local file containing the value of yaml_pipeline_path. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --yaml-image=YAML_IMAGE + Path to the any image registry location of the prebuilt yaml template + image. + OPTIONAL FLAGS --additional-experiments=[ADDITIONAL_EXPERIMENTS,...] Default experiments to pass to the job. diff --git a/gcloud/beta/dataflow/jobs/run b/gcloud/beta/dataflow/jobs/run index cfde8ea2e..8a20bad21 100644 --- a/gcloud/beta/dataflow/jobs/run +++ b/gcloud/beta/dataflow/jobs/run @@ -11,6 +11,8 @@ SYNOPSIS [--service-account-email=SERVICE_ACCOUNT_EMAIL] [--staging-location=STAGING_LOCATION] [--subnetwork=SUBNETWORK] [--worker-machine-type=WORKER_MACHINE_TYPE] + [[--[no-]update + : --transform-name-mappings=[TRANSFORM_NAME_MAPPINGS,...]]] [--worker-region=WORKER_REGION | --worker-zone=WORKER_ZONE | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] @@ -74,6 +76,13 @@ OPTIONAL FLAGS --worker-machine-type=WORKER_MACHINE_TYPE The type of machine to use for workers. Defaults to server-specified. + --[no-]update + Set this to true for streaming update jobs. Use --update to enable and + --no-update to disable. + + --transform-name-mappings=[TRANSFORM_NAME_MAPPINGS,...] + Transform name mappings for the streaming update job. + Worker location options. At most one of these can be specified: diff --git a/gcloud/beta/datastream/connection-profiles/create b/gcloud/beta/datastream/connection-profiles/create index f36616556..9a4100ebe 100644 --- a/gcloud/beta/datastream/connection-profiles/create +++ b/gcloud/beta/datastream/connection-profiles/create @@ -24,12 +24,11 @@ SYNOPSIS : [--postgresql-ca-certificate=POSTGRESQL_CA_CERTIFICATE : --postgresql-client-certificate=POSTGRESQL_CLIENT_CERTIFICATE --postgresql-client-key=POSTGRESQL_CLIENT_KEY]] - | --sqlserver-database=SQLSERVER_DATABASE - --sqlserver-hostname=SQLSERVER_HOSTNAME - --sqlserver-port=SQLSERVER_PORT - --sqlserver-username=SQLSERVER_USERNAME - (--sqlserver-password=SQLSERVER_PASSWORD - | --sqlserver-prompt-for-password)] + | --salesforce-domain=SALESFORCE_DOMAIN + (--salesforce-oauth2-client-id=SALESFORCE_OAUTH2_CLIENT_ID + (--salesforce-oauth2-client-secret=SALESFORCE_OAUTH2_CLIENT_SECRET + | --salesforce-prompt-for-oauth2-client-secret + | --salesforce-secret-manager-stored-oauth2-client-secret=SALESFORCE_SECRET_MANAGER_STORED_OAUTH2_CLIENT_SECRET) | --salesforce-username=SALESFORCE_USERNAME (--salesforce-password=SALESFORCE_PASSWORD | --salesforce-prompt-for-password | --salesforce-secret-manager-stored-password=SALESFORCE_SECRET_MANAGER_STORED_PASSWORD) (--salesforce-prompt-for-security-token | --salesforce-secret-manager-stored-security-token=SALESFORCE_SECRET_MANAGER_STORED_SECURITY_TOKEN | --salesforce-security-token=SALESFORCE_SECURITY_TOKEN)) | --sqlserver-database=SQLSERVER_DATABASE --sqlserver-hostname=SQLSERVER_HOSTNAME --sqlserver-port=SQLSERVER_PORT --sqlserver-username=SQLSERVER_USERNAME (--sqlserver-password=SQLSERVER_PASSWORD | --sqlserver-prompt-for-password)] [--no-connectivity | --private-connection-name=PRIVATE_CONNECTION_NAME | --static-ip-connectivity | [--forward-ssh-hostname=FORWARD_SSH_HOSTNAME @@ -271,6 +270,67 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --salesforce-domain=SALESFORCE_DOMAIN + Domain of the Salesforce organization. For example, + 'myorg.my.salesforce.com' + + This flag argument must be specified if any of the other arguments in + this group are specified. + + Exactly one of these must be specified: + + --salesforce-oauth2-client-id=SALESFORCE_OAUTH2_CLIENT_ID + OAuth 2.0 Client ID used to connect to Salesforce. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + Exactly one of these must be specified: + + --salesforce-oauth2-client-secret=SALESFORCE_OAUTH2_CLIENT_SECRET + OAuth 2.0 Client secret used to connect to Salesforce. + + --salesforce-prompt-for-oauth2-client-secret + Prompt for the OAuth 2.0 Client secret used to connect to + Salesforce. + + --salesforce-secret-manager-stored-oauth2-client-secret=SALESFORCE_SECRET_MANAGER_STORED_OAUTH2_CLIENT_SECRET + Path to secret manager, storing the OAuth 2.0 Client secret used + to connect to Salesforce. + + --salesforce-username=SALESFORCE_USERNAME + Username Datastream will use to connect to the database. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + Exactly one of these must be specified: + + --salesforce-password=SALESFORCE_PASSWORD + Password for the user that Datastream will be using to connect to + Salesforce. This field is not returned on request, and the value + is encrypted when stored in Datastream. + + --salesforce-prompt-for-password + Prompt for the password used to connect to Salesforce. + + --salesforce-secret-manager-stored-password=SALESFORCE_SECRET_MANAGER_STORED_PASSWORD + Path to secret manager, storing the password used to connect to + Salesforce. + + Exactly one of these must be specified: + + --salesforce-prompt-for-security-token + Prompt for the security token used to connect to Salesforce. + + --salesforce-secret-manager-stored-security-token=SALESFORCE_SECRET_MANAGER_STORED_SECURITY_TOKEN + Path to secret manager, storing the security token used to + connect to Salesforce. + + --salesforce-security-token=SALESFORCE_SECURITY_TOKEN + Security token for the user that Datastream will be using to + connect to Salesforce. + --sqlserver-database=SQLSERVER_DATABASE Database service for the SQL Server connection. diff --git a/gcloud/beta/datastream/connection-profiles/update b/gcloud/beta/datastream/connection-profiles/update index 4f7835d6a..98f77e1cf 100644 --- a/gcloud/beta/datastream/connection-profiles/update +++ b/gcloud/beta/datastream/connection-profiles/update @@ -25,12 +25,11 @@ SYNOPSIS --postgresql-client-key=POSTGRESQL_CLIENT_KEY --postgresql-password=POSTGRESQL_PASSWORD | --postgresql-prompt-for-password - | --sqlserver-database=SQLSERVER_DATABASE - --sqlserver-hostname=SQLSERVER_HOSTNAME - --sqlserver-port=SQLSERVER_PORT - --sqlserver-username=SQLSERVER_USERNAME - --sqlserver-password=SQLSERVER_PASSWORD - | --sqlserver-prompt-for-password] + | --salesforce-domain=SALESFORCE_DOMAIN + --salesforce-oauth2-client-id=SALESFORCE_OAUTH2_CLIENT_ID + --salesforce-oauth2-client-secret=SALESFORCE_OAUTH2_CLIENT_SECRET + | --salesforce-prompt-for-oauth2-client-secret + | --salesforce-secret-manager-stored-oauth2-client-secret=SALESFORCE_SECRET_MANAGER_STORED_OAUTH2_CLIENT_SECRET | --salesforce-username=SALESFORCE_USERNAME --salesforce-password=SALESFORCE_PASSWORD | --salesforce-prompt-for-password | --salesforce-secret-manager-stored-password=SALESFORCE_SECRET_MANAGER_STORED_PASSWORD --salesforce-prompt-for-security-token | --salesforce-secret-manager-stored-security-token=SALESFORCE_SECRET_MANAGER_STORED_SECURITY_TOKEN | --salesforce-security-token=SALESFORCE_SECURITY_TOKEN | --sqlserver-database=SQLSERVER_DATABASE --sqlserver-hostname=SQLSERVER_HOSTNAME --sqlserver-port=SQLSERVER_PORT --sqlserver-username=SQLSERVER_USERNAME --sqlserver-password=SQLSERVER_PASSWORD | --sqlserver-prompt-for-password] [--clear-labels | --remove-labels=[KEY,...]] [--no-connectivity | --private-connection-name=PRIVATE_CONNECTION_NAME | --static-ip-connectivity @@ -220,6 +219,58 @@ OPTIONAL FLAGS --postgresql-prompt-for-password Prompt for the password used to connect to the database. + --salesforce-domain=SALESFORCE_DOMAIN + Domain of the Salesforce organization. For example, + 'myorg.my.salesforce.com' + + At most one of these can be specified: + + --salesforce-oauth2-client-id=SALESFORCE_OAUTH2_CLIENT_ID + OAuth 2.0 Client ID used to connect to Salesforce. + + At most one of these can be specified: + + --salesforce-oauth2-client-secret=SALESFORCE_OAUTH2_CLIENT_SECRET + OAuth 2.0 Client secret used to connect to Salesforce. + + --salesforce-prompt-for-oauth2-client-secret + Prompt for the OAuth 2.0 Client secret used to connect to + Salesforce. + + --salesforce-secret-manager-stored-oauth2-client-secret=SALESFORCE_SECRET_MANAGER_STORED_OAUTH2_CLIENT_SECRET + Path to secret manager, storing the OAuth 2.0 Client secret used + to connect to Salesforce. + + --salesforce-username=SALESFORCE_USERNAME + Username Datastream will use to connect to the database. + + At most one of these can be specified: + + --salesforce-password=SALESFORCE_PASSWORD + Password for the user that Datastream will be using to connect to + Salesforce. This field is not returned on request, and the value + is encrypted when stored in Datastream. + + --salesforce-prompt-for-password + Prompt for the password used to connect to Salesforce. + + --salesforce-secret-manager-stored-password=SALESFORCE_SECRET_MANAGER_STORED_PASSWORD + Path to secret manager, storing the password used to connect to + Salesforce. + + At most one of these can be specified: + + --salesforce-prompt-for-security-token + Prompt for the security token used to connect to Salesforce. + + --salesforce-secret-manager-stored-security-token=SALESFORCE_SECRET_MANAGER_STORED_SECURITY_TOKEN + Path to secret manager, storing the security token used to + connect to Salesforce. + + --salesforce-security-token=SALESFORCE_SECURITY_TOKEN + Security token for the user that Datastream will be using to + connect to Salesforce. + --sqlserver-database=SQLSERVER_DATABASE Database service for the SQL Server connection. diff --git a/gcloud/beta/datastream/streams/create b/gcloud/beta/datastream/streams/create index addb803d8..19c65ceec 100644 --- a/gcloud/beta/datastream/streams/create +++ b/gcloud/beta/datastream/streams/create @@ -8,6 +8,7 @@ SYNOPSIS | --backfill-all --mysql-excluded-objects=MYSQL_EXCLUDED_OBJECTS | --oracle-excluded-objects=ORACLE_EXCLUDED_OBJECTS | --postgresql-excluded-objects=POSTGRESQL_EXCLUDED_OBJECTS + | --salesforce-excluded-objects=SALESFORCE_EXCLUDED_OBJECTS | --sqlserver-excluded-objects=SQLSERVER_EXCLUDED_OBJECTS) (--destination-name=DESTINATION_NAME (--bigquery-destination-config=BIGQUERY_DESTINATION_CONFIG @@ -15,6 +16,7 @@ SYNOPSIS (--source-name=SOURCE_NAME (--mysql-source-config=MYSQL_SOURCE_CONFIG | --oracle-source-config=ORACLE_SOURCE_CONFIG | --postgresql-source-config=POSTGRESQL_SOURCE_CONFIG + | --salesforce-source-config=SALESFORCE_SOURCE_CONFIG | --sqlserver-source-config=SQLSERVER_SOURCE_CONFIG)) [--labels=[KEY=VALUE,...]] [--force | --validate-only] [GCLOUD_WIDE_FLAG ...] @@ -102,22 +104,21 @@ REQUIRED FLAGS The JSON file is formatted as follows, with camelCase field naming: { - "mysqlDatabases": [ + "mysqlDatabases": [ + { + "database":"sample_database", + "mysqlTables": [ { - "database":"sample_database", - "mysqlTables": [ + "table": "sample_table", + "mysqlColumns": [ { - "table": "sample_table", - "mysqlColumns": [ - { - "column": "sample_column", - } - ] + "column": "sample_column", } - ] + ] } ] } + ] } --oracle-excluded-objects=ORACLE_EXCLUDED_OBJECTS @@ -127,22 +128,21 @@ REQUIRED FLAGS The JSON file is formatted as follows, with camelCase field naming: { - "oracleSchemas": [ - { - "schema": "SAMPLE", - "oracleTables": [ - { - "table": "SAMPLE_TABLE", - "oracleColumns": [ - { - "column": "COL", - } - ] - } - ] - } - ] - } + "oracleSchemas": [ + { + "schema": "SAMPLE", + "oracleTables": [ + { + "table": "SAMPLE_TABLE", + "oracleColumns": [ + { + "column": "COL", + } + ] + } + ] + } + ] } --postgresql-excluded-objects=POSTGRESQL_EXCLUDED_OBJECTS @@ -152,22 +152,38 @@ REQUIRED FLAGS The JSON file is formatted as follows, with camelCase field naming: { - "postgresqlSchemas": [ - { - "schema": "SAMPLE", - "postgresqlTables": [ - { - "table": "SAMPLE_TABLE", - "postgresqlColumns": [ - { - "column": "COL", - } - ] - } - ] - } - ] - } + "postgresqlSchemas": [ + { + "schema": "SAMPLE", + "postgresqlTables": [ + { + "table": "SAMPLE_TABLE", + "postgresqlColumns": [ + { + "column": "COL", + } + ] + } + ] + } + ] + } + + --salesforce-excluded-objects=SALESFORCE_EXCLUDED_OBJECTS + Path to a YAML (or JSON) file containing the Salesforce data + sources to avoid backfilling. + + The JSON file is formatted as follows, with camelCase field naming: + + { + "objects": [ + { + "objectName": "SAMPLE", + }, + { + "objectName": "SAMPLE2", + } + ] } --sqlserver-excluded-objects=SQLSERVER_EXCLUDED_OBJECTS @@ -177,22 +193,21 @@ REQUIRED FLAGS The JSON file is formatted as follows, with camelCase field naming: { - "schemas": [ - { - "schema": "SAMPLE", - "tables": [ - { - "table": "SAMPLE_TABLE", - "columns": [ - { - "column": "COL", - } - ] - } - ] - } - ] - } + "schemas": [ + { + "schema": "SAMPLE", + "tables": [ + { + "table": "SAMPLE_TABLE", + "columns": [ + { + "column": "COL", + } + ] + } + ] + } + ] } This must be specified. @@ -392,6 +407,29 @@ REQUIRED FLAGS "publication": "SAMPLE_PUBLICATION" } + --salesforce-source-config=SALESFORCE_SOURCE_CONFIG + Path to a YAML (or JSON) file containing the configuration for + Salesforce Source Config. + + The JSON file is formatted as follows, with camelCase field naming: + + { + "pollingInterval": "3000s", + "includeObjects": {}, + "excludeObjects": { + "objects": [ + { + "objectName": "SAMPLE", + "fields": [ + { + "fieldName": "SAMPLE_FIELD", + } + ] + } + ] + } + } + --sqlserver-source-config=SQLSERVER_SOURCE_CONFIG Path to a YAML (or JSON) file containing the configuration for SQL Server Source Config. diff --git a/gcloud/beta/datastream/streams/update b/gcloud/beta/datastream/streams/update index b80ce5fa1..85e3d9d61 100644 --- a/gcloud/beta/datastream/streams/update +++ b/gcloud/beta/datastream/streams/update @@ -9,6 +9,7 @@ SYNOPSIS | --backfill-all --mysql-excluded-objects=MYSQL_EXCLUDED_OBJECTS | --oracle-excluded-objects=ORACLE_EXCLUDED_OBJECTS | --postgresql-excluded-objects=POSTGRESQL_EXCLUDED_OBJECTS + | --salesforce-excluded-objects=SALESFORCE_EXCLUDED_OBJECTS | --sqlserver-excluded-objects=SQLSERVER_EXCLUDED_OBJECTS] [--clear-labels | --remove-labels=[KEY,...]] [--destination-name=DESTINATION_NAME @@ -18,6 +19,7 @@ SYNOPSIS [--source-name=SOURCE_NAME --mysql-source-config=MYSQL_SOURCE_CONFIG | --oracle-source-config=ORACLE_SOURCE_CONFIG | --postgresql-source-config=POSTGRESQL_SOURCE_CONFIG + | --salesforce-source-config=SALESFORCE_SOURCE_CONFIG | --sqlserver-source-config=SQLSERVER_SOURCE_CONFIG] [GCLOUD_WIDE_FLAG ...] @@ -123,22 +125,21 @@ FLAGS The JSON file is formatted as follows, with camelCase field naming: { - "mysqlDatabases": [ + "mysqlDatabases": [ + { + "database":"sample_database", + "mysqlTables": [ { - "database":"sample_database", - "mysqlTables": [ + "table": "sample_table", + "mysqlColumns": [ { - "table": "sample_table", - "mysqlColumns": [ - { - "column": "sample_column", - } - ] + "column": "sample_column", } - ] + ] } ] } + ] } --oracle-excluded-objects=ORACLE_EXCLUDED_OBJECTS @@ -148,22 +149,21 @@ FLAGS The JSON file is formatted as follows, with camelCase field naming: { - "oracleSchemas": [ - { - "schema": "SAMPLE", - "oracleTables": [ - { - "table": "SAMPLE_TABLE", - "oracleColumns": [ - { - "column": "COL", - } - ] - } - ] - } - ] - } + "oracleSchemas": [ + { + "schema": "SAMPLE", + "oracleTables": [ + { + "table": "SAMPLE_TABLE", + "oracleColumns": [ + { + "column": "COL", + } + ] + } + ] + } + ] } --postgresql-excluded-objects=POSTGRESQL_EXCLUDED_OBJECTS @@ -173,22 +173,38 @@ FLAGS The JSON file is formatted as follows, with camelCase field naming: { - "postgresqlSchemas": [ - { - "schema": "SAMPLE", - "postgresqlTables": [ - { - "table": "SAMPLE_TABLE", - "postgresqlColumns": [ - { - "column": "COL", - } - ] - } - ] - } - ] - } + "postgresqlSchemas": [ + { + "schema": "SAMPLE", + "postgresqlTables": [ + { + "table": "SAMPLE_TABLE", + "postgresqlColumns": [ + { + "column": "COL", + } + ] + } + ] + } + ] + } + + --salesforce-excluded-objects=SALESFORCE_EXCLUDED_OBJECTS + Path to a YAML (or JSON) file containing the Salesforce data + sources to avoid backfilling. + + The JSON file is formatted as follows, with camelCase field naming: + + { + "objects": [ + { + "objectName": "SAMPLE", + }, + { + "objectName": "SAMPLE2", + } + ] } --sqlserver-excluded-objects=SQLSERVER_EXCLUDED_OBJECTS @@ -198,22 +214,21 @@ FLAGS The JSON file is formatted as follows, with camelCase field naming: { - "schemas": [ - { - "schema": "SAMPLE", - "tables": [ - { - "table": "SAMPLE_TABLE", - "columns": [ - { - "column": "COL", - } - ] - } - ] - } - ] - } + "schemas": [ + { + "schema": "SAMPLE", + "tables": [ + { + "table": "SAMPLE_TABLE", + "columns": [ + { + "column": "COL", + } + ] + } + ] + } + ] } At most one of these can be specified: @@ -432,9 +447,32 @@ FLAGS "publication": "SAMPLE_PUBLICATION" } - --sqlserver-source-config=SQLSERVER_SOURCE_CONFIG + --salesforce-source-config=SALESFORCE_SOURCE_CONFIG Path to a YAML (or JSON) file containing the configuration for - PostgreSQL Source Config. + Salesforce Source Config. + + The JSON file is formatted as follows, with camelCase field naming: + + { + "pollingInterval": "3000s", + "includeObjects": {}, + "excludeObjects": { + "objects": [ + { + "objectName": "SAMPLE", + "fields": [ + { + "fieldName": "SAMPLE_FIELD", + } + ] + } + ] + } + } + + --sqlserver-source-config=SQLSERVER_SOURCE_CONFIG + Path to a YAML (or JSON) file containing the configuration for SQL + Server Source Config. The JSON file is formatted as follows, with camelCase field naming: diff --git a/gcloud/beta/filestore/instances/create b/gcloud/beta/filestore/instances/create index 2ecc2120b..c643a955f 100644 --- a/gcloud/beta/filestore/instances/create +++ b/gcloud/beta/filestore/instances/create @@ -6,8 +6,9 @@ SYNOPSIS --file-share=[capacity=CAPACITY],[name=NAME], [nfs-export-options=NFS-EXPORT-OPTIONS],[source-backup=SOURCE-BACKUP], [source-backup-region=SOURCE-BACKUP-REGION] - --network=[connect-mode=CONNECT-MODE], - [name=NAME],[reserved-ip-range=RESERVED-IP-RANGE] [--async] + --network=[connect-mode=CONNECT-MODE],[name=NAME], + [psc-endpoint-project=PSC-ENDPOINT-PROJECT], + [reserved-ip-range=RESERVED-IP-RANGE] [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--location=LOCATION] [--managed-ad=[computer=COMPUTER],[domain=DOMAIN]] @@ -32,8 +33,9 @@ EXAMPLES --description=DESCRIPTION --tier=TIER --protocol=PROTOCOL \ --file-share=name=VOLUME_NAME,capacity=CAPACITY \ --network=name=NETWORK_NAME,\ - reserved-ip-range=RESERVED_IP_RANGE,connect-mode=CONNECT_MODE \ - --zone=ZONE --kms-key=KMS-KEY --kms-keyring=KMS_KEYRING \ + reserved-ip-range=RESERVED_IP_RANGE,connect-mode=CONNECT_MODE,\ + psc-endpoint-project=PSC_ENDPOINT_PROJECT --zone=ZONE \ + --kms-key=KMS-KEY --kms-keyring=KMS_KEYRING \ --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT \ --managed-ad=domain=DOMAIN,computer=COMPUTER \ --flags-file=FLAGS_FILE --source-instance=SOURCE_INSTANCE @@ -186,7 +188,7 @@ REQUIRED FLAGS source-backup-region The region of the source backup. - --network=[connect-mode=CONNECT-MODE],[name=NAME],[reserved-ip-range=RESERVED-IP-RANGE] + --network=[connect-mode=CONNECT-MODE],[name=NAME],[psc-endpoint-project=PSC-ENDPOINT-PROJECT],[reserved-ip-range=RESERVED-IP-RANGE] Network configuration for a Cloud Filestore instance. Specifying reserved-ip-range and connect-mode is optional. name @@ -211,7 +213,13 @@ REQUIRED FLAGS network. connect-mode Network connection mode used by instances. CONNECT_MODE must be one - of: DIRECT_PEERING or PRIVATE_SERVICE_ACCESS. + of: DIRECT_PEERING, PRIVATE_SERVICE_ACCESS or + PRIVATE_SERVICE_CONNECT. + psc-endpoint-project + Consumer service project in which the psc endpoint would be set up. + This is optional, and only relevant in case the network is a shared + VPC. If this is not specified, the psc endpoint would be setup in + the VPC host project. OPTIONAL FLAGS --async diff --git a/gcloud/beta/kms/keys/versions/get-public-key b/gcloud/beta/kms/keys/versions/get-public-key index cd0dd7cd0..8826c2506 100644 --- a/gcloud/beta/kms/keys/versions/get-public-key +++ b/gcloud/beta/kms/keys/versions/get-public-key @@ -16,8 +16,8 @@ DESCRIPTION The optional flag public-key-format indicates the format in which the public key will be returned. For the PQC algorithms, this must be specified - and set to NIST_PQC. For all other algorithms, this flag is optional and - defaults to PEM. See "Retrieve a public key" in the Cloud KMS documentation + and set to nist-pqc. For all other algorithms, this flag is optional and + defaults to pem. See "Retrieve a public key" in the Cloud KMS documentation (https://cloud.google.com/kms/docs/retrieve-public-key) for more information about the supported formats. @@ -27,7 +27,7 @@ EXAMPLES $ gcloud beta kms keys versions get-public-key 2 --key=frodo \ --keyring=fellowship --location=us-east1 \ - --public-key-format=PEM --output-file=/tmp/my/public_key.file + --public-key-format=pem --output-file=/tmp/my/public_key.file POSITIONAL ARGUMENTS VERSION diff --git a/gcloud/beta/memorystore/instances/create b/gcloud/beta/memorystore/instances/create index 55e156d98..3366cd769 100644 --- a/gcloud/beta/memorystore/instances/create +++ b/gcloud/beta/memorystore/instances/create @@ -3,14 +3,15 @@ NAME SYNOPSIS gcloud beta memorystore instances create (INSTANCE : --location=LOCATION) - [--async] [--authorization-mode=AUTHORIZATION_MODE] + [--async] [--async-instance-endpoints-deletion-enabled] + [--authorization-mode=AUTHORIZATION_MODE] [--deletion-protection-enabled] [--endpoints=[connections=CONNECTIONS]] [--engine-configs=[ENGINE_CONFIGS,...]] [--engine-version=ENGINE_VERSION] [--labels=[LABELS,...]] [--mode=MODE] - [--node-type=NODE_TYPE] - [--psc-auto-connections=[network=NETWORK],[projectId=PROJECTID]] - [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] - [--shard-count=SHARD_COUNT] + [--node-type=NODE_TYPE] [--ondemand-maintenance] + [--psc-auto-connections=[network=NETWORK], + [port=PORT],[projectId=PROJECTID]] [--replica-count=REPLICA_COUNT] + [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] [--transit-encryption-mode=TRANSIT_ENCRYPTION_MODE] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC --persistence-config-mode=PERSISTENCE_CONFIG_MODE @@ -83,6 +84,14 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + Arguments for the async instance endpoints deletion enabled. + + --async-instance-endpoints-deletion-enabled + If true, instance endpoints that are created and registered by + customers can be deleted asynchronously. That is, such an instance + endpoint can be de-registered before the forwarding rules in the + instance endpoint are deleted. + --authorization-mode=AUTHORIZATION_MODE Authorization mode of the instance. AUTHORIZATION_MODE must be one of: @@ -111,6 +120,10 @@ FLAGS The network where the PSC endpoints are created, in the form of projects/{project_id}/global/networks/{network_id}. + port + port will only be set for Primary/Reader or Discovery + endpoint. + projectId The consumer project_id where PSC connections are established. This should be the same project_id that the @@ -118,11 +131,11 @@ FLAGS Shorthand Example: - --endpoints=connections=[{pscAutoConnection={network=string,projectId=string}}] --endpoints=connections=[{pscAutoConnection={network=string,projectId=string}}] + --endpoints=connections=[{pscAutoConnection={network=string,port=int,projectId=string}}] --endpoints=connections=[{pscAutoConnection={network=string,port=int,projectId=string}}] JSON Example: - --endpoints='[{"connections": [{"pscAutoConnection": {"network": "string", "projectId": "string"}}]}]' + --endpoints='[{"connections": [{"pscAutoConnection": {"network": "string", "port": int, "projectId": "string"}}]}]' File Example: @@ -198,13 +211,21 @@ FLAGS standard-small Standard small. - --psc-auto-connections=[network=NETWORK],[projectId=PROJECTID] + Arguments for the ondemand maintenance. + + --ondemand-maintenance + Ondemand maintenance for the instance. + + --psc-auto-connections=[network=NETWORK],[port=PORT],[projectId=PROJECTID] User inputs and resource details of the auto-created PSC connections. network The network where the PSC endpoints are created, in the form of projects/{project_id}/global/networks/{network_id}. + port + port will only be set for Primary/Reader or Discovery endpoint. + projectId The consumer project_id where PSC connections are established. This should be the same project_id that the instance is being created @@ -212,11 +233,11 @@ FLAGS Shorthand Example: - --psc-auto-connections=network=string,projectId=string --psc-auto-connections=network=string,projectId=string + --psc-auto-connections=network=string,port=int,projectId=string --psc-auto-connections=network=string,port=int,projectId=string JSON Example: - --psc-auto-connections='[{"network": "string", "projectId": "string"}]' + --psc-auto-connections='[{"network": "string", "port": int, "projectId": "string"}]' File Example: diff --git a/gcloud/beta/memorystore/instances/update b/gcloud/beta/memorystore/instances/update index 1ea715050..356703c36 100644 --- a/gcloud/beta/memorystore/instances/update +++ b/gcloud/beta/memorystore/instances/update @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud beta memorystore instances update (INSTANCE : --location=LOCATION) - [--async] [--[no-]deletion-protection-enabled] [--mode=MODE] + [--async] [--[no-]async-instance-endpoints-deletion-enabled] + [--[no-]deletion-protection-enabled] [--engine-version=ENGINE_VERSION] + [--mode=MODE] [--node-type=NODE_TYPE] [--[no-]ondemand-maintenance] [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC @@ -77,6 +79,16 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + Arguments for the async instance endpoints deletion enabled. + + --[no-]async-instance-endpoints-deletion-enabled + If true, instance endpoints that are created and registered by + customers can be deleted asynchronously. That is, such an instance + endpoint can be de-registered before the forwarding rules in the + instance endpoint are deleted. Use + --async-instance-endpoints-deletion-enabled to enable and + --no-async-instance-endpoints-deletion-enabled to disable. + Arguments for the deletion protection enabled. --[no-]deletion-protection-enabled @@ -84,6 +96,9 @@ FLAGS --deletion-protection-enabled to enable and --no-deletion-protection-enabled to disable. + --engine-version=ENGINE_VERSION + Engine version of the instance. + --mode=MODE The mode config for the instance. MODE must be one of: @@ -94,6 +109,25 @@ FLAGS standalone Deprecated: Use CLUSTER_DISABLED instead. + --node-type=NODE_TYPE + Machine type for individual nodes of the instance. NODE_TYPE must be + one of: + + highmem-medium + High memory medium. + highmem-xlarge + High memory extra large. + shared-core-nano + Shared core nano. + standard-small + Standard small. + + Arguments for the ondemand maintenance. + + --[no-]ondemand-maintenance + Ondemand maintenance for the instance. Use --ondemand-maintenance to + enable and --no-ondemand-maintenance to disable. + Arguments for the replica count. --replica-count=REPLICA_COUNT diff --git a/gcloud/beta/metastore/services/create b/gcloud/beta/metastore/services/create index d64bd959c..48ce47263 100644 --- a/gcloud/beta/metastore/services/create +++ b/gcloud/beta/metastore/services/create @@ -5,7 +5,7 @@ SYNOPSIS gcloud beta metastore services create (SERVICE : --location=LOCATION) [--async] [--autoscaling-enabled] [--data-catalog-sync] [--database-type=DATABASE_TYPE; default="mysql"] - [--deletion-protection] [--encryption-kms-key=ENCRYPTION_KMS_KEY] + [--deletion-protection] [--endpoint-protocol=ENDPOINT_PROTOCOL; default="thrift"] [--hive-metastore-version=HIVE_METASTORE_VERSION] [--labels=[KEY=VALUE,...]] [--port=PORT; default=9083] @@ -14,6 +14,8 @@ SYNOPSIS | --auxiliary-versions-from-file=AUXILIARY_VERSIONS_FROM_FILE] [--consumer-subnetworks=[CONSUMER_SUBNETWORKS,...] | --network=NETWORK | --network-config-from-file=NETWORK_CONFIG_FROM_FILE] + [--encryption-kms-key=ENCRYPTION_KMS_KEY + | --encryption-kms-keys=[ENCRYPTION_KMS_KEYS,...]] [--hive-metastore-configs=[KEY=VALUE,...] | --hive-metastore-configs-from-file=PATH_TO_FILE] [--instance-size=INSTANCE_SIZE | --scaling-factor=SCALING_FACTOR @@ -124,13 +126,6 @@ FLAGS prevent accidental deletions of the instance. Use --deletion-protection to enable. - --encryption-kms-key=ENCRYPTION_KMS_KEY - The name of the Cloud KMS key to use for customer data encryption. - Cannot be changed once the service is created. Mutually exclusive with - flag --data-catalog-sync. This can be provided as a fully-qualified - URL, or a relative name in the form - projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{crypto_key_id}. - --endpoint-protocol=ENDPOINT_PROTOCOL; default="thrift" The protocol to use for the metastore service endpoint. If unspecified, defaults to THRIFT. ENDPOINT_PROTOCOL must be one of: @@ -242,6 +237,25 @@ FLAGS projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork_id} ... + Encryption configuration for the metastore service. + + At most one of these can be specified: + + --encryption-kms-key=ENCRYPTION_KMS_KEY + The name of the Cloud KMS key to use for customer data encryption. + Cannot be changed once the service is created. Mutually exclusive + with flag --data-catalog-sync. This can be provided as a + fully-qualified URL, or a relative name in the form + projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{crypto_key_id}. + + --encryption-kms-keys=[ENCRYPTION_KMS_KEYS,...] + Comma-separated list of the Cloud KMS keys to use for customer data + encryption. Cannot be changed once the service is created. Mutually + exclusive with flag --data-catalog-sync and --encryption-kms-key. + Each key can be provided as a fully-qualified URL, or a relative name + in the form + projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{crypto_key_id}. + Configuration properties specific to running Hive metastore software as the metastore service. diff --git a/gcloud/beta/redis/clusters/update b/gcloud/beta/redis/clusters/update index 824543c3a..47b09db17 100644 --- a/gcloud/beta/redis/clusters/update +++ b/gcloud/beta/redis/clusters/update @@ -8,6 +8,7 @@ SYNOPSIS [--automated-backup-mode=AUTOMATED_BACKUP_MODE] [--automated-backup-start-time=AUTOMATED_BACKUP_START_TIME] [--automated-backup-ttl=AUTOMATED_BACKUP_TTL] [--deletion-protection] + [--node-type=NODE_TYPE] [--ondemand-maintenance] [--persistence-mode=PERSISTENCE_MODE] [--rdb-snapshot-period=RDB_SNAPSHOT_PERIOD] [--rdb-snapshot-start-time=RDB_SNAPSHOT_START_TIME] @@ -106,6 +107,14 @@ FLAGS Enable deletion protection for the Redis Cluster. Use --deletion-protection/--no-deletion-protection to enable/disable it. + --node-type=NODE_TYPE + Node Type of the redis cluster Node. NODE_TYPE must be one of: + redis-highmem-medium, redis-highmem-xlarge, redis-shared-core-nano, + redis-standard-small. + + --ondemand-maintenance + Trigger an on-demand maintenance. + --persistence-mode=PERSISTENCE_MODE Operation mode for persistence. PERSISTENCE_MODE must be one of: diff --git a/gcloud/colab/runtime-templates/create b/gcloud/colab/runtime-templates/create index b01bfc12a..68c973414 100644 --- a/gcloud/colab/runtime-templates/create +++ b/gcloud/colab/runtime-templates/create @@ -14,7 +14,11 @@ SYNOPSIS : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] --no-enable-internet-access --network=NETWORK [--subnetwork=SUBNETWORK - : --subnetwork-region=SUBNETWORK_REGION]] [GCLOUD_WIDE_FLAG ...] + : --subnetwork-region=SUBNETWORK_REGION] + --post-startup-script=POST_STARTUP_SCRIPT + --post-startup-script-behavior=POST_STARTUP_SCRIPT_BEHAVIOR + --post-startup-script-url=POST_STARTUP_SCRIPT_URL + --set-env-vars=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a Colab Enterprise runtime template, a VM configuration for your @@ -212,6 +216,25 @@ OPTIONAL FLAGS fully specified name; â—‡ provide the argument --subnetwork-region on the command line. + The software configuration of the runtime template. + + --post-startup-script=POST_STARTUP_SCRIPT + Post startup script in raw string to execute on the runtime. + + --post-startup-script-behavior=POST_STARTUP_SCRIPT_BEHAVIOR + The behavior of the post startup script. The default if passing a + post-startup-script-url is RUN_ONCE. POST_STARTUP_SCRIPT_BEHAVIOR + must be one of: POST_STARTUP_SCRIPT_BEHAVIOR_UNSPECIFIED, RUN_ONCE, + RUN_EVERY_START, DOWNLOAD_AND_RUN_EVERY_START. + + --post-startup-script-url=POST_STARTUP_SCRIPT_URL + Post startup script URL to execute on the runtime. This can be a + public or private Google Cloud Storage object. In the form of + gs://bucket/object or https://storage.googleapis.com/bucket/object. + + --set-env-vars=[KEY=VALUE,...] + Set environment variables used by the runtime. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/compute/instance-templates/create b/gcloud/compute/instance-templates/create index 4202258f1..15e1bce38 100644 --- a/gcloud/compute/instance-templates/create +++ b/gcloud/compute/instance-templates/create @@ -18,6 +18,7 @@ SYNOPSIS [--[no-]enable-nested-virtualization] [--[no-]enable-uefi-networking] [--external-ipv6-address=EXTERNAL_IPV6_ADDRESS] [--external-ipv6-prefix-length=EXTERNAL_IPV6_PREFIX_LENGTH] + [--host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS] [--instance-template-region=INSTANCE_TEMPLATE_REGION] [--instance-termination-action=INSTANCE_TERMINATION_ACTION] [--internal-ipv6-address=INTERNAL_IPV6_ADDRESS] @@ -408,6 +409,11 @@ FLAGS be used together with --external-ipv6-address. Only the /96 IP address range is supported, and the default value is 96. + --host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS + The timeout in seconds for host error detection. The value must be set + with 30 second increments, with a range of 90 to 330 seconds. If unset, + the default behavior of the host error recovery is used. + --instance-template-region=INSTANCE_TEMPLATE_REGION Specifies the region of the regional instance template. diff --git a/gcloud/compute/instances/bulk/create b/gcloud/compute/instances/bulk/create index ba8d9e057..d5d82ab73 100644 --- a/gcloud/compute/instances/bulk/create +++ b/gcloud/compute/instances/bulk/create @@ -20,6 +20,7 @@ SYNOPSIS [device-name=DEVICE-NAME],[name=NAME],[scope=SCOPE]] [--[no-]enable-nested-virtualization] [--[no-]enable-uefi-networking] [--erase-windows-vss-signature] + [--host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS] [--instance-termination-action=INSTANCE_TERMINATION_ACTION] [--labels=[KEY=VALUE,...]] [--local-ssd=[device-name=DEVICE-NAME], @@ -441,6 +442,11 @@ OPTIONAL FLAGS machine image should erase Windows specific VSS signature. See https://cloud.google.com/sdk/gcloud/reference/compute/disks/snapshot#--guest-flush + --host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS + The timeout in seconds for host error detection. The value must be set + with 30 second increments, with a range of 90 to 330 seconds. If unset, + the default behavior of the host error recovery is used. + --instance-termination-action=INSTANCE_TERMINATION_ACTION Specifies the termination action that will be taken upon VM preemption (--provisioning-model=SPOT) or automatic instance termination diff --git a/gcloud/compute/instances/create b/gcloud/compute/instances/create index dac6f3beb..077061d33 100644 --- a/gcloud/compute/instances/create +++ b/gcloud/compute/instances/create @@ -23,6 +23,7 @@ SYNOPSIS [--[no-]enable-uefi-networking] [--erase-windows-vss-signature] [--external-ipv6-address=EXTERNAL_IPV6_ADDRESS] [--external-ipv6-prefix-length=EXTERNAL_IPV6_PREFIX_LENGTH] + [--host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS] [--hostname=HOSTNAME] [--instance-termination-action=INSTANCE_TERMINATION_ACTION] [--internal-ipv6-address=INTERNAL_IPV6_ADDRESS] @@ -490,6 +491,11 @@ FLAGS be used together with --external-ipv6-address. Only the /96 IP address range is supported, and the default value is 96. + --host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS + The timeout in seconds for host error detection. The value must be set + with 30 second increments, with a range of 90 to 330 seconds. If unset, + the default behavior of the host error recovery is used. + --hostname=HOSTNAME Specify the hostname of the instance to be created. The specified hostname must be RFC1035 compliant. If hostname is not specified, the diff --git a/gcloud/compute/instances/create-with-container b/gcloud/compute/instances/create-with-container index 9cab660f1..39e8e6cc4 100644 --- a/gcloud/compute/instances/create-with-container +++ b/gcloud/compute/instances/create-with-container @@ -32,6 +32,7 @@ SYNOPSIS [--[no-]enable-nested-virtualization] [--external-ipv6-address=EXTERNAL_IPV6_ADDRESS] [--external-ipv6-prefix-length=EXTERNAL_IPV6_PREFIX_LENGTH] + [--host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS] [--instance-termination-action=INSTANCE_TERMINATION_ACTION] [--internal-ipv6-address=INTERNAL_IPV6_ADDRESS] [--internal-ipv6-prefix-length=INTERNAL_IPV6_PREFIX_LENGTH] @@ -471,6 +472,11 @@ FLAGS be used together with --external-ipv6-address. Only the /96 IP address range is supported, and the default value is 96. + --host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS + The timeout in seconds for host error detection. The value must be set + with 30 second increments, with a range of 90 to 330 seconds. If unset, + the default behavior of the host error recovery is used. + --instance-termination-action=INSTANCE_TERMINATION_ACTION Specifies the termination action that will be taken upon VM preemption (--provisioning-model=SPOT) or automatic instance termination diff --git a/gcloud/compute/instances/help b/gcloud/compute/instances/help index 4f8fbcab9..9d81287fb 100644 --- a/gcloud/compute/instances/help +++ b/gcloud/compute/instances/help @@ -28,7 +28,7 @@ GROUPS executions. network-interfaces - Read and manipulate Compute Engine VM instance network interfaces. + Read and manipulate Compute Engine instance network interfaces. ops-agents Manage Google Cloud Observability agents for Compute Engine VM diff --git a/gcloud/compute/instances/network-interfaces/help b/gcloud/compute/instances/network-interfaces/help index db686ca4a..b46a5c9c1 100644 --- a/gcloud/compute/instances/network-interfaces/help +++ b/gcloud/compute/instances/network-interfaces/help @@ -1,18 +1,18 @@ NAME gcloud compute instances network-interfaces - read and manipulate Compute - Engine VM instance network interfaces + Engine instance network interfaces SYNOPSIS gcloud compute instances network-interfaces COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Read and manipulate Compute Engine VM instance network interfaces. + Read and manipulate Compute Engine instance network interfaces. - For more information about VM instance network interfaces, see the network + For more information about instance network interfaces, see the network interfaces documentation (https://cloud.google.com/vpc/docs/multiple-interfaces-concepts). - See also: VM instance network interfaces API + See also: instance network interfaces API (https://cloud.google.com/compute/docs/reference/rest/v1/instances/updateNetworkInterface). GCLOUD WIDE FLAGS diff --git a/gcloud/compute/instances/set-scheduling b/gcloud/compute/instances/set-scheduling index 81edf010b..be73e36d3 100644 --- a/gcloud/compute/instances/set-scheduling +++ b/gcloud/compute/instances/set-scheduling @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud compute instances set-scheduling INSTANCE_NAME [--clear-min-node-cpu] + [--host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS] [--local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT] [--maintenance-policy=MAINTENANCE_POLICY] [--min-node-cpu=MIN_NODE_CPU] [--[no-]preemptible] [--provisioning-model=PROVISIONING_MODEL] @@ -42,6 +43,11 @@ FLAGS instance min-node-cpu will be cleared. The instance will not be overcommitted and utilize the full CPU count assigned. + --host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS + The timeout in seconds for host error detection. The value must be set + with 30 second increments, with a range of 90 to 330 seconds. If unset, + the default behavior of the host error recovery is used. + --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT Specifies the maximum amount of time a Local Ssd Vm should wait while recovery of the Local Ssd state is attempted. Its value should be in diff --git a/gcloud/compute/routers/add-bgp-peer b/gcloud/compute/routers/add-bgp-peer index e8b8341f4..3307e1015 100644 --- a/gcloud/compute/routers/add-bgp-peer +++ b/gcloud/compute/routers/add-bgp-peer @@ -8,7 +8,9 @@ SYNOPSIS [--advertised-route-priority=ADVERTISED_ROUTE_PRIORITY] [--advertisement-mode=MODE] [--async] [--custom-learned-route-priority=PRIORITY] [--[no-]enable-ipv4] - [--[no-]enable-ipv6] [--[no-]enabled] [--instance=INSTANCE] + [--[no-]enable-ipv6] [--[no-]enabled] + [--export-policies=[EXPORT_POLICY,...]] + [--import-policies=[IMPORT_POLICY,...]] [--instance=INSTANCE] [--instance-zone=INSTANCE_ZONE] [--ipv4-nexthop-address=IPV4_NEXTHOP_ADDRESS] [--ipv6-nexthop-address=IPV6_NEXTHOP_ADDRESS] @@ -87,6 +89,14 @@ OPTIONAL FLAGS terminated and all associated routing information is removed. Enabled by default. Use --enabled to enable and --no-enabled to disable. + --export-policies=[EXPORT_POLICY,...] + Comma-separated list of export policies. Passing an empty string + removes all export policies. + + --import-policies=[IMPORT_POLICY,...] + Comma-separated list of import policies. Passing an empty string + removes all import policies. + --instance=INSTANCE Router appliance instance of the BGP peer being added. diff --git a/gcloud/compute/routers/add-route-policy b/gcloud/compute/routers/add-route-policy new file mode 100644 index 000000000..c108cd845 --- /dev/null +++ b/gcloud/compute/routers/add-route-policy @@ -0,0 +1,72 @@ +NAME + gcloud compute routers add-route-policy - add an empty route policy to a + Compute Engine router + +SYNOPSIS + gcloud compute routers add-route-policy NAME --policy-name=POLICY_NAME + --policy-type=POLICY_TYPE [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute routers add-route-policy adds an empty route policy to a + Compute Engine router. + +EXAMPLES + To add an import route policy my-policy to a router my-router in region + us-central1, run: + + $ gcloud compute routers add-route-policy my-router \ + --region=us-central1 --policy-name=my-policy \ + --policy-type=IMPORT + +POSITIONAL ARGUMENTS + NAME + Name of the router to update. + +REQUIRED FLAGS + --policy-name=POLICY_NAME + Name of the route policy to add. + + --policy-type=POLICY_TYPE + Type of the route policy to add. POLICY_TYPE must be one of: + + EXPORT + The route policy is an export policy. + IMPORT + The route policy is an import policy. + +OPTIONAL FLAGS + --region=REGION + Region of the router to update. If not specified, you might be prompted + to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --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 compute routers add-route-policy + + $ gcloud beta compute routers add-route-policy + diff --git a/gcloud/compute/routers/add-route-policy-term b/gcloud/compute/routers/add-route-policy-term new file mode 100644 index 000000000..957dcfcdd --- /dev/null +++ b/gcloud/compute/routers/add-route-policy-term @@ -0,0 +1,75 @@ +NAME + gcloud compute routers add-route-policy-term - adds a new term to an + existing route policy of a Comute Engine router + +SYNOPSIS + gcloud compute routers add-route-policy-term NAME --actions=[ACTION;...] + --match=MATCH --policy-name=POLICY_NAME --priority=PRIORITY + [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute routers add-route-policy-term adds a term to a route policy. + +EXAMPLES + To add a term with priority 0 with match destination == '192.168.0.0/16' + and actions drop() to a route policy my-policy of a router my-router in + region us-central1, run: + + $ gcloud compute routers add-route-policy-term my-router \ + --region=us-central1 --policy-name=my-policy --priority=0 \ + --match="destination == '192.168.0.0/16'" --actions="drop()" + +POSITIONAL ARGUMENTS + NAME + Name of the router to update. + +REQUIRED FLAGS + --actions=[ACTION;...] + Semicolon separated CEL expressions for the actions to take when the + rule matches. + + --match=MATCH + CEL expression for matching a route. + + --policy-name=POLICY_NAME + Name of the route policy to which to add the term. + + --priority=PRIORITY + Order of the term within the policy. + +OPTIONAL FLAGS + --region=REGION + Region of the router to update. If not specified, you might be prompted + to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --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 compute routers add-route-policy-term + + $ gcloud beta compute routers add-route-policy-term + diff --git a/gcloud/compute/routers/download-route-policy b/gcloud/compute/routers/download-route-policy new file mode 100644 index 000000000..b7d7dfe05 --- /dev/null +++ b/gcloud/compute/routers/download-route-policy @@ -0,0 +1,72 @@ +NAME + gcloud compute routers download-route-policy - download a route policy from + a Compute Engine router + +SYNOPSIS + gcloud compute routers download-route-policy NAME --file-name=FILE_NAME + --policy-name=POLICY_NAME [--file-format=FILE_FORMAT] [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute routers download-route-policy downloads a route policy from + a Compute Engine router. + +EXAMPLES + To download a route policy my-export-policy to a file my-export-policy.yaml + from a router my-router in region us-central1, run: + + $ gcloud compute routers download-route-policy my-router \ + --region=us-central1 --policy-name=my-export-policy \ + --file-name=my-export-policy.yaml" + +POSITIONAL ARGUMENTS + NAME + Name of the router to export. + +REQUIRED FLAGS + --file-name=FILE_NAME + The name of the file to download the route policy config to. + + --policy-name=POLICY_NAME + Name of the route policy to download. + +OPTIONAL FLAGS + --file-format=FILE_FORMAT + Format of the file passed to --file-name. FILE_FORMAT must be one of: + json, yaml. + + --region=REGION + Region of the router to export. If not specified, you might be prompted + to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --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 compute routers download-route-policy + + $ gcloud beta compute routers download-route-policy + diff --git a/gcloud/compute/routers/get-route-policy b/gcloud/compute/routers/get-route-policy new file mode 100644 index 000000000..bebed0148 --- /dev/null +++ b/gcloud/compute/routers/get-route-policy @@ -0,0 +1,63 @@ +NAME + gcloud compute routers get-route-policy - get a route policy from a Compute + Engine router + +SYNOPSIS + gcloud compute routers get-route-policy NAME --policy-name=POLICY_NAME + [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute routers get-route-policy gets a route policy from a Compute + Engine router. + +EXAMPLES + To get a route policy my-policy from a router my-router in region + us-central1, run: + + $ gcloud compute routers get-route-policy my-router \ + --region=us-central1 --policy-name=my-policy + +POSITIONAL ARGUMENTS + NAME + Name of the router to get. + +REQUIRED FLAGS + --policy-name=POLICY_NAME + Name of the route policy to get. + +OPTIONAL FLAGS + --region=REGION + Region of the router to get. If not specified, you might be prompted to + select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --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 compute routers get-route-policy + + $ gcloud beta compute routers get-route-policy + diff --git a/gcloud/compute/routers/help b/gcloud/compute/routers/help index 85d7d3e2f..23738eb03 100644 --- a/gcloud/compute/routers/help +++ b/gcloud/compute/routers/help @@ -34,6 +34,12 @@ COMMANDS add-interface Add an interface to a Compute Engine router. + add-route-policy + Add an empty route policy to a Compute Engine router. + + add-route-policy-term + Adds a new term to an existing route policy of a Comute Engine router. + create Create a Compute Engine router. @@ -43,24 +49,43 @@ COMMANDS describe Describe a Compute Engine router. + download-route-policy + Download a route policy from a Compute Engine router. + get-nat-ip-info Display NAT IP information in a router. get-nat-mapping-info Display NAT Mapping information in a router. + get-route-policy + Get a route policy from a Compute Engine router. + get-status Get status of a Compute Engine router. list List Google Compute Engine routers. + list-bgp-routes + List routes advertised and learned on individual BGP sessions, both + pre- and post-policy evaluation. + + list-route-policies + List route policies from a Compute Engine router. + remove-bgp-peer Remove a BGP peer from a Compute Engine router. remove-interface Remove an interface from a Compute Engine router. + remove-route-policy + Remove a route policy from a Compute Engine router. + + remove-route-policy-term + Remove a route policy term of a Compute Engine router. + update Update a Compute Engine router. @@ -70,6 +95,12 @@ COMMANDS update-interface Update an interface on a Compute Engine router. + update-route-policy-term + Updates a term of an existing route policy of a Comute Engine router. + + upload-route-policy + Upload a route policy into a Compute Engine router. + NOTES These variants are also available: diff --git a/gcloud/compute/routers/list-bgp-routes b/gcloud/compute/routers/list-bgp-routes new file mode 100644 index 000000000..d1ae5d3ca --- /dev/null +++ b/gcloud/compute/routers/list-bgp-routes @@ -0,0 +1,125 @@ +NAME + gcloud compute routers list-bgp-routes - list routes advertised and learned + on individual BGP sessions, both pre- and post-policy evaluation + +SYNOPSIS + gcloud compute routers list-bgp-routes NAME --address-family=ADDRESS_FAMILY + --peer=PEER --route-direction=ROUTE_DIRECTION + [--destination-range=CIDR_RANGE] [--no-policy-applied] + [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute routers list-bgp-routes lists routes advertised and learned + on individual BGP sessions, both pre- and post-policy evaluation. + +EXAMPLES + To list inbound BGP routes limited to IPv4 addess family from a router + my-router BGP peer my-bgp-peer in region us-central1, run: + + $ gcloud compute routers list-bgp-routes my-router \ + --region=us-central1 --address-family=IPV4 --peer=my-bgp-peer \ + --route-direction=INBOUND" + +POSITIONAL ARGUMENTS + NAME + Name of the router to list. + +REQUIRED FLAGS + --address-family=ADDRESS_FAMILY + Limit results to routes learned for this Address Family Identifier. + ADDRESS_FAMILY must be one of: + + IPV4 + Interface with IPv4-based BGP. + IPV6 + Interface with IPv6-based BGP. + + --peer=PEER + Limit results to routes learned from this peer (name). + + --route-direction=ROUTE_DIRECTION + Limit results to routes in this direction. ROUTE_DIRECTION must be one + of: + + INBOUND + Learned routes. + OUTBOUND + Advertised routes. + +FLAGS + --destination-range=CIDR_RANGE + Limit results to prefixes. + + --policy-applied + Routes returned are post-policy evaluation. Enabled by default, use + --no-policy-applied to disable. + + --region=REGION + Region of the router to list. If not specified, you might be prompted + to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute routers list-bgp-routes + + $ gcloud beta compute routers list-bgp-routes + diff --git a/gcloud/compute/routers/list-route-policies b/gcloud/compute/routers/list-route-policies new file mode 100644 index 000000000..8467f826a --- /dev/null +++ b/gcloud/compute/routers/list-route-policies @@ -0,0 +1,91 @@ +NAME + gcloud compute routers list-route-policies - list route policies from a + Compute Engine router + +SYNOPSIS + gcloud compute routers list-route-policies NAME [--region=REGION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute routers list-route-policies lists all route policies from a + Compute Engine router. + +EXAMPLES + To list route policies from a router my-router in region us-central1, run: + + $ gcloud compute routers list-route-policies my-router \ + --region=us-central1 + +POSITIONAL ARGUMENTS + NAME + Name of the router to list. + +FLAGS + --region=REGION + Region of the router to list. If not specified, you might be prompted + to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute routers list-route-policies + + $ gcloud beta compute routers list-route-policies + diff --git a/gcloud/compute/routers/remove-route-policy b/gcloud/compute/routers/remove-route-policy new file mode 100644 index 000000000..e80257971 --- /dev/null +++ b/gcloud/compute/routers/remove-route-policy @@ -0,0 +1,63 @@ +NAME + gcloud compute routers remove-route-policy - remove a route policy from a + Compute Engine router + +SYNOPSIS + gcloud compute routers remove-route-policy NAME --policy-name=POLICY_NAME + [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute routers remove-route-policy removes a route policy from a + Compute Engine router. + +EXAMPLES + To remove a route policy my-policy from a router my-router in region + us-central1, run: + + $ gcloud compute routers remove-route-policy my-router \ + --region=us-central1 --policy-name=my-policy + +POSITIONAL ARGUMENTS + NAME + Name of the router to delete. + +REQUIRED FLAGS + --policy-name=POLICY_NAME + Name of the route policy to be removed. + +OPTIONAL FLAGS + --region=REGION + Region of the router to delete. If not specified, you might be prompted + to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --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 compute routers remove-route-policy + + $ gcloud beta compute routers remove-route-policy + diff --git a/gcloud/compute/routers/remove-route-policy-term b/gcloud/compute/routers/remove-route-policy-term new file mode 100644 index 000000000..2ee1bc87b --- /dev/null +++ b/gcloud/compute/routers/remove-route-policy-term @@ -0,0 +1,68 @@ +NAME + gcloud compute routers remove-route-policy-term - remove a route policy + term of a Compute Engine router + +SYNOPSIS + gcloud compute routers remove-route-policy-term NAME + --policy-name=POLICY_NAME --priority=PRIORITY [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute routers remove-route-policy-term removes a term of a route + policy. + +EXAMPLES + To remove a route policy term with priority 0 from a route policy my-policy + from a router my-router in region us-central1, run: + + $ gcloud compute routers remove-route-policy-term my-router \ + --region=us-central1 --policy-name=my-policy --priority=0 + +POSITIONAL ARGUMENTS + NAME + Name of the router to remove a route policy term from. + +REQUIRED FLAGS + --policy-name=POLICY_NAME + Name of the route policy from which the term should be removed. + + --priority=PRIORITY + Order of the term within the policy. + +OPTIONAL FLAGS + --region=REGION + Region of the router to remove a route policy term from. If not + specified, you might be prompted to select a region (interactive mode + only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --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 compute routers remove-route-policy-term + + $ gcloud beta compute routers remove-route-policy-term + diff --git a/gcloud/compute/routers/update-bgp-peer b/gcloud/compute/routers/update-bgp-peer index 35f2f1cf5..ab9fc209d 100644 --- a/gcloud/compute/routers/update-bgp-peer +++ b/gcloud/compute/routers/update-bgp-peer @@ -7,7 +7,9 @@ SYNOPSIS [--advertised-route-priority=ADVERTISED_ROUTE_PRIORITY] [--advertisement-mode=MODE] [--async] [--clear-md5-authentication-key] [--custom-learned-route-priority=PRIORITY] [--[no-]enable-ipv4] - [--[no-]enable-ipv6] [--[no-]enabled] [--interface=INTERFACE] + [--[no-]enable-ipv6] [--[no-]enabled] + [--export-policies=[EXPORT_POLICY,...]] + [--import-policies=[IMPORT_POLICY,...]] [--interface=INTERFACE] [--ip-address=IP_ADDRESS] [--ipv4-nexthop-address=IPV4_NEXTHOP_ADDRESS] [--ipv6-nexthop-address=IPV6_NEXTHOP_ADDRESS] [--md5-authentication-key=MD5_AUTHENTICATION_KEY] [--peer-asn=PEER_ASN] @@ -87,6 +89,14 @@ OPTIONAL FLAGS terminated and all associated routing information is removed. Use --enabled to enable and --no-enabled to disable. + --export-policies=[EXPORT_POLICY,...] + Comma-separated list of export policies. Passing an empty string + removes all export policies. + + --import-policies=[IMPORT_POLICY,...] + Comma-separated list of import policies. Passing an empty string + removes all import policies. + --interface=INTERFACE The name of the interface for this BGP peer. diff --git a/gcloud/compute/routers/update-route-policy-term b/gcloud/compute/routers/update-route-policy-term new file mode 100644 index 000000000..d992b9aec --- /dev/null +++ b/gcloud/compute/routers/update-route-policy-term @@ -0,0 +1,78 @@ +NAME + gcloud compute routers update-route-policy-term - updates a term of an + existing route policy of a Comute Engine router + +SYNOPSIS + gcloud compute routers update-route-policy-term NAME --actions=[ACTION;...] + --match=MATCH --policy-name=POLICY_NAME --priority=PRIORITY + [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute routers update-route-policy-term updates a term of a route + policy. + +EXAMPLES + To update a term with priority 128 with match destination == + '192.168.0.0/24' and actions med.set(12345);asPath.prependSequence([1, 2]) + of a route policy example-policy-name of a router example-router in region + router-region, run: + + $ gcloud compute routers update-route-policy-term example-router \ + --region=router-region --policy-name=example-policy-name \ + --priority=128 --match="destination == '192.168.0.0/24'" \ + --actions="med.set(12345);asPath.prependSequence([1, 2])" + +POSITIONAL ARGUMENTS + NAME + Name of the router to update. + +REQUIRED FLAGS + --actions=[ACTION;...] + Semicolon separated CEL expressions for the actions to take when the + rule matches. + + --match=MATCH + CEL expression for matching a route. + + --policy-name=POLICY_NAME + Name of the route policy to which the term should be updated. + + --priority=PRIORITY + Order of the term within the policy. + +OPTIONAL FLAGS + --region=REGION + Region of the router to update. If not specified, you might be prompted + to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --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 compute routers update-route-policy-term + + $ gcloud beta compute routers update-route-policy-term + diff --git a/gcloud/compute/routers/upload-route-policy b/gcloud/compute/routers/upload-route-policy new file mode 100644 index 000000000..a79de43cd --- /dev/null +++ b/gcloud/compute/routers/upload-route-policy @@ -0,0 +1,72 @@ +NAME + gcloud compute routers upload-route-policy - upload a route policy into a + Compute Engine router + +SYNOPSIS + gcloud compute routers upload-route-policy NAME --file-name=FILE_NAME + [--file-format=FILE_FORMAT] [--policy-name=POLICY_NAME] + [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute routers upload-route-policy uploads a route policy into a + Compute Engine router. + +EXAMPLES + To upload a route policy my-import-policy from a file my-import-policy.yaml + into a router my-router in region us-central1, run: + + $ gcloud compute routers upload-route-policy my-router \ + --region=us-central1 --policy-name=my-import-policy \ + --file-name=my-import-policy.yaml" + +POSITIONAL ARGUMENTS + NAME + Name of the router to upload. + +REQUIRED FLAGS + --file-name=FILE_NAME + Local path to the file defining the policy + +OPTIONAL FLAGS + --file-format=FILE_FORMAT + Format of the file passed to --file-name. FILE_FORMAT must be one of: + json, yaml. + + --policy-name=POLICY_NAME + Name of the route policy to add/replace. + + --region=REGION + Region of the router to upload. If not specified, you might be prompted + to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --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 compute routers upload-route-policy + + $ gcloud beta compute routers upload-route-policy + diff --git a/gcloud/compute/url-maps/list-cdn-cache-invalidations b/gcloud/compute/url-maps/list-cdn-cache-invalidations index 61e9d2c30..bca8bcdf1 100644 --- a/gcloud/compute/url-maps/list-cdn-cache-invalidations +++ b/gcloud/compute/url-maps/list-cdn-cache-invalidations @@ -20,7 +20,8 @@ FLAGS (Default) The URL map is global. Regional URL maps are not supported. --limit=LIMIT - The maximum number of invalidations to list. + The maximum number of invalidations to list. This has an upper limit of + 1000. For more results, use Cloud Logging. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/config/get b/gcloud/config/get index 6fdce94c3..9bf45f174 100644 --- a/gcloud/config/get +++ b/gcloud/config/get @@ -517,10 +517,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud redis command group. Defaults to https://redis.googleapis.com/ - resourcesettings - Overrides API endpoint for gcloud resource-settings command group. - Defaults to https://resourcesettings.googleapis.com/ - run Overrides API endpoint for gcloud run command group. Defaults to https://run.googleapis.com/ diff --git a/gcloud/config/help b/gcloud/config/help index f780b7a55..735789d6d 100644 --- a/gcloud/config/help +++ b/gcloud/config/help @@ -549,10 +549,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud redis command group. Defaults to https://redis.googleapis.com/ - resourcesettings - Overrides API endpoint for gcloud resource-settings command group. - Defaults to https://resourcesettings.googleapis.com/ - run Overrides API endpoint for gcloud run command group. Defaults to https://run.googleapis.com/ diff --git a/gcloud/config/list b/gcloud/config/list index 6c11a5e7f..09afcc301 100644 --- a/gcloud/config/list +++ b/gcloud/config/list @@ -561,10 +561,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud redis command group. Defaults to https://redis.googleapis.com/ - resourcesettings - Overrides API endpoint for gcloud resource-settings command group. - Defaults to https://resourcesettings.googleapis.com/ - run Overrides API endpoint for gcloud run command group. Defaults to https://run.googleapis.com/ diff --git a/gcloud/config/set b/gcloud/config/set index fb78658a6..755ff41b7 100644 --- a/gcloud/config/set +++ b/gcloud/config/set @@ -564,10 +564,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud redis command group. Defaults to https://redis.googleapis.com/ - resourcesettings - Overrides API endpoint for gcloud resource-settings command group. - Defaults to https://resourcesettings.googleapis.com/ - run Overrides API endpoint for gcloud run command group. Defaults to https://run.googleapis.com/ diff --git a/gcloud/config/unset b/gcloud/config/unset index 04df149f9..b76e2eca1 100644 --- a/gcloud/config/unset +++ b/gcloud/config/unset @@ -525,10 +525,6 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud redis command group. Defaults to https://redis.googleapis.com/ - resourcesettings - Overrides API endpoint for gcloud resource-settings command group. - Defaults to https://resourcesettings.googleapis.com/ - run Overrides API endpoint for gcloud run command group. Defaults to https://run.googleapis.com/ diff --git a/gcloud/container/clusters/create b/gcloud/container/clusters/create index ce51020a0..92c2935b1 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -901,7 +901,7 @@ FLAGS Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM, JOBSET For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/configure-metrics#available-metrics @@ -998,7 +998,7 @@ FLAGS on how to manage Pub/Sub topics and subscriptions. You can also use the filter option to specify which event types you'd like to receive from the following options: SecurityBulletinEvent, UpgradeEvent, - UpgradeAvailableEvent. + UpgradeInfoEvent, UpgradeAvailableEvent. Examples: @@ -2075,10 +2075,17 @@ FLAGS --maintenance-window-recurrence=FREQ=DAILY --maintenance-window-end=TIME_STAMP - End time of the first window (can occur in the past). Must take - place after the start time. The difference in start and end time - specifies the length of each recurrence. See $ gcloud topic - datetimes for information on time formats. + The end time for calculating the duration of the maintenance + window, as expressed by the amount of time after the START_TIME, in + the same format. The value for END_TIME must be in the future, + relative to START_TIME. This only calculates the duration of the + window, and doesn't set when the maintenance window stops + recurring. Maintenance windows only stop recurring when they're + removed. See $ gcloud topic datetimes for information on time + formats. + + This flag argument must be specified if any of the other arguments + in this group are specified. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/container/clusters/create-auto b/gcloud/container/clusters/create-auto index d632f33a3..4ce7c30a9 100644 --- a/gcloud/container/clusters/create-auto +++ b/gcloud/container/clusters/create-auto @@ -342,7 +342,7 @@ FLAGS Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM, JOBSET For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/configure-metrics#available-metrics diff --git a/gcloud/container/clusters/update b/gcloud/container/clusters/update index 62e2080b8..d22acf737 100644 --- a/gcloud/container/clusters/update +++ b/gcloud/container/clusters/update @@ -13,7 +13,9 @@ SYNOPSIS | --containerd-config-from-file=PATH_TO_FILE | --database-encryption-key=DATABASE_ENCRYPTION_KEY | --disable-database-encryption | --disable-default-snat - | --disable-workload-identity | --enable-autoscaling + | --disable-workload-identity + | --[no-]enable-autopilot-compatibility-auditing + | --enable-autoscaling | --[no-]enable-cilium-clusterwide-network-policy | --enable-cost-allocation | --enable-fleet | --enable-fqdn-network-policy | --enable-identity-service @@ -299,6 +301,13 @@ REQUIRED FLAGS https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity + --[no-]enable-autopilot-compatibility-auditing + Enables the Autopilot Compatibility Auditing Feature. See + https://cloud.google.com/sdk/gcloud/reference/container/clusters/check-autopilot-compatibility. + Only applicable to clusters with version >= 1.32. Use + --enable-autopilot-compatibility-auditing to enable and + --no-enable-autopilot-compatibility-auditing to disable. + --enable-autoscaling Enables autoscaling for a node pool. @@ -551,7 +560,8 @@ REQUIRED FLAGS https://cloud.google.com/pubsub/docs/admin on how to manage Pub/Sub topics and subscriptions. You can also use the filter option to specify which event types you'd like to receive from the following - options: SecurityBulletinEvent, UpgradeEvent, UpgradeAvailableEvent. + options: SecurityBulletinEvent, UpgradeEvent, UpgradeInfoEvent, + UpgradeAvailableEvent. Examples: @@ -815,7 +825,7 @@ REQUIRED FLAGS Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM, JOBSET For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/configure-metrics#available-metrics @@ -924,10 +934,17 @@ REQUIRED FLAGS --maintenance-window-recurrence=FREQ=DAILY --maintenance-window-end=TIME_STAMP - End time of the first window (can occur in the past). Must take - place after the start time. The difference in start and end time - specifies the length of each recurrence. See $ gcloud topic - datetimes for information on time formats. + The end time for calculating the duration of the maintenance + window, as expressed by the amount of time after the START_TIME, + in the same format. The value for END_TIME must be in the future, + relative to START_TIME. This only calculates the duration of the + window, and doesn't set when the maintenance window stops + recurring. Maintenance windows only stop recurring when they're + removed. See $ gcloud topic datetimes for information on time + formats. + + This flag argument must be specified if any of the other + arguments in this group are specified. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/data-catalog/entries/create b/gcloud/data-catalog/entries/create index 38680b9c3..a7803fb29 100644 --- a/gcloud/data-catalog/entries/create +++ b/gcloud/data-catalog/entries/create @@ -16,6 +16,9 @@ SYNOPSIS | --schema-from-file=PATH_TO_FILE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex entries + instead. + Create a Data Catalog entry. EXAMPLES diff --git a/gcloud/data-catalog/entries/delete b/gcloud/data-catalog/entries/delete index dfe645df0..a0222b9bf 100644 --- a/gcloud/data-catalog/entries/delete +++ b/gcloud/data-catalog/entries/delete @@ -7,6 +7,9 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex entries + instead. + Delete a Data Catalog entry. EXAMPLES diff --git a/gcloud/data-catalog/entries/describe b/gcloud/data-catalog/entries/describe index ea7e73f24..73f389e19 100644 --- a/gcloud/data-catalog/entries/describe +++ b/gcloud/data-catalog/entries/describe @@ -7,6 +7,9 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex entries + instead. + Describe a Data Catalog entry. EXAMPLES diff --git a/gcloud/data-catalog/entries/help b/gcloud/data-catalog/entries/help index 6715cf86b..f352c8971 100644 --- a/gcloud/data-catalog/entries/help +++ b/gcloud/data-catalog/entries/help @@ -16,28 +16,28 @@ COMMANDS COMMAND is one of the following: create - Create a Data Catalog entry. + (DEPRECATED) Create a Data Catalog entry. delete - Delete a Data Catalog entry. + (DEPRECATED) Delete a Data Catalog entry. describe - Describe a Data Catalog entry. + (DEPRECATED) Describe a Data Catalog entry. list - List all entries in a Data Catalog entry group. + (DEPRECATED) List all entries in a Data Catalog entry group. lookup - Lookup a Data Catalog entry by its target name. + (DEPRECATED) Lookup a Data Catalog entry by its target name. star - Star a Data Catalog entry. + (DEPRECATED) Star a Data Catalog entry. unstar - Unstar a Data Catalog entry. + (DEPRECATED) Unstar a Data Catalog entry. update - Update a Data Catalog entry. + (DEPRECATED) Update a Data Catalog entry. NOTES These variants are also available: diff --git a/gcloud/data-catalog/entries/list b/gcloud/data-catalog/entries/list index c2101c9ec..37bdd62a5 100644 --- a/gcloud/data-catalog/entries/list +++ b/gcloud/data-catalog/entries/list @@ -9,6 +9,9 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex entries + instead. + List all entries in a Data Catalog entry group. EXAMPLES diff --git a/gcloud/data-catalog/entries/lookup b/gcloud/data-catalog/entries/lookup index 40e849ee9..ed685c099 100644 --- a/gcloud/data-catalog/entries/lookup +++ b/gcloud/data-catalog/entries/lookup @@ -6,6 +6,9 @@ SYNOPSIS gcloud data-catalog entries lookup RESOURCE [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex entries + instead. + Lookup a Data Catalog entry by its target name. EXAMPLES diff --git a/gcloud/data-catalog/entries/star b/gcloud/data-catalog/entries/star index 408ccab44..b6b44a088 100644 --- a/gcloud/data-catalog/entries/star +++ b/gcloud/data-catalog/entries/star @@ -7,6 +7,8 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. + Star a Data Catalog entry. EXAMPLES diff --git a/gcloud/data-catalog/entries/unstar b/gcloud/data-catalog/entries/unstar index 768a406ba..6936a7a2f 100644 --- a/gcloud/data-catalog/entries/unstar +++ b/gcloud/data-catalog/entries/unstar @@ -7,6 +7,8 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. + Unstar a Data Catalog entry. EXAMPLES diff --git a/gcloud/data-catalog/entries/update b/gcloud/data-catalog/entries/update index 5cfdc5f96..ad7403aef 100644 --- a/gcloud/data-catalog/entries/update +++ b/gcloud/data-catalog/entries/update @@ -15,6 +15,9 @@ SYNOPSIS | --schema-from-file=PATH_TO_FILE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex entries + instead. + Update a Data Catalog entry. The entry to update can either be specified directly, or the --lookup-entry flag may be used to update the entry corresponding to the lookup of the given resource. diff --git a/gcloud/data-catalog/entry-groups/add-iam-policy-binding b/gcloud/data-catalog/entry-groups/add-iam-policy-binding index 392b5aeb5..a71ea9a17 100644 --- a/gcloud/data-catalog/entry-groups/add-iam-policy-binding +++ b/gcloud/data-catalog/entry-groups/add-iam-policy-binding @@ -8,6 +8,9 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + Add an IAM policy binding to a Data Catalog entry group. EXAMPLES diff --git a/gcloud/data-catalog/entry-groups/create b/gcloud/data-catalog/entry-groups/create index 46fa85aac..879b7d5aa 100644 --- a/gcloud/data-catalog/entry-groups/create +++ b/gcloud/data-catalog/entry-groups/create @@ -7,6 +7,9 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + Create a Data Catalog entry group. EXAMPLES diff --git a/gcloud/data-catalog/entry-groups/delete b/gcloud/data-catalog/entry-groups/delete index 816c1e636..619be2035 100644 --- a/gcloud/data-catalog/entry-groups/delete +++ b/gcloud/data-catalog/entry-groups/delete @@ -6,6 +6,9 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + Delete a Data Catalog entry group. EXAMPLES diff --git a/gcloud/data-catalog/entry-groups/describe b/gcloud/data-catalog/entry-groups/describe index cc8db8b28..2d31e6242 100644 --- a/gcloud/data-catalog/entry-groups/describe +++ b/gcloud/data-catalog/entry-groups/describe @@ -7,6 +7,9 @@ SYNOPSIS (ENTRY_GROUP : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + Describe a Data Catalog entry group. EXAMPLES diff --git a/gcloud/data-catalog/entry-groups/get-iam-policy b/gcloud/data-catalog/entry-groups/get-iam-policy index d130cac03..b0f852885 100644 --- a/gcloud/data-catalog/entry-groups/get-iam-policy +++ b/gcloud/data-catalog/entry-groups/get-iam-policy @@ -9,6 +9,9 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + gcloud data-catalog entry-groups get-iam-policy displays the IAM policy associated with a Data Catalog entry group. If formatted as JSON, the output can be edited and used as a policy file for set-iam-policy. The diff --git a/gcloud/data-catalog/entry-groups/help b/gcloud/data-catalog/entry-groups/help index 3800435dc..ddbe727d9 100644 --- a/gcloud/data-catalog/entry-groups/help +++ b/gcloud/data-catalog/entry-groups/help @@ -5,7 +5,10 @@ SYNOPSIS gcloud data-catalog entry-groups COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Manage entry groups in Data Catalog. + (DEPRECATED) Manage entry groups in Data Catalog. + + This command is deprecated. Please use gcloud dataplex entry-groups + instead. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -16,31 +19,32 @@ COMMANDS COMMAND is one of the following: add-iam-policy-binding - Add an IAM policy binding to a Data Catalog entry group. + (DEPRECATED) Add an IAM policy binding to a Data Catalog entry group. create - Create a Data Catalog entry group. + (DEPRECATED) Create a Data Catalog entry group. delete - Delete a Data Catalog entry group. + (DEPRECATED) Delete a Data Catalog entry group. describe - Describe a Data Catalog entry group. + (DEPRECATED) Describe a Data Catalog entry group. get-iam-policy - Get the IAM policy for a Data Catalog entry group. + (DEPRECATED) Get the IAM policy for a Data Catalog entry group. list - List all entry groups in a Data Catalog location. + (DEPRECATED) List all entry groups in a Data Catalog location. remove-iam-policy-binding - Remove an IAM policy binding from a Data Catalog entry group. + (DEPRECATED) Remove an IAM policy binding from a Data Catalog entry + group. set-iam-policy - Set the IAM policy for a Data Catalog entry group. + (DEPRECATED) Set the IAM policy for a Data Catalog entry group. update - Update a Data Catalog entry group. + (DEPRECATED) Update a Data Catalog entry group. NOTES These variants are also available: diff --git a/gcloud/data-catalog/entry-groups/list b/gcloud/data-catalog/entry-groups/list index 592f46f86..f877d7d74 100644 --- a/gcloud/data-catalog/entry-groups/list +++ b/gcloud/data-catalog/entry-groups/list @@ -8,6 +8,9 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + List all entries in a Data Catalog location. EXAMPLES diff --git a/gcloud/data-catalog/entry-groups/remove-iam-policy-binding b/gcloud/data-catalog/entry-groups/remove-iam-policy-binding index 05b9855d0..250dabb7b 100644 --- a/gcloud/data-catalog/entry-groups/remove-iam-policy-binding +++ b/gcloud/data-catalog/entry-groups/remove-iam-policy-binding @@ -8,6 +8,9 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + Remove an IAM policy binding from a Data Catalog entry group. EXAMPLES diff --git a/gcloud/data-catalog/entry-groups/set-iam-policy b/gcloud/data-catalog/entry-groups/set-iam-policy index fdf30ed1e..05f0c2983 100644 --- a/gcloud/data-catalog/entry-groups/set-iam-policy +++ b/gcloud/data-catalog/entry-groups/set-iam-policy @@ -7,6 +7,9 @@ SYNOPSIS (ENTRY_GROUP : --location=LOCATION) POLICY_FILE [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + Set the IAM policy for the given Data Catalog entry group as defined in a JSON or YAML file. diff --git a/gcloud/data-catalog/entry-groups/update b/gcloud/data-catalog/entry-groups/update index 01f51d150..a004b7310 100644 --- a/gcloud/data-catalog/entry-groups/update +++ b/gcloud/data-catalog/entry-groups/update @@ -7,6 +7,9 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + entry-groups instead. + Update a Data Catalog entry group. EXAMPLES diff --git a/gcloud/data-catalog/help b/gcloud/data-catalog/help index 8cfffb874..45e37fb6f 100644 --- a/gcloud/data-catalog/help +++ b/gcloud/data-catalog/help @@ -19,13 +19,13 @@ GROUPS Manage entries in Data Catalog. entry-groups - Manage entry groups in Data Catalog. + (DEPRECATED) Manage entry groups in Data Catalog. tag-templates - Manage tag templates in Data Catalog. + (DEPRECATED) Manage tag templates in Data Catalog. tags - Manage tags in Data Catalog. + (DEPRECATED) Manage tags in Data Catalog. taxonomies Manage taxonomies in Data Catalog. @@ -34,7 +34,7 @@ COMMANDS COMMAND is one of the following: search - Search Data Catalog for resources that match a query. + (DEPRECATED) Search Data Catalog for resources that match a query. NOTES These variants are also available: diff --git a/gcloud/data-catalog/search b/gcloud/data-catalog/search index 4aa6da52b..d3e1923c7 100644 --- a/gcloud/data-catalog/search +++ b/gcloud/data-catalog/search @@ -11,6 +11,9 @@ SYNOPSIS [--order-by=ORDER_BY] [--page-size=PAGE_SIZE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex entries + search instead. + Search Data Catalog for resources that match a query. EXAMPLES diff --git a/gcloud/data-catalog/tag-templates/add-iam-policy-binding b/gcloud/data-catalog/tag-templates/add-iam-policy-binding index 5fbb54dbc..475ad0a2c 100644 --- a/gcloud/data-catalog/tag-templates/add-iam-policy-binding +++ b/gcloud/data-catalog/tag-templates/add-iam-policy-binding @@ -8,6 +8,9 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + Add IAM policy binding to a Data Catalog tag template. EXAMPLES diff --git a/gcloud/data-catalog/tag-templates/create b/gcloud/data-catalog/tag-templates/create index d539beb93..53e7cee1d 100644 --- a/gcloud/data-catalog/tag-templates/create +++ b/gcloud/data-catalog/tag-templates/create @@ -10,6 +10,9 @@ SYNOPSIS [--display-name=DISPLAY_NAME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + Create a Data Catalog tag template. EXAMPLES diff --git a/gcloud/data-catalog/tag-templates/delete b/gcloud/data-catalog/tag-templates/delete index 92179515b..3517c3470 100644 --- a/gcloud/data-catalog/tag-templates/delete +++ b/gcloud/data-catalog/tag-templates/delete @@ -7,6 +7,9 @@ SYNOPSIS (TAG_TEMPLATE : --location=LOCATION) [--force] [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + Delete a Data Catalog tag template. EXAMPLES diff --git a/gcloud/data-catalog/tag-templates/describe b/gcloud/data-catalog/tag-templates/describe index e6e6e2d8e..7aa450eef 100644 --- a/gcloud/data-catalog/tag-templates/describe +++ b/gcloud/data-catalog/tag-templates/describe @@ -7,6 +7,9 @@ SYNOPSIS (TAG_TEMPLATE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + Describe a Data Catalog tag template. EXAMPLES diff --git a/gcloud/data-catalog/tag-templates/fields/create b/gcloud/data-catalog/tag-templates/fields/create index a96c0d801..74fcb7586 100644 --- a/gcloud/data-catalog/tag-templates/fields/create +++ b/gcloud/data-catalog/tag-templates/fields/create @@ -8,6 +8,9 @@ SYNOPSIS [--display-name=DISPLAY_NAME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + Create a Data Catalog tag template field. EXAMPLES diff --git a/gcloud/data-catalog/tag-templates/fields/delete b/gcloud/data-catalog/tag-templates/fields/delete index f838a198c..ce5ae9738 100644 --- a/gcloud/data-catalog/tag-templates/fields/delete +++ b/gcloud/data-catalog/tag-templates/fields/delete @@ -8,6 +8,9 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + Delete a Data Catalog tag template field. EXAMPLES diff --git a/gcloud/data-catalog/tag-templates/fields/enum-values/help b/gcloud/data-catalog/tag-templates/fields/enum-values/help index 7b6d41a8a..930025d90 100644 --- a/gcloud/data-catalog/tag-templates/fields/enum-values/help +++ b/gcloud/data-catalog/tag-templates/fields/enum-values/help @@ -7,7 +7,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Manage tag template enum values in Data Catalog. + (DEPRECATED) Manage tag template enum values in Data Catalog. + + This command is deprecated. Please use gcloud dataplex aspect-types + instead. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,7 +21,8 @@ COMMANDS COMMAND is one of the following: rename - Rename an enum value in Data Catalog tag template enum field. + (DEPRECATED) Rename an enum value in Data Catalog tag template enum + field. NOTES These variants are also available: diff --git a/gcloud/data-catalog/tag-templates/fields/enum-values/rename b/gcloud/data-catalog/tag-templates/fields/enum-values/rename index cb936cc3d..05c32def2 100644 --- a/gcloud/data-catalog/tag-templates/fields/enum-values/rename +++ b/gcloud/data-catalog/tag-templates/fields/enum-values/rename @@ -9,6 +9,9 @@ SYNOPSIS --new-id=NEW_ID [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + Rename an enum value in Data Catalog tag template enum field. EXAMPLES diff --git a/gcloud/data-catalog/tag-templates/fields/help b/gcloud/data-catalog/tag-templates/fields/help index 19372e68a..af8be57b8 100644 --- a/gcloud/data-catalog/tag-templates/fields/help +++ b/gcloud/data-catalog/tag-templates/fields/help @@ -7,7 +7,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Manage tag template fields in Data Catalog. + (DEPRECATED) Manage tag template fields in Data Catalog. + + This command is deprecated. Please use gcloud dataplex aspect-types + instead. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,22 +21,22 @@ GROUPS GROUP is one of the following: enum-values - Manage tag template enum values in Data Catalog. + (DEPRECATED) Manage tag template enum values in Data Catalog. COMMANDS COMMAND is one of the following: create - Create a Data Catalog tag template field. + (DEPRECATED) Create a Data Catalog tag template field. delete - Delete a Data Catalog tag template field. + (DEPRECATED) Delete a Data Catalog tag template field. rename - Rename a Data Catalog tag template field. + (DEPRECATED) Rename a Data Catalog tag template field. update - Update a Data Catalog tag template field. + (DEPRECATED) Update a Data Catalog tag template field. NOTES These variants are also available: diff --git a/gcloud/data-catalog/tag-templates/fields/rename b/gcloud/data-catalog/tag-templates/fields/rename index a391590d8..2a9dd342d 100644 --- a/gcloud/data-catalog/tag-templates/fields/rename +++ b/gcloud/data-catalog/tag-templates/fields/rename @@ -8,6 +8,9 @@ SYNOPSIS --new-id=NEW_ID [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + Rename a Data Catalog tag template field. EXAMPLES diff --git a/gcloud/data-catalog/tag-templates/fields/update b/gcloud/data-catalog/tag-templates/fields/update index ae79e3ff1..c271df65c 100644 --- a/gcloud/data-catalog/tag-templates/fields/update +++ b/gcloud/data-catalog/tag-templates/fields/update @@ -9,6 +9,9 @@ SYNOPSIS [--required] [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + Update a Data Catalog tag template field. EXAMPLES diff --git a/gcloud/data-catalog/tag-templates/get-iam-policy b/gcloud/data-catalog/tag-templates/get-iam-policy index 3f9cdf172..d17c42fc1 100644 --- a/gcloud/data-catalog/tag-templates/get-iam-policy +++ b/gcloud/data-catalog/tag-templates/get-iam-policy @@ -9,6 +9,9 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + gcloud data-catalog tag-templates get-iam-policy displays the IAM policy associated with a Data Catalog. If formatted as JSON, the output can be edited and used as a policy file for set-iam-policy. The output includes an diff --git a/gcloud/data-catalog/tag-templates/help b/gcloud/data-catalog/tag-templates/help index 02d56c5b4..09061ae7f 100644 --- a/gcloud/data-catalog/tag-templates/help +++ b/gcloud/data-catalog/tag-templates/help @@ -5,7 +5,10 @@ SYNOPSIS gcloud data-catalog tag-templates GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Manage tag templates in Data Catalog. + (DEPRECATED) Manage tag templates in Data Catalog. + + This command is deprecated. Please use gcloud dataplex aspect-types + instead. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -16,34 +19,35 @@ GROUPS GROUP is one of the following: fields - Manage tag template fields in Data Catalog. + (DEPRECATED) Manage tag template fields in Data Catalog. COMMANDS COMMAND is one of the following: add-iam-policy-binding - Add IAM policy binding to a Data Catalog tag template. + (DEPRECATED) Add IAM policy binding to a Data Catalog tag template. create - Create a Data Catalog tag template. + (DEPRECATED) Create a Data Catalog tag template. delete - Delete a Data Catalog tag template. + (DEPRECATED) Delete a Data Catalog tag template. describe - Describe a Data Catalog tag template. + (DEPRECATED) Describe a Data Catalog tag template. get-iam-policy - Get the IAM policy for a Data Catalog tag template. + (DEPRECATED) Get the IAM policy for a Data Catalog tag template. remove-iam-policy-binding - Remove IAM policy binding from a Data Catalog tag template. + (DEPRECATED) Remove IAM policy binding from a Data Catalog tag + template. set-iam-policy - Set the IAM policy for a Data Catalog tag template. + (DEPRECATED) Set the IAM policy for a Data Catalog tag template. update - Update a Data Catalog tag template. + (DEPRECATED) Update a Data Catalog tag template. NOTES These variants are also available: diff --git a/gcloud/data-catalog/tag-templates/remove-iam-policy-binding b/gcloud/data-catalog/tag-templates/remove-iam-policy-binding index 9e873b72a..518f55264 100644 --- a/gcloud/data-catalog/tag-templates/remove-iam-policy-binding +++ b/gcloud/data-catalog/tag-templates/remove-iam-policy-binding @@ -8,6 +8,9 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + Removes a policy binding from the IAM policy of a Data Catalog tag template, given a project ID and the binding. diff --git a/gcloud/data-catalog/tag-templates/set-iam-policy b/gcloud/data-catalog/tag-templates/set-iam-policy index b19c1c361..3b84d64c1 100644 --- a/gcloud/data-catalog/tag-templates/set-iam-policy +++ b/gcloud/data-catalog/tag-templates/set-iam-policy @@ -7,6 +7,9 @@ SYNOPSIS (TAG_TEMPLATE : --location=LOCATION) POLICY_FILE [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + Sets the IAM policy for the given Data Catalog tag template as defined in a JSON or YAML file. diff --git a/gcloud/data-catalog/tag-templates/update b/gcloud/data-catalog/tag-templates/update index baf96bcf3..32c708f8d 100644 --- a/gcloud/data-catalog/tag-templates/update +++ b/gcloud/data-catalog/tag-templates/update @@ -8,6 +8,9 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex + aspect-types instead. + Update a Data Catalog tag template. EXAMPLES diff --git a/gcloud/data-catalog/tags/create b/gcloud/data-catalog/tags/create index ad8ec2ebe..fa3486fa7 100644 --- a/gcloud/data-catalog/tags/create +++ b/gcloud/data-catalog/tags/create @@ -10,6 +10,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex entries + instead. Note that aspects - successors of tags - are part of the entry + resource and are managed by gcloud dataplex entries command. + Create a Data Catalog entry tag. EXAMPLES diff --git a/gcloud/data-catalog/tags/delete b/gcloud/data-catalog/tags/delete index d2811d758..af69b2074 100644 --- a/gcloud/data-catalog/tags/delete +++ b/gcloud/data-catalog/tags/delete @@ -7,6 +7,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex entries + instead. Note that aspects - successors of tags - are part of the entry + resource and are managed by gcloud dataplex entries command. + Delete a Data Catalog entry tag. EXAMPLES diff --git a/gcloud/data-catalog/tags/help b/gcloud/data-catalog/tags/help index 6c3aabefe..8cb3089e0 100644 --- a/gcloud/data-catalog/tags/help +++ b/gcloud/data-catalog/tags/help @@ -5,7 +5,11 @@ SYNOPSIS gcloud data-catalog tags COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Manage tags in Data Catalog. + (DEPRECATED) Manage tags in Data Catalog. + + This command is deprecated. Please use gcloud dataplex entries instead. + Note that aspects - successors of tags - are part of the entry resource and + are managed by gcloud dataplex entries command. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -16,16 +20,16 @@ COMMANDS COMMAND is one of the following: create - Create a Data Catalog entry tag. + (DEPRECATED) Create a Data Catalog entry tag. delete - Delete a Data Catalog entry tag. + (DEPRECATED) Delete a Data Catalog entry tag. list - List Data Catalog entry tags. + (DEPRECATED) List Data Catalog entry tags. update - Update a Data Catalog entry tag. + (DEPRECATED) Update a Data Catalog entry tag. NOTES These variants are also available: diff --git a/gcloud/data-catalog/tags/list b/gcloud/data-catalog/tags/list index 77b7c54fb..e66b3b727 100644 --- a/gcloud/data-catalog/tags/list +++ b/gcloud/data-catalog/tags/list @@ -8,6 +8,10 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex entries + instead. Note that aspects - successors of tags - are part of the entry + resource and are managed by gcloud dataplex entries command. + List Data Catalog entry tags. EXAMPLES diff --git a/gcloud/data-catalog/tags/update b/gcloud/data-catalog/tags/update index 45b17dcd5..2c71b2096 100644 --- a/gcloud/data-catalog/tags/update +++ b/gcloud/data-catalog/tags/update @@ -10,6 +10,10 @@ SYNOPSIS --tag-template-project=TAG_TEMPLATE_PROJECT) [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. Please use gcloud dataplex entries + instead. Note that aspects - successors of tags - are part of the entry + resource and are managed by gcloud dataplex entries command. + Update a Data Catalog entry tag. This will overwrite the current values of the tag. diff --git a/gcloud/dataflow/flex-template/build b/gcloud/dataflow/flex-template/build index b66f9f2c6..a7787742a 100644 --- a/gcloud/dataflow/flex-template/build +++ b/gcloud/dataflow/flex-template/build @@ -8,7 +8,9 @@ SYNOPSIS (--image=IMAGE | --env=[ENV,...] --flex-template-base-image=FLEX_TEMPLATE_BASE_IMAGE --image-gcr-path=IMAGE_GCR_PATH (--go-binary-path=GO_BINARY_PATH - | --jar=[JAR,...] | --py-path=[PY_PATH,...])) + | --jar=[JAR,...] | --py-path=[PY_PATH,...]) + | [--yaml-pipeline-path=YAML_PIPELINE_PATH + : --yaml-image=YAML_IMAGE]) [--additional-experiments=[ADDITIONAL_EXPERIMENTS,...]] [--additional-user-labels=[ADDITIONAL_USER_LABELS,...]] [--cloud-build-service-account=CLOUD_BUILD_SERVICE_ACCOUNT] @@ -63,7 +65,7 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --sdk-language=SDK_LANGUAGE SDK language of the flex template job. SDK_LANGUAGE must be one of: - JAVA, PYTHON, GO. + JAVA, PYTHON, GO, YAML. Exactly one of these must be specified: @@ -125,6 +127,17 @@ REQUIRED FLAGS --py-path flag. Ex: --py-path="path/pipleline/,path/dependency/" or --py-path path/pipleline/, --py-path path/dependency/. + --yaml-pipeline-path=YAML_PIPELINE_PATH + Local path to your YAML pipeline file. Use a full or relative path to + a local file containing the value of yaml_pipeline_path. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --yaml-image=YAML_IMAGE + Path to the any image registry location of the prebuilt yaml template + image. + OPTIONAL FLAGS --additional-experiments=[ADDITIONAL_EXPERIMENTS,...] Default experiments to pass to the job. diff --git a/gcloud/dataflow/jobs/run b/gcloud/dataflow/jobs/run index 6ca768265..08f8ad726 100644 --- a/gcloud/dataflow/jobs/run +++ b/gcloud/dataflow/jobs/run @@ -11,6 +11,8 @@ SYNOPSIS [--service-account-email=SERVICE_ACCOUNT_EMAIL] [--staging-location=STAGING_LOCATION] [--subnetwork=SUBNETWORK] [--worker-machine-type=WORKER_MACHINE_TYPE] + [[--[no-]update + : --transform-name-mappings=[TRANSFORM_NAME_MAPPINGS,...]]] [--worker-region=WORKER_REGION | --worker-zone=WORKER_ZONE | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] @@ -74,6 +76,13 @@ OPTIONAL FLAGS --worker-machine-type=WORKER_MACHINE_TYPE The type of machine to use for workers. Defaults to server-specified. + --[no-]update + Set this to true for streaming update jobs. Use --update to enable and + --no-update to disable. + + --transform-name-mappings=[TRANSFORM_NAME_MAPPINGS,...] + Transform name mappings for the streaming update job. + Worker location options. At most one of these can be specified: diff --git a/gcloud/datastream/connection-profiles/create b/gcloud/datastream/connection-profiles/create index 5cd050cd9..9b83c81a2 100644 --- a/gcloud/datastream/connection-profiles/create +++ b/gcloud/datastream/connection-profiles/create @@ -24,12 +24,11 @@ SYNOPSIS : [--postgresql-ca-certificate=POSTGRESQL_CA_CERTIFICATE : --postgresql-client-certificate=POSTGRESQL_CLIENT_CERTIFICATE --postgresql-client-key=POSTGRESQL_CLIENT_KEY]] - | --sqlserver-database=SQLSERVER_DATABASE - --sqlserver-hostname=SQLSERVER_HOSTNAME - --sqlserver-port=SQLSERVER_PORT - --sqlserver-username=SQLSERVER_USERNAME - (--sqlserver-password=SQLSERVER_PASSWORD - | --sqlserver-prompt-for-password)] + | --salesforce-domain=SALESFORCE_DOMAIN + (--salesforce-oauth2-client-id=SALESFORCE_OAUTH2_CLIENT_ID + (--salesforce-oauth2-client-secret=SALESFORCE_OAUTH2_CLIENT_SECRET + | --salesforce-prompt-for-oauth2-client-secret + | --salesforce-secret-manager-stored-oauth2-client-secret=SALESFORCE_SECRET_MANAGER_STORED_OAUTH2_CLIENT_SECRET) | --salesforce-username=SALESFORCE_USERNAME (--salesforce-password=SALESFORCE_PASSWORD | --salesforce-prompt-for-password | --salesforce-secret-manager-stored-password=SALESFORCE_SECRET_MANAGER_STORED_PASSWORD) (--salesforce-prompt-for-security-token | --salesforce-secret-manager-stored-security-token=SALESFORCE_SECRET_MANAGER_STORED_SECURITY_TOKEN | --salesforce-security-token=SALESFORCE_SECURITY_TOKEN)) | --sqlserver-database=SQLSERVER_DATABASE --sqlserver-hostname=SQLSERVER_HOSTNAME --sqlserver-port=SQLSERVER_PORT --sqlserver-username=SQLSERVER_USERNAME (--sqlserver-password=SQLSERVER_PASSWORD | --sqlserver-prompt-for-password)] [--private-connection=PRIVATE_CONNECTION | --static-ip-connectivity | [--forward-ssh-hostname=FORWARD_SSH_HOSTNAME --forward-ssh-username=FORWARD_SSH_USERNAME @@ -68,6 +67,37 @@ EXAMPLES --postgresql-hostname=35.188.150.50 --postgresql-port=5432 \ --postgresql-database=db --static-ip-connectivity + To create a connection profile for SQL Server: + + $ gcloud datastream connection-profiles create CONNECTION_PROFILE \ + --location=us-central1 --type=sqlserver \ + --sqlserver-password=fakepassword \ + --sqlserver-username=fakeuser --display-name=my-profile \ + --sqlserver-hostname=35.188.150.50 --sqlserver-port=1433 \ + --sqlserver-database=db --static-ip-connectivity + + To create a connection profile for Salesforce using Username, Password and + Security Token: + + $ gcloud datastream connection-profiles create CONNECTION_PROFILE \ + --location=us-central1 --type=salesforce \ + --salesforce-password=fakepassword \ + --salesforce-username=fakeuser \ + --salesforce-security-token=fakesecuritytoken \ + --display-name=my-profile --salesforce-hostname=35.188.150.50 \ + --salesforce-port=1433 --salesforce-database=db \ + --static-ip-connectivity + + To create a connection profile for Salesforce using OAuth: + + $ gcloud datastream connection-profiles create CONNECTION_PROFILE \ + --location=us-central1 --type=salesforce \ + --salesforce-client-secret=fakesecret \ + --salesforce-client-id=fake-client-id \ + --display-name=my-profile \ + --salesforce-domain=fakecompany.my.salesforce.com \ + --static-ip-connectivity + To create a connection profile for Google Cloud Storage: $ gcloud datastream connection-profiles create CONNECTION_PROFILE \ @@ -283,6 +313,67 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --salesforce-domain=SALESFORCE_DOMAIN + Domain of the Salesforce organization. For example, + 'myorg.my.salesforce.com' + + This flag argument must be specified if any of the other arguments in + this group are specified. + + Exactly one of these must be specified: + + --salesforce-oauth2-client-id=SALESFORCE_OAUTH2_CLIENT_ID + OAuth 2.0 Client ID used to connect to Salesforce. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + Exactly one of these must be specified: + + --salesforce-oauth2-client-secret=SALESFORCE_OAUTH2_CLIENT_SECRET + OAuth 2.0 Client secret used to connect to Salesforce. + + --salesforce-prompt-for-oauth2-client-secret + Prompt for the OAuth 2.0 Client secret used to connect to + Salesforce. + + --salesforce-secret-manager-stored-oauth2-client-secret=SALESFORCE_SECRET_MANAGER_STORED_OAUTH2_CLIENT_SECRET + Path to secret manager, storing the OAuth 2.0 Client secret used + to connect to Salesforce. + + --salesforce-username=SALESFORCE_USERNAME + Username Datastream will use to connect to the database. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + Exactly one of these must be specified: + + --salesforce-password=SALESFORCE_PASSWORD + Password for the user that Datastream will be using to connect to + Salesforce. This field is not returned on request, and the value + is encrypted when stored in Datastream. + + --salesforce-prompt-for-password + Prompt for the password used to connect to Salesforce. + + --salesforce-secret-manager-stored-password=SALESFORCE_SECRET_MANAGER_STORED_PASSWORD + Path to secret manager, storing the password used to connect to + Salesforce. + + Exactly one of these must be specified: + + --salesforce-prompt-for-security-token + Prompt for the security token used to connect to Salesforce. + + --salesforce-secret-manager-stored-security-token=SALESFORCE_SECRET_MANAGER_STORED_SECURITY_TOKEN + Path to secret manager, storing the security token used to + connect to Salesforce. + + --salesforce-security-token=SALESFORCE_SECURITY_TOKEN + Security token for the user that Datastream will be using to + connect to Salesforce. + --sqlserver-database=SQLSERVER_DATABASE Database service for the SQL Server connection. diff --git a/gcloud/datastream/connection-profiles/update b/gcloud/datastream/connection-profiles/update index e4c21900a..d39333b60 100644 --- a/gcloud/datastream/connection-profiles/update +++ b/gcloud/datastream/connection-profiles/update @@ -26,12 +26,11 @@ SYNOPSIS --postgresql-client-key=POSTGRESQL_CLIENT_KEY --postgresql-password=POSTGRESQL_PASSWORD | --postgresql-prompt-for-password - | --sqlserver-database=SQLSERVER_DATABASE - --sqlserver-hostname=SQLSERVER_HOSTNAME - --sqlserver-port=SQLSERVER_PORT - --sqlserver-username=SQLSERVER_USERNAME - --sqlserver-password=SQLSERVER_PASSWORD - | --sqlserver-prompt-for-password] + | --salesforce-domain=SALESFORCE_DOMAIN + --salesforce-oauth2-client-id=SALESFORCE_OAUTH2_CLIENT_ID + --salesforce-oauth2-client-secret=SALESFORCE_OAUTH2_CLIENT_SECRET + | --salesforce-prompt-for-oauth2-client-secret + | --salesforce-secret-manager-stored-oauth2-client-secret=SALESFORCE_SECRET_MANAGER_STORED_OAUTH2_CLIENT_SECRET | --salesforce-username=SALESFORCE_USERNAME --salesforce-password=SALESFORCE_PASSWORD | --salesforce-prompt-for-password | --salesforce-secret-manager-stored-password=SALESFORCE_SECRET_MANAGER_STORED_PASSWORD --salesforce-prompt-for-security-token | --salesforce-secret-manager-stored-security-token=SALESFORCE_SECRET_MANAGER_STORED_SECURITY_TOKEN | --salesforce-security-token=SALESFORCE_SECURITY_TOKEN | --sqlserver-database=SQLSERVER_DATABASE --sqlserver-hostname=SQLSERVER_HOSTNAME --sqlserver-port=SQLSERVER_PORT --sqlserver-username=SQLSERVER_USERNAME --sqlserver-password=SQLSERVER_PASSWORD | --sqlserver-prompt-for-password] [--clear-labels | --remove-labels=[KEY,...]] [--private-connection=PRIVATE_CONNECTION | --static-ip-connectivity | --forward-ssh-hostname=FORWARD_SSH_HOSTNAME @@ -71,6 +70,24 @@ EXAMPLES --postgresql-hostname=35.188.150.50 --postgresql-port=5432 \ --postgresql-database=db --static-ip-connectivity + To update a connection profile for SQL Server: + + $ gcloud datastream connection-profiles update CONNECTION_PROFILE \ + --location=us-central1 --type=sqlserver \ + --sqlserver-password=fakepassword \ + --sqlserver-username=fakeuser --display-name=my-profile \ + --sqlserver-hostname=35.188.150.50 --sqlserver-port=1433 \ + --sqlserver-database=db --static-ip-connectivity + + To update a connection profile for Salesforce: + + $ gcloud datastream connection-profiles update CONNECTION_PROFILE \ + --location=us-central1 --type=salesforce \ + --salesforce-password=fakepassword \ + --salesforce-username=fakeuser --display-name=my-profile \ + --salesforce-domain=fakecompany.my.salesforce.com \ + --static-ip-connectivity + To update a connection profile for Google Cloud Storage: $ gcloud datastream connection-profiles update CONNECTION_PROFILE \ @@ -78,7 +95,7 @@ EXAMPLES --bucket=fake-bucket --root-path=/root/path \ --display-name=my-profile - To update a connection profile for Google Cloud Storage: + To update a connection profile for BigQuery: $ gcloud datastream connection-profiles update CONNECTION_PROFILE \ --location=us-central1 --type=bigquery --display-name=my-profile @@ -233,6 +250,58 @@ OPTIONAL FLAGS --postgresql-prompt-for-password Prompt for the password used to connect to the database. + --salesforce-domain=SALESFORCE_DOMAIN + Domain of the Salesforce organization. For example, + 'myorg.my.salesforce.com' + + At most one of these can be specified: + + --salesforce-oauth2-client-id=SALESFORCE_OAUTH2_CLIENT_ID + OAuth 2.0 Client ID used to connect to Salesforce. + + At most one of these can be specified: + + --salesforce-oauth2-client-secret=SALESFORCE_OAUTH2_CLIENT_SECRET + OAuth 2.0 Client secret used to connect to Salesforce. + + --salesforce-prompt-for-oauth2-client-secret + Prompt for the OAuth 2.0 Client secret used to connect to + Salesforce. + + --salesforce-secret-manager-stored-oauth2-client-secret=SALESFORCE_SECRET_MANAGER_STORED_OAUTH2_CLIENT_SECRET + Path to secret manager, storing the OAuth 2.0 Client secret used + to connect to Salesforce. + + --salesforce-username=SALESFORCE_USERNAME + Username Datastream will use to connect to the database. + + At most one of these can be specified: + + --salesforce-password=SALESFORCE_PASSWORD + Password for the user that Datastream will be using to connect to + Salesforce. This field is not returned on request, and the value + is encrypted when stored in Datastream. + + --salesforce-prompt-for-password + Prompt for the password used to connect to Salesforce. + + --salesforce-secret-manager-stored-password=SALESFORCE_SECRET_MANAGER_STORED_PASSWORD + Path to secret manager, storing the password used to connect to + Salesforce. + + At most one of these can be specified: + + --salesforce-prompt-for-security-token + Prompt for the security token used to connect to Salesforce. + + --salesforce-secret-manager-stored-security-token=SALESFORCE_SECRET_MANAGER_STORED_SECURITY_TOKEN + Path to secret manager, storing the security token used to + connect to Salesforce. + + --salesforce-security-token=SALESFORCE_SECURITY_TOKEN + Security token for the user that Datastream will be using to + connect to Salesforce. + --sqlserver-database=SQLSERVER_DATABASE Database service for the SQL Server connection. diff --git a/gcloud/datastream/objects/lookup b/gcloud/datastream/objects/lookup index 8f2623a11..e5f6441c2 100644 --- a/gcloud/datastream/objects/lookup +++ b/gcloud/datastream/objects/lookup @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud datastream objects lookup - (--mysql-database=MYSQL_DATABASE --mysql-table=MYSQL_TABLE + (--salesforce-object-name=SALESFORCE_OBJECT_NAME + | --mysql-database=MYSQL_DATABASE --mysql-table=MYSQL_TABLE | --oracle-schema=ORACLE_SCHEMA --oracle-table=ORACLE_TABLE | --postgresql-schema=POSTGRESQL_SCHEMA --postgresql-table=POSTGRESQL_TABLE @@ -33,9 +34,23 @@ EXAMPLES --location=us-central1 --postgresql-schema=my-schema \ --postgresql-table=my-table + To lookup an existing SQL Server stream object: + + $ gcloud datastream objects lookup --stream=my-stream \ + --location=us-central1 --sqlserver-schema=my-schema \ + --sqlserver-table=my-table + + To lookup an existing Salesforce stream object: + + $ gcloud datastream objects lookup --stream=my-stream \ + --location=us-central1 --salesforce-object-name=my-object + REQUIRED FLAGS Exactly one of these must be specified: + --salesforce-object-name=SALESFORCE_OBJECT_NAME + Salesforce object name. + --mysql-database=MYSQL_DATABASE Mysql database for the object. diff --git a/gcloud/datastream/streams/create b/gcloud/datastream/streams/create index 8a2994b4b..78241c202 100644 --- a/gcloud/datastream/streams/create +++ b/gcloud/datastream/streams/create @@ -8,6 +8,7 @@ SYNOPSIS | --backfill-all --mysql-excluded-objects=MYSQL_EXCLUDED_OBJECTS | --oracle-excluded-objects=ORACLE_EXCLUDED_OBJECTS | --postgresql-excluded-objects=POSTGRESQL_EXCLUDED_OBJECTS + | --salesforce-excluded-objects=SALESFORCE_EXCLUDED_OBJECTS | --sqlserver-excluded-objects=SQLSERVER_EXCLUDED_OBJECTS) (--destination=DESTINATION (--bigquery-destination-config=BIGQUERY_DESTINATION_CONFIG @@ -15,6 +16,7 @@ SYNOPSIS (--source=SOURCE (--mysql-source-config=MYSQL_SOURCE_CONFIG | --oracle-source-config=ORACLE_SOURCE_CONFIG | --postgresql-source-config=POSTGRESQL_SOURCE_CONFIG + | --salesforce-source-config=SALESFORCE_SOURCE_CONFIG | --sqlserver-source-config=SQLSERVER_SOURCE_CONFIG)) [--labels=[KEY=VALUE,...]] [--force | --validate-only] [GCLOUD_WIDE_FLAG ...] @@ -117,22 +119,21 @@ REQUIRED FLAGS The JSON file is formatted as follows, with camelCase field naming: { - "mysqlDatabases": [ + "mysqlDatabases": [ + { + "database":"sample_database", + "mysqlTables": [ { - "database":"sample_database", - "mysqlTables": [ + "table": "sample_table", + "mysqlColumns": [ { - "table": "sample_table", - "mysqlColumns": [ - { - "column": "sample_column", - } - ] + "column": "sample_column", } - ] + ] } ] } + ] } --oracle-excluded-objects=ORACLE_EXCLUDED_OBJECTS @@ -142,22 +143,21 @@ REQUIRED FLAGS The JSON file is formatted as follows, with camelCase field naming: { - "oracleSchemas": [ - { - "schema": "SAMPLE", - "oracleTables": [ - { - "table": "SAMPLE_TABLE", - "oracleColumns": [ - { - "column": "COL", - } - ] - } - ] - } - ] - } + "oracleSchemas": [ + { + "schema": "SAMPLE", + "oracleTables": [ + { + "table": "SAMPLE_TABLE", + "oracleColumns": [ + { + "column": "COL", + } + ] + } + ] + } + ] } --postgresql-excluded-objects=POSTGRESQL_EXCLUDED_OBJECTS @@ -167,22 +167,38 @@ REQUIRED FLAGS The JSON file is formatted as follows, with camelCase field naming: { - "postgresqlSchemas": [ - { - "schema": "SAMPLE", - "postgresqlTables": [ - { - "table": "SAMPLE_TABLE", - "postgresqlColumns": [ - { - "column": "COL", - } - ] - } - ] - } - ] - } + "postgresqlSchemas": [ + { + "schema": "SAMPLE", + "postgresqlTables": [ + { + "table": "SAMPLE_TABLE", + "postgresqlColumns": [ + { + "column": "COL", + } + ] + } + ] + } + ] + } + + --salesforce-excluded-objects=SALESFORCE_EXCLUDED_OBJECTS + Path to a YAML (or JSON) file containing the Salesforce data + sources to avoid backfilling. + + The JSON file is formatted as follows, with camelCase field naming: + + { + "objects": [ + { + "objectName": "SAMPLE", + }, + { + "objectName": "SAMPLE2", + } + ] } --sqlserver-excluded-objects=SQLSERVER_EXCLUDED_OBJECTS @@ -192,22 +208,21 @@ REQUIRED FLAGS The JSON file is formatted as follows, with camelCase field naming: { - "schemas": [ - { - "schema": "SAMPLE", - "tables": [ - { - "table": "SAMPLE_TABLE", - "columns": [ - { - "column": "COL", - } - ] - } - ] - } - ] - } + "schemas": [ + { + "schema": "SAMPLE", + "tables": [ + { + "table": "SAMPLE_TABLE", + "columns": [ + { + "column": "COL", + } + ] + } + ] + } + ] } This must be specified. @@ -405,6 +420,29 @@ REQUIRED FLAGS "publication": "SAMPLE_PUBLICATION" } + --salesforce-source-config=SALESFORCE_SOURCE_CONFIG + Path to a YAML (or JSON) file containing the configuration for + Salesforce Source Config. + + The JSON file is formatted as follows, with camelCase field naming: + + { + "pollingInterval": "3000s", + "includeObjects": {}, + "excludeObjects": { + "objects": [ + { + "objectName": "SAMPLE", + "fields": [ + { + "fieldName": "SAMPLE_FIELD", + } + ] + } + ] + } + } + --sqlserver-source-config=SQLSERVER_SOURCE_CONFIG Path to a YAML (or JSON) file containing the configuration for SQL Server Source Config. diff --git a/gcloud/datastream/streams/update b/gcloud/datastream/streams/update index 91075380e..e9b82527d 100644 --- a/gcloud/datastream/streams/update +++ b/gcloud/datastream/streams/update @@ -9,6 +9,7 @@ SYNOPSIS | --backfill-all --mysql-excluded-objects=MYSQL_EXCLUDED_OBJECTS | --oracle-excluded-objects=ORACLE_EXCLUDED_OBJECTS | --postgresql-excluded-objects=POSTGRESQL_EXCLUDED_OBJECTS + | --salesforce-excluded-objects=SALESFORCE_EXCLUDED_OBJECTS | --sqlserver-excluded-objects=SQLSERVER_EXCLUDED_OBJECTS] [--clear-labels | --remove-labels=[KEY,...]] [--destination=DESTINATION @@ -18,6 +19,7 @@ SYNOPSIS [--source=SOURCE --mysql-source-config=MYSQL_SOURCE_CONFIG | --oracle-source-config=ORACLE_SOURCE_CONFIG | --postgresql-source-config=POSTGRESQL_SOURCE_CONFIG + | --salesforce-source-config=SALESFORCE_SOURCE_CONFIG | --sqlserver-source-config=SQLSERVER_SOURCE_CONFIG] [GCLOUD_WIDE_FLAG ...] @@ -119,22 +121,21 @@ FLAGS The JSON file is formatted as follows, with camelCase field naming: { - "mysqlDatabases": [ + "mysqlDatabases": [ + { + "database":"sample_database", + "mysqlTables": [ { - "database":"sample_database", - "mysqlTables": [ + "table": "sample_table", + "mysqlColumns": [ { - "table": "sample_table", - "mysqlColumns": [ - { - "column": "sample_column", - } - ] + "column": "sample_column", } - ] + ] } ] } + ] } --oracle-excluded-objects=ORACLE_EXCLUDED_OBJECTS @@ -144,22 +145,21 @@ FLAGS The JSON file is formatted as follows, with camelCase field naming: { - "oracleSchemas": [ - { - "schema": "SAMPLE", - "oracleTables": [ - { - "table": "SAMPLE_TABLE", - "oracleColumns": [ - { - "column": "COL", - } - ] - } - ] - } - ] - } + "oracleSchemas": [ + { + "schema": "SAMPLE", + "oracleTables": [ + { + "table": "SAMPLE_TABLE", + "oracleColumns": [ + { + "column": "COL", + } + ] + } + ] + } + ] } --postgresql-excluded-objects=POSTGRESQL_EXCLUDED_OBJECTS @@ -169,22 +169,38 @@ FLAGS The JSON file is formatted as follows, with camelCase field naming: { - "postgresqlSchemas": [ - { - "schema": "SAMPLE", - "postgresqlTables": [ - { - "table": "SAMPLE_TABLE", - "postgresqlColumns": [ - { - "column": "COL", - } - ] - } - ] - } - ] - } + "postgresqlSchemas": [ + { + "schema": "SAMPLE", + "postgresqlTables": [ + { + "table": "SAMPLE_TABLE", + "postgresqlColumns": [ + { + "column": "COL", + } + ] + } + ] + } + ] + } + + --salesforce-excluded-objects=SALESFORCE_EXCLUDED_OBJECTS + Path to a YAML (or JSON) file containing the Salesforce data + sources to avoid backfilling. + + The JSON file is formatted as follows, with camelCase field naming: + + { + "objects": [ + { + "objectName": "SAMPLE", + }, + { + "objectName": "SAMPLE2", + } + ] } --sqlserver-excluded-objects=SQLSERVER_EXCLUDED_OBJECTS @@ -194,22 +210,21 @@ FLAGS The JSON file is formatted as follows, with camelCase field naming: { - "schemas": [ - { - "schema": "SAMPLE", - "tables": [ - { - "table": "SAMPLE_TABLE", - "columns": [ - { - "column": "COL", - } - ] - } - ] - } - ] - } + "schemas": [ + { + "schema": "SAMPLE", + "tables": [ + { + "table": "SAMPLE_TABLE", + "columns": [ + { + "column": "COL", + } + ] + } + ] + } + ] } At most one of these can be specified: @@ -428,9 +443,32 @@ FLAGS "publication": "SAMPLE_PUBLICATION" } - --sqlserver-source-config=SQLSERVER_SOURCE_CONFIG + --salesforce-source-config=SALESFORCE_SOURCE_CONFIG Path to a YAML (or JSON) file containing the configuration for - PostgreSQL Source Config. + Salesforce Source Config. + + The JSON file is formatted as follows, with camelCase field naming: + + { + "pollingInterval": "3000s", + "includeObjects": {}, + "excludeObjects": { + "objects": [ + { + "objectName": "SAMPLE", + "fields": [ + { + "fieldName": "SAMPLE_FIELD", + } + ] + } + ] + } + } + + --sqlserver-source-config=SQLSERVER_SOURCE_CONFIG + Path to a YAML (or JSON) file containing the configuration for SQL + Server Source Config. The JSON file is formatted as follows, with camelCase field naming: diff --git a/gcloud/kms/keys/versions/get-public-key b/gcloud/kms/keys/versions/get-public-key index 837880d36..05b2ab130 100644 --- a/gcloud/kms/keys/versions/get-public-key +++ b/gcloud/kms/keys/versions/get-public-key @@ -16,8 +16,8 @@ DESCRIPTION The optional flag public-key-format indicates the format in which the public key will be returned. For the PQC algorithms, this must be specified - and set to NIST_PQC. For all other algorithms, this flag is optional and - defaults to PEM. See "Retrieve a public key" in the Cloud KMS documentation + and set to nist-pqc. For all other algorithms, this flag is optional and + defaults to pem. See "Retrieve a public key" in the Cloud KMS documentation (https://cloud.google.com/kms/docs/retrieve-public-key) for more information about the supported formats. @@ -27,7 +27,7 @@ EXAMPLES $ gcloud kms keys versions get-public-key 2 --key=frodo \ --keyring=fellowship --location=us-east1 \ - --public-key-format=PEM --output-file=/tmp/my/public_key.file + --public-key-format=pem --output-file=/tmp/my/public_key.file POSITIONAL ARGUMENTS VERSION diff --git a/gcloud/memorystore/instances/create b/gcloud/memorystore/instances/create index a75f5b8fd..ee2c20e62 100644 --- a/gcloud/memorystore/instances/create +++ b/gcloud/memorystore/instances/create @@ -3,14 +3,15 @@ NAME SYNOPSIS gcloud memorystore instances create (INSTANCE : --location=LOCATION) - [--async] [--authorization-mode=AUTHORIZATION_MODE] + [--async] [--async-instance-endpoints-deletion-enabled] + [--authorization-mode=AUTHORIZATION_MODE] [--deletion-protection-enabled] [--endpoints=[connections=CONNECTIONS]] [--engine-configs=[ENGINE_CONFIGS,...]] [--engine-version=ENGINE_VERSION] [--labels=[LABELS,...]] [--mode=MODE] - [--node-type=NODE_TYPE] - [--psc-auto-connections=[network=NETWORK],[projectId=PROJECTID]] - [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] - [--shard-count=SHARD_COUNT] + [--node-type=NODE_TYPE] [--ondemand-maintenance] + [--psc-auto-connections=[network=NETWORK], + [port=PORT],[projectId=PROJECTID]] [--replica-count=REPLICA_COUNT] + [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] [--transit-encryption-mode=TRANSIT_ENCRYPTION_MODE] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC --persistence-config-mode=PERSISTENCE_CONFIG_MODE @@ -83,6 +84,14 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + Arguments for the async instance endpoints deletion enabled. + + --async-instance-endpoints-deletion-enabled + If true, instance endpoints that are created and registered by + customers can be deleted asynchronously. That is, such an instance + endpoint can be de-registered before the forwarding rules in the + instance endpoint are deleted. + --authorization-mode=AUTHORIZATION_MODE Authorization mode of the instance. AUTHORIZATION_MODE must be one of: @@ -111,6 +120,10 @@ FLAGS The network where the PSC endpoints are created, in the form of projects/{project_id}/global/networks/{network_id}. + port + port will only be set for Primary/Reader or Discovery + endpoint. + projectId The consumer project_id where PSC connections are established. This should be the same project_id that the @@ -118,11 +131,11 @@ FLAGS Shorthand Example: - --endpoints=connections=[{pscAutoConnection={network=string,projectId=string}}] --endpoints=connections=[{pscAutoConnection={network=string,projectId=string}}] + --endpoints=connections=[{pscAutoConnection={network=string,port=int,projectId=string}}] --endpoints=connections=[{pscAutoConnection={network=string,port=int,projectId=string}}] JSON Example: - --endpoints='[{"connections": [{"pscAutoConnection": {"network": "string", "projectId": "string"}}]}]' + --endpoints='[{"connections": [{"pscAutoConnection": {"network": "string", "port": int, "projectId": "string"}}]}]' File Example: @@ -198,13 +211,21 @@ FLAGS standard-small Standard small. - --psc-auto-connections=[network=NETWORK],[projectId=PROJECTID] + Arguments for the ondemand maintenance. + + --ondemand-maintenance + Ondemand maintenance for the instance. + + --psc-auto-connections=[network=NETWORK],[port=PORT],[projectId=PROJECTID] User inputs and resource details of the auto-created PSC connections. network The network where the PSC endpoints are created, in the form of projects/{project_id}/global/networks/{network_id}. + port + port will only be set for Primary/Reader or Discovery endpoint. + projectId The consumer project_id where PSC connections are established. This should be the same project_id that the instance is being created @@ -212,11 +233,11 @@ FLAGS Shorthand Example: - --psc-auto-connections=network=string,projectId=string --psc-auto-connections=network=string,projectId=string + --psc-auto-connections=network=string,port=int,projectId=string --psc-auto-connections=network=string,port=int,projectId=string JSON Example: - --psc-auto-connections='[{"network": "string", "projectId": "string"}]' + --psc-auto-connections='[{"network": "string", "port": int, "projectId": "string"}]' File Example: diff --git a/gcloud/memorystore/instances/update b/gcloud/memorystore/instances/update index 0fc2fdda5..ae3bc5ea4 100644 --- a/gcloud/memorystore/instances/update +++ b/gcloud/memorystore/instances/update @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud memorystore instances update (INSTANCE : --location=LOCATION) - [--async] [--[no-]deletion-protection-enabled] [--mode=MODE] + [--async] [--[no-]async-instance-endpoints-deletion-enabled] + [--[no-]deletion-protection-enabled] [--engine-version=ENGINE_VERSION] + [--mode=MODE] [--node-type=NODE_TYPE] [--[no-]ondemand-maintenance] [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC @@ -77,6 +79,16 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + Arguments for the async instance endpoints deletion enabled. + + --[no-]async-instance-endpoints-deletion-enabled + If true, instance endpoints that are created and registered by + customers can be deleted asynchronously. That is, such an instance + endpoint can be de-registered before the forwarding rules in the + instance endpoint are deleted. Use + --async-instance-endpoints-deletion-enabled to enable and + --no-async-instance-endpoints-deletion-enabled to disable. + Arguments for the deletion protection enabled. --[no-]deletion-protection-enabled @@ -84,6 +96,9 @@ FLAGS --deletion-protection-enabled to enable and --no-deletion-protection-enabled to disable. + --engine-version=ENGINE_VERSION + Engine version of the instance. + --mode=MODE The mode config for the instance. MODE must be one of: @@ -94,6 +109,25 @@ FLAGS standalone Deprecated: Use CLUSTER_DISABLED instead. + --node-type=NODE_TYPE + Machine type for individual nodes of the instance. NODE_TYPE must be + one of: + + highmem-medium + High memory medium. + highmem-xlarge + High memory extra large. + shared-core-nano + Shared core nano. + standard-small + Standard small. + + Arguments for the ondemand maintenance. + + --[no-]ondemand-maintenance + Ondemand maintenance for the instance. Use --ondemand-maintenance to + enable and --no-ondemand-maintenance to disable. + Arguments for the replica count. --replica-count=REPLICA_COUNT diff --git a/gcloud/metastore/services/create b/gcloud/metastore/services/create index 841446fa3..058fad29e 100644 --- a/gcloud/metastore/services/create +++ b/gcloud/metastore/services/create @@ -122,12 +122,14 @@ FLAGS prevent accidental deletions of the instance. Use --deletion-protection to enable. - --encryption-kms-key=ENCRYPTION_KMS_KEY - The name of the Cloud KMS key to use for customer data encryption. - Cannot be changed once the service is created. Mutually exclusive with - flag --data-catalog-sync. This can be provided as a fully-qualified - URL, or a relative name in the form - projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{crypto_key_id}. + Encryption configuration for the metastore service. + + --encryption-kms-key=ENCRYPTION_KMS_KEY + The name of the Cloud KMS key to use for customer data encryption. + Cannot be changed once the service is created. Mutually exclusive + with flag --data-catalog-sync. This can be provided as a + fully-qualified URL, or a relative name in the form + projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{crypto_key_id}. --endpoint-protocol=ENDPOINT_PROTOCOL; default="thrift" The protocol to use for the metastore service endpoint. If unspecified, diff --git a/gcloud/migration/vms/image-imports/create b/gcloud/migration/vms/image-imports/create index 7b22cdbe8..996f56b57 100644 --- a/gcloud/migration/vms/image-imports/create +++ b/gcloud/migration/vms/image-imports/create @@ -10,8 +10,8 @@ SYNOPSIS [--image-name=IMAGE_NAME] [--kms-key=KMS_KEY] [--labels=[KEY=VALUE,...]] [--single-region-storage] [--target-project=TARGET_PROJECT] - [--skip-os-adaptation | --generalize --license-type=LICENSE_TYPE] - [GCLOUD_WIDE_FLAG ...] + [--skip-os-adaptation | --boot-conversion=BOOT_CONVERSION + --generalize --license-type=LICENSE_TYPE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION gcloud migration vms image-imports create imports images such as VMWare @@ -108,6 +108,15 @@ OPTIONAL FLAGS --skip-os-adaptation If true, skip OS adaptation. Default false. + --boot-conversion=BOOT_CONVERSION + This property will trigger an internal process which will convert the + image from using the existing boot option to another. The size of the + boot disk might be increased to allow the conversion. Currently only + support BIOS_TO_EFI. + + BOOT_CONVERSION must be one of: bios-to-efi, + boot-conversion-unspecified, none. + --generalize If true, generalize the imported image. Default false. The generalization process enables co-existence of multiple VMs created diff --git a/gcloud/migration/vms/machine-image-imports/create b/gcloud/migration/vms/machine-image-imports/create index 0da0bb775..a12f414ed 100644 --- a/gcloud/migration/vms/machine-image-imports/create +++ b/gcloud/migration/vms/machine-image-imports/create @@ -15,8 +15,8 @@ SYNOPSIS [--target-project=TARGET_PROJECT] [--enable-integrity-monitoring --enable-vtpm --secure-boot=SECURE_BOOT] [--scopes=[SCOPES,...] --service-account=SERVICE_ACCOUNT] - [--skip-os-adaptation | --generalize --license-type=LICENSE_TYPE] - [GCLOUD_WIDE_FLAG ...] + [--skip-os-adaptation | --boot-conversion=BOOT_CONVERSION + --generalize --license-type=LICENSE_TYPE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION gcloud migration vms machine-image-imports create Imports machine images @@ -157,6 +157,13 @@ OPTIONAL FLAGS --skip-os-adaptation If true, skip OS adaptation. Default false. + --boot-conversion=BOOT_CONVERSION + This property will trigger an internal process which will convert the + image from using the existing boot option to another. The size of the + boot disk might be increased to allow the conversion. Currently only + support BIOS_TO_EFI. BOOT_CONVERSION must be one of: bios-to-efi, + boot-conversion-unspecified, none. + --generalize If true, generalize the imported machine image. Default false. The generalization process enables co-existence of multiple VMs created diff --git a/gcloud/network-security/security-profiles/threat-prevention/add-override b/gcloud/network-security/security-profiles/threat-prevention/add-override index e05f993a0..30ea417b4 100644 --- a/gcloud/network-security/security-profiles/threat-prevention/add-override +++ b/gcloud/network-security/security-profiles/threat-prevention/add-override @@ -6,14 +6,15 @@ SYNOPSIS gcloud network-security security-profiles threat-prevention add-override (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) --action=ACTION - (--severities=[SEVERITY_LEVEL,...] | --threat-ids=[THREAT-ID,...]) - [--async] [--update-labels=[KEY=VALUE,...]] + (--antivirus=[PROTOCOL,...] | --severities=[SEVERITY_LEVEL,...] + | --threat-ids=[THREAT-ID,...]) [--async] + [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Add severities or threat-ids to existing threat prevention profile with - intended action on each specified. Check the updates of add-override - command by using gcloud network-security security-profiles + Add antivirus, severities, or threat-ids to existing threat prevention + profile with intended action on each specified. Check the updates of + add-override command by using gcloud network-security security-profiles threat-prevention list-override my-security-profile. For more examples, refer to the EXAMPLES section below. @@ -65,11 +66,15 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --action=ACTION - Action associated with severity or threat-id. ACTION must be one of: - DEFAULT_ACTION, ALLOW, ALERT, DENY. + Action associated with antivirus, severity, or threat-id. ACTION must + be one of: DEFAULT_ACTION, ALLOW, ALERT, DENY. Exactly one of these must be specified: + --antivirus=[PROTOCOL,...] + List of comma-separated protocols where each value in the list + indicates the protocol of the antivirus threat. + --severities=[SEVERITY_LEVEL,...] List of comma-separated severities where each value in the list indicates the severity of the threat. diff --git a/gcloud/network-security/security-profiles/threat-prevention/delete-override b/gcloud/network-security/security-profiles/threat-prevention/delete-override index 92b0b3471..0c00c594b 100644 --- a/gcloud/network-security/security-profiles/threat-prevention/delete-override +++ b/gcloud/network-security/security-profiles/threat-prevention/delete-override @@ -5,14 +5,15 @@ NAME SYNOPSIS gcloud network-security security-profiles threat-prevention delete-override (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) - (--severities=[SEVERITY_LEVEL,...] | --threat-ids=[THREAT-ID,...]) - [--async] [--update-labels=[KEY=VALUE,...]] + (--antivirus=[PROTOCOL,...] | --severities=[SEVERITY_LEVEL,...] + | --threat-ids=[THREAT-ID,...]) [--async] + [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - To delete existing severities or threat-ids of threat prevention profile. - Check the updates of update-override command by using gcloud - network-security security-profiles threat-prevention list-override + To delete existing antivirus, severities, or threat-ids of threat + prevention profile. Check the updates of update-override command by using + gcloud network-security security-profiles threat-prevention list-override my-security-profile. For more examples, refer to the EXAMPLES section below. @@ -64,6 +65,10 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS Exactly one of these must be specified: + --antivirus=[PROTOCOL,...] + List of comma-separated protocols where each value in the list + indicates the protocol of the antivirus threat. + --severities=[SEVERITY_LEVEL,...] List of comma-separated severities where each value in the list indicates the severity of the threat. diff --git a/gcloud/network-security/security-profiles/threat-prevention/list-overrides b/gcloud/network-security/security-profiles/threat-prevention/list-overrides index 206802156..8ac4afee4 100644 --- a/gcloud/network-security/security-profiles/threat-prevention/list-overrides +++ b/gcloud/network-security/security-profiles/threat-prevention/list-overrides @@ -8,7 +8,8 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - To list existing severities or threat-ids of threat prevention profile. + To list existing antivirus, severities, or threat-ids of threat prevention + profile. For more examples, refer to the EXAMPLES section below. diff --git a/gcloud/network-security/security-profiles/threat-prevention/update-override b/gcloud/network-security/security-profiles/threat-prevention/update-override index aa96e46ff..efc58106e 100644 --- a/gcloud/network-security/security-profiles/threat-prevention/update-override +++ b/gcloud/network-security/security-profiles/threat-prevention/update-override @@ -6,15 +6,16 @@ SYNOPSIS gcloud network-security security-profiles threat-prevention update-override (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) --action=ACTION - (--severities=[SEVERITY_LEVEL,...] | --threat-ids=[THREAT-ID,...]) - [--async] [--update-labels=[KEY=VALUE,...]] + (--antivirus=[PROTOCOL,...] | --severities=[SEVERITY_LEVEL,...] + | --threat-ids=[THREAT-ID,...]) [--async] + [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - To update existing severities or threat-ids of threat prevention profile - with intended action on each specified. Check the updates of - update-override command by using gcloud network-security security-profiles - threat-prevention list-override my-security-profile. + To update existing antivirus, severities, or threat-ids of threat + prevention profile with intended action on each specified. Check the + updates of update-override command by using gcloud network-security + security-profiles threat-prevention list-override my-security-profile. For more examples, refer to the EXAMPLES section below. @@ -65,11 +66,15 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --action=ACTION - Action associated with severity or threat-id. ACTION must be one of: - DEFAULT_ACTION, ALLOW, ALERT, DENY. + Action associated with antivirus, severity, or threat-id. ACTION must + be one of: DEFAULT_ACTION, ALLOW, ALERT, DENY. Exactly one of these must be specified: + --antivirus=[PROTOCOL,...] + List of comma-separated protocols where each value in the list + indicates the protocol of the antivirus threat. + --severities=[SEVERITY_LEVEL,...] List of comma-separated severities where each value in the list indicates the severity of the threat. diff --git a/gcloud/redis/clusters/update b/gcloud/redis/clusters/update index a44b84be3..f31dbd037 100644 --- a/gcloud/redis/clusters/update +++ b/gcloud/redis/clusters/update @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud redis clusters update (CLUSTER : --region=REGION) [--aof-append-fsync=AOF_APPEND_FSYNC] [--async] [--deletion-protection] + [--node-type=NODE_TYPE] [--ondemand-maintenance] [--persistence-mode=PERSISTENCE_MODE] [--rdb-snapshot-period=RDB_SNAPSHOT_PERIOD] [--rdb-snapshot-start-time=RDB_SNAPSHOT_START_TIME] @@ -83,6 +84,14 @@ FLAGS Enable deletion protection for the Redis Cluster. Use --deletion-protection/--no-deletion-protection to enable/disable it. + --node-type=NODE_TYPE + Node Type of the redis cluster Node. NODE_TYPE must be one of: + redis-highmem-medium, redis-highmem-xlarge, redis-shared-core-nano, + redis-standard-small. + + --ondemand-maintenance + Trigger an on-demand maintenance. + --persistence-mode=PERSISTENCE_MODE Operation mode for persistence. PERSISTENCE_MODE must be one of: diff --git a/gcloud/workflows/deploy b/gcloud/workflows/deploy index f7ffc5dc9..64327b7de 100644 --- a/gcloud/workflows/deploy +++ b/gcloud/workflows/deploy @@ -7,7 +7,7 @@ SYNOPSIS [--description=DESCRIPTION] [--execution-history-level=EXECUTION_HISTORY_LEVEL; default="none"] [--labels=[KEY=VALUE,...]] [--service-account=SERVICE_ACCOUNT] - [--source=SOURCE] [GCLOUD_WIDE_FLAG ...] + [--source=SOURCE] [--tags=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create or update a workflow. @@ -113,6 +113,12 @@ FLAGS deployment. Location needs to be defined as a path to a local file with the source code. + --tags=[KEY=VALUE,...] + List of tags KEY=VALUE pairs to bind. Each item must be expressed as + "=". + + Example: 123/environment=production,123/costCenter=marketing + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format,