From 971306823a0a42e3bac835ee46c048571bcee7b7 Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 16 Mar 2022 08:47:18 +0000 Subject: [PATCH] gcloud: Wed Mar 16 08:47:18 UTC 2022 --- gcloud/_version | 10 +- gcloud/alpha/artifacts/operations/describe | 4 +- gcloud/alpha/artifacts/packages/delete | 4 +- gcloud/alpha/artifacts/packages/list | 4 +- .../repositories/add-iam-policy-binding | 4 +- gcloud/alpha/artifacts/repositories/delete | 4 +- gcloud/alpha/artifacts/repositories/describe | 4 +- .../artifacts/repositories/get-iam-policy | 4 +- .../repositories/remove-iam-policy-binding | 4 +- .../artifacts/repositories/set-iam-policy | 4 +- gcloud/alpha/artifacts/repositories/update | 4 +- gcloud/alpha/artifacts/tags/create | 4 +- gcloud/alpha/artifacts/tags/delete | 4 +- gcloud/alpha/artifacts/tags/list | 4 +- gcloud/alpha/artifacts/tags/update | 4 +- gcloud/alpha/artifacts/versions/delete | 4 +- gcloud/alpha/artifacts/versions/list | 4 +- gcloud/alpha/auth/login | 5 +- gcloud/alpha/bms/instances/list | 11 +- gcloud/alpha/bms/instances/start | 4 +- gcloud/alpha/bms/instances/update | 4 +- gcloud/alpha/bms/networks/update | 4 +- gcloud/alpha/bms/nfs-shares/describe | 4 +- gcloud/alpha/bms/nfs-shares/help | 4 +- gcloud/alpha/bms/nfs-shares/list | 4 +- gcloud/alpha/bms/nfs-shares/update | 4 +- gcloud/alpha/bms/volumes/list | 11 +- gcloud/alpha/bms/volumes/update | 54 +-- .../alpha/composer/environments/check-upgrade | 2 +- gcloud/alpha/composer/environments/create | 6 +- gcloud/alpha/composer/environments/update | 2 +- gcloud/alpha/compute/backend-services/create | 8 +- gcloud/alpha/compute/backend-services/update | 8 +- gcloud/alpha/compute/commitments/create | 6 +- gcloud/alpha/compute/routers/nats/create | 17 +- gcloud/alpha/compute/routers/nats/update | 17 +- gcloud/alpha/compute/scp | 6 +- gcloud/alpha/compute/snapshots/create | 22 +- .../compute/sole-tenancy/node-groups/create | 2 +- .../compute/sole-tenancy/node-groups/update | 2 +- gcloud/alpha/compute/ssh | 6 +- gcloud/alpha/compute/start-iap-tunnel | 7 +- gcloud/alpha/container/aws/node-pools/update | 6 +- gcloud/alpha/container/clusters/create | 10 +- gcloud/alpha/container/node-pools/create | 13 +- gcloud/alpha/dns/managed-zones/get-iam-policy | 46 +++ gcloud/alpha/dns/managed-zones/help | 6 + gcloud/alpha/dns/managed-zones/set-iam-policy | 52 +++ gcloud/alpha/functions/deploy | 2 + gcloud/alpha/iam/service-accounts/undelete | 4 +- gcloud/alpha/network-services/help | 3 - gcloud/alpha/network-services/routers/delete | 61 --- gcloud/alpha/network-services/routers/export | 64 --- gcloud/alpha/network-services/routers/help | 35 -- gcloud/alpha/network-services/routers/import | 71 ---- gcloud/alpha/network-services/routers/list | 77 ---- gcloud/alpha/transfer/agent-pools/create | 4 +- gcloud/alpha/transfer/agent-pools/delete | 4 +- gcloud/alpha/transfer/agent-pools/describe | 4 +- gcloud/alpha/transfer/agent-pools/help | 4 +- gcloud/alpha/transfer/agent-pools/list | 4 +- gcloud/alpha/transfer/agent-pools/update | 4 +- gcloud/alpha/transfer/agents/delete | 4 +- gcloud/alpha/transfer/agents/help | 4 +- gcloud/alpha/transfer/agents/install | 4 +- gcloud/alpha/transfer/authorize | 4 +- gcloud/alpha/transfer/help | 6 +- gcloud/alpha/transfer/jobs/create | 4 +- gcloud/alpha/transfer/jobs/delete | 4 +- gcloud/alpha/transfer/jobs/describe | 4 +- gcloud/alpha/transfer/jobs/help | 4 +- gcloud/alpha/transfer/jobs/list | 4 +- gcloud/alpha/transfer/jobs/monitor | 4 +- gcloud/alpha/transfer/jobs/run | 4 +- gcloud/alpha/transfer/jobs/update | 4 +- gcloud/alpha/transfer/operations/cancel | 4 +- gcloud/alpha/transfer/operations/describe | 4 +- gcloud/alpha/transfer/operations/help | 4 +- gcloud/alpha/transfer/operations/list | 4 +- gcloud/alpha/transfer/operations/monitor | 4 +- gcloud/alpha/transfer/operations/pause | 4 +- gcloud/alpha/transfer/operations/resume | 4 +- gcloud/artifacts/operations/describe | 4 +- gcloud/artifacts/packages/delete | 4 +- gcloud/artifacts/packages/list | 4 +- .../repositories/add-iam-policy-binding | 4 +- gcloud/artifacts/repositories/create | 6 +- gcloud/artifacts/repositories/delete | 4 +- gcloud/artifacts/repositories/describe | 4 +- gcloud/artifacts/repositories/get-iam-policy | 4 +- .../repositories/remove-iam-policy-binding | 4 +- gcloud/artifacts/repositories/set-iam-policy | 4 +- gcloud/artifacts/repositories/update | 4 +- gcloud/artifacts/tags/create | 4 +- gcloud/artifacts/tags/delete | 4 +- gcloud/artifacts/tags/list | 4 +- gcloud/artifacts/tags/update | 4 +- gcloud/artifacts/versions/delete | 4 +- gcloud/artifacts/versions/list | 4 +- gcloud/auth/application-default/login | 5 +- gcloud/auth/login | 5 +- gcloud/beta/artifacts/operations/describe | 4 +- gcloud/beta/artifacts/packages/delete | 4 +- gcloud/beta/artifacts/packages/list | 4 +- .../repositories/add-iam-policy-binding | 4 +- gcloud/beta/artifacts/repositories/delete | 4 +- gcloud/beta/artifacts/repositories/describe | 4 +- .../artifacts/repositories/get-iam-policy | 4 +- .../repositories/remove-iam-policy-binding | 4 +- .../artifacts/repositories/set-iam-policy | 4 +- gcloud/beta/artifacts/repositories/update | 4 +- gcloud/beta/artifacts/tags/create | 4 +- gcloud/beta/artifacts/tags/delete | 4 +- gcloud/beta/artifacts/tags/list | 4 +- gcloud/beta/artifacts/tags/update | 4 +- gcloud/beta/artifacts/versions/delete | 4 +- gcloud/beta/artifacts/versions/list | 4 +- gcloud/beta/auth/application-default/login | 5 +- gcloud/beta/auth/login | 5 +- .../beta/composer/environments/check-upgrade | 2 +- gcloud/beta/composer/environments/create | 6 +- gcloud/beta/composer/environments/update | 2 +- gcloud/beta/compute/routers/nats/create | 11 +- gcloud/beta/compute/routers/nats/update | 11 +- gcloud/beta/container/clusters/create | 10 +- gcloud/beta/container/node-pools/create | 13 +- gcloud/beta/functions/deploy | 2 + gcloud/beta/iam/service-accounts/undelete | 6 +- gcloud/beta/privateca/certificates/create | 2 +- gcloud/beta/privateca/roots/create | 24 +- gcloud/beta/privateca/subordinates/create | 16 +- gcloud/bms/help | 3 + gcloud/bms/instances/help | 6 + gcloud/bms/instances/list | 11 +- gcloud/bms/instances/start | 64 +++ gcloud/bms/instances/update | 96 +++++ gcloud/bms/networks/help | 3 + gcloud/bms/networks/update | 96 +++++ gcloud/bms/nfs-shares/describe | 56 +++ gcloud/bms/nfs-shares/help | 31 ++ gcloud/bms/nfs-shares/list | 62 +++ gcloud/bms/nfs-shares/update | 101 +++++ gcloud/bms/volumes/help | 3 + gcloud/bms/volumes/list | 11 +- gcloud/bms/volumes/update | 93 +++++ gcloud/composer/environments/create | 6 +- gcloud/compute/routers/nats/create | 11 +- gcloud/compute/routers/nats/update | 11 +- gcloud/container/aws/node-pools/update | 6 +- gcloud/functions/deploy | 2 + gcloud/iam/service-accounts/help | 3 + gcloud/iam/service-accounts/undelete | 44 ++ gcloud/network-connectivity/help | 3 + .../network-connectivity/locations/describe | 44 ++ gcloud/network-connectivity/locations/help | 23 ++ gcloud/network-connectivity/locations/list | 69 ++++ gcloud/privateca/certificates/create | 2 +- gcloud/privateca/roots/create | 10 +- gcloud/privateca/subordinates/create | 16 +- gcloud/redis/instances/create | 26 +- gcloud/redis/instances/update | 32 +- gcloud/transfer/agent-pools/create | 59 +++ gcloud/transfer/agent-pools/delete | 39 ++ gcloud/transfer/agent-pools/describe | 32 ++ gcloud/transfer/agent-pools/help | 37 ++ gcloud/transfer/agent-pools/list | 50 +++ gcloud/transfer/agent-pools/update | 66 +++ gcloud/transfer/agents/delete | 49 +++ gcloud/transfer/agents/help | 31 ++ gcloud/transfer/agents/install | 98 +++++ gcloud/transfer/authorize | 55 +++ gcloud/transfer/help | 46 +++ gcloud/transfer/jobs/create | 335 +++++++++++++++ gcloud/transfer/jobs/delete | 31 ++ gcloud/transfer/jobs/describe | 41 ++ gcloud/transfer/jobs/help | 43 ++ gcloud/transfer/jobs/list | 70 ++++ gcloud/transfer/jobs/monitor | 40 ++ gcloud/transfer/jobs/run | 36 ++ gcloud/transfer/jobs/update | 390 ++++++++++++++++++ gcloud/transfer/operations/cancel | 31 ++ gcloud/transfer/operations/describe | 32 ++ gcloud/transfer/operations/help | 40 ++ gcloud/transfer/operations/list | 73 ++++ gcloud/transfer/operations/monitor | 37 ++ gcloud/transfer/operations/pause | 32 ++ gcloud/transfer/operations/resume | 32 ++ 187 files changed, 3248 insertions(+), 630 deletions(-) create mode 100644 gcloud/alpha/dns/managed-zones/get-iam-policy create mode 100644 gcloud/alpha/dns/managed-zones/set-iam-policy delete mode 100644 gcloud/alpha/network-services/routers/delete delete mode 100644 gcloud/alpha/network-services/routers/export delete mode 100644 gcloud/alpha/network-services/routers/help delete mode 100644 gcloud/alpha/network-services/routers/import delete mode 100644 gcloud/alpha/network-services/routers/list create mode 100644 gcloud/bms/instances/start create mode 100644 gcloud/bms/instances/update create mode 100644 gcloud/bms/networks/update create mode 100644 gcloud/bms/nfs-shares/describe create mode 100644 gcloud/bms/nfs-shares/help create mode 100644 gcloud/bms/nfs-shares/list create mode 100644 gcloud/bms/nfs-shares/update create mode 100644 gcloud/bms/volumes/update create mode 100644 gcloud/iam/service-accounts/undelete create mode 100644 gcloud/network-connectivity/locations/describe create mode 100644 gcloud/network-connectivity/locations/help create mode 100644 gcloud/network-connectivity/locations/list create mode 100644 gcloud/transfer/agent-pools/create create mode 100644 gcloud/transfer/agent-pools/delete create mode 100644 gcloud/transfer/agent-pools/describe create mode 100644 gcloud/transfer/agent-pools/help create mode 100644 gcloud/transfer/agent-pools/list create mode 100644 gcloud/transfer/agent-pools/update create mode 100644 gcloud/transfer/agents/delete create mode 100644 gcloud/transfer/agents/help create mode 100644 gcloud/transfer/agents/install create mode 100644 gcloud/transfer/authorize create mode 100644 gcloud/transfer/help create mode 100644 gcloud/transfer/jobs/create create mode 100644 gcloud/transfer/jobs/delete create mode 100644 gcloud/transfer/jobs/describe create mode 100644 gcloud/transfer/jobs/help create mode 100644 gcloud/transfer/jobs/list create mode 100644 gcloud/transfer/jobs/monitor create mode 100644 gcloud/transfer/jobs/run create mode 100644 gcloud/transfer/jobs/update create mode 100644 gcloud/transfer/operations/cancel create mode 100644 gcloud/transfer/operations/describe create mode 100644 gcloud/transfer/operations/help create mode 100644 gcloud/transfer/operations/list create mode 100644 gcloud/transfer/operations/monitor create mode 100644 gcloud/transfer/operations/pause create mode 100644 gcloud/transfer/operations/resume diff --git a/gcloud/_version b/gcloud/_version index b1d2283bf..655cdc143 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,6 +1,6 @@ -Google Cloud SDK 376.0.0 -alpha 2022.03.04 -beta 2022.03.04 +Google Cloud SDK 377.0.0 +alpha 2022.03.10 +beta 2022.03.10 bq 2.0.74 -core 2022.03.04 -gsutil 5.6 +core 2022.03.10 +gsutil 5.8 diff --git a/gcloud/alpha/artifacts/operations/describe b/gcloud/alpha/artifacts/operations/describe index bf94cafbe..1cb334aeb 100644 --- a/gcloud/alpha/artifacts/operations/describe +++ b/gcloud/alpha/artifacts/operations/describe @@ -61,8 +61,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/artifacts/packages/delete b/gcloud/alpha/artifacts/packages/delete index baf713f62..8d11e3f03 100644 --- a/gcloud/alpha/artifacts/packages/delete +++ b/gcloud/alpha/artifacts/packages/delete @@ -77,8 +77,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/artifacts/packages/list b/gcloud/alpha/artifacts/packages/list index 995e0068a..e8a13fbc2 100644 --- a/gcloud/alpha/artifacts/packages/list +++ b/gcloud/alpha/artifacts/packages/list @@ -83,8 +83,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/artifacts/repositories/add-iam-policy-binding b/gcloud/alpha/artifacts/repositories/add-iam-policy-binding index e7102ca28..7bda35832 100644 --- a/gcloud/alpha/artifacts/repositories/add-iam-policy-binding +++ b/gcloud/alpha/artifacts/repositories/add-iam-policy-binding @@ -128,8 +128,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/artifacts/repositories/delete b/gcloud/alpha/artifacts/repositories/delete index 65d456b4b..2e561b9da 100644 --- a/gcloud/alpha/artifacts/repositories/delete +++ b/gcloud/alpha/artifacts/repositories/delete @@ -65,8 +65,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/artifacts/repositories/describe b/gcloud/alpha/artifacts/repositories/describe index 54e7acc27..98f630689 100644 --- a/gcloud/alpha/artifacts/repositories/describe +++ b/gcloud/alpha/artifacts/repositories/describe @@ -56,8 +56,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/artifacts/repositories/get-iam-policy b/gcloud/alpha/artifacts/repositories/get-iam-policy index 507592640..691f3018b 100644 --- a/gcloud/alpha/artifacts/repositories/get-iam-policy +++ b/gcloud/alpha/artifacts/repositories/get-iam-policy @@ -91,8 +91,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/artifacts/repositories/remove-iam-policy-binding b/gcloud/alpha/artifacts/repositories/remove-iam-policy-binding index 1fa0049ef..39fa68094 100644 --- a/gcloud/alpha/artifacts/repositories/remove-iam-policy-binding +++ b/gcloud/alpha/artifacts/repositories/remove-iam-policy-binding @@ -135,8 +135,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/artifacts/repositories/set-iam-policy b/gcloud/alpha/artifacts/repositories/set-iam-policy index 94a023e8c..48da70e13 100644 --- a/gcloud/alpha/artifacts/repositories/set-iam-policy +++ b/gcloud/alpha/artifacts/repositories/set-iam-policy @@ -70,8 +70,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/artifacts/repositories/update b/gcloud/alpha/artifacts/repositories/update index 347225d26..0f71e6b4e 100644 --- a/gcloud/alpha/artifacts/repositories/update +++ b/gcloud/alpha/artifacts/repositories/update @@ -96,8 +96,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/artifacts/tags/create b/gcloud/alpha/artifacts/tags/create index 668bf05fb..3233c2b10 100644 --- a/gcloud/alpha/artifacts/tags/create +++ b/gcloud/alpha/artifacts/tags/create @@ -87,8 +87,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/artifacts/tags/delete b/gcloud/alpha/artifacts/tags/delete index 1213e6adb..e73c17515 100644 --- a/gcloud/alpha/artifacts/tags/delete +++ b/gcloud/alpha/artifacts/tags/delete @@ -82,8 +82,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/artifacts/tags/list b/gcloud/alpha/artifacts/tags/list index 9cd6b5582..d8900689d 100644 --- a/gcloud/alpha/artifacts/tags/list +++ b/gcloud/alpha/artifacts/tags/list @@ -105,8 +105,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/artifacts/tags/update b/gcloud/alpha/artifacts/tags/update index 4689a2030..40f653c27 100644 --- a/gcloud/alpha/artifacts/tags/update +++ b/gcloud/alpha/artifacts/tags/update @@ -87,8 +87,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/artifacts/versions/delete b/gcloud/alpha/artifacts/versions/delete index 3efc68945..0f3162f6f 100644 --- a/gcloud/alpha/artifacts/versions/delete +++ b/gcloud/alpha/artifacts/versions/delete @@ -90,8 +90,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/artifacts/versions/list b/gcloud/alpha/artifacts/versions/list index 6fb2589e2..50a7ecb2f 100644 --- a/gcloud/alpha/artifacts/versions/list +++ b/gcloud/alpha/artifacts/versions/list @@ -97,8 +97,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/auth/login b/gcloud/alpha/auth/login index e2e15cefe..367d5f4af 100644 --- a/gcloud/alpha/auth/login +++ b/gcloud/alpha/auth/login @@ -83,8 +83,9 @@ FLAGS to be copied. The --[no-]launch-browser flags are deprecated and will be removed in - future updates. Use --no-browser to replace --no-launch-browser. - Enabled by default, use --no-launch-browser to disable. + version 383.0.0 (04/26/2022). Use --no-browser to replace + --no-launch-browser. Enabled by default, use --no-launch-browser to + disable. --update-adc Write the obtained credentials to the well-known location for diff --git a/gcloud/alpha/bms/instances/list b/gcloud/alpha/bms/instances/list index d5fd0b486..c7fdb7a48 100644 --- a/gcloud/alpha/bms/instances/list +++ b/gcloud/alpha/bms/instances/list @@ -3,8 +3,8 @@ NAME project SYNOPSIS - gcloud alpha bms instances list --region=REGION [--limit=LIMIT] - [GCLOUD_WIDE_FLAG ...] + gcloud alpha bms instances list --region=REGION [--filter=EXPRESSION] + [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) List Bare Metal Solution instances in a project. @@ -35,6 +35,13 @@ FLAGS ▸ provide the argument --region on the command line. LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --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: diff --git a/gcloud/alpha/bms/instances/start b/gcloud/alpha/bms/instances/start index 9885b016c..1cf579fa5 100644 --- a/gcloud/alpha/bms/instances/start +++ b/gcloud/alpha/bms/instances/start @@ -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 bms instances start diff --git a/gcloud/alpha/bms/instances/update b/gcloud/alpha/bms/instances/update index 606e0b594..695aa0268 100644 --- a/gcloud/alpha/bms/instances/update +++ b/gcloud/alpha/bms/instances/update @@ -93,5 +93,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud bms instances update diff --git a/gcloud/alpha/bms/networks/update b/gcloud/alpha/bms/networks/update index 24b70be94..73dd66699 100644 --- a/gcloud/alpha/bms/networks/update +++ b/gcloud/alpha/bms/networks/update @@ -93,5 +93,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud bms networks update diff --git a/gcloud/alpha/bms/nfs-shares/describe b/gcloud/alpha/bms/nfs-shares/describe index 3e97f52a3..201423ba1 100644 --- a/gcloud/alpha/bms/nfs-shares/describe +++ b/gcloud/alpha/bms/nfs-shares/describe @@ -54,5 +54,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 bms nfs-shares describe diff --git a/gcloud/alpha/bms/nfs-shares/help b/gcloud/alpha/bms/nfs-shares/help index 3d180ca8c..5bb8789b6 100644 --- a/gcloud/alpha/bms/nfs-shares/help +++ b/gcloud/alpha/bms/nfs-shares/help @@ -28,5 +28,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud bms nfs-shares diff --git a/gcloud/alpha/bms/nfs-shares/list b/gcloud/alpha/bms/nfs-shares/list index 55e7d18c8..2dc6ef61e 100644 --- a/gcloud/alpha/bms/nfs-shares/list +++ b/gcloud/alpha/bms/nfs-shares/list @@ -59,5 +59,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 bms nfs-shares list diff --git a/gcloud/alpha/bms/nfs-shares/update b/gcloud/alpha/bms/nfs-shares/update index 0f05c747e..35f88ea2d 100644 --- a/gcloud/alpha/bms/nfs-shares/update +++ b/gcloud/alpha/bms/nfs-shares/update @@ -98,5 +98,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 bms nfs-shares update diff --git a/gcloud/alpha/bms/volumes/list b/gcloud/alpha/bms/volumes/list index f6ecc0897..39b29ba88 100644 --- a/gcloud/alpha/bms/volumes/list +++ b/gcloud/alpha/bms/volumes/list @@ -3,8 +3,8 @@ NAME project SYNOPSIS - gcloud alpha bms volumes list --region=REGION [--limit=LIMIT] - [GCLOUD_WIDE_FLAG ...] + gcloud alpha bms volumes list --region=REGION [--filter=EXPRESSION] + [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) List Bare Metal Solution volumes in a project. @@ -35,6 +35,13 @@ FLAGS ▸ provide the argument --region on the command line. LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --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: diff --git a/gcloud/alpha/bms/volumes/update b/gcloud/alpha/bms/volumes/update index 4e384edb0..9651a6467 100644 --- a/gcloud/alpha/bms/volumes/update +++ b/gcloud/alpha/bms/volumes/update @@ -3,11 +3,8 @@ NAME SYNOPSIS gcloud alpha bms volumes update (VOLUME : --region=REGION) - [--snapshot-auto-delete=SNAPSHOT_AUTO_DELETE] [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] - [--snapshot-schedule-policy=SNAPSHOT_SCHEDULE_POLICY - : --remove-snapshot-schedule-policy] [GCLOUD_WIDE_FLAG ...] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update a Bare Metal Solution volume. @@ -17,14 +14,6 @@ DESCRIPTION describe command for the volume. EXAMPLES - To update a volume called my-volume in region us-central1 with a new - snapshot schedule policy my-policy and snapshot auto delete behavior - oldest-first, run: - - $ gcloud alpha bms volumes update my-volume --region=us-central1 \ - --snapshot-schedule-policy=my-policy \ - --snapshot-auto-delete=oldest-first - To add the label 'key1=value1' to a policy, run: $ gcloud alpha bms volumes update my-volume \ @@ -61,18 +50,6 @@ POSITIONAL ARGUMENTS ▸ provide the argument --region on the command line. FLAGS - --snapshot-auto-delete=SNAPSHOT_AUTO_DELETE - Behavior of the disk when snapshot reserved space is full. - SNAPSHOT_AUTO_DELETE must be one of: - - disabled - Don't delete any snapshots. This disables new snapshot creation as - long as the snapshot reserved space is full. - newest-first - Delete the newest snapshot first. - oldest-first - Delete the oldest snapshot first. - --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. @@ -102,31 +79,6 @@ FLAGS silently ignored. If --update-labels is also specified then --update-labels is applied first. - At most one of these can be specified: - - Snapshot schedule policy resource - snapshot_schedule_policy. 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 --snapshot-schedule-policy on the command line - with a fully specified name; - ▸ set the property core/project; - ▸ provide the argument --project on the command line. To set the - region attribute: - ▸ provide the argument --snapshot-schedule-policy on the command line - with a fully specified name; - ▸ global is the only supported location. - - --snapshot-schedule-policy=SNAPSHOT_SCHEDULE_POLICY - ID of the snapshot_schedule_policy or fully qualified identifier - for the snapshot_schedule_policy. To set the - snapshot_schedule_policy attribute: - ▫ provide the argument --snapshot-schedule-policy on the command - line. - - --remove-snapshot-schedule-policy - Remove any existing snapshot schedule policy. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, @@ -139,5 +91,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud bms volumes update diff --git a/gcloud/alpha/composer/environments/check-upgrade b/gcloud/alpha/composer/environments/check-upgrade index 545dd64f0..fc3b84a89 100644 --- a/gcloud/alpha/composer/environments/check-upgrade +++ b/gcloud/alpha/composer/environments/check-upgrade @@ -71,7 +71,7 @@ FLAGS The image version encapsulates the versions of both Cloud Composer and Apache Airflow. Must be of the form - composer-A.B.C[-D.E]-airflow-X.Y[.Z]. + composer-A[.B.C[-D.E]]-airflow-X.Y[.Z]. The Cloud Composer and Airflow versions are semantic versions. latest can be provided instead of an explicit Cloud Composer version number diff --git a/gcloud/alpha/composer/environments/create b/gcloud/alpha/composer/environments/create index 7d077769e..ce56cc36e 100644 --- a/gcloud/alpha/composer/environments/create +++ b/gcloud/alpha/composer/environments/create @@ -187,15 +187,15 @@ FLAGS Must be of the form `X.Y[.Z]`. - The latest supported Cloud Composer version will be used within - the created environment. + The current Cloud Composer version will be used within the created + environment. --image-version=IMAGE_VERSION Version of the image to run in the environment. The image version encapsulates the versions of both Cloud Composer and Apache Airflow. Must be of the form - `composer-A.B.C[-D.E]-airflow-X.Y[.Z]`. + `composer-A[.B.C[-D.E]]-airflow-X.Y[.Z]`. The Cloud Composer and Airflow versions are semantic versions. `latest` can be provided instead of an explicit Cloud Composer diff --git a/gcloud/alpha/composer/environments/update b/gcloud/alpha/composer/environments/update index 19608e055..b4035758d 100644 --- a/gcloud/alpha/composer/environments/update +++ b/gcloud/alpha/composer/environments/update @@ -112,7 +112,7 @@ REQUIRED FLAGS The image version encapsulates the versions of both Cloud Composer and Apache Airflow. Must be of the form - composer-A.B.C[-D.E]-airflow-X.Y[.Z]. + composer-A[.B.C[-D.E]]-airflow-X.Y[.Z]. The Cloud Composer and Airflow versions are semantic versions. latest can be provided instead of an explicit Cloud Composer diff --git a/gcloud/alpha/compute/backend-services/create b/gcloud/alpha/compute/backend-services/create index a0f80e8e8..dc45c90f0 100644 --- a/gcloud/alpha/compute/backend-services/create +++ b/gcloud/alpha/compute/backend-services/create @@ -258,8 +258,9 @@ FLAGS --[no-]enable-logging The logging options for the load balancer traffic served by this backend service. If logging is enabled, logs will be exported to Cloud - Logging. Disabled by default. Use --enable-logging to enable and - --no-enable-logging to disable. + Logging. This can only be specified if the protocol is HTTP, HTTPS, + HTTP2, TCP, or SSL. Disabled by default. Use --enable-logging to enable + and --no-enable-logging to disable. --[no-]enable-strong-affinity Enable or disable strong session affinity. This is only available for @@ -332,7 +333,8 @@ FLAGS service. The value of the field must be a float in the range [0, 1]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no - logged requests are reported. The default value is 1.0. + logged requests are reported. This can only be specified if the + protocol is HTTP, HTTPS, HTTP2, TCP, or SSL. The default value is 1.0. --max-ttl=MAX_TTL Specifies the maximum allowed TTL for cached content served by this diff --git a/gcloud/alpha/compute/backend-services/update b/gcloud/alpha/compute/backend-services/update index db4b6c700..e0115d436 100644 --- a/gcloud/alpha/compute/backend-services/update +++ b/gcloud/alpha/compute/backend-services/update @@ -171,8 +171,9 @@ FLAGS --[no-]enable-logging The logging options for the load balancer traffic served by this backend service. If logging is enabled, logs will be exported to Cloud - Logging. Disabled by default. Use --enable-logging to enable and - --no-enable-logging to disable. + Logging. This can only be specified if the protocol is HTTP, HTTPS, + HTTP2, TCP, or SSL. Disabled by default. Use --enable-logging to enable + and --no-enable-logging to disable. --[no-]enable-strong-affinity Enable or disable strong session affinity. This is only available for @@ -239,7 +240,8 @@ FLAGS service. The value of the field must be a float in the range [0, 1]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no - logged requests are reported. The default value is 1.0. + logged requests are reported. This can only be specified if the + protocol is HTTP, HTTPS, HTTP2, TCP, or SSL. The default value is 1.0. --port-name=PORT_NAME Backend services for external HTTP(S) load balancing, internal HTTP(S) diff --git a/gcloud/alpha/compute/commitments/create b/gcloud/alpha/compute/commitments/create index 53d502ee4..82cdf95f6 100644 --- a/gcloud/alpha/compute/commitments/create +++ b/gcloud/alpha/compute/commitments/create @@ -5,7 +5,8 @@ SYNOPSIS gcloud alpha compute commitments create COMMITMENT --plan=PLAN (--resources=[local-ssd=LOCAL-SSD],[memory=MEMORY],[vcpu=VCPU] --resources-accelerator=[count=COUNT],[type=TYPE]) [--auto-renew] - [--region=REGION] [--split-source-commitment=SPLIT_SOURCE_COMMITMENT] + [--merge-source-commitments=MERGE_SOURCE_COMMITMENTS] [--region=REGION] + [--split-source-commitment=SPLIT_SOURCE_COMMITMENT] [--type=TYPE; default="general-purpose"] [--reservations-from-file=RESERVATIONS_FROM_FILE | [--reservation=RESERVATION : --reservation-zone=RESERVATION_ZONE @@ -65,6 +66,9 @@ OPTIONAL FLAGS --auto-renew Enable auto renewal for the commitment. + --merge-source-commitments=MERGE_SOURCE_COMMITMENTS + Merge the resources of two or more commitments into one new commitment. + --region=REGION Region of the commitment to create. If not specified, you might be prompted to select a region (interactive mode only). diff --git a/gcloud/alpha/compute/routers/nats/create b/gcloud/alpha/compute/routers/nats/create index a8d7d279b..4bc1ad7d6 100644 --- a/gcloud/alpha/compute/routers/nats/create +++ b/gcloud/alpha/compute/routers/nats/create @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud alpha compute routers nats create NAME --router=ROUTER (--nat-all-subnet-ip-ranges - | --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME],[...] + | --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME|ALL],[...] | --nat-primary-subnet-ip-ranges) [--async] [--[no-]enable-dynamic-port-allocation] [--enable-endpoint-independent-mapping] [--enable-logging] @@ -61,12 +61,17 @@ REQUIRED FLAGS Allow all IP ranges of all subnetworks in the region, including primary and secondary ranges, to use NAT. - --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME],[...] + --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME|ALL],[...] List of subnetwork primary and secondary IP ranges to be allowed to - use NAT. [SUBNETWORK]: including a subnetwork name includes only the - primary subnet range of the subnetwork. [SUBNETWORK]:[RANGE_NAME]: - specifying a subnetwork and secondary range name includes only that - secondary range.It does not include the primary range of the subnet. + use NAT. + + ▸ SUBNETWORK:ALL - specifying a subnetwork name with ALL includes + the primary range and all secondary ranges of the subnet. + ▸ SUBNETWORK - including a subnetwork name includes only the + primary subnet range of the subnetwork. + ▸ SUBNETWORK:RANGE_NAME - specifying a subnetwork and secondary + range name includes only that secondary range. It does not include + the primary range of the subnet. --nat-primary-subnet-ip-ranges Allow only primary IP ranges of all subnetworks in the region to use diff --git a/gcloud/alpha/compute/routers/nats/update b/gcloud/alpha/compute/routers/nats/update index cef9734c5..1f33eebb6 100644 --- a/gcloud/alpha/compute/routers/nats/update +++ b/gcloud/alpha/compute/routers/nats/update @@ -22,7 +22,7 @@ SYNOPSIS | --tcp-transitory-idle-timeout=TCP_TRANSITORY_IDLE_TIMEOUT] [--clear-udp-idle-timeout | --udp-idle-timeout=UDP_IDLE_TIMEOUT] [--nat-all-subnet-ip-ranges - | --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME],[...] + | --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME|ALL],[...] | --nat-primary-subnet-ip-ranges] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -240,12 +240,17 @@ OPTIONAL FLAGS Allow all IP ranges of all subnetworks in the region, including primary and secondary ranges, to use NAT. - --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME],[...] + --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME|ALL],[...] List of subnetwork primary and secondary IP ranges to be allowed to - use NAT. [SUBNETWORK]: including a subnetwork name includes only the - primary subnet range of the subnetwork. [SUBNETWORK]:[RANGE_NAME]: - specifying a subnetwork and secondary range name includes only that - secondary range.It does not include the primary range of the subnet. + use NAT. + + ▸ SUBNETWORK:ALL - specifying a subnetwork name with ALL includes + the primary range and all secondary ranges of the subnet. + ▸ SUBNETWORK - including a subnetwork name includes only the + primary subnet range of the subnetwork. + ▸ SUBNETWORK:RANGE_NAME - specifying a subnetwork and secondary + range name includes only that secondary range. It does not include + the primary range of the subnet. --nat-primary-subnet-ip-ranges Allow only primary IP ranges of all subnetworks in the region to use diff --git a/gcloud/alpha/compute/scp b/gcloud/alpha/compute/scp index 0c410ab8d..f0cba24cb 100644 --- a/gcloud/alpha/compute/scp +++ b/gcloud/alpha/compute/scp @@ -9,7 +9,7 @@ SYNOPSIS [--scp-flag=SCP_FLAG] [--ssh-key-file=SSH_KEY_FILE] [--strict-host-key-checking=STRICT_HOST_KEY_CHECKING] [--zone=ZONE] [--internal-ip | --tunnel-through-iap] - [--network=NETWORK --region=REGION] + [--network=NETWORK --region=REGION : --dest-group=DEST_GROUP] [--ssh-key-expiration=SSH_KEY_EXPIRATION | --ssh-key-expire-after=SSH_KEY_EXPIRE_AFTER] [GCLOUD_WIDE_FLAG ...] @@ -177,6 +177,10 @@ FLAGS --region=REGION Configures the region to use when connecting via IP address or FQDN. + --dest-group=DEST_GROUP + Configures the destination group to use when connecting via IP address + or FQDN. + At most one of these can be specified: --ssh-key-expiration=SSH_KEY_EXPIRATION diff --git a/gcloud/alpha/compute/snapshots/create b/gcloud/alpha/compute/snapshots/create index 86ea0e10b..d5405a05a 100644 --- a/gcloud/alpha/compute/snapshots/create +++ b/gcloud/alpha/compute/snapshots/create @@ -6,9 +6,13 @@ SYNOPSIS [--chain-name=CHAIN_NAME] [--csek-key-file=FILE] [--description=DESCRIPTION] [--guest-flush] [--labels=[KEY=VALUE,...]] [--source-disk=SOURCE_DISK] [--source-disk-key-file=FILE] + [--source-instant-snapshot=SOURCE_INSTANT_SNAPSHOT] [--storage-location=LOCATION] [--source-disk-region=SOURCE_DISK_REGION - | --source-disk-zone=SOURCE_DISK_ZONE] [GCLOUD_WIDE_FLAG ...] + | --source-disk-zone=SOURCE_DISK_ZONE] + [--source-instant-snapshot-region=SOURCE_INSTANT_SNAPSHOT_REGION + | --source-instant-snapshot-zone=SOURCE_INSTANT_SNAPSHOT_ZONE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute snapshots create creates snapshot of @@ -76,6 +80,12 @@ FLAGS Required if the source disk is protected by a customer-supplied encryption key. + --source-instant-snapshot=SOURCE_INSTANT_SNAPSHOT + Source instant snapshot used to create the snapshot. To create a + snapshot from a source instant snapshot in a different project, specify + the full path to the source instant snapshot. For example: + https://www.googleapis.com/compute/v1/projects/MY-PROJECT/zones/MY-ZONE/instantSnapshots/MY-INSTANT-SNAPSHOT + --storage-location=LOCATION Google Cloud Storage location, either regional or multi-regional, where snapshot content is to be stored. If absent, a nearby regional or @@ -91,6 +101,16 @@ FLAGS Zone of the source disk to operate on. Overrides the default compute/zone property value for this command invocation. + At most one of these can be specified: + + --source-instant-snapshot-region=SOURCE_INSTANT_SNAPSHOT_REGION + Region of the source instant snapshot to operate on. Overrides the + default compute/region property value for this command invocation. + + --source-instant-snapshot-zone=SOURCE_INSTANT_SNAPSHOT_ZONE + Zone of the source instant snapshot to operate on. Overrides the + default compute/zone property value for this command invocation. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/compute/sole-tenancy/node-groups/create b/gcloud/alpha/compute/sole-tenancy/node-groups/create index ae6440d1f..97695c44e 100644 --- a/gcloud/alpha/compute/sole-tenancy/node-groups/create +++ b/gcloud/alpha/compute/sole-tenancy/node-groups/create @@ -107,7 +107,7 @@ OPTIONAL FLAGS --share-setting=SHARE_SETTING Specify if this node group is shared; and if so, the type of sharing: share with specific projects or folders. SHARE_SETTING must be one - of: projects, organization. + of: projects, organization, local. This flag must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/alpha/compute/sole-tenancy/node-groups/update b/gcloud/alpha/compute/sole-tenancy/node-groups/update index cf57b9cd3..948851149 100644 --- a/gcloud/alpha/compute/sole-tenancy/node-groups/update +++ b/gcloud/alpha/compute/sole-tenancy/node-groups/update @@ -84,7 +84,7 @@ FLAGS --share-setting=SHARE_SETTING Specify if this node group is shared; and if so, the type of sharing: share with specific projects or folders. SHARE_SETTING must be one - of: projects, organization. + of: projects, organization, local. This flag must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/alpha/compute/ssh b/gcloud/alpha/compute/ssh index 508ef8f31..66f3f2fae 100644 --- a/gcloud/alpha/compute/ssh +++ b/gcloud/alpha/compute/ssh @@ -7,7 +7,7 @@ SYNOPSIS [--plain] [--ssh-flag=SSH_FLAG] [--ssh-key-file=SSH_KEY_FILE] [--strict-host-key-checking=STRICT_HOST_KEY_CHECKING] [--troubleshoot] [--zone=ZONE] [--internal-ip | --tunnel-through-iap] - [--network=NETWORK --region=REGION] + [--network=NETWORK --region=REGION : --dest-group=DEST_GROUP] [--ssh-key-expiration=SSH_KEY_EXPIRATION | --ssh-key-expire-after=SSH_KEY_EXPIRE_AFTER] [GCLOUD_WIDE_FLAG ...] [-- SSH_ARGS ...] @@ -229,6 +229,10 @@ FLAGS --region=REGION Configures the region to use when connecting via IP address or FQDN. + --dest-group=DEST_GROUP + Configures the destination group to use when connecting via IP address + or FQDN. + At most one of these can be specified: --ssh-key-expiration=SSH_KEY_EXPIRATION diff --git a/gcloud/alpha/compute/start-iap-tunnel b/gcloud/alpha/compute/start-iap-tunnel index b90a7e939..2672d5e7a 100644 --- a/gcloud/alpha/compute/start-iap-tunnel +++ b/gcloud/alpha/compute/start-iap-tunnel @@ -5,7 +5,8 @@ SYNOPSIS gcloud alpha compute start-iap-tunnel INSTANCE_NAME INSTANCE_PORT [--iap-tunnel-disable-connection-check] [--local-host-port=LOCAL_HOST_PORT; default="localhost:0"] - [--zone=ZONE] [--network=NETWORK --region=REGION] + [--zone=ZONE] + [--network=NETWORK --region=REGION : --dest-group=DEST_GROUP] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -91,6 +92,10 @@ FLAGS --region=REGION Configures the region to use when connecting via IP address or FQDN. + --dest-group=DEST_GROUP + Configures the destination group to use when connecting via IP address + or FQDN. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/container/aws/node-pools/update b/gcloud/alpha/container/aws/node-pools/update index 9c15b6a12..48788df86 100644 --- a/gcloud/alpha/container/aws/node-pools/update +++ b/gcloud/alpha/container/aws/node-pools/update @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud alpha container aws node-pools update (NODE_POOL : --cluster=CLUSTER --location=LOCATION) [--async] - [--node-version=NODE_VERSION] [--validate-only] + [--node-version=NODE_VERSION] + [--security-group-ids=[SECURITY_GROUP_ID,...]] [--validate-only] [--max-nodes=MAX_NODES --min-nodes=MIN_NODES] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -62,6 +63,9 @@ FLAGS --node-version=NODE_VERSION Kubernetes version to use for the node pool. + --security-group-ids=[SECURITY_GROUP_ID,...] + IDs of additional security groups to add to nodes. + --validate-only Validate the node pool to update, but don't actually perform it. diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index d54f57d74..f3d961171 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -16,9 +16,9 @@ SYNOPSIS [--create-subnetwork=[KEY=VALUE,...]] [--database-encryption-key=DATABASE_ENCRYPTION_KEY] [--default-max-pods-per-node=DEFAULT_MAX_PODS_PER_NODE] - [--disable-default-snat] [--disk-size=DISK_SIZE] - [--disk-type=DISK_TYPE] [--enable-autorepair] [--no-enable-autoupgrade] - [--enable-binauthz] [--enable-cloud-logging] + [--disable-default-snat] [--disable-pod-cidr-overprovision] + [--disk-size=DISK_SIZE] [--disk-type=DISK_TYPE] [--enable-autorepair] + [--no-enable-autoupgrade] [--enable-binauthz] [--enable-cloud-logging] [--enable-cloud-monitoring] [--enable-cloud-run-alpha] [--enable-confidential-nodes] [--enable-cost-management] [--enable-dataplane-v2] [--enable-gke-oidc] [--enable-gvnic] @@ -306,6 +306,10 @@ FLAGS requires that you also set --enable-ip-alias and --enable-private-nodes. + --disable-pod-cidr-overprovision + Disables pod cidr overprovision on nodes. Pod cidr overprovisioning is + enabled by default. + --disk-size=DISK_SIZE Size for node VM boot disks in GB. Defaults to 100GB. diff --git a/gcloud/alpha/container/node-pools/create b/gcloud/alpha/container/node-pools/create index 022f92420..4af1acf75 100644 --- a/gcloud/alpha/container/node-pools/create +++ b/gcloud/alpha/container/node-pools/create @@ -6,10 +6,11 @@ SYNOPSIS gcloud alpha container node-pools create NAME [--accelerator=[type=TYPE,[count=COUNT],...]] [--boot-disk-kms-key=BOOT_DISK_KMS_KEY] [--cluster=CLUSTER] - [--disk-size=DISK_SIZE] [--disk-type=DISK_TYPE] - [--enable-autoprovisioning] [--enable-autorepair] - [--no-enable-autoupgrade] [--enable-confidential-nodes] - [--enable-gvnic] [--enable-image-streaming] [--image-type=IMAGE_TYPE] + [--disable-pod-cidr-overprovision] [--disk-size=DISK_SIZE] + [--disk-type=DISK_TYPE] [--enable-autoprovisioning] + [--enable-autorepair] [--no-enable-autoupgrade] + [--enable-confidential-nodes] [--enable-gvnic] + [--enable-image-streaming] [--image-type=IMAGE_TYPE] [--linux-sysctls=KEY=VALUE,[KEY=VALUE,...]] [--machine-type=MACHINE_TYPE, -m MACHINE_TYPE] [--max-pods-per-node=MAX_PODS_PER_NODE] @@ -88,6 +89,10 @@ FLAGS The cluster to add the node pool to. Overrides the default container/cluster property value for this command invocation. + --disable-pod-cidr-overprovision + Disables pod cidr overprovision on nodes. Pod cidr overprovisioning is + enabled by default. + --disk-size=DISK_SIZE Size for node VM boot disks in GB. Defaults to 100GB. diff --git a/gcloud/alpha/dns/managed-zones/get-iam-policy b/gcloud/alpha/dns/managed-zones/get-iam-policy new file mode 100644 index 000000000..e0062d071 --- /dev/null +++ b/gcloud/alpha/dns/managed-zones/get-iam-policy @@ -0,0 +1,46 @@ +NAME + gcloud alpha dns managed-zones get-iam-policy - get the IAM policy for a + Cloud DNS managed-zone + +SYNOPSIS + gcloud alpha dns managed-zones get-iam-policy ZONE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command displays the IAM Policy of the specified managed-zone. + +EXAMPLES + To display the details of your managed-zone IAM Policy , run: + + $ gcloud alpha dns managed-zones get-iam-policy my-zone + +POSITIONAL ARGUMENTS + Zone resource - The name of the managed-zone to get IAM policy. 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 zone on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + ZONE + ID of the zone or fully qualified identifier for the zone. To set the + zone attribute: + ▸ provide the argument zone on the command line. + +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/dns/managed-zones/help b/gcloud/alpha/dns/managed-zones/help index c38447356..f66025188 100644 --- a/gcloud/alpha/dns/managed-zones/help +++ b/gcloud/alpha/dns/managed-zones/help @@ -49,9 +49,15 @@ COMMANDS describe (ALPHA) View the details of a Cloud DNS managed-zone. + get-iam-policy + (ALPHA) Get the IAM policy for a Cloud DNS managed-zone. + list (ALPHA) View the list of all your managed-zones. + set-iam-policy + (ALPHA) Set the IAM policy for a Cloud DNS managed-zone. + update (ALPHA) Update an existing Cloud DNS managed-zone. diff --git a/gcloud/alpha/dns/managed-zones/set-iam-policy b/gcloud/alpha/dns/managed-zones/set-iam-policy new file mode 100644 index 000000000..64a1ff05f --- /dev/null +++ b/gcloud/alpha/dns/managed-zones/set-iam-policy @@ -0,0 +1,52 @@ +NAME + gcloud alpha dns managed-zones set-iam-policy - set the IAM policy for a + Cloud DNS managed-zone + +SYNOPSIS + gcloud alpha dns managed-zones set-iam-policy ZONE + --policy-file=POLICY_FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command sets the IAM Policy of the specified managed-zone. + +EXAMPLES + To set the IAM policy of your managed-zone , run: + + $ gcloud alpha dns managed-zones set-iam-policy my-zone \ + --policy-file=policy.json + +POSITIONAL ARGUMENTS + Zone resource - The name of the managed-zone to set IAM policy. 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 zone on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + ZONE + ID of the zone or fully qualified identifier for the zone. To set the + zone attribute: + ▸ provide the argument zone on the command line. + +REQUIRED FLAGS + --policy-file=POLICY_FILE + JSON or YAML file with the IAM policy + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in 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/functions/deploy b/gcloud/alpha/functions/deploy index f9d2b31e0..37d8763bd 100644 --- a/gcloud/alpha/functions/deploy +++ b/gcloud/alpha/functions/deploy @@ -169,9 +169,11 @@ FLAGS ◆ go113: Go 1.13 ◆ go116: Go 1.16 (preview) ◆ java11: Java 11 + ◆ java17: Java 17 (preview) ◆ dotnet3: .NET Framework 3 ◆ ruby26: Ruby 2.6 ◆ ruby27: Ruby 2.7 + ◆ ruby30: Ruby 3.0 (preview) ◆ nodejs6: Node.js 6 (deprecated) ◆ nodejs8: Node.js 8 (deprecated) diff --git a/gcloud/alpha/iam/service-accounts/undelete b/gcloud/alpha/iam/service-accounts/undelete index 2134c0406..7d7430687 100644 --- a/gcloud/alpha/iam/service-accounts/undelete +++ b/gcloud/alpha/iam/service-accounts/undelete @@ -40,7 +40,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 iam service-accounts undelete $ gcloud beta iam service-accounts undelete diff --git a/gcloud/alpha/network-services/help b/gcloud/alpha/network-services/help index 7e9c9ab2b..d5eaff835 100644 --- a/gcloud/alpha/network-services/help +++ b/gcloud/alpha/network-services/help @@ -36,9 +36,6 @@ GROUPS observability-policies (ALPHA) Manage Network Services ObservabilityPolicies. - routers - (ALPHA) Manage Network Services Routers. - service-bindings (ALPHA) Manage Network Services Bindings. diff --git a/gcloud/alpha/network-services/routers/delete b/gcloud/alpha/network-services/routers/delete deleted file mode 100644 index d970ab962..000000000 --- a/gcloud/alpha/network-services/routers/delete +++ /dev/null @@ -1,61 +0,0 @@ -NAME - gcloud alpha network-services routers delete - delete router - -SYNOPSIS - gcloud alpha network-services routers delete (ROUTER : --location=LOCATION) - [--async] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Delete the specified router. - -POSITIONAL ARGUMENTS - Router resource - Name of the router you want to delete. The arguments in - this group can be used to specify the attributes of this resource. (NOTE) - Some attributes are not given arguments in this group but can be set in - other ways. To set the project attribute: - ◆ provide the argument router on the command line with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - ROUTER - ID of the router or fully qualified identifier for the router. To set - the router attribute: - ▸ provide the argument router on the command line. - - This positional must be specified if any of the other arguments in - this group are specified. - - --location=LOCATION - The location Id. - - To set the location attribute: - ▸ provide the argument router on the command line with a fully - specified name; - ▸ provide the argument --location on the command line. - -FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the networkservices/v1alpha1 API. The full documentation - for this API can be found at: https://cloud.google.com/networking - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. - diff --git a/gcloud/alpha/network-services/routers/export b/gcloud/alpha/network-services/routers/export deleted file mode 100644 index ef879835c..000000000 --- a/gcloud/alpha/network-services/routers/export +++ /dev/null @@ -1,64 +0,0 @@ -NAME - gcloud alpha network-services routers export - export router - -SYNOPSIS - gcloud alpha network-services routers export (ROUTER : --location=LOCATION) - [--destination=DESTINATION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Export a router. - -POSITIONAL ARGUMENTS - Router resource - Name of the router to export. The arguments in this - group can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. To set the project attribute: - ◆ provide the argument router on the command line with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - ROUTER - ID of the router or fully qualified identifier for the router. To set - the router attribute: - ▸ provide the argument router on the command line. - - This positional must be specified if any of the other arguments in - this group are specified. - - --location=LOCATION - The location Id. - - To set the location attribute: - ▸ provide the argument router on the command line with a fully - specified name; - ▸ provide the argument --location on the command line. - -FLAGS - --destination=DESTINATION - Path to a YAML file where the configuration will be exported. The - exported data will not contain any output-only fields. Alternatively, - you may omit this flag to write to standard output. For a schema - describing the export/import format, see - $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the networkservices/v1alpha1 API. The full documentation - for this API can be found at: https://cloud.google.com/networking - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. - diff --git a/gcloud/alpha/network-services/routers/help b/gcloud/alpha/network-services/routers/help deleted file mode 100644 index 73a282df3..000000000 --- a/gcloud/alpha/network-services/routers/help +++ /dev/null @@ -1,35 +0,0 @@ -NAME - gcloud alpha network-services routers - manage Network Services Routers - -SYNOPSIS - gcloud alpha network-services routers COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Manage Network Services Routers. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - delete - (ALPHA) Delete router. - - export - (ALPHA) Export router. - - import - (ALPHA) Import router. - - list - (ALPHA) List routers. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. - diff --git a/gcloud/alpha/network-services/routers/import b/gcloud/alpha/network-services/routers/import deleted file mode 100644 index 568bc3431..000000000 --- a/gcloud/alpha/network-services/routers/import +++ /dev/null @@ -1,71 +0,0 @@ -NAME - gcloud alpha network-services routers import - import router - -SYNOPSIS - gcloud alpha network-services routers import (ROUTER : --location=LOCATION) - [--async] [--source=SOURCE] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Import a router. - -POSITIONAL ARGUMENTS - Router resource - Name of the router to import. The arguments in this - group can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. To set the project attribute: - ◆ provide the argument router on the command line with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - ROUTER - ID of the router or fully qualified identifier for the router. To set - the router attribute: - ▸ provide the argument router on the command line. - - This positional must be specified if any of the other arguments in - this group are specified. - - --location=LOCATION - The location Id. - - To set the location attribute: - ▸ provide the argument router on the command line with a fully - specified name; - ▸ provide the argument --location on the command line. - -FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --source=SOURCE - Path to a YAML file containing the configuration export data. The YAML - file must not contain any output-only fields. Alternatively, you may - omit this flag to read from standard input. For a schema describing the - export/import format, see: $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... - - $CLOUDSDKROOT is can be obtained with the following command: - - $ gcloud info --format='value(installation.sdk_root)' - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the networkservices/v1alpha1 API. The full documentation - for this API can be found at: https://cloud.google.com/networking - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. - diff --git a/gcloud/alpha/network-services/routers/list b/gcloud/alpha/network-services/routers/list deleted file mode 100644 index 68116590e..000000000 --- a/gcloud/alpha/network-services/routers/list +++ /dev/null @@ -1,77 +0,0 @@ -NAME - gcloud alpha network-services routers list - list routers - -SYNOPSIS - gcloud alpha network-services routers list --location=LOCATION - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) List all routers in the specified location of the current project. - -REQUIRED FLAGS - Location resource - The project of the routers to display. This represents - a Cloud resource. (NOTE) Some attributes are not given arguments in this - group but can be set in other ways. To set the project attribute: - ◆ provide the argument --location on the command line with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - --location=LOCATION - ID of the location or fully qualified identifier for the location. To - set the location attribute: - ▸ provide the argument --location on the command line. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the networkservices/v1alpha1 API. The full documentation - for this API can be found at: https://cloud.google.com/networking - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. - diff --git a/gcloud/alpha/transfer/agent-pools/create b/gcloud/alpha/transfer/agent-pools/create index 4dec71c26..070c8b53f 100644 --- a/gcloud/alpha/transfer/agent-pools/create +++ b/gcloud/alpha/transfer/agent-pools/create @@ -57,5 +57,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 transfer agent-pools create diff --git a/gcloud/alpha/transfer/agent-pools/delete b/gcloud/alpha/transfer/agent-pools/delete index 185682feb..e9f02f62a 100644 --- a/gcloud/alpha/transfer/agent-pools/delete +++ b/gcloud/alpha/transfer/agent-pools/delete @@ -37,5 +37,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud transfer agent-pools delete diff --git a/gcloud/alpha/transfer/agent-pools/describe b/gcloud/alpha/transfer/agent-pools/describe index 6ba417315..e8eb078e1 100644 --- a/gcloud/alpha/transfer/agent-pools/describe +++ b/gcloud/alpha/transfer/agent-pools/describe @@ -29,5 +29,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 transfer agent-pools describe diff --git a/gcloud/alpha/transfer/agent-pools/help b/gcloud/alpha/transfer/agent-pools/help index 17c691753..5764e2021 100644 --- a/gcloud/alpha/transfer/agent-pools/help +++ b/gcloud/alpha/transfer/agent-pools/help @@ -34,5 +34,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud transfer agent-pools diff --git a/gcloud/alpha/transfer/agent-pools/list b/gcloud/alpha/transfer/agent-pools/list index 5720c088c..9353f647d 100644 --- a/gcloud/alpha/transfer/agent-pools/list +++ b/gcloud/alpha/transfer/agent-pools/list @@ -49,5 +49,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud transfer agent-pools list diff --git a/gcloud/alpha/transfer/agent-pools/update b/gcloud/alpha/transfer/agent-pools/update index 611853b9d..7705c2312 100644 --- a/gcloud/alpha/transfer/agent-pools/update +++ b/gcloud/alpha/transfer/agent-pools/update @@ -66,5 +66,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud transfer agent-pools update diff --git a/gcloud/alpha/transfer/agents/delete b/gcloud/alpha/transfer/agents/delete index 4f2918a0f..0c5cfa8b5 100644 --- a/gcloud/alpha/transfer/agents/delete +++ b/gcloud/alpha/transfer/agents/delete @@ -47,5 +47,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 transfer agents delete diff --git a/gcloud/alpha/transfer/agents/help b/gcloud/alpha/transfer/agents/help index d74ce45cb..ca19f77bc 100644 --- a/gcloud/alpha/transfer/agents/help +++ b/gcloud/alpha/transfer/agents/help @@ -28,5 +28,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud transfer agents diff --git a/gcloud/alpha/transfer/agents/install b/gcloud/alpha/transfer/agents/install index 178cbb2c3..3ef9c3234 100644 --- a/gcloud/alpha/transfer/agents/install +++ b/gcloud/alpha/transfer/agents/install @@ -96,5 +96,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 transfer agents install diff --git a/gcloud/alpha/transfer/authorize b/gcloud/alpha/transfer/authorize index 934cd204b..d32635a17 100644 --- a/gcloud/alpha/transfer/authorize +++ b/gcloud/alpha/transfer/authorize @@ -52,5 +52,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 transfer authorize diff --git a/gcloud/alpha/transfer/help b/gcloud/alpha/transfer/help index 5cc2cb2bb..84d35a26c 100644 --- a/gcloud/alpha/transfer/help +++ b/gcloud/alpha/transfer/help @@ -9,7 +9,7 @@ DESCRIPTION (ALPHA) The gcloud transfer command group lets you create and manage Transfer Service jobs, operations, and agents. - To get started, run: gcloud alpha transfer jobs create --help + To get started, run: gcloud transfer jobs create --help More info on prerequisite IAM permissions: https://cloud.google.com/storage-transfer/docs/on-prem-set-up @@ -44,5 +44,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 transfer diff --git a/gcloud/alpha/transfer/jobs/create b/gcloud/alpha/transfer/jobs/create index d302ae2c8..7fbc0cb7c 100644 --- a/gcloud/alpha/transfer/jobs/create +++ b/gcloud/alpha/transfer/jobs/create @@ -333,5 +333,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 transfer jobs create diff --git a/gcloud/alpha/transfer/jobs/delete b/gcloud/alpha/transfer/jobs/delete index 5ae0f032d..b6f76168c 100644 --- a/gcloud/alpha/transfer/jobs/delete +++ b/gcloud/alpha/transfer/jobs/delete @@ -28,5 +28,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud transfer jobs delete diff --git a/gcloud/alpha/transfer/jobs/describe b/gcloud/alpha/transfer/jobs/describe index 76e6cf46f..8c1e21b18 100644 --- a/gcloud/alpha/transfer/jobs/describe +++ b/gcloud/alpha/transfer/jobs/describe @@ -38,5 +38,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud transfer jobs describe diff --git a/gcloud/alpha/transfer/jobs/help b/gcloud/alpha/transfer/jobs/help index 2c13616f2..b4f117a56 100644 --- a/gcloud/alpha/transfer/jobs/help +++ b/gcloud/alpha/transfer/jobs/help @@ -48,5 +48,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 transfer jobs diff --git a/gcloud/alpha/transfer/jobs/list b/gcloud/alpha/transfer/jobs/list index 8b82147fd..bc2bad874 100644 --- a/gcloud/alpha/transfer/jobs/list +++ b/gcloud/alpha/transfer/jobs/list @@ -67,5 +67,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud transfer jobs list diff --git a/gcloud/alpha/transfer/jobs/monitor b/gcloud/alpha/transfer/jobs/monitor index 6f8ab0cbe..6a1575bc5 100644 --- a/gcloud/alpha/transfer/jobs/monitor +++ b/gcloud/alpha/transfer/jobs/monitor @@ -37,5 +37,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud transfer jobs monitor diff --git a/gcloud/alpha/transfer/jobs/run b/gcloud/alpha/transfer/jobs/run index 59c092037..5364e9da6 100644 --- a/gcloud/alpha/transfer/jobs/run +++ b/gcloud/alpha/transfer/jobs/run @@ -33,5 +33,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 transfer jobs run diff --git a/gcloud/alpha/transfer/jobs/update b/gcloud/alpha/transfer/jobs/update index 2e4ff9fdb..c9cbaa7d9 100644 --- a/gcloud/alpha/transfer/jobs/update +++ b/gcloud/alpha/transfer/jobs/update @@ -387,5 +387,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 transfer jobs update diff --git a/gcloud/alpha/transfer/operations/cancel b/gcloud/alpha/transfer/operations/cancel index e44d027e2..4a20858e9 100644 --- a/gcloud/alpha/transfer/operations/cancel +++ b/gcloud/alpha/transfer/operations/cancel @@ -28,5 +28,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud transfer operations cancel diff --git a/gcloud/alpha/transfer/operations/describe b/gcloud/alpha/transfer/operations/describe index 8ce03665e..7e941918c 100644 --- a/gcloud/alpha/transfer/operations/describe +++ b/gcloud/alpha/transfer/operations/describe @@ -29,5 +29,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 transfer operations describe diff --git a/gcloud/alpha/transfer/operations/help b/gcloud/alpha/transfer/operations/help index ff2d74d29..8d535289a 100644 --- a/gcloud/alpha/transfer/operations/help +++ b/gcloud/alpha/transfer/operations/help @@ -37,5 +37,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud transfer operations diff --git a/gcloud/alpha/transfer/operations/list b/gcloud/alpha/transfer/operations/list index 25e37f1e5..c6198ac6f 100644 --- a/gcloud/alpha/transfer/operations/list +++ b/gcloud/alpha/transfer/operations/list @@ -71,5 +71,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 transfer operations list diff --git a/gcloud/alpha/transfer/operations/monitor b/gcloud/alpha/transfer/operations/monitor index b40c928fb..e4f07bc4c 100644 --- a/gcloud/alpha/transfer/operations/monitor +++ b/gcloud/alpha/transfer/operations/monitor @@ -34,5 +34,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud transfer operations monitor diff --git a/gcloud/alpha/transfer/operations/pause b/gcloud/alpha/transfer/operations/pause index 4f5c313a6..c4aa80d14 100644 --- a/gcloud/alpha/transfer/operations/pause +++ b/gcloud/alpha/transfer/operations/pause @@ -29,5 +29,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 transfer operations pause diff --git a/gcloud/alpha/transfer/operations/resume b/gcloud/alpha/transfer/operations/resume index bbdf09ed1..947c2549f 100644 --- a/gcloud/alpha/transfer/operations/resume +++ b/gcloud/alpha/transfer/operations/resume @@ -29,5 +29,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 transfer operations resume diff --git a/gcloud/artifacts/operations/describe b/gcloud/artifacts/operations/describe index 36fdc4d41..e4cdcc92b 100644 --- a/gcloud/artifacts/operations/describe +++ b/gcloud/artifacts/operations/describe @@ -61,8 +61,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES These variants are also available: diff --git a/gcloud/artifacts/packages/delete b/gcloud/artifacts/packages/delete index 0c3ea5475..9d31a47b5 100644 --- a/gcloud/artifacts/packages/delete +++ b/gcloud/artifacts/packages/delete @@ -76,8 +76,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES These variants are also available: diff --git a/gcloud/artifacts/packages/list b/gcloud/artifacts/packages/list index c95d7c0ab..3fb7ee598 100644 --- a/gcloud/artifacts/packages/list +++ b/gcloud/artifacts/packages/list @@ -83,8 +83,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES These variants are also available: diff --git a/gcloud/artifacts/repositories/add-iam-policy-binding b/gcloud/artifacts/repositories/add-iam-policy-binding index 62916d288..21e632059 100644 --- a/gcloud/artifacts/repositories/add-iam-policy-binding +++ b/gcloud/artifacts/repositories/add-iam-policy-binding @@ -127,8 +127,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES These variants are also available: diff --git a/gcloud/artifacts/repositories/create b/gcloud/artifacts/repositories/create index 535a9462d..142173511 100644 --- a/gcloud/artifacts/repositories/create +++ b/gcloud/artifacts/repositories/create @@ -70,8 +70,6 @@ REQUIRED FLAGS APT package format. docker Docker image format. - googet - GooGet package format. maven Maven package format. npm @@ -125,8 +123,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES These variants are also available: diff --git a/gcloud/artifacts/repositories/delete b/gcloud/artifacts/repositories/delete index 94c36d20b..b31c05beb 100644 --- a/gcloud/artifacts/repositories/delete +++ b/gcloud/artifacts/repositories/delete @@ -65,8 +65,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES These variants are also available: diff --git a/gcloud/artifacts/repositories/describe b/gcloud/artifacts/repositories/describe index 6c84b1446..06080cdcf 100644 --- a/gcloud/artifacts/repositories/describe +++ b/gcloud/artifacts/repositories/describe @@ -55,8 +55,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES These variants are also available: diff --git a/gcloud/artifacts/repositories/get-iam-policy b/gcloud/artifacts/repositories/get-iam-policy index be5ca5acc..4ac566ce2 100644 --- a/gcloud/artifacts/repositories/get-iam-policy +++ b/gcloud/artifacts/repositories/get-iam-policy @@ -91,8 +91,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES These variants are also available: diff --git a/gcloud/artifacts/repositories/remove-iam-policy-binding b/gcloud/artifacts/repositories/remove-iam-policy-binding index 6d783e996..2adec2ca8 100644 --- a/gcloud/artifacts/repositories/remove-iam-policy-binding +++ b/gcloud/artifacts/repositories/remove-iam-policy-binding @@ -132,8 +132,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES These variants are also available: diff --git a/gcloud/artifacts/repositories/set-iam-policy b/gcloud/artifacts/repositories/set-iam-policy index 1eac321b5..3a63713a7 100644 --- a/gcloud/artifacts/repositories/set-iam-policy +++ b/gcloud/artifacts/repositories/set-iam-policy @@ -69,8 +69,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES These variants are also available: diff --git a/gcloud/artifacts/repositories/update b/gcloud/artifacts/repositories/update index cce3746ca..6677475ea 100644 --- a/gcloud/artifacts/repositories/update +++ b/gcloud/artifacts/repositories/update @@ -94,8 +94,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES These variants are also available: diff --git a/gcloud/artifacts/tags/create b/gcloud/artifacts/tags/create index 1c8c581cf..d43e195e3 100644 --- a/gcloud/artifacts/tags/create +++ b/gcloud/artifacts/tags/create @@ -87,8 +87,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES These variants are also available: diff --git a/gcloud/artifacts/tags/delete b/gcloud/artifacts/tags/delete index ce43548cf..4999ad8c4 100644 --- a/gcloud/artifacts/tags/delete +++ b/gcloud/artifacts/tags/delete @@ -82,8 +82,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES These variants are also available: diff --git a/gcloud/artifacts/tags/list b/gcloud/artifacts/tags/list index 391596e6b..11ac8d847 100644 --- a/gcloud/artifacts/tags/list +++ b/gcloud/artifacts/tags/list @@ -105,8 +105,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES These variants are also available: diff --git a/gcloud/artifacts/tags/update b/gcloud/artifacts/tags/update index 6c1214c03..1dd4cee5c 100644 --- a/gcloud/artifacts/tags/update +++ b/gcloud/artifacts/tags/update @@ -87,8 +87,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES These variants are also available: diff --git a/gcloud/artifacts/versions/delete b/gcloud/artifacts/versions/delete index d2b0a4c99..39fb76f5d 100644 --- a/gcloud/artifacts/versions/delete +++ b/gcloud/artifacts/versions/delete @@ -90,8 +90,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES These variants are also available: diff --git a/gcloud/artifacts/versions/list b/gcloud/artifacts/versions/list index d63a21095..7ee289e66 100644 --- a/gcloud/artifacts/versions/list +++ b/gcloud/artifacts/versions/list @@ -95,8 +95,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES These variants are also available: diff --git a/gcloud/auth/application-default/login b/gcloud/auth/application-default/login index 0c0351198..d2be2132d 100644 --- a/gcloud/auth/application-default/login +++ b/gcloud/auth/application-default/login @@ -82,8 +82,9 @@ FLAGS to be copied. The --[no-]launch-browser flags are deprecated and will be removed in - future updates. Use --no-browser to replace --no-launch-browser. - Enabled by default, use --no-launch-browser to disable. + version 383.0.0 (04/26/2022). Use --no-browser to replace + --no-launch-browser. Enabled by default, use --no-launch-browser to + disable. --scopes=SCOPES,[SCOPES,...] The names of the scopes to authorize for. By default openid, diff --git a/gcloud/auth/login b/gcloud/auth/login index af4b43ddd..c8f653e32 100644 --- a/gcloud/auth/login +++ b/gcloud/auth/login @@ -82,8 +82,9 @@ FLAGS to be copied. The --[no-]launch-browser flags are deprecated and will be removed in - future updates. Use --no-browser to replace --no-launch-browser. - Enabled by default, use --no-launch-browser to disable. + version 383.0.0 (04/26/2022). Use --no-browser to replace + --no-launch-browser. Enabled by default, use --no-launch-browser to + disable. --update-adc Write the obtained credentials to the well-known location for diff --git a/gcloud/beta/artifacts/operations/describe b/gcloud/beta/artifacts/operations/describe index 99757a05f..d6bd63388 100644 --- a/gcloud/beta/artifacts/operations/describe +++ b/gcloud/beta/artifacts/operations/describe @@ -61,8 +61,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/artifacts/packages/delete b/gcloud/beta/artifacts/packages/delete index b0c559567..b1b88858c 100644 --- a/gcloud/beta/artifacts/packages/delete +++ b/gcloud/beta/artifacts/packages/delete @@ -76,8 +76,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/artifacts/packages/list b/gcloud/beta/artifacts/packages/list index c835893d7..44c9dde79 100644 --- a/gcloud/beta/artifacts/packages/list +++ b/gcloud/beta/artifacts/packages/list @@ -83,8 +83,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/artifacts/repositories/add-iam-policy-binding b/gcloud/beta/artifacts/repositories/add-iam-policy-binding index d3ad407b2..f03500fda 100644 --- a/gcloud/beta/artifacts/repositories/add-iam-policy-binding +++ b/gcloud/beta/artifacts/repositories/add-iam-policy-binding @@ -128,8 +128,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/artifacts/repositories/delete b/gcloud/beta/artifacts/repositories/delete index b4abf4a06..5a168357d 100644 --- a/gcloud/beta/artifacts/repositories/delete +++ b/gcloud/beta/artifacts/repositories/delete @@ -65,8 +65,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/artifacts/repositories/describe b/gcloud/beta/artifacts/repositories/describe index e01d3ca75..7870b74a9 100644 --- a/gcloud/beta/artifacts/repositories/describe +++ b/gcloud/beta/artifacts/repositories/describe @@ -56,8 +56,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/artifacts/repositories/get-iam-policy b/gcloud/beta/artifacts/repositories/get-iam-policy index 0364d52a3..2a40dbc18 100644 --- a/gcloud/beta/artifacts/repositories/get-iam-policy +++ b/gcloud/beta/artifacts/repositories/get-iam-policy @@ -91,8 +91,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/artifacts/repositories/remove-iam-policy-binding b/gcloud/beta/artifacts/repositories/remove-iam-policy-binding index 071a6844e..1ecadfd86 100644 --- a/gcloud/beta/artifacts/repositories/remove-iam-policy-binding +++ b/gcloud/beta/artifacts/repositories/remove-iam-policy-binding @@ -135,8 +135,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/artifacts/repositories/set-iam-policy b/gcloud/beta/artifacts/repositories/set-iam-policy index ba39bd3cd..bd9620419 100644 --- a/gcloud/beta/artifacts/repositories/set-iam-policy +++ b/gcloud/beta/artifacts/repositories/set-iam-policy @@ -70,8 +70,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/artifacts/repositories/update b/gcloud/beta/artifacts/repositories/update index 0a13291b4..3d38564de 100644 --- a/gcloud/beta/artifacts/repositories/update +++ b/gcloud/beta/artifacts/repositories/update @@ -96,8 +96,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/artifacts/tags/create b/gcloud/beta/artifacts/tags/create index c18f921b9..434a5f358 100644 --- a/gcloud/beta/artifacts/tags/create +++ b/gcloud/beta/artifacts/tags/create @@ -87,8 +87,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/artifacts/tags/delete b/gcloud/beta/artifacts/tags/delete index 27b72d3ae..e811861d2 100644 --- a/gcloud/beta/artifacts/tags/delete +++ b/gcloud/beta/artifacts/tags/delete @@ -82,8 +82,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/artifacts/tags/list b/gcloud/beta/artifacts/tags/list index 65447087f..1e28b71c7 100644 --- a/gcloud/beta/artifacts/tags/list +++ b/gcloud/beta/artifacts/tags/list @@ -105,8 +105,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/artifacts/tags/update b/gcloud/beta/artifacts/tags/update index 851ff29b8..9aad57f1d 100644 --- a/gcloud/beta/artifacts/tags/update +++ b/gcloud/beta/artifacts/tags/update @@ -87,8 +87,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/artifacts/versions/delete b/gcloud/beta/artifacts/versions/delete index 9f72ce8b7..08dbfc438 100644 --- a/gcloud/beta/artifacts/versions/delete +++ b/gcloud/beta/artifacts/versions/delete @@ -90,8 +90,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/artifacts/versions/list b/gcloud/beta/artifacts/versions/list index 7382b3ccb..acd86c5c1 100644 --- a/gcloud/beta/artifacts/versions/list +++ b/gcloud/beta/artifacts/versions/list @@ -97,8 +97,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the artifactregistry/v1beta2 API. The full documentation - for this API can be found at: https://cloud.google.com/artifacts/docs/ + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/auth/application-default/login b/gcloud/beta/auth/application-default/login index 42162ef90..1cf859c76 100644 --- a/gcloud/beta/auth/application-default/login +++ b/gcloud/beta/auth/application-default/login @@ -82,8 +82,9 @@ FLAGS to be copied. The --[no-]launch-browser flags are deprecated and will be removed in - future updates. Use --no-browser to replace --no-launch-browser. - Enabled by default, use --no-launch-browser to disable. + version 383.0.0 (04/26/2022). Use --no-browser to replace + --no-launch-browser. Enabled by default, use --no-launch-browser to + disable. --scopes=SCOPES,[SCOPES,...] The names of the scopes to authorize for. By default openid, diff --git a/gcloud/beta/auth/login b/gcloud/beta/auth/login index 3733b2a1c..2ef1a8ad8 100644 --- a/gcloud/beta/auth/login +++ b/gcloud/beta/auth/login @@ -83,8 +83,9 @@ FLAGS to be copied. The --[no-]launch-browser flags are deprecated and will be removed in - future updates. Use --no-browser to replace --no-launch-browser. - Enabled by default, use --no-launch-browser to disable. + version 383.0.0 (04/26/2022). Use --no-browser to replace + --no-launch-browser. Enabled by default, use --no-launch-browser to + disable. --update-adc Write the obtained credentials to the well-known location for diff --git a/gcloud/beta/composer/environments/check-upgrade b/gcloud/beta/composer/environments/check-upgrade index 3b62feca5..8ac290951 100644 --- a/gcloud/beta/composer/environments/check-upgrade +++ b/gcloud/beta/composer/environments/check-upgrade @@ -71,7 +71,7 @@ FLAGS The image version encapsulates the versions of both Cloud Composer and Apache Airflow. Must be of the form - composer-A.B.C[-D.E]-airflow-X.Y[.Z]. + composer-A[.B.C[-D.E]]-airflow-X.Y[.Z]. The Cloud Composer and Airflow versions are semantic versions. latest can be provided instead of an explicit Cloud Composer version number diff --git a/gcloud/beta/composer/environments/create b/gcloud/beta/composer/environments/create index 4ebe40cb9..acbb593a2 100644 --- a/gcloud/beta/composer/environments/create +++ b/gcloud/beta/composer/environments/create @@ -187,15 +187,15 @@ FLAGS Must be of the form `X.Y[.Z]`. - The latest supported Cloud Composer version will be used within - the created environment. + The current Cloud Composer version will be used within the created + environment. --image-version=IMAGE_VERSION Version of the image to run in the environment. The image version encapsulates the versions of both Cloud Composer and Apache Airflow. Must be of the form - `composer-A.B.C[-D.E]-airflow-X.Y[.Z]`. + `composer-A[.B.C[-D.E]]-airflow-X.Y[.Z]`. The Cloud Composer and Airflow versions are semantic versions. `latest` can be provided instead of an explicit Cloud Composer diff --git a/gcloud/beta/composer/environments/update b/gcloud/beta/composer/environments/update index 0b14120f2..e66c68d1f 100644 --- a/gcloud/beta/composer/environments/update +++ b/gcloud/beta/composer/environments/update @@ -112,7 +112,7 @@ REQUIRED FLAGS The image version encapsulates the versions of both Cloud Composer and Apache Airflow. Must be of the form - composer-A.B.C[-D.E]-airflow-X.Y[.Z]. + composer-A[.B.C[-D.E]]-airflow-X.Y[.Z]. The Cloud Composer and Airflow versions are semantic versions. latest can be provided instead of an explicit Cloud Composer diff --git a/gcloud/beta/compute/routers/nats/create b/gcloud/beta/compute/routers/nats/create index 9c226daea..78d1197a9 100644 --- a/gcloud/beta/compute/routers/nats/create +++ b/gcloud/beta/compute/routers/nats/create @@ -70,10 +70,13 @@ REQUIRED FLAGS --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME],[...] List of subnetwork primary and secondary IP ranges to be allowed to - use NAT. [SUBNETWORK]: including a subnetwork name includes only the - primary subnet range of the subnetwork. [SUBNETWORK]:[RANGE_NAME]: - specifying a subnetwork and secondary range name includes only that - secondary range.It does not include the primary range of the subnet. + use NAT. + + ▸ SUBNETWORK - including a subnetwork name includes only the + primary subnet range of the subnetwork. + ▸ SUBNETWORK:RANGE_NAME - specifying a subnetwork and secondary + range name includes only that secondary range. It does not include + the primary range of the subnet. --nat-primary-subnet-ip-ranges Allow only primary IP ranges of all subnetworks in the region to use diff --git a/gcloud/beta/compute/routers/nats/update b/gcloud/beta/compute/routers/nats/update index 8b62cd0d9..ecb87aa45 100644 --- a/gcloud/beta/compute/routers/nats/update +++ b/gcloud/beta/compute/routers/nats/update @@ -242,10 +242,13 @@ OPTIONAL FLAGS --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME],[...] List of subnetwork primary and secondary IP ranges to be allowed to - use NAT. [SUBNETWORK]: including a subnetwork name includes only the - primary subnet range of the subnetwork. [SUBNETWORK]:[RANGE_NAME]: - specifying a subnetwork and secondary range name includes only that - secondary range.It does not include the primary range of the subnet. + use NAT. + + ▸ SUBNETWORK - including a subnetwork name includes only the + primary subnet range of the subnetwork. + ▸ SUBNETWORK:RANGE_NAME - specifying a subnetwork and secondary + range name includes only that secondary range. It does not include + the primary range of the subnet. --nat-primary-subnet-ip-ranges Allow only primary IP ranges of all subnetworks in the region to use diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index 1b60255bf..3b405a053 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -16,9 +16,9 @@ SYNOPSIS [--create-subnetwork=[KEY=VALUE,...]] [--database-encryption-key=DATABASE_ENCRYPTION_KEY] [--default-max-pods-per-node=DEFAULT_MAX_PODS_PER_NODE] - [--disable-default-snat] [--disk-size=DISK_SIZE] - [--disk-type=DISK_TYPE] [--enable-autorepair] [--no-enable-autoupgrade] - [--enable-binauthz] [--enable-cloud-logging] + [--disable-default-snat] [--disable-pod-cidr-overprovision] + [--disk-size=DISK_SIZE] [--disk-type=DISK_TYPE] [--enable-autorepair] + [--no-enable-autoupgrade] [--enable-binauthz] [--enable-cloud-logging] [--enable-cloud-monitoring] [--enable-cloud-run-alpha] [--enable-confidential-nodes] [--enable-dataplane-v2] [--enable-gke-oidc] [--enable-gvnic] [--enable-identity-service] @@ -301,6 +301,10 @@ FLAGS requires that you also set --enable-ip-alias and --enable-private-nodes. + --disable-pod-cidr-overprovision + Disables pod cidr overprovision on nodes. Pod cidr overprovisioning is + enabled by default. + --disk-size=DISK_SIZE Size for node VM boot disks in GB. Defaults to 100GB. diff --git a/gcloud/beta/container/node-pools/create b/gcloud/beta/container/node-pools/create index 7cd4fc551..7172cfc15 100644 --- a/gcloud/beta/container/node-pools/create +++ b/gcloud/beta/container/node-pools/create @@ -6,10 +6,11 @@ SYNOPSIS gcloud beta container node-pools create NAME [--accelerator=[type=TYPE,[count=COUNT],...]] [--boot-disk-kms-key=BOOT_DISK_KMS_KEY] [--cluster=CLUSTER] - [--disk-size=DISK_SIZE] [--disk-type=DISK_TYPE] - [--enable-autoprovisioning] [--enable-autorepair] - [--no-enable-autoupgrade] [--enable-confidential-nodes] - [--enable-gvnic] [--enable-image-streaming] [--image-type=IMAGE_TYPE] + [--disable-pod-cidr-overprovision] [--disk-size=DISK_SIZE] + [--disk-type=DISK_TYPE] [--enable-autoprovisioning] + [--enable-autorepair] [--no-enable-autoupgrade] + [--enable-confidential-nodes] [--enable-gvnic] + [--enable-image-streaming] [--image-type=IMAGE_TYPE] [--machine-type=MACHINE_TYPE, -m MACHINE_TYPE] [--max-pods-per-node=MAX_PODS_PER_NODE] [--max-surge-upgrade=MAX_SURGE_UPGRADE; default=1] @@ -85,6 +86,10 @@ FLAGS The cluster to add the node pool to. Overrides the default container/cluster property value for this command invocation. + --disable-pod-cidr-overprovision + Disables pod cidr overprovision on nodes. Pod cidr overprovisioning is + enabled by default. + --disk-size=DISK_SIZE Size for node VM boot disks in GB. Defaults to 100GB. diff --git a/gcloud/beta/functions/deploy b/gcloud/beta/functions/deploy index 7f4015e6f..7f66b8aba 100644 --- a/gcloud/beta/functions/deploy +++ b/gcloud/beta/functions/deploy @@ -162,9 +162,11 @@ FLAGS ◆ go113: Go 1.13 ◆ go116: Go 1.16 (preview) ◆ java11: Java 11 + ◆ java17: Java 17 (preview) ◆ dotnet3: .NET Framework 3 ◆ ruby26: Ruby 2.6 ◆ ruby27: Ruby 2.7 + ◆ ruby30: Ruby 3.0 (preview) ◆ nodejs6: Node.js 6 (deprecated) ◆ nodejs8: Node.js 8 (deprecated) diff --git a/gcloud/beta/iam/service-accounts/undelete b/gcloud/beta/iam/service-accounts/undelete index d6420777b..846599231 100644 --- a/gcloud/beta/iam/service-accounts/undelete +++ b/gcloud/beta/iam/service-accounts/undelete @@ -36,8 +36,10 @@ API REFERENCE be found at: https://cloud.google.com/iam/ 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 iam service-accounts undelete $ gcloud alpha iam service-accounts undelete diff --git a/gcloud/beta/privateca/certificates/create b/gcloud/beta/privateca/certificates/create index 0ce3b9aee..0cc3bd42c 100644 --- a/gcloud/beta/privateca/certificates/create +++ b/gcloud/beta/privateca/certificates/create @@ -26,7 +26,7 @@ EXAMPLES $ gcloud beta privateca certificates create frontend-server-tls \ --issuer=server-tls-1 --issuer-location=us --generate-key \ --key-output-file=./key --cert-output-file=./cert.pem \ - --dns-san=www.joonix.net --reusable-config=server-tls + --dns-san=www.example.com --reusable-config=server-tls POSITIONAL ARGUMENTS CERTIFICATE resource - The name of the certificate to issue. If the diff --git a/gcloud/beta/privateca/roots/create b/gcloud/beta/privateca/roots/create index 1eab89ecc..21e4ae8cd 100644 --- a/gcloud/beta/privateca/roots/create +++ b/gcloud/beta/privateca/roots/create @@ -25,34 +25,34 @@ EXAMPLES To create a root CA that supports one layer of subordinates: $ gcloud beta privateca roots create prod-root \ - --kms-key-version="projects/joonix-pki/locations/us-west1/keyRin\ - gs/kr1/cryptoKeys/k1/cryptoKeyVersions/1" \ - --subject="CN=Joonix Production Root CA, O=Google" \ + --kms-key-version="projects/my-project-pki/locations/us-west1/ke\ + yRings/kr1/cryptoKeys/k1/cryptoKeyVersions/1" \ + --subject="CN=Example Production Root CA, O=Google" \ --max-chain-length=1 To create a root CA and restrict what it can issue: $ gcloud beta privateca roots create prod-root \ - --kms-key-version="projects/joonix-pki/locations/us-west1/keyRin\ - gs/kr1/cryptoKeys/k1/cryptoKeyVersions/1" \ - --subject="CN=Joonix Production Root CA, O=Google" \ + --kms-key-version="projects/my-project-pki/locations/us-west1/ke\ + yRings/kr1/cryptoKeys/k1/cryptoKeyVersions/1" \ + --subject="CN=Example Production Root CA, O=Google" \ --issuance-policy=policy.yaml To create a root CA that doesn't publicly publish CA certificate and CRLs: $ gcloud beta privateca roots create root-2 \ - --kms-key-version="projects/joonix-pki/locations/us-west1/keyRin\ - gs/kr1/cryptoKeys/k1/cryptoKeyVersions/1" \ - --subject="CN=Joonix Production Root CA, O=Google" \ + --kms-key-version="projects/my-project-pki/locations/us-west1/ke\ + yRings/kr1/cryptoKeys/k1/cryptoKeyVersions/1" \ + --subject="CN=Example Production Root CA, O=Google" \ --issuance-policy=policy.yaml --no-publish-ca-cert \ --no-publish-crl To create a root CA that is based on an existing CA: $ gcloud beta privateca roots create prod-root \ - --kms-key-version="projects/joonix-pki/locations/us-west1/keyRin\ - gs/kr1/cryptoKeys/k1/cryptoKeyVersions/1" --from-ca=source-root \ - --from-ca-location=us-central1 + --kms-key-version="projects/my-project-pki/locations/us-west1/ke\ + yRings/kr1/cryptoKeys/k1/cryptoKeyVersions/1" \ + --from-ca=source-root --from-ca-location=us-central1 POSITIONAL ARGUMENTS Certificate Authority resource - The name of the root CA to create. The diff --git a/gcloud/beta/privateca/subordinates/create b/gcloud/beta/privateca/subordinates/create index 8c77e52be..a04b89976 100644 --- a/gcloud/beta/privateca/subordinates/create +++ b/gcloud/beta/privateca/subordinates/create @@ -29,19 +29,19 @@ EXAMPLES CA: $ gcloud beta privateca subordinates create server-tls-1 \ - --subject="CN=Joonix TLS CA, O=Google" --issuer=prod-root \ + --subject="CN=Example TLS CA, O=Google" --issuer=prod-root \ --issuer-location=us-west1 \ - --kms-key-version="projects/joonix-pki/locations/us-west1/keyRin\ - gs/kr1/cryptoKeys/key2/cryptoKeyVersions/1" + --kms-key-version="projects/my-project-pki/locations/us-west1/ke\ + yRings/kr1/cryptoKeys/key2/cryptoKeyVersions/1" To create a subordinate CA named 'server-tls-1' whose issuer is located elsewhere: $ gcloud beta privateca subordinates create server-tls-1 \ - --subject="CN=Joonix TLS CA, O=Google" --create-csr \ + --subject="CN=Example TLS CA, O=Google" --create-csr \ --csr-output-file="./csr.pem" \ - --kms-key-version="projects/joonix-pki/locations/us-west1/keyRin\ - gs/kr1/cryptoKeys/key2/cryptoKeyVersions/1" + --kms-key-version="projects/my-project-pki/locations/us-west1/ke\ + yRings/kr1/cryptoKeys/key2/cryptoKeyVersions/1" To create a subordinate CA named 'server-tls-1' chaining up to a root CA named 'prod-root' based on an existing CA: @@ -49,8 +49,8 @@ EXAMPLES $ gcloud beta privateca subordinates create server-tls-1 \ --issuer=prod-root --issuer-location=us-west1 \ --from-ca=source-ca --from-ca-location=us-central1 \ - --kms-key-version="projects/joonix-pki/locations/us-west1/keyRin\ - gs/kr1/cryptoKeys/key2/cryptoKeyVersions/1" + --kms-key-version="projects/my-project-pki/locations/us-west1/ke\ + yRings/kr1/cryptoKeys/key2/cryptoKeyVersions/1" POSITIONAL ARGUMENTS Certificate Authority resource - The name of the subordinate CA to create. diff --git a/gcloud/bms/help b/gcloud/bms/help index 69895b56d..c94bec74a 100644 --- a/gcloud/bms/help +++ b/gcloud/bms/help @@ -21,6 +21,9 @@ GROUPS networks Manage networks in Bare Metal Solution. + nfs-shares + Manage NFS shares in Bare Metal Solution. + operations Manage operations in Bare Metal Solution. diff --git a/gcloud/bms/instances/help b/gcloud/bms/instances/help index 2b03f33ad..a3e196e5c 100644 --- a/gcloud/bms/instances/help +++ b/gcloud/bms/instances/help @@ -24,6 +24,12 @@ COMMANDS reset Reset a Bare Metal Solution instance. + start + Start a Bare Metal Solution instance. + + update + Update a Bare Metal Solution instance. + NOTES This variant is also available: diff --git a/gcloud/bms/instances/list b/gcloud/bms/instances/list index 84e81bac4..03d7af7a8 100644 --- a/gcloud/bms/instances/list +++ b/gcloud/bms/instances/list @@ -2,8 +2,8 @@ NAME gcloud bms instances list - list Bare Metal Solution instances in a project SYNOPSIS - gcloud bms instances list --region=REGION [--limit=LIMIT] - [GCLOUD_WIDE_FLAG ...] + gcloud bms instances list --region=REGION [--filter=EXPRESSION] + [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION List Bare Metal Solution instances in a project. @@ -34,6 +34,13 @@ FLAGS ▸ provide the argument --region on the command line. LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --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: diff --git a/gcloud/bms/instances/start b/gcloud/bms/instances/start new file mode 100644 index 000000000..e6b0f197a --- /dev/null +++ b/gcloud/bms/instances/start @@ -0,0 +1,64 @@ +NAME + gcloud bms instances start - start a Bare Metal Solution instance + +SYNOPSIS + gcloud bms instances start (INSTANCE : --region=REGION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Starts up a Bare Metal Solution instance. + +EXAMPLES + To start an instance named test-instance, run: + + $ gcloud bms instances start test-instance + +POSITIONAL ARGUMENTS + Instance resource - Arguments and flags that specify the Bare Metal + Solution instance you want to start. 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 instance on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. To + set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --region=REGION + Region of the resource. To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the baremetalsolution/v2 API. The full documentation for + this API can be found at: https://cloud.google.com/bare-metal + +NOTES + This variant is also available: + + $ gcloud alpha bms instances start + diff --git a/gcloud/bms/instances/update b/gcloud/bms/instances/update new file mode 100644 index 000000000..54b2c4b38 --- /dev/null +++ b/gcloud/bms/instances/update @@ -0,0 +1,96 @@ +NAME + gcloud bms instances update - update a Bare Metal Solution instance + +SYNOPSIS + gcloud bms instances update (INSTANCE : --region=REGION) + [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a Bare Metal Solution instance. + + This call returns immediately, but the update operation may take several + minutes to complete. To check if the operation is complete, use the + describe command for the instance. + +EXAMPLES + To update an instance called my-instance in region us-central1 with a new + label key1=value1, run: + + $ gcloud bms instances update my-instance --region=us-central1 \ + --update-labels=key1=value1 + + To clear all labels, run: + + $ gcloud bms instances update my-instance --region=us-central1 \ + --clear-labels + +POSITIONAL ARGUMENTS + Instance resource - instance. 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 instance on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. To + set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --region=REGION + Region of the resource. To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud bms instances update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud bms instances update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha bms instances update + diff --git a/gcloud/bms/networks/help b/gcloud/bms/networks/help index 1b15bba53..38fe7c828 100644 --- a/gcloud/bms/networks/help +++ b/gcloud/bms/networks/help @@ -21,6 +21,9 @@ COMMANDS list List Bare Metal Solution networks in a project. + update + Update a Bare Metal Solution network. + NOTES This variant is also available: diff --git a/gcloud/bms/networks/update b/gcloud/bms/networks/update new file mode 100644 index 000000000..0dc1e7be4 --- /dev/null +++ b/gcloud/bms/networks/update @@ -0,0 +1,96 @@ +NAME + gcloud bms networks update - update a Bare Metal Solution network + +SYNOPSIS + gcloud bms networks update (NETWORK : --region=REGION) + [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a Bare Metal Solution network. + + This call returns immediately, but the update operation may take several + minutes to complete. To check if the operation is complete, use the + describe command for the network. + +EXAMPLES + To update an network called my-network in region us-central1 with a new + label key1=value1, run: + + $ gcloud bms networks update my-network --region=us-central1 \ + --update-labels=key1=value1 + + To clear all labels, run: + + $ gcloud bms networks update my-network --region=us-central1 \ + --clear-labels + +POSITIONAL ARGUMENTS + Network resource - network. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. To set the + project attribute: + ◆ provide the argument network on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + NETWORK + ID of the network or fully qualified identifier for the network. To + set the network attribute: + ▸ provide the argument network on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --region=REGION + Region of the resource. To set the region attribute: + ▸ provide the argument network on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud bms networks update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud bms networks update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha bms networks update + diff --git a/gcloud/bms/nfs-shares/describe b/gcloud/bms/nfs-shares/describe new file mode 100644 index 000000000..b8eecc5bb --- /dev/null +++ b/gcloud/bms/nfs-shares/describe @@ -0,0 +1,56 @@ +NAME + gcloud bms nfs-shares describe - describe a Bare Metal solution NFS share + +SYNOPSIS + gcloud bms nfs-shares describe (NFS_SHARE : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a Bare Metal Solution NFS share. + +EXAMPLES + To get a description of an NFS share called my-nfs-share in project + my-project and region us-central1, run: + + $ gcloud bms nfs-shares describe my-nfs-share --project=my-project \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Nfs share resource - nfs_share. 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 nfs_share on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + NFS_SHARE + ID of the nfs_share or fully qualified identifier for the nfs_share. + To set the nfs_share attribute: + ▸ provide the argument nfs_share on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --region=REGION + Region of the resource. To set the region attribute: + ▸ provide the argument nfs_share on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha bms nfs-shares describe + diff --git a/gcloud/bms/nfs-shares/help b/gcloud/bms/nfs-shares/help new file mode 100644 index 000000000..ee8376b30 --- /dev/null +++ b/gcloud/bms/nfs-shares/help @@ -0,0 +1,31 @@ +NAME + gcloud bms nfs-shares - manage NFS shares in Bare Metal Solution + +SYNOPSIS + gcloud bms nfs-shares COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage NFS shares in Bare Metal Solution. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Describe a Bare Metal solution NFS share. + + list + List Bare Metal Solution NFS shares in a project. + + update + Update a Bare Metal Solution NFS share. + +NOTES + This variant is also available: + + $ gcloud alpha bms nfs-shares + diff --git a/gcloud/bms/nfs-shares/list b/gcloud/bms/nfs-shares/list new file mode 100644 index 000000000..ecde9b660 --- /dev/null +++ b/gcloud/bms/nfs-shares/list @@ -0,0 +1,62 @@ +NAME + gcloud bms nfs-shares list - list Bare Metal Solution NFS shares in a + project + +SYNOPSIS + gcloud bms nfs-shares list --region=REGION [--filter=EXPRESSION] + [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Bare Metal Solution NFS shares in a project. + +EXAMPLES + To list NFS shares within the project in the region us-central1, run: + + $ gcloud bms nfs-shares list --region=us-central1 + + Or: + + To list all NFS shares in the project, run: + + $ gcloud bms nfs-shares list + +FLAGS + Region resource - region. This represents a Cloud resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. To set the project attribute: + ◆ provide the argument --region on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --region=REGION + ID of the region or fully qualified identifier for the region. To set + the region attribute: + ▸ provide the argument --region on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha bms nfs-shares list + diff --git a/gcloud/bms/nfs-shares/update b/gcloud/bms/nfs-shares/update new file mode 100644 index 000000000..3cda4cde0 --- /dev/null +++ b/gcloud/bms/nfs-shares/update @@ -0,0 +1,101 @@ +NAME + gcloud bms nfs-shares update - update a Bare Metal Solution NFS share + +SYNOPSIS + gcloud bms nfs-shares update (NFS_SHARE : --region=REGION) + [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a Bare Metal Solution NFS share. + + This call returns immediately, but the update operation may take several + minutes to complete. To check if the operation is complete, use the + describe command for the NFS share. + +EXAMPLES + To update an NFS share called my-share in region us-central1 with a new + label key1=value1, run: + + $ gcloud bms nfs-shares update my-share --region=us-central1 \ + --update-labels=key1=value1 + + To clear all labels, run: + + $ gcloud bms nfs-shares update my-share --region=us-central1 \ + --clear-labels + + To remove label key1, run: + + $ gcloud bms nfs-shares update my-share --region=us-central1 \ + --remove-labels=key1 + +POSITIONAL ARGUMENTS + Nfs share resource - nfs_share. 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 nfs_share on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + NFS_SHARE + ID of the nfs_share or fully qualified identifier for the nfs_share. + To set the nfs_share attribute: + ▸ provide the argument nfs_share on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --region=REGION + Region of the resource. To set the region attribute: + ▸ provide the argument nfs_share on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud bms nfs-shares update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud bms nfs-shares update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha bms nfs-shares update + diff --git a/gcloud/bms/volumes/help b/gcloud/bms/volumes/help index 44014c750..bdbc99055 100644 --- a/gcloud/bms/volumes/help +++ b/gcloud/bms/volumes/help @@ -27,6 +27,9 @@ COMMANDS list List Bare Metal Solution volumes in a project. + update + Update a Bare Metal Solution volume. + NOTES This variant is also available: diff --git a/gcloud/bms/volumes/list b/gcloud/bms/volumes/list index 2690854c1..03c96e211 100644 --- a/gcloud/bms/volumes/list +++ b/gcloud/bms/volumes/list @@ -2,8 +2,8 @@ NAME gcloud bms volumes list - list Bare Metal Solution volumes in a project SYNOPSIS - gcloud bms volumes list --region=REGION [--limit=LIMIT] - [GCLOUD_WIDE_FLAG ...] + gcloud bms volumes list --region=REGION [--filter=EXPRESSION] + [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION List Bare Metal Solution volumes in a project. @@ -34,6 +34,13 @@ FLAGS ▸ provide the argument --region on the command line. LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --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: diff --git a/gcloud/bms/volumes/update b/gcloud/bms/volumes/update new file mode 100644 index 000000000..e93cddb57 --- /dev/null +++ b/gcloud/bms/volumes/update @@ -0,0 +1,93 @@ +NAME + gcloud bms volumes update - update a Bare Metal Solution volume + +SYNOPSIS + gcloud bms volumes update (VOLUME : --region=REGION) + [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a Bare Metal Solution volume. + + This call returns immediately, but the update operation may take several + minutes to complete. To check if the operation is complete, use the + describe command for the volume. + +EXAMPLES + To add the label 'key1=value1' to a policy, run: + + $ gcloud bms volumes update my-volume --update-labels=key1=value1 + + To clear all labels, run: + + $ gcloud bms volumes update my-volume --clear-labels + +POSITIONAL ARGUMENTS + Volume resource - volume. 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 volume on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + VOLUME + ID of the volume or fully qualified identifier for the volume. To set + the volume attribute: + ▸ provide the argument volume on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --region=REGION + Region of the resource. To set the region attribute: + ▸ provide the argument volume on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud bms volumes update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud bms volumes update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha bms volumes update + diff --git a/gcloud/composer/environments/create b/gcloud/composer/environments/create index 401beb665..1fd58e81b 100644 --- a/gcloud/composer/environments/create +++ b/gcloud/composer/environments/create @@ -175,15 +175,15 @@ FLAGS Must be of the form `X.Y[.Z]`. - The latest supported Cloud Composer version will be used within - the created environment. + The current Cloud Composer version will be used within the created + environment. --image-version=IMAGE_VERSION Version of the image to run in the environment. The image version encapsulates the versions of both Cloud Composer and Apache Airflow. Must be of the form - `composer-A.B.C[-D.E]-airflow-X.Y[.Z]`. + `composer-A[.B.C[-D.E]]-airflow-X.Y[.Z]`. The Cloud Composer and Airflow versions are semantic versions. `latest` can be provided instead of an explicit Cloud Composer diff --git a/gcloud/compute/routers/nats/create b/gcloud/compute/routers/nats/create index 0d269ca41..b81f9d50b 100644 --- a/gcloud/compute/routers/nats/create +++ b/gcloud/compute/routers/nats/create @@ -69,10 +69,13 @@ REQUIRED FLAGS --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME],[...] List of subnetwork primary and secondary IP ranges to be allowed to - use NAT. [SUBNETWORK]: including a subnetwork name includes only the - primary subnet range of the subnetwork. [SUBNETWORK]:[RANGE_NAME]: - specifying a subnetwork and secondary range name includes only that - secondary range.It does not include the primary range of the subnet. + use NAT. + + ▸ SUBNETWORK - including a subnetwork name includes only the + primary subnet range of the subnetwork. + ▸ SUBNETWORK:RANGE_NAME - specifying a subnetwork and secondary + range name includes only that secondary range. It does not include + the primary range of the subnet. --nat-primary-subnet-ip-ranges Allow only primary IP ranges of all subnetworks in the region to use diff --git a/gcloud/compute/routers/nats/update b/gcloud/compute/routers/nats/update index 599d9ddf6..e66793240 100644 --- a/gcloud/compute/routers/nats/update +++ b/gcloud/compute/routers/nats/update @@ -242,10 +242,13 @@ OPTIONAL FLAGS --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME],[...] List of subnetwork primary and secondary IP ranges to be allowed to - use NAT. [SUBNETWORK]: including a subnetwork name includes only the - primary subnet range of the subnetwork. [SUBNETWORK]:[RANGE_NAME]: - specifying a subnetwork and secondary range name includes only that - secondary range.It does not include the primary range of the subnet. + use NAT. + + ▸ SUBNETWORK - including a subnetwork name includes only the + primary subnet range of the subnetwork. + ▸ SUBNETWORK:RANGE_NAME - specifying a subnetwork and secondary + range name includes only that secondary range. It does not include + the primary range of the subnet. --nat-primary-subnet-ip-ranges Allow only primary IP ranges of all subnetworks in the region to use diff --git a/gcloud/container/aws/node-pools/update b/gcloud/container/aws/node-pools/update index 0cdffe40a..b9f8bf752 100644 --- a/gcloud/container/aws/node-pools/update +++ b/gcloud/container/aws/node-pools/update @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud container aws node-pools update (NODE_POOL : --cluster=CLUSTER --location=LOCATION) [--async] - [--node-version=NODE_VERSION] [--validate-only] + [--node-version=NODE_VERSION] + [--security-group-ids=[SECURITY_GROUP_ID,...]] [--validate-only] [--max-nodes=MAX_NODES --min-nodes=MIN_NODES] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -62,6 +63,9 @@ FLAGS --node-version=NODE_VERSION Kubernetes version to use for the node pool. + --security-group-ids=[SECURITY_GROUP_ID,...] + IDs of additional security groups to add to nodes. + --validate-only Validate the node pool to update, but don't actually perform it. diff --git a/gcloud/functions/deploy b/gcloud/functions/deploy index 6742d032b..3fb782114 100644 --- a/gcloud/functions/deploy +++ b/gcloud/functions/deploy @@ -138,9 +138,11 @@ FLAGS ◆ go113: Go 1.13 ◆ go116: Go 1.16 (preview) ◆ java11: Java 11 + ◆ java17: Java 17 (preview) ◆ dotnet3: .NET Framework 3 ◆ ruby26: Ruby 2.6 ◆ ruby27: Ruby 2.7 + ◆ ruby30: Ruby 3.0 (preview) ◆ nodejs6: Node.js 6 (deprecated) ◆ nodejs8: Node.js 8 (deprecated) diff --git a/gcloud/iam/service-accounts/help b/gcloud/iam/service-accounts/help index a5204150d..18e74bffa 100644 --- a/gcloud/iam/service-accounts/help +++ b/gcloud/iam/service-accounts/help @@ -62,6 +62,9 @@ COMMANDS sign-blob Sign a blob with a managed service account key. + undelete + Undelete a service account for a project. + update Update an IAM service account. diff --git a/gcloud/iam/service-accounts/undelete b/gcloud/iam/service-accounts/undelete new file mode 100644 index 000000000..d9e602668 --- /dev/null +++ b/gcloud/iam/service-accounts/undelete @@ -0,0 +1,44 @@ +NAME + gcloud iam service-accounts undelete - undelete a service account for a + project + +SYNOPSIS + gcloud iam service-accounts undelete ACCOUNT_ID [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Undelete a service account for a project. + + If the service account does not exist, this command returns a + PERMISSION_DENIED error. + +EXAMPLES + The following command undeletes a service account with unique id + 103271949540120710052: + + $ gcloud iam service-accounts undelete 103271949540120710052 + +POSITIONAL ARGUMENTS + ACCOUNT_ID + The deleted service account's unique ID must be provided when using the + undelete command. Unique IDs are a 21 digit number, such as + 103271949540120710052. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ + +NOTES + These variants are also available: + + $ gcloud alpha iam service-accounts undelete + + $ gcloud beta iam service-accounts undelete + diff --git a/gcloud/network-connectivity/help b/gcloud/network-connectivity/help index c1d7ed128..645d02fec 100644 --- a/gcloud/network-connectivity/help +++ b/gcloud/network-connectivity/help @@ -18,6 +18,9 @@ GROUPS hubs Manage Network Connectivity Center hubs. + locations + Get information about supported Network Connectivity Center locations. + operations Manage Network Connectivity Center operations. diff --git a/gcloud/network-connectivity/locations/describe b/gcloud/network-connectivity/locations/describe new file mode 100644 index 000000000..0e5c83a27 --- /dev/null +++ b/gcloud/network-connectivity/locations/describe @@ -0,0 +1,44 @@ +NAME + gcloud network-connectivity locations describe - describe a Network + Connectivity Center location + +SYNOPSIS + gcloud network-connectivity locations describe LOCATION + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Retrieve details about a location. + +EXAMPLES + To describe location us-central1, run: + + $ gcloud network-connectivity locations describe us-central1 + +POSITIONAL ARGUMENTS + Location resource - Name of the location to describe. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. To set the project attribute: + ◆ provide the argument location on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + LOCATION + ID of the location or fully qualified identifier for the location. To + set the location attribute: + ▸ provide the argument location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest diff --git a/gcloud/network-connectivity/locations/help b/gcloud/network-connectivity/locations/help new file mode 100644 index 000000000..e054acf16 --- /dev/null +++ b/gcloud/network-connectivity/locations/help @@ -0,0 +1,23 @@ +NAME + gcloud network-connectivity locations - get information about supported + Network Connectivity Center locations + +SYNOPSIS + gcloud network-connectivity locations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get information about supported Network Connectivity Center locations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Describe a Network Connectivity Center location. + + list + List Network Connectivity Center locations. diff --git a/gcloud/network-connectivity/locations/list b/gcloud/network-connectivity/locations/list new file mode 100644 index 000000000..f26e31c91 --- /dev/null +++ b/gcloud/network-connectivity/locations/list @@ -0,0 +1,69 @@ +NAME + gcloud network-connectivity locations list - list Network Connectivity + Center locations + +SYNOPSIS + gcloud network-connectivity locations list [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Retrieve and display a list of locations. + + Network Connectivity Center includes two general types of spokes: those + that use the site-to-site data transfer feature and those that don't. To + get a list of the locations that support one of these features, use the + --filter flag (see examples). The full list of location features can be + found here: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest/Shared.Types/LocationFeature + + To specify the maximum number of locations to return, use the --limit flag. + +EXAMPLES + To list all locations, run: + + $ gcloud network-connectivity locations list + + To list locations that support the site-to-site data transfer feature, run: + + $ gcloud network-connectivity locations list \ + --filter="metadata.locationFeatures=SITE_TO_SITE_SPOKES" + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest diff --git a/gcloud/privateca/certificates/create b/gcloud/privateca/certificates/create index b85c4db66..59cb6efe5 100644 --- a/gcloud/privateca/certificates/create +++ b/gcloud/privateca/certificates/create @@ -33,7 +33,7 @@ EXAMPLES $ gcloud privateca certificates create frontend-server-tls \ --issuer-pool=my-pool --issuer-location=us-west1 \ --generate-key --key-output-file=./key \ - --cert-output-file=./cert.pem --dns-san=www.joonix.net \ + --cert-output-file=./cert.pem --dns-san=www.example.com \ --use-preset-profile=leaf_server_tls POSITIONAL ARGUMENTS diff --git a/gcloud/privateca/roots/create b/gcloud/privateca/roots/create index ca33ec1ad..f89c130c3 100644 --- a/gcloud/privateca/roots/create +++ b/gcloud/privateca/roots/create @@ -23,17 +23,17 @@ EXAMPLES $ gcloud privateca roots create prod-root --location=us-west1 \ --pool=my-pool \ - --kms-key-version="projects/joonix-pki/locations/us-west1/keyRin\ - gs/kr1/cryptoKeys/k1/cryptoKeyVersions/1" \ - --subject="CN=Joonix Production Root CA, O=Google" \ + --kms-key-version="projects/my-project-pki/locations/us-west1/ke\ + yRings/kr1/cryptoKeys/k1/cryptoKeyVersions/1" \ + --subject="CN=Example Production Root CA, O=Google" \ --max-chain-length=1 To create a root CA that is based on an existing CA: $ gcloud privateca roots create prod-root --location=us-west1 \ --pool=my-pool \ - --kms-key-version="projects/joonix-pki/locations/us-west1/keyRin\ - gs/kr1/cryptoKeys/k1/cryptoKeyVersions/1" --from-ca=source-root + --kms-key-version="projects/my-project-pki/locations/us-west1/ke\ + yRings/kr1/cryptoKeys/k1/cryptoKeyVersions/1" --from-ca=source-root POSITIONAL ARGUMENTS Certificate Authority resource - The name of the root CA to create. The diff --git a/gcloud/privateca/subordinates/create b/gcloud/privateca/subordinates/create index 1e2db85bd..63a373102 100644 --- a/gcloud/privateca/subordinates/create +++ b/gcloud/privateca/subordinates/create @@ -27,20 +27,20 @@ EXAMPLES $ gcloud privateca subordinates create server-tls-1 \ --location=us-west1 --pool=my-pool \ - --subject="CN=Joonix TLS CA, O=Google" \ + --subject="CN=Example TLS CA, O=Google" \ --issuer-pool=other-pool --issuer-location=us-west1 \ - --kms-key-version="projects/joonix-pki/locations/us-west1/keyRin\ - gs/kr1/cryptoKeys/key2/cryptoKeyVersions/1" + --kms-key-version="projects/my-project-pki/locations/us-west1/ke\ + yRings/kr1/cryptoKeys/key2/cryptoKeyVersions/1" To create a subordinate CA named 'server-tls-1' whose issuer is located elsewhere: $ gcloud privateca subordinates create server-tls-1 \ --location=us-west1 --pool=my-pool \ - --subject="CN=Joonix TLS CA, O=Google" --create-csr \ + --subject="CN=Example TLS CA, O=Google" --create-csr \ --csr-output-file=./csr.pem \ - --kms-key-version="projects/joonix-pki/locations/us-west1/keyRin\ - gs/kr1/cryptoKeys/key2/cryptoKeyVersions/1" + --kms-key-version="projects/my-project-pki/locations/us-west1/ke\ + yRings/kr1/cryptoKeys/key2/cryptoKeyVersions/1" To create a subordinate CA named 'server-tls-1' chaining up to a root CA named 'prod-root' based on an existing CA: @@ -48,8 +48,8 @@ EXAMPLES $ gcloud privateca subordinates create server-tls-1 \ --location=us-west1 --pool=my-pool --issuer-pool=other-pool \ --issuer-location=us-west1 --from-ca=source-ca \ - --kms-key-version="projects/joonix-pki/locations/us-west1/keyRin\ - gs/kr1/cryptoKeys/key2/cryptoKeyVersions/1" + --kms-key-version="projects/my-project-pki/locations/us-west1/ke\ + yRings/kr1/cryptoKeys/key2/cryptoKeyVersions/1" POSITIONAL ARGUMENTS Certificate Authority resource - The name of the subordinate CA to create. diff --git a/gcloud/redis/instances/create b/gcloud/redis/instances/create index f4252b319..54e8b068f 100644 --- a/gcloud/redis/instances/create +++ b/gcloud/redis/instances/create @@ -6,9 +6,11 @@ SYNOPSIS [--alternative-zone=ALTERNATIVE_ZONE] [--async] [--connect-mode=CONNECT_MODE] [--display-name=DISPLAY_NAME] [--enable-auth] [--labels=[KEY=VALUE,...]] - [--network=NETWORK; default="default"] [--redis-config=KEY=VALUE] - [--redis-version=VERSION] [--reserved-ip-range=RESERVED_IP_RANGE] - [--size=SIZE; default=1] [--tier=TIER; default="basic"] + [--network=NETWORK; default="default"] + [--read-replicas-mode=READ_REPLICAS_MODE] [--redis-config=KEY=VALUE] + [--redis-version=VERSION] [--replica-count=REPLICA_COUNT] + [--reserved-ip-range=RESERVED_IP_RANGE] [--size=SIZE; default=1] + [--tier=TIER; default="basic"] [--transit-encryption-mode=TRANSIT_ENCRYPTION_MODE] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] @@ -91,6 +93,21 @@ FLAGS will be connected. If left unspecified, the default network will be used. + --read-replicas-mode=READ_REPLICAS_MODE + Read replicas mode used by the instance. Only works against standard + tier instances with 5GB and above provisioned capacity. + READ_REPLICAS_MODE must be one of: + + read-replicas-disabled + Read replica is disabled for the instance. Read endpoint will not + be provided and the instance cannot scale up or down the number of + replicas. + + read-replicas-enabled + Read replica is enabled for the instance. Read endpoint will be + provided and the instance can scale up and down the number of + replicas. + --redis-config=KEY=VALUE A list of Redis config KEY=VALUE pairs to set on the instance according to http://redis.io/topics/config. Currently, the only supported @@ -117,6 +134,9 @@ FLAGS redis_6_x Redis 6.x compatibility + --replica-count=REPLICA_COUNT + The replica count of the instance. + --reserved-ip-range=RESERVED_IP_RANGE The CIDR range of internal addresses that are reserved for this instance. For example, 10.0.0.0/29 or 192.168.0.0/29. Range must be diff --git a/gcloud/redis/instances/update b/gcloud/redis/instances/update index c0e160dfd..2a2f8978e 100644 --- a/gcloud/redis/instances/update +++ b/gcloud/redis/instances/update @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud redis instances update (INSTANCE : --region=REGION) [--async] [--display-name=DISPLAY_NAME] [--enable-auth] - [--remove-redis-config=[KEY,...]] [--size=SIZE] + [--read-replicas-mode=READ_REPLICAS_MODE] + [--remove-redis-config=[KEY,...]] [--replica-count=REPLICA_COUNT] + [--secondary-ip-range=SECONDARY_IP_RANGE] [--size=SIZE] [--update-labels=[KEY=VALUE,...]] [--update-redis-config=KEY=VALUE] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -67,10 +69,38 @@ FLAGS --enable-auth Enables Redis AUTH for the instance. + --read-replicas-mode=READ_REPLICAS_MODE + Read replicas mode used by the instance. Only works against standard + tier instances with 5GB and above provisioned capacity and Redis + version 5.0 and above. This is an irreversible update i.e. Read + replicas can not be disabled for the instance once it is enabled. Also + this update is exclusive and cannot be clubbed with other update + operations. READ_REPLICAS_MODE must be one of: + + read-replicas-disabled + If read replica is not enabled on the instance, no changes are + done. If read replica is enabled for the instance, update operation + fails + + read-replicas-enabled + Read replica is enabled for the instance if not already enabled. + Read endpoint will be provided and the instance can scale up and + down the number of replicas. + --remove-redis-config=[KEY,...] A list of Redis config parameters to remove. Removing a non-existent config parameter is silently ignored. + --replica-count=REPLICA_COUNT + The replica count of the instance. Valid from 0 to 5. + + --secondary-ip-range=SECONDARY_IP_RANGE + Required only when read-replicas-mode is enabled on the instance. The + CIDR range of internal addresses that are reserved for this instance. + For example, 10.0.0.0/28 or 192.168.0.0/28. Range must be unique and + non-overlapping with existing ranges in the network. If value 'auto' + passed, the service will automatically pick an available range. + --size=SIZE The memory size of the instance in GiB. diff --git a/gcloud/transfer/agent-pools/create b/gcloud/transfer/agent-pools/create new file mode 100644 index 000000000..3a7071997 --- /dev/null +++ b/gcloud/transfer/agent-pools/create @@ -0,0 +1,59 @@ +NAME + gcloud transfer agent-pools create - create a Transfer Service agent pool + +SYNOPSIS + gcloud transfer agent-pools create NAME [--no-async] + [--bandwidth-limit=BANDWIDTH_LIMIT] [--display-name=DISPLAY_NAME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create an agent pool -- a group of agents used to connect to a source or + destination filesystem. + +EXAMPLES + To create an agent pool with name 'my-pool', display name 'daily backups', + and no bandwidth limit, run: + + $ gcloud transfer agent-pools create my-pool \ + --display-name='daily backups' + + To create an agent pool with name 'my-pool', display name 'daily backups', + and a bandwidth limit of 50 MB/s, run: + + $ gcloud transfer agent-pools create my-pool \ + --display-name="daily backups" --bandwidth-limit=50 + +POSITIONAL ARGUMENTS + NAME + A unique, permanent identifier for this pool. + +FLAGS + --no-async + Block other tasks in your terminal until the pool has been created. If + not included, pool creation will run asynchronously. + + --bandwidth-limit=BANDWIDTH_LIMIT + Set how much of your bandwidth to make available to this pool's agents. + A bandwidth limit applies to all agents in a pool and can help prevent + the pool's transfer workload from disrupting other operations that + share your bandwidth. For example, enter '50' to set a bandwidth limit + of 50 MB/s. By leaving this flag unspecified, this flag unspecified, + this pool's agents will use all bandwidth available to them. + + --display-name=DISPLAY_NAME + A modifiable name to help you identify this pool. You can include + details that might not fit in the pool's unique full resource name. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer agent-pools create + diff --git a/gcloud/transfer/agent-pools/delete b/gcloud/transfer/agent-pools/delete new file mode 100644 index 000000000..1b8f194d0 --- /dev/null +++ b/gcloud/transfer/agent-pools/delete @@ -0,0 +1,39 @@ +NAME + gcloud transfer agent-pools delete - delete a Transfer Service agent pool + +SYNOPSIS + gcloud transfer agent-pools delete NAME [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete an agent pool. Note that before you can delete a pool, all the + pool's agents must be stopped, its associated jobs must be disabled, and + there must be no associated in-progress transfer operations. + +EXAMPLES + To delete agent pool 'foo', run: + + $ gcloud transfer agent-pools delete foo + + To check if there are active operations associated with a pool before + deleting it, scroll through the results of: + + $ gcloud transfer operations list --format=yaml \ + --operation-statuses=in_progress + +POSITIONAL ARGUMENTS + NAME + The name of the job you want to delete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer agent-pools delete + diff --git a/gcloud/transfer/agent-pools/describe b/gcloud/transfer/agent-pools/describe new file mode 100644 index 000000000..07adf3f53 --- /dev/null +++ b/gcloud/transfer/agent-pools/describe @@ -0,0 +1,32 @@ +NAME + gcloud transfer agent-pools describe - get details about a specific agent + pool + +SYNOPSIS + gcloud transfer agent-pools describe NAME [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get details about a specific agent pool. + +EXAMPLES + To monitor an agent pool, run: + + $ gcloud transfer agent-pools describe NAME + +POSITIONAL ARGUMENTS + NAME + The name of the agent pool you want to describe. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer agent-pools describe + diff --git a/gcloud/transfer/agent-pools/help b/gcloud/transfer/agent-pools/help new file mode 100644 index 000000000..db3125a20 --- /dev/null +++ b/gcloud/transfer/agent-pools/help @@ -0,0 +1,37 @@ +NAME + gcloud transfer agent-pools - manage on-premise transfer agent pools + +SYNOPSIS + gcloud transfer agent-pools COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage on-premise transfer agent pools. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a Transfer Service agent pool. + + delete + Delete a Transfer Service agent pool. + + describe + Get details about a specific agent pool. + + list + List Transfer Service transfer agent pools. + + update + Update a Transfer Service agent pool. + +NOTES + This variant is also available: + + $ gcloud alpha transfer agent-pools + diff --git a/gcloud/transfer/agent-pools/list b/gcloud/transfer/agent-pools/list new file mode 100644 index 000000000..70d293f2e --- /dev/null +++ b/gcloud/transfer/agent-pools/list @@ -0,0 +1,50 @@ +NAME + gcloud transfer agent-pools list - list Transfer Service transfer agent + pools + +SYNOPSIS + gcloud transfer agent-pools list [--limit=LIMIT] [--names=[NAMES,...]] + [--page-size=PAGE_SIZE; default=256] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Transfer Service transfer pools in a given project to show their + configurations. + +EXAMPLES + To list all agent pools in your current project, run: + + $ gcloud transfer agent-pools list + + To list agent pools named "foo" and "bar" in your project, run: + + $ gcloud transfer agent-pools list --names=foo,bar + + To list all information about jobs 'foo' and 'bar' formatted as JSON, run: + + $ gcloud transfer agent-pools list --names=foo,bar --format=json + +FLAGS + --limit=LIMIT + Return the first items from the API up to this limit. + + --names=[NAMES,...] + The names of the agent pools you want to list. Separate multiple names + with commas (e.g., --name=foo,bar). If not specified, all agent pools + in your current project will be listed. + + --page-size=PAGE_SIZE; default=256 + Retrieve batches of this many items from the API. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer agent-pools list + diff --git a/gcloud/transfer/agent-pools/update b/gcloud/transfer/agent-pools/update new file mode 100644 index 000000000..fc10e809d --- /dev/null +++ b/gcloud/transfer/agent-pools/update @@ -0,0 +1,66 @@ +NAME + gcloud transfer agent-pools update - update a Transfer Service agent pool + +SYNOPSIS + gcloud transfer agent-pools update NAME [--bandwidth-limit=BANDWIDTH_LIMIT] + [--clear-bandwidth-limit] [--clear-display-name] + [--display-name=DISPLAY_NAME] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update an agent pool. + +EXAMPLES + To remove the bandwidth limit for agent pool 'foo', run: + + $ gcloud transfer agent-pools update foo --clear-bandwidth-limit + + To remove the display name for agent pool 'foo', run: + + $ gcloud transfer agent-pools update foo --clear-display-name + + To update the bandwidth limit for agent pool 'foo' to 100 MB/s, run: + + $ gcloud transfer agent-pools update foo --bandwidth-limit=100 + + To update the display name for agent pool 'foo' to 'example name', run: + + $ gcloud transfer agent-pools update foo \ + --display-name="example name" + +POSITIONAL ARGUMENTS + NAME + A unique, permanent identifier for this pool. + +FLAGS + --bandwidth-limit=BANDWIDTH_LIMIT + Set how much of your bandwidth to make available to this pool's agents. + A bandwidth limit applies to all agents in a pool and can help prevent + the pool's transfer workload from disrupting other operations that + share your bandwidth. For example, enter '50' to set a bandwidth limit + of 50 MB/s. By leaving this flag unspecified, this flag unspecified, + this pool's agents will use all bandwidth available to them. + + --clear-bandwidth-limit + Remove the agent pool's bandwidth limit, which enables the pool's + agents to use all bandwidth available to them. + + --clear-display-name + Remove the display name from the agent pool. + + --display-name=DISPLAY_NAME + A modifiable name to help you identify this pool. You can include + details that might not fit in the pool's unique full resource name. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer agent-pools update + diff --git a/gcloud/transfer/agents/delete b/gcloud/transfer/agents/delete new file mode 100644 index 000000000..b71f3b0be --- /dev/null +++ b/gcloud/transfer/agents/delete @@ -0,0 +1,49 @@ +NAME + gcloud transfer agents delete - delete a Transfer Service transfer agents + +SYNOPSIS + gcloud transfer agents delete [--ids=[IDS,...] | --all | --uninstall] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete agents and remove agent resources from your machine. + +EXAMPLES + If you plan to delete specific agents, you can list which agents are + running on your machine by running: + + $ docker container list --all \ + --filter ancestor=gcr.io/cloud-ingest/tsop-agent + + Then run: + + $ gcloud transfer agents delete --ids=id1,id2,... + +FLAGS + At most one of these can be specified: + + --ids=[IDS,...] + The IDs of the agents you want to delete. Separate multiple agent IDs + with commas, with no spaces following the commas. + + --all + Delete all agents running on your machine. + + --uninstall + Fully uninstall the agent Docker image in addition to deleting the + agents. Uninstalling the Docker image will free up space, but you'll + need to reinstall it to run agents on this machine in the future. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer agents delete + diff --git a/gcloud/transfer/agents/help b/gcloud/transfer/agents/help new file mode 100644 index 000000000..c087999ae --- /dev/null +++ b/gcloud/transfer/agents/help @@ -0,0 +1,31 @@ +NAME + gcloud transfer agents - manage Transfer Service agents + +SYNOPSIS + gcloud transfer agents COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage agents. Agents arre lightweight applications that enable Transfer + Service users to transfer data to or from POSIX filesystems, such as + on-premises filesystems. Agents are installed locally on your machine and + run within Docker containers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + Delete a Transfer Service transfer agents. + + install + Install Transfer Service agents. + +NOTES + This variant is also available: + + $ gcloud alpha transfer agents + diff --git a/gcloud/transfer/agents/install b/gcloud/transfer/agents/install new file mode 100644 index 000000000..d14783629 --- /dev/null +++ b/gcloud/transfer/agents/install @@ -0,0 +1,98 @@ +NAME + gcloud transfer agents install - install Transfer Service agents + +SYNOPSIS + gcloud transfer agents install --pool=POOL [--count=COUNT] + [--creds-file=CREDS_FILE] [--id-prefix=ID_PREFIX] + [--logs-directory=LOGS_DIRECTORY; default="/tmp"] + [--memlock-limit=MEMLOCK_LIMIT; default=64000000] + [--mount-directories=[MOUNT-DIRECTORIES,...]] [--proxy=PROXY] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Install Transfer Service agents to enable you to transfer data to or from + POSIX filesystems, such as on-premises filesystems. Agents are installed + locally on your machine and run inside Docker containers. + +EXAMPLES + To install an agent that authenticates with your user account credentials + and has default agent parameters, run: + + $ gcloud transfer agents install + + To install an agent that authenticates with a service account with + credentials stored at '/example/path.json', run: + + $ gcloud transfer agents install --creds-file=/example/path.json + +REQUIRED FLAGS + --pool=POOL + The agent pool to associate with the newly installed agent. When + creating transfer jobs, the agent pool parameter will determine which + agents are activated. + +OPTIONAL FLAGS + --count=COUNT + Specify the number of agents to install on your current machine. System + requirements: 8 GB of memory and 4 CPUs per agent. + + Note: If the 'id-prefix' flag is specified, Transfer Service increments + a number value after each prefix. Example: prefix1, prefix2, etc. + + --creds-file=CREDS_FILE + Specify the path to the service account's credentials file. + + No input required if authenticating with your user account credentials, + which Transfer Service will look for in your system. + + Note that the credentials location will be mounted to the agent + container. + + --id-prefix=ID_PREFIX + An optional prefix to add to the agent ID to help identify the agent. + + --logs-directory=LOGS_DIRECTORY; default="/tmp" + Specify the absolute path to the directory you want to store transfer + logs in. If not specified, gcloud transfer will mount your /tmp + directory for logs. + + --memlock-limit=MEMLOCK_LIMIT; default=64000000 + Set the agent container's memlock limit. A value of 64000000 (default) + or higher is required to ensure that agent versions 1.14 or later have + enough locked memory to be able to start. + + --mount-directories=[MOUNT-DIRECTORIES,...] + If you want to grant agents access to specific parts of your filesystem + instead of the entire filesystem, specify which directory paths to + mount to the agent container. Multiple paths must be separated by + commas with no spaces (e.g., + --mount-directories=/system/path/to/dir1,/path/to/dir2). When mounting + specific directories, gcloud transfer will also mount a directory for + logs (either /tmp or what you've specified for --logs-directory) and + your Google credentials file for agent authentication. + + If this flag is not specified, gcloud transfer will mount your entire + filesystem to the agent container. + + --proxy=PROXY + Specify the HTTP URL and port of a proxy server if you want to use a + forward proxy. For example, to use the URL 'example.com' and port + '8080' specify 'http://www.example.com:8080/' + + Ensure that you specify the HTTP URL and not an HTTPS URL to avoid + double-wrapping requests in TLS encryption. Double-wrapped requests + prevent the proxy server from sending valid outbound requests. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer agents install + diff --git a/gcloud/transfer/authorize b/gcloud/transfer/authorize new file mode 100644 index 000000000..55ec0ebde --- /dev/null +++ b/gcloud/transfer/authorize @@ -0,0 +1,55 @@ +NAME + gcloud transfer authorize - authorize an account for all Transfer Service + features + +SYNOPSIS + gcloud transfer authorize [--add-missing] [--creds-file=CREDS_FILE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Authorize a Google account for all Transfer Service features. + + This command provides admin and owner rights for simplicity. If that's too + much authority for your use case, see custom setups here: + https://cloud.google.com/storage-transfer/docs/on-prem-set-up + +EXAMPLES + To see what Transfer Service IAM roles the account logged into gcloud may + be missing, run: + + $ gcloud transfer authorize + + To add the missing IAM roles, run: + + $ gcloud transfer authorize --add-missing + + To check a custom service account for missing roles, run: + + $ gcloud transfer authorize \ + --creds-file=path/to/service-account-key.json + +FLAGS + --add-missing + Add IAM roles necessary to use all Transfer Service features to the + specified account. By default, this command just prints missing roles. + + --creds-file=CREDS_FILE + The path to the creds file for an account to authorize. The file should + be in JSON format and contain a "type" and "client_email", which are + automatically generated for most creds files downloaded from Google + (e.g. service account tokens). If this flag is not present, the command + authorizes the user currently logged into gcloud. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer authorize + diff --git a/gcloud/transfer/help b/gcloud/transfer/help new file mode 100644 index 000000000..c8f5b80f4 --- /dev/null +++ b/gcloud/transfer/help @@ -0,0 +1,46 @@ +NAME + gcloud transfer - manage Transfer Service jobs, operations, and agents + +SYNOPSIS + gcloud transfer GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + The gcloud transfer command group lets you create and manage Transfer + Service jobs, operations, and agents. + + To get started, run: gcloud transfer jobs create --help + + More info on prerequisite IAM permissions: + https://cloud.google.com/storage-transfer/docs/on-prem-set-up + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + agent-pools + Manage on-premise transfer agent pools. + + agents + Manage Transfer Service agents. + + jobs + Manage transfer jobs. + + operations + Manage transfer operations. + +COMMANDS + COMMAND is one of the following: + + authorize + Authorize an account for all Transfer Service features. + +NOTES + This variant is also available: + + $ gcloud alpha transfer + diff --git a/gcloud/transfer/jobs/create b/gcloud/transfer/jobs/create new file mode 100644 index 000000000..4d364f6f8 --- /dev/null +++ b/gcloud/transfer/jobs/create @@ -0,0 +1,335 @@ +NAME + gcloud transfer jobs create - create a Transfer Service transfer job + +SYNOPSIS + gcloud transfer jobs create SOURCE DESTINATION + [--name=NAME --description=DESCRIPTION + --source-creds-file=SOURCE_CREDS_FILE + --source-agent-pool=SOURCE_AGENT_POOL + --destination-agent-pool=DESTINATION_AGENT_POOL + --intermediate-storage-path=INTERMEDIATE_STORAGE_PATH + --manifest-file=MANIFEST_FILE] + [--do-not-run --schedule-starts=SCHEDULE_STARTS + --schedule-repeats-every=SCHEDULE_REPEATS_EVERY + --schedule-repeats-until=SCHEDULE_REPEATS_UNTIL] + [--include-prefixes=[INCLUDED_PREFIXES,...] + --exclude-prefixes=[EXCLUDED_PREFIXES,...] + --include-modified-before-absolute=INCLUDE_MODIFIED_BEFORE_ABSOLUTE + --include-modified-after-absolute=INCLUDE_MODIFIED_AFTER_ABSOLUTE + --include-modified-before-relative=INCLUDE_MODIFIED_BEFORE_RELATIVE + --include-modified-after-relative=INCLUDE_MODIFIED_AFTER_RELATIVE] + [--overwrite-when=OVERWRITE_WHEN --delete-from=DELETE_FROM + --preserve-metadata=[METADATA_FIELDS,...] + --custom-storage-class=CUSTOM_STORAGE_CLASS] + [--notification-pubsub-topic=NOTIFICATION_PUBSUB_TOPIC + --notification-event-types=[EVENT_TYPES,...] + --notification-payload-format=NOTIFICATION_PAYLOAD_FORMAT] + [--log-actions=[LOG_ACTIONS,...] + --log-action-states=[LOG_ACTION_STATES,...]] [--no-async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a Transfer Service transfer job, allowing you to transfer data to + Google Cloud Storage on a one-time or recurring basis. + +EXAMPLES + To create a one-time, immediate transfer job to move data from Google Cloud + Storage bucket "foo" into the "baz" folder in Cloud Storage bucket "bar", + run: + + $ gcloud transfer jobs create gs://foo gs://bar/baz/ + + To create a transfer job to move data from an Amazon S3 bucket called "foo" + to a Google Cloud Storage bucket named "bar" that runs every day with + custom name "my-test-job", run: + + $ gcloud transfer jobs create s3://foo gs://bar --name=my-test-job \ + --source-creds-file=/examplefolder/creds.txt \ + --schedule-repeats-every=1d + + To create a one-time, immediate transfer job to move data between Google + Cloud Storage buckets "foo" and "bar" with filters to include objects that + start with prefixes "baz" and "qux"; and objects modified in the 24 hours + before the transfer started, run: + + $ gcloud transfer jobs create gs://foo gs://bar/ \ + --include-prefixes=baz,qux --include-modified-after-relative=1d + + To create a one-time, immediate transfer job to move data from a directory + with absolute path "/foo/bar/" in the filesystem associated with agent pool + "my-pool" into Google Cloud Storage bucket "example-bucket", run: + + $ gcloud transfer jobs create posix:///foo/bar/ \ + gs://example-bucket --source-agent-pool=my-pool + +POSITIONAL ARGUMENTS + SOURCE + The source of your data. Available sources and formatting information: + + Public clouds - For Google Cloud Storage and Amazon S3, specify the + scheme of the source type; name of the resource; and, if transferring + from a folder, the path to the folder. For Azure Storage, note the + Azure-specific formatting below. For example: + ◆ [Google Cloud Storage] gs://example-bucket/example-folder + ◆ [Amazon S3] s3://examplebucket/example-folder + ◆ [Azure Blob Storage or Data Lake Storage] + http://examplestorageaccount.blob.core.windows.net/examplecontainer/examplefolder + + POSIX filesystem - Specify the posix:// scheme followed by the full + path to the desired directory. POSIX filesystem - Specify the posix:// + scheme followed by the absolute path to the desired directory, starting + from the root of the host machine (denoted by a leading slash). For + example: + ◆ posix:///path/directory/ + + A file transfer agent must be installed on the POSIX filesystem, and + you need an agent pool flag on this jobs command to activate the agent. + + Publicly-accessible objects - Specify the URL of a TSV file containing + a list of URLs of publicly-accessible objects. For example: + ◆ http://example.com/tsvfile + + DESTINATION + The destination of your transferred data. Available destinations and + formatting information: + + Google Cloud Storage - Specify the gs:// scheme; name of the bucket; + and, if transferring to a folder, the path to the folder. For example: + ◆ gs://example-bucket/example-folder + + POSIX filesystem - Specify the posix:// scheme followed by the full + path to the desired directory. POSIX filesystem - Specify the posix:// + scheme followed by the absolute path to the desired directory, starting + from the root of the host machine (denoted by a leading slash). For + example: + ◆ posix:///path/directory/ + + A file transfer agent must be installed on the POSIX filesystem, and + you need an agent pool flag on this jobs command to activate the agent. + +FLAGS + JOB INFORMATION + + --name=NAME + A unique identifier for the job. Referring to your source and + destination is recommended. If left blank, the name is auto-generated + upon submission of the job. + + --description=DESCRIPTION + An optional description to help identify the job using details that + don't fit in its name. + + --source-creds-file=SOURCE_CREDS_FILE + Path to a local file on your machine that includes credentials for an + Amazon S3 or Azure Blob Storage source (not required for Google Cloud + Storage sources). If not specified for an S3 source, gcloud will + check your system for an AWS config file. However, this flag must be + specified to use AWS's "role_arn" auth service. For formatting, see: + + S3: + https://cloud.google.com/storage-transfer/docs/reference/rest/v1/TransferSpec#AwsAccessKey + Note: Be sure to put quotations around the JSON value strings. + + Azure: + http://cloud/storage-transfer/docs/reference/rest/v1/TransferSpec#AzureCredentials + + --source-agent-pool=SOURCE_AGENT_POOL + If using a POSIX filesystem source, specify the ID of the agent pool + associated with source filesystem. + + --destination-agent-pool=DESTINATION_AGENT_POOL + If using a POSIX filesystem destination, specify the ID of the agent + pool associated with destination filesystem. + + --intermediate-storage-path=INTERMEDIATE_STORAGE_PATH + If transferring between filesystems, specify the path to a folder in + a Google Cloud Storage bucket (gs://example-bucket/example-folder) to + use as intermediary storage. Recommended: Use an empty folder + reserved for this transfer job to ensure transferred data doesn't + interact with any of your existing Cloud Storage data. + + --manifest-file=MANIFEST_FILE + Path to a .csv file in a Google Cloud Storage bucket containing a + list of files to transfer from your source. E.g., + gs://mybucket/manifest.csv. For manifest file formatting, see + https://cloud.google.com/storage-transfer/docs/manifest. + + SCHEDULE + + A job's schedule determines when and how often the job will run. For + formatting information, see + https://cloud.google.com/sdk/gcloud/reference/topic/datetimes. + + --do-not-run + Disable default Transfer Service behavior of running job upon + creation if no schedule is set. If this flag is specified, the job + won't run until an operation is manually started or a schedule is + added. + + --schedule-starts=SCHEDULE_STARTS + Set when the job will start using the %Y-%m-%dT%H:%M:%S%z datetime + format (e.g., 2020-04-12T06:42:12+04:00). If not set, the job will + run upon the successful submission of the create job command unless + the --do-not-run flag is included. + + --schedule-repeats-every=SCHEDULE_REPEATS_EVERY + Set the frequency of the job using the absolute duration format + (e.g., 1 month is p1m; 1 hour 30 minutes is 1h30m). If not set, the + job will run once. + + --schedule-repeats-until=SCHEDULE_REPEATS_UNTIL + Set when the job will stop recurring using the %Y-%m-%dT%H:%M:%S%z + datetime format (e.g., 2020-04-12T06:42:12+04:00). If specified, you + must also include a value for the --schedule-repeats-every flag. If + not specified, the job will continue to repeat as specified in its + repeat-every field unless the job is manually disabled or you add + this field later. + + OBJECT CONDITIONS + + A set of conditions to determine which objects are transferred. For + time-based object condition formatting tips, see + https://cloud.google.com/sdk/gcloud/reference/topic/datetimes. Note: If + you specify multiple conditions, objects must have at least one of the + specified 'include' prefixes and all of the specified time conditions. If + an object has an 'exclude' prefix, it will be excluded even if it matches + other conditions. + + --include-prefixes=[INCLUDED_PREFIXES,...] + Include only objects that start with the specified prefix(es). + Separate multiple prefixes with commas, omitting spaces after the + commas (e.g., --include-prefixes=foo,bar). + + --exclude-prefixes=[EXCLUDED_PREFIXES,...] + Exclude any objects that start with the prefix(es) entered. Separate + multiple prefixes with commas, omitting spaces after the commas + (e.g., --exclude-prefixes=foo,bar). + + --include-modified-before-absolute=INCLUDE_MODIFIED_BEFORE_ABSOLUTE + Include objects last modified before an absolute date/time. Ex. by + specifying '2020-01-01', the transfer would include objects last + modified before January 1, 2020. Use the %Y-%m-%dT%H:%M:%S%z datetime + format. + + --include-modified-after-absolute=INCLUDE_MODIFIED_AFTER_ABSOLUTE + Include objects last modified after an absolute date/time. Ex. by + specifying '2020-01-01', the transfer would include objects last + modified after January 1, 2020. Use the %Y-%m-%dT%H:%M:%S%z datetime + format. + + --include-modified-before-relative=INCLUDE_MODIFIED_BEFORE_RELATIVE + Include objects that were modified before a relative date/time in the + past. Ex. by specifying a duration of '10d', the transfer would + include objects last modified more than 10 days before its start + time. Use the absolute duration format (ex. 1m for 1 month; 1h30m for + 1 hour 30 minutes). + + --include-modified-after-relative=INCLUDE_MODIFIED_AFTER_RELATIVE + Include objects that were modified after a relative date/time in the + past. Ex. by specifying a duration of '10d', the transfer would + include objects last modified less than 10 days before its start + time. Use the absolute duration format (ex. 1m for 1 month; 1h30m for + 1 hour 30 minutes). + + TRANSFER OPTIONS + + --overwrite-when=OVERWRITE_WHEN + Determine when destination objects are overwritten by source objects. + Options include: + ▸ 'different' - Overwrites files with the same name if the contents + are different (e.g., if etags or checksums don't match) + ▸ 'always' - Overwrite destination file whenever source file has + the same name -- even if they're identical + + OVERWRITE_WHEN must be one of: always, different. + + --delete-from=DELETE_FROM + By default, transfer jobs won't delete any data from your source or + destination. These options enable you to delete data if needed for + your use case. Options include: + ▸ 'destination-if-unique' - Delete files from destination if + they're not also at source. Use to sync destination to source + (i.e., make destination match source exactly) + ▸ 'source-after-transfer' - Delete files from source after they're + transferred + + DELETE_FROM must be one of: destination-if-unique, + source-after-transfer. + + --preserve-metadata=[METADATA_FIELDS,...] + Specify object metadata values that can optionally be preserved. + Example: --preserve-metadata=storage-class,uid + + For more info, see: + https://cloud.google.com/storage-transfer/docs/metadata-preservation. + + METADATA_FIELDS must be one of: acl, gid, kms-key, mode, + storage-class, symlink, temporary-hold, uid. + + --custom-storage-class=CUSTOM_STORAGE_CLASS + Specifies the storage class to set on objects being transferred to + Google Cloud Storage buckets. If unspecified, the behavior is to + match the destination bucket default. The value "preserve" will use + the class from the object's Google Cloud Storage source bucket. + + NOTIFICATION CONFIG + + A configuration for receiving notifications oftransfer operation status + changes via Cloud Pub/Sub. + + --notification-pubsub-topic=NOTIFICATION_PUBSUB_TOPIC + Pub/Sub topic used for notifications. + + --notification-event-types=[EVENT_TYPES,...] + Define which change of transfer operation status will trigger Pub/Sub + notifications. Choices include 'success', 'failed', 'aborted'. To + trigger notifications for all three status changes, you can leave + this flag unspecified as long as you've specified a topic for the + --notification-pubsub-topic flag. EVENT_TYPES must be one of: + success, failed, aborted. + + --notification-payload-format=NOTIFICATION_PAYLOAD_FORMAT + If 'none', no transfer operation details are included with + notifications. If 'json', a json representation of the relevant + transfer operation is included in notification messages (e.g., to see + errors after an operation fails). NOTIFICATION_PAYLOAD_FORMAT must be + one of: json, none. + + LOGGING CONFIG + + Configure which transfer actions and action states are reported when logs + are generated for this job. Logs can be viewed by running the following + command: gcloud logging read "resource.type=storage_transfer_job" + + --log-actions=[LOG_ACTIONS,...] + Define the transfer operation actions to report in logs. Separate + multiple actions with commas, omitting spaces after the commas (e.g., + --log-actions=find,copy). LOG_ACTIONS must be one of: copy, delete, + find. + + --log-action-states=[LOG_ACTION_STATES,...] + The states in which the actions specified in --log-actions are + logged. Separate multiple states with a comma, omitting the space + after the comma (e.g., --log-action-states=succeeded,failed). + LOG_ACTION_STATES must be one of: failed, succeeded. + + EXECUTION OPTIONS + + --no-async + For jobs set to run upon creation, this flag blocks other tasks in + your terminal until the job's initial, immediate transfer operation + has completed. If not included, tasks will run asynchronously. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer jobs create + diff --git a/gcloud/transfer/jobs/delete b/gcloud/transfer/jobs/delete new file mode 100644 index 000000000..66d81d240 --- /dev/null +++ b/gcloud/transfer/jobs/delete @@ -0,0 +1,31 @@ +NAME + gcloud transfer jobs delete - delete a Transfer Service transfer job + +SYNOPSIS + gcloud transfer jobs delete NAME [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a Transfer Service transfer job. + +EXAMPLES + To delete job 'foo', run: + + $ gcloud transfer jobs delete foo + +POSITIONAL ARGUMENTS + NAME + The name of the job you want to delete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer jobs delete + diff --git a/gcloud/transfer/jobs/describe b/gcloud/transfer/jobs/describe new file mode 100644 index 000000000..8542315ed --- /dev/null +++ b/gcloud/transfer/jobs/describe @@ -0,0 +1,41 @@ +NAME + gcloud transfer jobs describe - get configuration and latest operation + details about transfer job + +SYNOPSIS + gcloud transfer jobs describe NAME [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get configuration and latest operation details about a specific transfer + job. + +EXAMPLES + To describe a job, run: + + $ gcloud transfer jobs describe JOB-NAME + + If you're looking for recent error details, use the "latestOperationName" + returned by this command as input to the "operations describe" command: + + $ gcloud transfer jobs describe JOB-NAME \ + --format="json(latestOperationName)" + + $ gcloud transfer operations describe OPERATION-NAME + +POSITIONAL ARGUMENTS + NAME + The name of the job you want to describe. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer jobs describe + diff --git a/gcloud/transfer/jobs/help b/gcloud/transfer/jobs/help new file mode 100644 index 000000000..1d3b5e694 --- /dev/null +++ b/gcloud/transfer/jobs/help @@ -0,0 +1,43 @@ +NAME + gcloud transfer jobs - manage transfer jobs + +SYNOPSIS + gcloud transfer jobs COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage transfer jobs. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a Transfer Service transfer job. + + delete + Delete a Transfer Service transfer job. + + describe + Get configuration and latest operation details about transfer job. + + list + List Transfer Service transfer jobs. + + monitor + Track progress in real time for a transfer job's latest operation. + + run + Run a Transfer Service transfer job. + + update + Update a Transfer Service transfer job. + +NOTES + This variant is also available: + + $ gcloud alpha transfer jobs + diff --git a/gcloud/transfer/jobs/list b/gcloud/transfer/jobs/list new file mode 100644 index 000000000..140aba1f2 --- /dev/null +++ b/gcloud/transfer/jobs/list @@ -0,0 +1,70 @@ +NAME + gcloud transfer jobs list - list Transfer Service transfer jobs + +SYNOPSIS + gcloud transfer jobs list [--limit=LIMIT] + [--page-size=PAGE_SIZE; default=256] [--job-names=[JOB_NAMES,...]] + [--job-statuses=[JOB_STATUSES,...]] [--expand-table] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Transfer Service transfer jobs in a given project to show their + configurations and latest operations. + +EXAMPLES + To list all jobs in your current project, run: + + $ gcloud transfer jobs list + + To list all disabled jobs in your project, run: + + $ gcloud transfer jobs list --job-statuses=disabled + + To list jobs 'foo' and 'bar', run: + + $ gcloud transfer jobs list --job-names=foo,bar + + To list all information about all jobs formatted as JSON, run: + + $ gcloud transfer jobs list --format=json + + To list all information about jobs 'foo' and 'bar' formatted as YAML, run: + + $ gcloud transfer jobs list --job-names=foo,bar --format=YAML + +FLAGS + --limit=LIMIT + Return the first items from the API up to this limit. + + --page-size=PAGE_SIZE; default=256 + Retrieve batches of this many items from the API. + + --job-names=[JOB_NAMES,...] + The names of the jobs you want to list. Separate multiple job names + with commas (e.g., --job-names=foo,bar). If not specified, all jobs + will be listed. + + --job-statuses=[JOB_STATUSES,...] + List only jobs with the statuses you specify. Options include + 'enabled', 'disabled', 'deleted' (case insensitive). Separate multiple + statuses with commas (e.g., --job-statuses=enabled,deleted). If not + specified, all jobs will be listed. + + --expand-table + Include additional table columns (job name, source, destination, + frequency, lastest operation name, job status) in command output. Tip: + increase the size of your terminal before running the command. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer jobs list + diff --git a/gcloud/transfer/jobs/monitor b/gcloud/transfer/jobs/monitor new file mode 100644 index 000000000..c51cdeab5 --- /dev/null +++ b/gcloud/transfer/jobs/monitor @@ -0,0 +1,40 @@ +NAME + gcloud transfer jobs monitor - track progress in real time for a transfer + job's latest operation + +SYNOPSIS + gcloud transfer jobs monitor NAME [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Track progress in real time for a transfer job's latest operation. + +EXAMPLES + To monitor a job, run: + + $ gcloud transfer jobs monitor JOB-NAME + + If you're looking for recent error details, use the "Operation name" + returned by this command as input to the "operations describe" command: + + $ gcloud transfer jobs monitor JOB-NAME + + $ gcloud transfer operations describe OPERATION-NAME + +POSITIONAL ARGUMENTS + NAME + The name of the job you want to monitor (you'll see details for the + job's latest operation). + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer jobs monitor + diff --git a/gcloud/transfer/jobs/run b/gcloud/transfer/jobs/run new file mode 100644 index 000000000..11542382b --- /dev/null +++ b/gcloud/transfer/jobs/run @@ -0,0 +1,36 @@ +NAME + gcloud transfer jobs run - run a Transfer Service transfer job + +SYNOPSIS + gcloud transfer jobs run NAME [--no-async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Run a Transfer Service transfer job. + +EXAMPLES + To run job 'foo', run: + + $ gcloud transfer jobs run foo + +POSITIONAL ARGUMENTS + NAME + The name of the job you want to run. + +FLAGS + --no-async + Blocks other tasks in your terminal until the transfer operation has + completed. If not included, tasks will run asynchronously. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer jobs run + diff --git a/gcloud/transfer/jobs/update b/gcloud/transfer/jobs/update new file mode 100644 index 000000000..32e66e463 --- /dev/null +++ b/gcloud/transfer/jobs/update @@ -0,0 +1,390 @@ +NAME + gcloud transfer jobs update - update a Transfer Service transfer job + +SYNOPSIS + gcloud transfer jobs update NAME + [--status=STATUS --source=SOURCE --destination=DESTINATION + --clear-description --clear-source-creds-file + --clear-source-agent-pool --clear-destination-agent-pool + --clear-intermediate-storage-path --clear-manifest-file + --description=DESCRIPTION --source-creds-file=SOURCE_CREDS_FILE + --source-agent-pool=SOURCE_AGENT_POOL + --destination-agent-pool=DESTINATION_AGENT_POOL + --intermediate-storage-path=INTERMEDIATE_STORAGE_PATH + --manifest-file=MANIFEST_FILE] + [--clear-schedule --schedule-starts=SCHEDULE_STARTS + --schedule-repeats-every=SCHEDULE_REPEATS_EVERY + --schedule-repeats-until=SCHEDULE_REPEATS_UNTIL] + [--clear-include-prefixes --clear-exclude-prefixes + --clear-include-modified-before-absolute + --clear-include-modified-after-absolute + --clear-include-modified-before-relative + --clear-include-modified-after-relative + --include-prefixes=[INCLUDED_PREFIXES,...] + --exclude-prefixes=[EXCLUDED_PREFIXES,...] + --include-modified-before-absolute=INCLUDE_MODIFIED_BEFORE_ABSOLUTE + --include-modified-after-absolute=INCLUDE_MODIFIED_AFTER_ABSOLUTE + --include-modified-before-relative=INCLUDE_MODIFIED_BEFORE_RELATIVE + --include-modified-after-relative=INCLUDE_MODIFIED_AFTER_RELATIVE] + [--clear-delete-from --clear-preserve-metadata + --clear-custom-storage-class --overwrite-when=OVERWRITE_WHEN + --delete-from=DELETE_FROM --preserve-metadata=[METADATA_FIELDS,...] + --custom-storage-class=CUSTOM_STORAGE_CLASS] + [--clear-notification-config --clear-notification-event-types + --notification-pubsub-topic=NOTIFICATION_PUBSUB_TOPIC + --notification-event-types=[EVENT_TYPES,...] + --notification-payload-format=NOTIFICATION_PAYLOAD_FORMAT] + [--clear-log-config --log-actions=[LOG_ACTIONS,...] + --log-action-states=[LOG_ACTION_STATES,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a Transfer Service transfer job. + +EXAMPLES + To disable transfer job 'foo', run: + + $ gcloud transfer jobs update foo --status=disabled + + To remove the schedule for transfer job 'foo' so that it will only run when + you manually start it, run: + + $ gcloud transfer jobs update foo --clear-schedule + + To clear the values from the include=prefixes object condition in transfer + job 'foo', run: + + $ gcloud transfer jobs update foo --clear-include-prefixes + +POSITIONAL ARGUMENTS + NAME + Name of the transfer job you'd like to update. + +FLAGS + JOB INFORMATION + + --status=STATUS + Specify this flag to change the status of the job. Options include + 'enabled', 'disabled', 'deleted'. STATUS must be one of: deleted, + disabled, enabled. + + --source=SOURCE + The source of your data. Available sources and formatting + information: + + Public clouds - For Google Cloud Storage and Amazon S3, specify the + scheme of the source type; name of the resource; and, if transferring + from a folder, the path to the folder. For Azure Storage, note the + Azure-specific formatting below. For example: + ▸ [Google Cloud Storage] gs://example-bucket/example-folder + ▸ [Amazon S3] s3://examplebucket/example-folder + ▸ [Azure Blob Storage or Data Lake Storage] + http://examplestorageaccount.blob.core.windows.net/examplecontainer/examplefolder + + POSIX filesystem - Specify the posix:// scheme followed by the full + path to the desired directory. POSIX filesystem - Specify the + posix:// scheme followed by the absolute path to the desired + directory, starting from the root of the host machine (denoted by a + leading slash). For example: + ▸ posix:///path/directory/ + + A file transfer agent must be installed on the POSIX filesystem, and + you need an agent pool flag on this jobs command to activate the + agent. + + Publicly-accessible objects - Specify the URL of a TSV file + containing a list of URLs of publicly-accessible objects. For + example: + ▸ http://example.com/tsvfile + + --destination=DESTINATION + The destination of your transferred data. Available destinations and + formatting information: + + Google Cloud Storage - Specify the gs:// scheme; name of the bucket; + and, if transferring to a folder, the path to the folder. For + example: + ▸ gs://example-bucket/example-folder + + POSIX filesystem - Specify the posix:// scheme followed by the full + path to the desired directory. POSIX filesystem - Specify the + posix:// scheme followed by the absolute path to the desired + directory, starting from the root of the host machine (denoted by a + leading slash). For example: + ▸ posix:///path/directory/ + + A file transfer agent must be installed on the POSIX filesystem, and + you need an agent pool flag on this jobs command to activate the + agent. + + --clear-description + Remove the description from the transfer job. + + --clear-source-creds-file + Remove the source creds file from the transfer job. + + --clear-source-agent-pool + Remove the source agent pool from the transfer job. + + --clear-destination-agent-pool + Remove the destination agent pool from the transfer job. + + --clear-intermediate-storage-path + Remove the intermediate storage path from the transfer job. + + --clear-manifest-file + Remove the manifest file from the transfer job. + + --description=DESCRIPTION + An optional description to help identify the job using details that + don't fit in its name. + + --source-creds-file=SOURCE_CREDS_FILE + Path to a local file on your machine that includes credentials for an + Amazon S3 or Azure Blob Storage source (not required for Google Cloud + Storage sources). If not specified for an S3 source, gcloud will + check your system for an AWS config file. However, this flag must be + specified to use AWS's "role_arn" auth service. For formatting, see: + + S3: + https://cloud.google.com/storage-transfer/docs/reference/rest/v1/TransferSpec#AwsAccessKey + Note: Be sure to put quotations around the JSON value strings. + + Azure: + http://cloud/storage-transfer/docs/reference/rest/v1/TransferSpec#AzureCredentials + + --source-agent-pool=SOURCE_AGENT_POOL + If using a POSIX filesystem source, specify the ID of the agent pool + associated with source filesystem. + + --destination-agent-pool=DESTINATION_AGENT_POOL + If using a POSIX filesystem destination, specify the ID of the agent + pool associated with destination filesystem. + + --intermediate-storage-path=INTERMEDIATE_STORAGE_PATH + If transferring between filesystems, specify the path to a folder in + a Google Cloud Storage bucket (gs://example-bucket/example-folder) to + use as intermediary storage. Recommended: Use an empty folder + reserved for this transfer job to ensure transferred data doesn't + interact with any of your existing Cloud Storage data. + + --manifest-file=MANIFEST_FILE + Path to a .csv file in a Google Cloud Storage bucket containing a + list of files to transfer from your source. E.g., + gs://mybucket/manifest.csv. For manifest file formatting, see + https://cloud.google.com/storage-transfer/docs/manifest. + + SCHEDULE + + A job's schedule determines when and how often the job will run. For + formatting information, see + https://cloud.google.com/sdk/gcloud/reference/topic/datetimes. + + --clear-schedule + Remove the job's entire schedule by clearing all scheduling flags. + The job will no longer run unless an operation is manually started or + a new schedule is specified. + + --schedule-starts=SCHEDULE_STARTS + Set when the job will start using the %Y-%m-%dT%H:%M:%S%z datetime + format (e.g., 2020-04-12T06:42:12+04:00). If not set, the job will + run upon the successful submission of the create job command unless + the --do-not-run flag is included. + + --schedule-repeats-every=SCHEDULE_REPEATS_EVERY + Set the frequency of the job using the absolute duration format + (e.g., 1 month is p1m; 1 hour 30 minutes is 1h30m). If not set, the + job will run once. + + --schedule-repeats-until=SCHEDULE_REPEATS_UNTIL + Set when the job will stop recurring using the %Y-%m-%dT%H:%M:%S%z + datetime format (e.g., 2020-04-12T06:42:12+04:00). If specified, you + must also include a value for the --schedule-repeats-every flag. If + not specified, the job will continue to repeat as specified in its + repeat-every field unless the job is manually disabled or you add + this field later. + + OBJECT CONDITIONS + + A set of conditions to determine which objects are transferred. For + time-based object condition formatting tips, see + https://cloud.google.com/sdk/gcloud/reference/topic/datetimes. Note: If + you specify multiple conditions, objects must have at least one of the + specified 'include' prefixes and all of the specified time conditions. If + an object has an 'exclude' prefix, it will be excluded even if it matches + other conditions. + + --clear-include-prefixes + Remove the list of object prefixes to include from the object + conditions. + + --clear-exclude-prefixes + Remove the list of object prefixes to exclude from the object + conditions. + + --clear-include-modified-before-absolute + Remove the maximum modification datetime from the object conditions. + + --clear-include-modified-after-absolute + Remove the minimum modification datetime from the object conditions. + + --clear-include-modified-before-relative + Remove the maximum duration since modification from the object + conditions. + + --clear-include-modified-after-relative + Remove the minimum duration since modification from the object + conditions. + + --include-prefixes=[INCLUDED_PREFIXES,...] + Include only objects that start with the specified prefix(es). + Separate multiple prefixes with commas, omitting spaces after the + commas (e.g., --include-prefixes=foo,bar). + + --exclude-prefixes=[EXCLUDED_PREFIXES,...] + Exclude any objects that start with the prefix(es) entered. Separate + multiple prefixes with commas, omitting spaces after the commas + (e.g., --exclude-prefixes=foo,bar). + + --include-modified-before-absolute=INCLUDE_MODIFIED_BEFORE_ABSOLUTE + Include objects last modified before an absolute date/time. Ex. by + specifying '2020-01-01', the transfer would include objects last + modified before January 1, 2020. Use the %Y-%m-%dT%H:%M:%S%z datetime + format. + + --include-modified-after-absolute=INCLUDE_MODIFIED_AFTER_ABSOLUTE + Include objects last modified after an absolute date/time. Ex. by + specifying '2020-01-01', the transfer would include objects last + modified after January 1, 2020. Use the %Y-%m-%dT%H:%M:%S%z datetime + format. + + --include-modified-before-relative=INCLUDE_MODIFIED_BEFORE_RELATIVE + Include objects that were modified before a relative date/time in the + past. Ex. by specifying a duration of '10d', the transfer would + include objects last modified more than 10 days before its start + time. Use the absolute duration format (ex. 1m for 1 month; 1h30m for + 1 hour 30 minutes). + + --include-modified-after-relative=INCLUDE_MODIFIED_AFTER_RELATIVE + Include objects that were modified after a relative date/time in the + past. Ex. by specifying a duration of '10d', the transfer would + include objects last modified less than 10 days before its start + time. Use the absolute duration format (ex. 1m for 1 month; 1h30m for + 1 hour 30 minutes). + + TRANSFER OPTIONS + + --clear-delete-from + Remove a specified deletion option from the transfer job. If this + flag is specified, the transfer job won't delete any data from your + source or destination. + + --clear-preserve-metadata + Skips preserving optional metadata fields of objects being + transferred. + + --clear-custom-storage-class + Reverts to using destination default storage class. + + --overwrite-when=OVERWRITE_WHEN + Determine when destination objects are overwritten by source objects. + Options include: + ▸ 'different' - Overwrites files with the same name if the contents + are different (e.g., if etags or checksums don't match) + ▸ 'always' - Overwrite destination file whenever source file has + the same name -- even if they're identical + + OVERWRITE_WHEN must be one of: always, different. + + --delete-from=DELETE_FROM + By default, transfer jobs won't delete any data from your source or + destination. These options enable you to delete data if needed for + your use case. Options include: + ▸ 'destination-if-unique' - Delete files from destination if + they're not also at source. Use to sync destination to source + (i.e., make destination match source exactly) + ▸ 'source-after-transfer' - Delete files from source after they're + transferred + + DELETE_FROM must be one of: destination-if-unique, + source-after-transfer. + + --preserve-metadata=[METADATA_FIELDS,...] + Specify object metadata values that can optionally be preserved. + Example: --preserve-metadata=storage-class,uid + + For more info, see: + https://cloud.google.com/storage-transfer/docs/metadata-preservation. + + METADATA_FIELDS must be one of: acl, gid, kms-key, mode, + storage-class, symlink, temporary-hold, uid. + + --custom-storage-class=CUSTOM_STORAGE_CLASS + Specifies the storage class to set on objects being transferred to + Google Cloud Storage buckets. If unspecified, the behavior is to + match the destination bucket default. The value "preserve" will use + the class from the object's Google Cloud Storage source bucket. + + NOTIFICATION CONFIG + + A configuration for receiving notifications oftransfer operation status + changes via Cloud Pub/Sub. + + --clear-notification-config + Remove the job's full notification configuration to no longer receive + notifications via Cloud Pub/Sub. + + --clear-notification-event-types + Remove the event types from the notification config. + + --notification-pubsub-topic=NOTIFICATION_PUBSUB_TOPIC + Pub/Sub topic used for notifications. + + --notification-event-types=[EVENT_TYPES,...] + Define which change of transfer operation status will trigger Pub/Sub + notifications. Choices include 'success', 'failed', 'aborted'. To + trigger notifications for all three status changes, you can leave + this flag unspecified as long as you've specified a topic for the + --notification-pubsub-topic flag. EVENT_TYPES must be one of: + success, failed, aborted. + + --notification-payload-format=NOTIFICATION_PAYLOAD_FORMAT + If 'none', no transfer operation details are included with + notifications. If 'json', a json representation of the relevant + transfer operation is included in notification messages (e.g., to see + errors after an operation fails). NOTIFICATION_PAYLOAD_FORMAT must be + one of: json, none. + + LOGGING CONFIG + + Configure which transfer actions and action states are reported when logs + are generated for this job. Logs can be viewed by running the following + command: gcloud logging read "resource.type=storage_transfer_job" + + --clear-log-config + Remove the job's full logging config. + + --log-actions=[LOG_ACTIONS,...] + Define the transfer operation actions to report in logs. Separate + multiple actions with commas, omitting spaces after the commas (e.g., + --log-actions=find,copy). LOG_ACTIONS must be one of: copy, delete, + find. + + --log-action-states=[LOG_ACTION_STATES,...] + The states in which the actions specified in --log-actions are + logged. Separate multiple states with a comma, omitting the space + after the comma (e.g., --log-action-states=succeeded,failed). + LOG_ACTION_STATES must be one of: failed, succeeded. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer jobs update + diff --git a/gcloud/transfer/operations/cancel b/gcloud/transfer/operations/cancel new file mode 100644 index 000000000..24412cb3e --- /dev/null +++ b/gcloud/transfer/operations/cancel @@ -0,0 +1,31 @@ +NAME + gcloud transfer operations cancel - cancel a transfer operation + +SYNOPSIS + gcloud transfer operations cancel NAME [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Cancel a transfer operation. + +EXAMPLES + To cancel an operation, run: + + $ gcloud transfer operations cancel OPERATION-NAME + +POSITIONAL ARGUMENTS + NAME + The name of the transfer operation you want to cancel. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer operations cancel + diff --git a/gcloud/transfer/operations/describe b/gcloud/transfer/operations/describe new file mode 100644 index 000000000..cf615d875 --- /dev/null +++ b/gcloud/transfer/operations/describe @@ -0,0 +1,32 @@ +NAME + gcloud transfer operations describe - get configuration and latest transfer + operation details + +SYNOPSIS + gcloud transfer operations describe NAME [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get details about a specific transfer operation. + +EXAMPLES + To describe an operation, run: + + $ gcloud transfer operations describe OPERATION-NAME + +POSITIONAL ARGUMENTS + NAME + The name of the operation you want to describe. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer operations describe + diff --git a/gcloud/transfer/operations/help b/gcloud/transfer/operations/help new file mode 100644 index 000000000..ef1837ffe --- /dev/null +++ b/gcloud/transfer/operations/help @@ -0,0 +1,40 @@ +NAME + gcloud transfer operations - manage transfer operations + +SYNOPSIS + gcloud transfer operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage transfer operations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + cancel + Cancel a transfer operation. + + describe + Get configuration and latest transfer operation details. + + list + List Transfer Service transfer operations. + + monitor + Track progress in real time for a transfer operation. + + pause + Pause a currently running transfer operation. + + resume + Resume a currently paused transfer operation. + +NOTES + This variant is also available: + + $ gcloud alpha transfer operations + diff --git a/gcloud/transfer/operations/list b/gcloud/transfer/operations/list new file mode 100644 index 000000000..d43883747 --- /dev/null +++ b/gcloud/transfer/operations/list @@ -0,0 +1,73 @@ +NAME + gcloud transfer operations list - list Transfer Service transfer operations + +SYNOPSIS + gcloud transfer operations list [--limit=LIMIT] + [--page-size=PAGE_SIZE; default=256] [--job-names=[JOB_NAMES,...]] + [--operation-names=[OPERATION_NAMES,...]] + [--operation-statuses=[OPERATION_STATUSES,...]] [--expand-table] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Transfer Service transfer operations to view their progress details at + a glance. + +EXAMPLES + To list all transfer operations in your current project, run: + + $ gcloud transfer operations list + + To list all failed operations in your project, run: + + $ gcloud transfer operations list --operation-statuses=failed + + To list operations 'foo' and 'bar', run: + + $ gcloud transfer operations list --operation-names=foo,bar + + To list all operations in your current project as JSON, which provides all + fields and formatting available in the API, run: + + $ gcloud transfer operations list --format=json + +FLAGS + --limit=LIMIT + Return the first items from the API up to this limit. + + --page-size=PAGE_SIZE; default=256 + Retrieve batches of this many items from the API. + + --job-names=[JOB_NAMES,...] + The names of the jobs whose operations you want to list. Separate + multiple job names with commas (e.g., --job-names=foo,bar). If not + specified, operations for all jobs are listed. + + --operation-names=[OPERATION_NAMES,...] + The names of operations you want to list. Separate multiple operation + names with commas (e.g., --operation-names-name=foo,bar). If not + specified, all operations are listed. + + --operation-statuses=[OPERATION_STATUSES,...] + List only transfer operations with the statuses you specify. Options + include 'in_progress', 'paused', 'success','failed', 'aborted'. + Separate multiple statuses with commas (e.g., + --operation-statuses=failed,aborted). + + --expand-table + Include additional table columns (operation name, start time, status, + data copied, status, has errors, job name) in command output. Tip: + increase the size of your terminal before running the command. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer operations list + diff --git a/gcloud/transfer/operations/monitor b/gcloud/transfer/operations/monitor new file mode 100644 index 000000000..7bd0efcaf --- /dev/null +++ b/gcloud/transfer/operations/monitor @@ -0,0 +1,37 @@ +NAME + gcloud transfer operations monitor - track progress in real time for a + transfer operation + +SYNOPSIS + gcloud transfer operations monitor NAME [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Track progress in real time for a transfer operation. + +EXAMPLES + To monitor an operation, run: + + $ gcloud transfer operations monitor OPERATION-NAME + + If you're looking for specific error details, use the "operations describe" + command: + + $ gcloud transfer operations describe OPERATION-NAME + +POSITIONAL ARGUMENTS + NAME + The name of the operation you want to monitor. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer operations monitor + diff --git a/gcloud/transfer/operations/pause b/gcloud/transfer/operations/pause new file mode 100644 index 000000000..d8c728d72 --- /dev/null +++ b/gcloud/transfer/operations/pause @@ -0,0 +1,32 @@ +NAME + gcloud transfer operations pause - pause a currently running transfer + operation + +SYNOPSIS + gcloud transfer operations pause NAME [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Pause a currently running transfer operation. + +EXAMPLES + To pause an operation, run: + + $ gcloud transfer operations pause OPERATION-NAME + +POSITIONAL ARGUMENTS + NAME + The name of the paused transfer operation you want to cancel. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer operations pause + diff --git a/gcloud/transfer/operations/resume b/gcloud/transfer/operations/resume new file mode 100644 index 000000000..e719f33a5 --- /dev/null +++ b/gcloud/transfer/operations/resume @@ -0,0 +1,32 @@ +NAME + gcloud transfer operations resume - resume a currently paused transfer + operation + +SYNOPSIS + gcloud transfer operations resume NAME [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Resume a currently paused transfer operation. + +EXAMPLES + To resume an operation, run: + + $ gcloud transfer operations resume OPERATION-NAME + +POSITIONAL ARGUMENTS + NAME + The name of the paused transfer operation you want to resume. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha transfer operations resume +