From fe3a430c1d1b3ef0b5e28540cd5e44aa194ef4b1 Mon Sep 17 00:00:00 2001 From: Automated Date: Thu, 17 Jul 2025 11:02:31 +0000 Subject: [PATCH] gcloud: Thu Jul 17 11:02:31 UTC 2025 --- gcloud/_version | 8 +- gcloud/alpha/assured/workloads/create | 19 +- .../alpha/bigtable/app-profiles/config/export | 2 +- .../authorized-views/add-iam-policy-binding | 32 ++-- gcloud/alpha/bigtable/authorized-views/create | 16 +- gcloud/alpha/bigtable/authorized-views/delete | 8 +- .../alpha/bigtable/authorized-views/describe | 8 +- .../bigtable/authorized-views/get-iam-policy | 10 +- gcloud/alpha/bigtable/authorized-views/list | 5 +- .../remove-iam-policy-binding | 32 ++-- .../bigtable/authorized-views/set-iam-policy | 10 +- gcloud/alpha/bigtable/authorized-views/update | 23 ++- .../bigtable/backups/add-iam-policy-binding | 30 ++-- gcloud/alpha/bigtable/backups/create | 20 +-- gcloud/alpha/bigtable/backups/delete | 4 +- gcloud/alpha/bigtable/backups/describe | 4 +- gcloud/alpha/bigtable/backups/get-iam-policy | 10 +- .../backups/remove-iam-policy-binding | 31 ++-- gcloud/alpha/bigtable/backups/set-iam-policy | 10 +- gcloud/alpha/bigtable/backups/update | 14 +- .../bigtable/instances/add-iam-policy-binding | 22 +-- .../instances/remove-iam-policy-binding | 22 +-- .../instances/tables/add-iam-policy-binding | 26 +-- .../bigtable/instances/tables/config/export | 2 +- gcloud/alpha/bigtable/instances/tables/create | 2 +- gcloud/alpha/bigtable/instances/tables/delete | 2 +- .../alpha/bigtable/instances/tables/describe | 2 +- .../bigtable/instances/tables/get-iam-policy | 7 +- .../tables/remove-iam-policy-binding | 26 +-- .../alpha/bigtable/instances/tables/restore | 6 +- .../bigtable/instances/tables/set-iam-policy | 8 +- .../alpha/bigtable/instances/tables/undelete | 2 +- gcloud/alpha/bigtable/instances/tables/update | 2 +- gcloud/alpha/bigtable/operations/describe | 2 +- .../bigtable/tables/add-iam-policy-binding | 24 +-- gcloud/alpha/bigtable/tables/config/export | 2 +- gcloud/alpha/bigtable/tables/create | 2 +- gcloud/alpha/bigtable/tables/delete | 2 +- gcloud/alpha/bigtable/tables/describe | 2 +- gcloud/alpha/bigtable/tables/get-iam-policy | 7 +- .../bigtable/tables/remove-iam-policy-binding | 24 +-- gcloud/alpha/bigtable/tables/restore | 6 +- gcloud/alpha/bigtable/tables/set-iam-policy | 8 +- gcloud/alpha/bigtable/tables/undelete | 2 +- gcloud/alpha/bigtable/tables/update | 2 +- .../blockchain-validator-configs/create | 8 +- .../cloud-locations/describe | 1 + .../composer/environments/restart-web-server | 4 +- .../backend-buckets/add-iam-policy-binding | 50 +++--- .../compute/backend-buckets/get-iam-policy | 36 ++-- .../backend-buckets/remove-iam-policy-binding | 50 +++--- .../compute/backend-buckets/set-iam-policy | 45 ++--- .../interconnects/groups/create-members | 4 + .../rules/add-preconfig-waf-exclusion | 148 ++++++++++++++++ .../compute/org-security-policies/rules/help | 8 + .../rules/remove-preconfig-waf-exclusion | 167 ++++++++++++++++++ .../compute/reservations/sub-blocks/describe | 8 +- .../compute/reservations/sub-blocks/help | 7 +- .../compute/reservations/sub-blocks/list | 6 +- .../sub-blocks/perform-maintenance | 15 +- gcloud/alpha/compute/storage-pools/create | 2 +- .../compute/tpus/queued-resources/create | 4 +- gcloud/alpha/compute/tpus/tpu-vm/create | 10 +- gcloud/alpha/container/ai/help | 3 - .../container/ai/profiles/accelerators/list | 9 +- .../ai/recommender/accelerators/list | 102 ----------- gcloud/alpha/container/ai/recommender/help | 58 ------ .../container/ai/recommender/manifests/create | 76 -------- .../container/ai/recommender/manifests/help | 32 ---- .../model-and-server-combinations/help | 32 ---- .../ai/recommender/model-server-versions/help | 32 ---- gcloud/alpha/container/clusters/create | 144 +++++++++++---- gcloud/alpha/container/clusters/create-auto | 50 ++++-- gcloud/alpha/container/clusters/update | 54 +++--- .../container/fleet/config-management/disable | 7 +- .../container/hub/config-management/disable | 7 +- gcloud/alpha/container/node-pools/create | 82 +++++++++ gcloud/alpha/container/node-pools/update | 79 +++++++++ .../container/vmware/admin-clusters/unenroll | 6 +- .../developer-connect/connections/create | 35 +++- .../developer-connect/connections/update | 32 +++- .../container/vpn-connections/create | 2 +- gcloud/alpha/firestore/databases/clone | 138 +++++++++++++++ gcloud/alpha/firestore/databases/create | 7 +- gcloud/alpha/firestore/databases/help | 3 + gcloud/alpha/firestore/databases/restore | 10 +- .../iam/workforce-pools/providers/create-oidc | 2 +- .../iam/workforce-pools/providers/update-oidc | 2 +- gcloud/alpha/iap/help | 4 +- gcloud/alpha/iap/oauth-brands/create | 12 +- gcloud/alpha/iap/oauth-brands/describe | 6 +- gcloud/alpha/iap/oauth-brands/help | 10 +- gcloud/alpha/iap/oauth-brands/list | 6 +- gcloud/alpha/iap/oauth-clients/create | 10 +- gcloud/alpha/iap/oauth-clients/delete | 8 +- gcloud/alpha/iap/oauth-clients/describe | 8 +- gcloud/alpha/iap/oauth-clients/help | 21 ++- gcloud/alpha/iap/oauth-clients/list | 8 +- gcloud/alpha/iap/oauth-clients/reset-secret | 8 +- gcloud/alpha/looker/instances/create | 9 +- gcloud/alpha/looker/instances/update | 17 +- .../schema-registries/subject/update | 10 +- gcloud/alpha/memorystore/instances/create | 12 +- gcloud/alpha/memorystore/instances/update | 13 +- .../alpha/model-armor/floorsettings/describe | 4 +- gcloud/alpha/model-armor/floorsettings/help | 4 +- gcloud/alpha/model-armor/floorsettings/update | 4 +- gcloud/alpha/netapp/volumes/create | 4 +- .../alpha/netapp/volumes/restore-backup-files | 4 +- gcloud/alpha/netapp/volumes/update | 4 +- .../internal-ranges/create | 10 +- gcloud/alpha/recaptcha/keys/create | 50 +++++- gcloud/alpha/recaptcha/keys/update | 37 +++- gcloud/alpha/redis/clusters/update | 12 +- gcloud/alpha/run/jobs/create | 11 +- gcloud/alpha/run/jobs/deploy | 11 +- gcloud/alpha/run/jobs/update | 9 +- gcloud/alpha/transfer/agents/help | 2 +- gcloud/alpha/zone-management/auth/help | 26 +++ .../zone-management/auth/print-identity-token | 34 ++++ gcloud/alpha/zone-management/help | 41 +++++ .../zone-management/identity-providers/create | 75 ++++++++ .../zone-management/identity-providers/delete | 74 ++++++++ .../identity-providers/describe | 75 ++++++++ .../identity-providers}/help | 22 ++- .../identity-providers}/list | 51 +++++- .../alpha/zone-management/projects/describe | 78 ++++++++ gcloud/alpha/zone-management/projects/enable | 86 +++++++++ .../models => zone-management/projects}/help | 19 +- gcloud/alpha/zone-management/projects/list | 101 +++++++++++ .../zone-management/service-accounts/create | 79 +++++++++ .../zone-management/service-accounts/delete | 75 ++++++++ .../zone-management/service-accounts/describe | 68 +++++++ .../zone-management/service-accounts/help | 43 +++++ .../service-accounts/keys/create | 78 ++++++++ .../service-accounts/keys}/help | 15 +- .../service-accounts}/list | 48 +++-- .../alpha/zone-management/services/describe | 66 +++++++ gcloud/alpha/zone-management/services/enable | 73 ++++++++ gcloud/alpha/zone-management/services/help | 33 ++++ .../services}/list | 40 +++-- gcloud/alpha/zone-management/zones/describe | 65 +++++++ .../zone-management/zones/get-iam-policy | 95 ++++++++++ gcloud/alpha/zone-management/zones/help | 35 ++++ .../zones}/list | 55 +++--- .../zone-management/zones/set-iam-policy | 77 ++++++++ gcloud/assured/workloads/create | 19 +- gcloud/beta/assured/workloads/create | 19 +- .../authorized-views/add-iam-policy-binding | 32 ++-- gcloud/beta/bigtable/authorized-views/create | 16 +- gcloud/beta/bigtable/authorized-views/delete | 8 +- .../beta/bigtable/authorized-views/describe | 8 +- .../bigtable/authorized-views/get-iam-policy | 10 +- gcloud/beta/bigtable/authorized-views/list | 5 +- .../remove-iam-policy-binding | 32 ++-- .../bigtable/authorized-views/set-iam-policy | 10 +- gcloud/beta/bigtable/authorized-views/update | 23 ++- .../bigtable/backups/add-iam-policy-binding | 30 ++-- gcloud/beta/bigtable/backups/create | 20 +-- gcloud/beta/bigtable/backups/delete | 4 +- gcloud/beta/bigtable/backups/describe | 4 +- gcloud/beta/bigtable/backups/get-iam-policy | 10 +- .../backups/remove-iam-policy-binding | 31 ++-- gcloud/beta/bigtable/backups/set-iam-policy | 10 +- gcloud/beta/bigtable/backups/update | 14 +- .../bigtable/instances/add-iam-policy-binding | 22 +-- .../instances/remove-iam-policy-binding | 22 +-- .../instances/tables/add-iam-policy-binding | 26 +-- gcloud/beta/bigtable/instances/tables/create | 2 +- gcloud/beta/bigtable/instances/tables/delete | 2 +- .../beta/bigtable/instances/tables/describe | 2 +- .../bigtable/instances/tables/get-iam-policy | 7 +- .../tables/remove-iam-policy-binding | 26 +-- gcloud/beta/bigtable/instances/tables/restore | 6 +- .../bigtable/instances/tables/set-iam-policy | 8 +- .../beta/bigtable/instances/tables/undelete | 2 +- gcloud/beta/bigtable/instances/tables/update | 2 +- gcloud/beta/bigtable/operations/describe | 2 +- .../bigtable/tables/add-iam-policy-binding | 24 +-- gcloud/beta/bigtable/tables/create | 2 +- gcloud/beta/bigtable/tables/delete | 2 +- gcloud/beta/bigtable/tables/describe | 2 +- gcloud/beta/bigtable/tables/get-iam-policy | 7 +- .../bigtable/tables/remove-iam-policy-binding | 24 +-- gcloud/beta/bigtable/tables/restore | 6 +- gcloud/beta/bigtable/tables/set-iam-policy | 8 +- gcloud/beta/bigtable/tables/undelete | 2 +- gcloud/beta/bigtable/tables/update | 2 +- .../composer/environments/restart-web-server | 6 +- .../interconnects/groups/create-members | 4 + .../rules/add-preconfig-waf-exclusion | 146 +++++++++++++++ .../compute/org-security-policies/rules/help | 8 + .../rules/remove-preconfig-waf-exclusion | 165 +++++++++++++++++ .../compute/reservations/sub-blocks/describe | 8 +- .../beta/compute/reservations/sub-blocks/help | 7 +- .../beta/compute/reservations/sub-blocks/list | 6 +- .../sub-blocks/perform-maintenance | 69 ++++++++ gcloud/beta/compute/storage-pools/create | 2 +- gcloud/beta/container/clusters/create | 141 ++++++++++++--- gcloud/beta/container/clusters/create-auto | 50 ++++-- gcloud/beta/container/clusters/update | 54 +++--- .../container/fleet/config-management/disable | 7 +- .../container/hub/config-management/disable | 7 +- gcloud/beta/container/node-pools/create | 82 +++++++++ gcloud/beta/container/node-pools/update | 79 +++++++++ .../container/vmware/admin-clusters/unenroll | 6 +- gcloud/beta/dataflow/flex-template/build | 10 +- gcloud/beta/dataflow/jobs/archive | 41 +++++ gcloud/beta/dataflow/jobs/help | 3 + .../beta/developer-connect/connections/create | 35 +++- .../beta/developer-connect/connections/update | 32 +++- gcloud/beta/firestore/databases/create | 17 +- gcloud/beta/firestore/databases/restore | 20 ++- .../iam/workforce-pools/providers/create-oidc | 2 +- .../iam/workforce-pools/providers/update-oidc | 2 +- gcloud/beta/iap/help | 4 +- gcloud/beta/iap/oauth-brands/create | 6 +- gcloud/beta/iap/oauth-brands/describe | 6 +- gcloud/beta/iap/oauth-brands/help | 10 +- gcloud/beta/iap/oauth-brands/list | 6 +- gcloud/beta/iap/oauth-clients/create | 10 +- gcloud/beta/iap/oauth-clients/delete | 8 +- gcloud/beta/iap/oauth-clients/describe | 8 +- gcloud/beta/iap/oauth-clients/help | 21 ++- gcloud/beta/iap/oauth-clients/list | 8 +- gcloud/beta/iap/oauth-clients/reset-secret | 8 +- gcloud/beta/memorystore/instances/create | 12 +- gcloud/beta/memorystore/instances/update | 13 +- .../beta/model-armor/floorsettings/describe | 31 ++++ gcloud/beta/model-armor/floorsettings/help | 31 ++++ gcloud/beta/model-armor/floorsettings/update | 127 +++++++++++++ gcloud/beta/model-armor/help | 3 + gcloud/beta/netapp/volumes/create | 4 +- gcloud/beta/netapp/volumes/help | 3 + .../beta/netapp/volumes/restore-backup-files | 119 +++++++++++++ gcloud/beta/netapp/volumes/update | 4 +- .../network-connectivity/hubs/accept-spoke | 4 +- .../network-connectivity/hubs/reject-spoke | 5 +- gcloud/beta/redis/clusters/update | 12 +- gcloud/beta/run/jobs/create | 11 +- gcloud/beta/run/jobs/deploy | 11 +- gcloud/beta/run/jobs/update | 9 +- gcloud/beta/saas-runtime/releases/create | 6 +- gcloud/beta/saas-runtime/rollout-kinds/create | 2 +- gcloud/beta/saas-runtime/rollouts/create | 6 +- gcloud/beta/saas-runtime/unit-kinds/create | 6 +- gcloud/beta/saas-runtime/unit-kinds/update | 6 +- .../beta/saas-runtime/unit-operations/create | 8 +- .../beta/saas-runtime/unit-operations/update | 8 +- gcloud/beta/saas-runtime/units/create | 2 +- gcloud/beta/saas-runtime/units/update | 2 +- gcloud/beta/workbench/instances/create | 4 +- .../authorized-views/add-iam-policy-binding | 32 ++-- gcloud/bigtable/authorized-views/create | 16 +- gcloud/bigtable/authorized-views/delete | 8 +- gcloud/bigtable/authorized-views/describe | 8 +- .../bigtable/authorized-views/get-iam-policy | 10 +- gcloud/bigtable/authorized-views/list | 5 +- .../remove-iam-policy-binding | 32 ++-- .../bigtable/authorized-views/set-iam-policy | 10 +- gcloud/bigtable/authorized-views/update | 23 ++- .../bigtable/backups/add-iam-policy-binding | 30 ++-- gcloud/bigtable/backups/create | 20 +-- gcloud/bigtable/backups/delete | 4 +- gcloud/bigtable/backups/describe | 4 +- gcloud/bigtable/backups/get-iam-policy | 10 +- .../backups/remove-iam-policy-binding | 31 ++-- gcloud/bigtable/backups/set-iam-policy | 10 +- gcloud/bigtable/backups/update | 14 +- .../bigtable/instances/add-iam-policy-binding | 20 +-- .../instances/remove-iam-policy-binding | 20 +-- .../instances/tables/add-iam-policy-binding | 24 +-- gcloud/bigtable/instances/tables/create | 2 +- gcloud/bigtable/instances/tables/delete | 2 +- gcloud/bigtable/instances/tables/describe | 2 +- .../bigtable/instances/tables/get-iam-policy | 7 +- .../tables/remove-iam-policy-binding | 26 +-- gcloud/bigtable/instances/tables/restore | 6 +- .../bigtable/instances/tables/set-iam-policy | 8 +- gcloud/bigtable/instances/tables/undelete | 2 +- gcloud/bigtable/instances/tables/update | 2 +- gcloud/bigtable/operations/describe | 2 +- gcloud/bigtable/tables/add-iam-policy-binding | 24 +-- gcloud/bigtable/tables/create | 2 +- gcloud/bigtable/tables/delete | 2 +- gcloud/bigtable/tables/describe | 2 +- gcloud/bigtable/tables/get-iam-policy | 7 +- .../bigtable/tables/remove-iam-policy-binding | 24 +-- gcloud/bigtable/tables/restore | 6 +- gcloud/bigtable/tables/set-iam-policy | 8 +- gcloud/bigtable/tables/undelete | 2 +- gcloud/bigtable/tables/update | 2 +- gcloud/composer/environments/help | 3 + .../composer/environments/restart-web-server | 71 ++++++++ gcloud/compute/backend-services/create | 12 +- gcloud/compute/backend-services/update | 17 +- .../interconnects/groups/create-members | 4 + .../compute/reservations/sub-blocks/describe | 8 +- gcloud/compute/reservations/sub-blocks/help | 7 +- gcloud/compute/reservations/sub-blocks/list | 6 +- .../sub-blocks/perform-maintenance | 67 +++++++ gcloud/compute/storage-pools/create | 2 +- gcloud/container/clusters/create | 140 ++++++++++++--- gcloud/container/clusters/create-auto | 50 ++++-- gcloud/container/clusters/update | 58 +++--- gcloud/container/node-pools/create | 82 +++++++++ gcloud/container/node-pools/update | 79 +++++++++ .../container/vmware/admin-clusters/unenroll | 6 +- .../connection-profiles/create/postgresql | 5 +- .../connection-profiles/create/sqlserver | 2 +- .../connection-profiles/update | 2 +- .../conversion-workspaces/help | 8 +- .../conversion-workspaces/mapping-rules/help | 22 +++ .../conversion-workspaces/mapping-rules/list | 95 ++++++++++ .../private-connections/create | 64 ++++--- gcloud/dataflow/flex-template/build | 10 +- gcloud/dataflow/jobs/archive | 39 ++++ gcloud/dataflow/jobs/help | 3 + gcloud/developer-connect/connections/create | 35 +++- gcloud/developer-connect/connections/update | 32 +++- gcloud/edge-cloud/container/clusters/create | 5 + .../container/vpn-connections/create | 2 +- gcloud/firestore/databases/create | 17 +- gcloud/firestore/databases/restore | 20 ++- gcloud/gemini/help | 6 +- .../iam/workforce-pools/providers/create-oidc | 2 +- .../iam/workforce-pools/providers/create-saml | 2 +- .../iam/workforce-pools/providers/update-oidc | 2 +- .../iam/workforce-pools/providers/update-saml | 2 +- gcloud/iap/help | 4 +- gcloud/iap/oauth-brands/create | 2 + gcloud/iap/oauth-brands/describe | 2 + gcloud/iap/oauth-brands/help | 10 +- gcloud/iap/oauth-brands/list | 2 + gcloud/iap/oauth-clients/create | 2 + gcloud/iap/oauth-clients/delete | 2 + gcloud/iap/oauth-clients/describe | 2 + gcloud/iap/oauth-clients/help | 14 +- gcloud/iap/oauth-clients/list | 2 + gcloud/iap/oauth-clients/reset-secret | 2 + gcloud/looker/instances/create | 9 +- gcloud/looker/instances/update | 17 +- gcloud/memorystore/instances/create | 12 +- gcloud/memorystore/instances/update | 13 +- gcloud/model-armor/floorsettings/describe | 4 +- gcloud/model-armor/floorsettings/help | 4 +- gcloud/model-armor/floorsettings/update | 4 +- gcloud/netapp/volumes/create | 4 +- gcloud/netapp/volumes/update | 4 +- gcloud/network-connectivity/hubs/accept-spoke | 4 +- gcloud/network-connectivity/hubs/reject-spoke | 5 +- .../internal-ranges/create | 10 +- .../service-connection-policies/create | 6 +- .../service-connection-policies/update | 6 +- .../service-lb-policies/create | 28 +++ .../service-lb-policies/update | 28 +++ .../autonomous-databases/create | 7 +- .../autonomous-databases/switchover | 7 +- .../oracle-database/cloud-vm-clusters/create | 2 +- gcloud/recaptcha/keys/create | 50 +++++- gcloud/recaptcha/keys/update | 37 +++- gcloud/redis/clusters/update | 12 +- gcloud/resource-manager/tags/keys/create | 5 +- gcloud/transfer/agents/help | 2 +- gcloud/workbench/instances/create | 4 +- 365 files changed, 6027 insertions(+), 1863 deletions(-) create mode 100644 gcloud/alpha/compute/org-security-policies/rules/add-preconfig-waf-exclusion create mode 100644 gcloud/alpha/compute/org-security-policies/rules/remove-preconfig-waf-exclusion delete mode 100644 gcloud/alpha/container/ai/recommender/accelerators/list delete mode 100644 gcloud/alpha/container/ai/recommender/help delete mode 100644 gcloud/alpha/container/ai/recommender/manifests/create delete mode 100644 gcloud/alpha/container/ai/recommender/manifests/help delete mode 100644 gcloud/alpha/container/ai/recommender/model-and-server-combinations/help delete mode 100644 gcloud/alpha/container/ai/recommender/model-server-versions/help create mode 100644 gcloud/alpha/firestore/databases/clone create mode 100644 gcloud/alpha/zone-management/auth/help create mode 100644 gcloud/alpha/zone-management/auth/print-identity-token create mode 100644 gcloud/alpha/zone-management/help create mode 100644 gcloud/alpha/zone-management/identity-providers/create create mode 100644 gcloud/alpha/zone-management/identity-providers/delete create mode 100644 gcloud/alpha/zone-management/identity-providers/describe rename gcloud/alpha/{container/ai/recommender/model-servers => zone-management/identity-providers}/help (51%) rename gcloud/alpha/{container/ai/recommender/models => zone-management/identity-providers}/list (56%) create mode 100644 gcloud/alpha/zone-management/projects/describe create mode 100644 gcloud/alpha/zone-management/projects/enable rename gcloud/alpha/{container/ai/recommender/models => zone-management/projects}/help (53%) create mode 100644 gcloud/alpha/zone-management/projects/list create mode 100644 gcloud/alpha/zone-management/service-accounts/create create mode 100644 gcloud/alpha/zone-management/service-accounts/delete create mode 100644 gcloud/alpha/zone-management/service-accounts/describe create mode 100644 gcloud/alpha/zone-management/service-accounts/help create mode 100644 gcloud/alpha/zone-management/service-accounts/keys/create rename gcloud/alpha/{container/ai/recommender/accelerators => zone-management/service-accounts/keys}/help (52%) rename gcloud/alpha/{container/ai/recommender/model-server-versions => zone-management/service-accounts}/list (61%) create mode 100644 gcloud/alpha/zone-management/services/describe create mode 100644 gcloud/alpha/zone-management/services/enable create mode 100644 gcloud/alpha/zone-management/services/help rename gcloud/alpha/{container/ai/recommender/model-servers => zone-management/services}/list (65%) create mode 100644 gcloud/alpha/zone-management/zones/describe create mode 100644 gcloud/alpha/zone-management/zones/get-iam-policy create mode 100644 gcloud/alpha/zone-management/zones/help rename gcloud/alpha/{container/ai/recommender/model-and-server-combinations => zone-management/zones}/list (59%) create mode 100644 gcloud/alpha/zone-management/zones/set-iam-policy create mode 100644 gcloud/beta/compute/org-security-policies/rules/add-preconfig-waf-exclusion create mode 100644 gcloud/beta/compute/org-security-policies/rules/remove-preconfig-waf-exclusion create mode 100644 gcloud/beta/compute/reservations/sub-blocks/perform-maintenance create mode 100644 gcloud/beta/dataflow/jobs/archive create mode 100644 gcloud/beta/model-armor/floorsettings/describe create mode 100644 gcloud/beta/model-armor/floorsettings/help create mode 100644 gcloud/beta/model-armor/floorsettings/update create mode 100644 gcloud/beta/netapp/volumes/restore-backup-files create mode 100644 gcloud/composer/environments/restart-web-server create mode 100644 gcloud/compute/reservations/sub-blocks/perform-maintenance create mode 100644 gcloud/database-migration/conversion-workspaces/mapping-rules/help create mode 100644 gcloud/database-migration/conversion-workspaces/mapping-rules/list create mode 100644 gcloud/dataflow/jobs/archive diff --git a/gcloud/_version b/gcloud/_version index 05dea9c9d..0bcbe4740 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 529.0.0 -alpha 2025.06.27 -beta 2025.06.27 +Google Cloud SDK 530.0.0 +alpha 2025.07.11 +beta 2025.07.11 bq 2.1.19 bundled-python3-unix 3.12.9 -core 2025.06.27 +core 2025.07.11 gcloud-crc32c 1.0.0 gsutil 5.35 diff --git a/gcloud/alpha/assured/workloads/create b/gcloud/alpha/assured/workloads/create index 718a932be..45522386d 100644 --- a/gcloud/alpha/assured/workloads/create +++ b/gcloud/alpha/assured/workloads/create @@ -86,13 +86,24 @@ REQUIRED FLAGS --compliance-regime=COMPLIANCE_REGIME The compliance regime of the new Assured Workloads environment. COMPLIANCE_REGIME must be one of: assured-workloads-for-partners, - au-regions-and-us-support, ca-protected-b, ca-regions-and-support, - canada-controlled-goods, cjis, eu-regions-and-support, fedramp-high, + au-regions-and-us-support, australia-data-boundary-and-support, + ca-protected-b, ca-regions-and-support, canada-controlled-goods, + canada-data-boundary-and-support, cjis, + data-boundary-for-canada-controlled-goods, + data-boundary-for-canada-protected-b, data-boundary-for-cjis, + data-boundary-for-fedramp-high, data-boundary-for-fedramp-moderate, + data-boundary-for-il2, data-boundary-for-il4, data-boundary-for-il5, + data-boundary-for-irs-publication-1075, data-boundary-for-itar, + eu-data-boundary-and-support, eu-regions-and-support, fedramp-high, fedramp-moderate, healthcare-and-life-sciences-controls, healthcare-and-life-sciences-controls-us-support, hipaa, hitrust, il2, - il4, il5, irs-1075, isr-regions, isr-regions-and-support, itar, - jp-regions-and-support, + il4, il5, irs-1075, isr-regions, isr-regions-and-support, + israel-data-boundary-and-support, itar, japan-data-boundary, + jp-regions-and-support, ksa-data-boundary-with-access-justifications, ksa-regions-and-support-with-sovereignty-controls, regional-controls, + regional-data-boundary, us-data-boundary-and-support, + us-data-boundary-for-healthcare-and-life-sciences, + us-data-boundary-for-healthcare-and-life-sciences-with-support, us-regional-access. --display-name=DISPLAY_NAME diff --git a/gcloud/alpha/bigtable/app-profiles/config/export b/gcloud/alpha/bigtable/app-profiles/config/export index e54684aa3..2f2463ed8 100644 --- a/gcloud/alpha/bigtable/app-profiles/config/export +++ b/gcloud/alpha/bigtable/app-profiles/config/export @@ -65,7 +65,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▫ provide the argument app_profile on the command line with a diff --git a/gcloud/alpha/bigtable/authorized-views/add-iam-policy-binding b/gcloud/alpha/bigtable/authorized-views/add-iam-policy-binding index 83ae890a7..92f4071e6 100644 --- a/gcloud/alpha/bigtable/authorized-views/add-iam-policy-binding +++ b/gcloud/alpha/bigtable/authorized-views/add-iam-policy-binding @@ -14,26 +14,26 @@ DESCRIPTION binding consists of a member, a role, and an optional condition. EXAMPLES - To add an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table', run: + To add an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with authorized view my-authorized-view in instance + my-instance and table my-table, run: $ gcloud alpha bigtable authorized-views add-iam-policy-binding \ - my-authorized-view --instance='my-instance' --table='my-table' \ - --member='user:test-user@gmail.com' --role='roles/editor' + my-authorized-view --instance=`my-instance` --table=`my-table` \ + --member=`user:test-user@gmail.com` --role=`roles/editor` To add an IAM policy binding which expires at the end of the year 2020 for - the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' with - authorized view 'my-authorized-view' in instance 'my-instance' and table - 'my-table', run: + the role of roles/bigtable.admin and the user test-user@gmail.com with + authorized view my-authorized-view in instance my-instance and table + my-table, run: $ gcloud alpha bigtable authorized-views add-iam-policy-binding \ - my-authorized-view --instance='my-instance' --table='my-table' \ - --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,descrip\ - tion=Expires at midnight on 2020-12-31' + my-authorized-view --instance=`my-instance` --table=`my-table` \ + --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,\ + description=Expires at midnight on 2020-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -63,7 +63,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -71,7 +71,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a diff --git a/gcloud/alpha/bigtable/authorized-views/create b/gcloud/alpha/bigtable/authorized-views/create index 8cf798371..13acdfead 100644 --- a/gcloud/alpha/bigtable/authorized-views/create +++ b/gcloud/alpha/bigtable/authorized-views/create @@ -12,16 +12,16 @@ DESCRIPTION (ALPHA) Create a new Cloud Bigtable authorized view. EXAMPLES - To create an authorized view 'my-authorized-view' in instance 'my-instance' - and table 'my-table', using the definition file 'authorized_view.json': + To create an authorized view my-authorized-view in instance my-instance and + table my-table, using the definition file authorized_view.json: $ gcloud alpha bigtable authorized-views create my-authorized-view \ --instance=test-instance --table=test-table \ --definition-file=authorized_view.json - To create an authorized view 'my-authorized-view' in instance 'my-instance' - and table 'my-table', using the pre-encoded definition file - 'authorized_view_pre_encoded.json': + To create an authorized view my-authorized-view in instance my-instance and + table my-table, using the pre-encoded definition file + authorized_view_pre_encoded.json: $ gcloud alpha bigtable authorized-views create my-authorized-view \ --instance=test-instance --table=test-table \ @@ -52,7 +52,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -60,7 +60,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a @@ -76,7 +76,7 @@ FLAGS Path to a JSON or YAML file containing a valid authorized view protobuf. - The 'name' field is ignored. The name is deduced from the other command + The name field is ignored. The name is deduced from the other command line arguments. Example: { "subsetView": { "rowPrefixes": ["store1#"], "familySubsets": diff --git a/gcloud/alpha/bigtable/authorized-views/delete b/gcloud/alpha/bigtable/authorized-views/delete index ab4143043..3b285c496 100644 --- a/gcloud/alpha/bigtable/authorized-views/delete +++ b/gcloud/alpha/bigtable/authorized-views/delete @@ -11,8 +11,8 @@ DESCRIPTION (ALPHA) Delete new Cloud Bigtable authorized view. EXAMPLES - To delete the authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table': + To delete the authorized view my-authorized-view in instance my-instance + and table my-table: $ gcloud alpha bigtable authorized-views delete my-authorized-view \ --instance=test-instance --table=test-table @@ -42,7 +42,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -50,7 +50,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a diff --git a/gcloud/alpha/bigtable/authorized-views/describe b/gcloud/alpha/bigtable/authorized-views/describe index 132af2d80..6d1c452fa 100644 --- a/gcloud/alpha/bigtable/authorized-views/describe +++ b/gcloud/alpha/bigtable/authorized-views/describe @@ -11,8 +11,8 @@ DESCRIPTION (ALPHA) Describe a Cloud Bigtable authorized view. EXAMPLES - To describe the authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table': + To describe the authorized view my-authorized-view in instance my-instance + and table my-table: $ gcloud alpha bigtable authorized-views describe \ my-authorized-view --instance=test-instance --table=test-table @@ -42,7 +42,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -50,7 +50,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a diff --git a/gcloud/alpha/bigtable/authorized-views/get-iam-policy b/gcloud/alpha/bigtable/authorized-views/get-iam-policy index a489068b0..2170d2368 100644 --- a/gcloud/alpha/bigtable/authorized-views/get-iam-policy +++ b/gcloud/alpha/bigtable/authorized-views/get-iam-policy @@ -12,11 +12,11 @@ DESCRIPTION (ALPHA) Get an IAM policy on a Cloud Bigtable authorized view. EXAMPLES - To get the IAM policy on the authorized view 'my-authorized-view' in - instance 'my-instance' and table 'my-table', run: + To get the IAM policy on the authorized view my-authorized-view in instance + my-instance and table my-table, run: $ gcloud alpha bigtable authorized-views get-iam-policy \ - my-authorized-view --instance='my-instance' --table='my-table' + my-authorized-view --instance=`my-instance` --table=`my-table` See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -46,7 +46,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -54,7 +54,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a diff --git a/gcloud/alpha/bigtable/authorized-views/list b/gcloud/alpha/bigtable/authorized-views/list index 3453b043e..db6aeb83c 100644 --- a/gcloud/alpha/bigtable/authorized-views/list +++ b/gcloud/alpha/bigtable/authorized-views/list @@ -12,8 +12,7 @@ DESCRIPTION (ALPHA) List all authorized views of a Cloud Bigtable table. EXAMPLES - To list the authorized views in instance 'my-instance' and table - 'my-table': + To list the authorized views in instance my-instance and table my-table: $ gcloud alpha bigtable authorized-views list \ --instance=test-instance --table=test-table @@ -42,7 +41,7 @@ REQUIRED FLAGS this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument --table on the command line with a fully diff --git a/gcloud/alpha/bigtable/authorized-views/remove-iam-policy-binding b/gcloud/alpha/bigtable/authorized-views/remove-iam-policy-binding index e217adc78..56a9cb3db 100644 --- a/gcloud/alpha/bigtable/authorized-views/remove-iam-policy-binding +++ b/gcloud/alpha/bigtable/authorized-views/remove-iam-policy-binding @@ -14,26 +14,26 @@ DESCRIPTION One binding consists of a member, a role, and an optional condition. EXAMPLES - To remove an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table', run: + To remove an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with authorized view my-authorized-view in instance + my-instance and table my-table, run: $ gcloud alpha bigtable authorized-views remove-iam-policy-binding \ - my-authorized-view --instance='my-instance' --table='my-table' \ - --member='user:test-user@gmail.com' --role='roles/editor' + my-authorized-view --instance=`my-instance` --table=`my-table` \ + --member=`user:test-user@gmail.com` --role=`roles/editor` To remove an IAM policy binding which expires at the end of the year 2020 - for the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' - with authorized view 'my-authorized-view' in instance 'my-instance' and - cluster 'my-cluster', run: + for the role of roles/bigtable.admin and the user test-user@gmail.com with + authorized view my-authorized-view in instance my-instance and cluster + my-cluster, run: $ gcloud alpha bigtable authorized-views remove-iam-policy-binding \ - my-authorized-view --instance='my-instance' --table='my-table' \ - --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,descrip\ - tion=Expires at midnight on 2020-12-31' + my-authorized-view --instance=`my-instance` --table=`my-table` \ + --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,\ + description=Expires at midnight on 2020-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -63,7 +63,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -71,7 +71,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a diff --git a/gcloud/alpha/bigtable/authorized-views/set-iam-policy b/gcloud/alpha/bigtable/authorized-views/set-iam-policy index d1056b2fe..501c104c4 100644 --- a/gcloud/alpha/bigtable/authorized-views/set-iam-policy +++ b/gcloud/alpha/bigtable/authorized-views/set-iam-policy @@ -11,11 +11,11 @@ DESCRIPTION (ALPHA) Set an IAM policy on a Cloud Bigtable authorized view. EXAMPLES - To set the IAM policy from file 'my-policy' on the authorized view - 'my-authorized-view' in instance 'my-instance' and table 'my-table', run: + To set the IAM policy from file my-policy on the authorized view + my-authorized-view in instance my-instance and table my-table, run: $ gcloud alpha bigtable authorized-views set-iam-policy \ - my-authorized-view --instance='my-instance' --table='my-table' \ + my-authorized-view --instance=`my-instance` --table=`my-table` \ my-policy See https://cloud.google.com/iam/docs/managing-policies for more @@ -46,7 +46,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -54,7 +54,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a diff --git a/gcloud/alpha/bigtable/authorized-views/update b/gcloud/alpha/bigtable/authorized-views/update index 0bbcf0628..ad28e20bb 100644 --- a/gcloud/alpha/bigtable/authorized-views/update +++ b/gcloud/alpha/bigtable/authorized-views/update @@ -12,25 +12,24 @@ DESCRIPTION (ALPHA) Update an existing Cloud Bigtable authorized view. EXAMPLES - To update the authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table', using the definition file - 'authorized_view.json': + To update the authorized view my-authorized-view in instance my-instance + and table my-table, using the definition file authorized_view.json: $ gcloud alpha bigtable authorized-views update my-authorized-view \ --instance=test-instance --table=test-table \ --definition-file=authorized_view.json - To update the authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table', using the pre-encoded definition file - 'authorized_view_pre_encoded.json': + To update the authorized view my-authorized-view in instance my-instance + and table my-table, using the pre-encoded definition file + authorized_view_pre_encoded.json: $ gcloud alpha bigtable authorized-views update my-authorized-view \ --instance=test-instance --table=test-table \ --definition-file=authorized_view_pre_encoded.json --pre-encoded - To update the authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table', using the definition file - 'authorized_view.json' and skip the prompt to proceed or cancel the update: + To update the authorized view my-authorized-view in instance my-instance + and table my-table, using the definition file authorized_view.json and skip + the prompt to proceed or cancel the update: $ gcloud alpha bigtable authorized-views update my-authorized-view \ --instance=test-instance --table=test-table \ @@ -61,7 +60,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -69,7 +68,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a @@ -85,7 +84,7 @@ FLAGS Path to a JSON or YAML file containing a valid authorized view protobuf. - The 'name' field is ignored. The name is deduced from the other command + The name field is ignored. The name is deduced from the other command line arguments. Example: { "subsetView": { "rowPrefixes": ["store1"], "familySubsets": diff --git a/gcloud/alpha/bigtable/backups/add-iam-policy-binding b/gcloud/alpha/bigtable/backups/add-iam-policy-binding index ceaa308ff..c0f7dffa1 100644 --- a/gcloud/alpha/bigtable/backups/add-iam-policy-binding +++ b/gcloud/alpha/bigtable/backups/add-iam-policy-binding @@ -14,25 +14,25 @@ DESCRIPTION consists of a member, a role, and an optional condition. EXAMPLES - To add an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with backup 'my-backup' in instance 'my-instance' and - cluster 'my-cluster', run: + To add an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with backup my-backup in instance my-instance and + cluster my-cluster, run: $ gcloud alpha bigtable backups add-iam-policy-binding my-backup \ - --instance='my-instance' --cluster='my-cluster' \ - --member='user:test-user@gmail.com' --role='roles/editor' + --instance=`my-instance` --cluster=`my-cluster` \ + --member=`user:test-user@gmail.com` --role=`roles/editor` To add an IAM policy binding which expires at the end of the year 2020 for - the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' with - backup 'my-backup' in instance 'my-instance' and cluster 'my-cluster', run: + the role of roles/bigtable.admin and the user test-user@gmail.com with + backup my-backup in instance my-instance and cluster my-cluster, run: $ gcloud alpha bigtable backups add-iam-policy-binding my-backup \ - --instance='my-instance' --cluster='my-cluster' \ - --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,descrip\ - tion=Expires at midnight on 2020-12-31' + --instance=`my-instance` --cluster=`my-cluster` \ + --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,\ + description=Expires at midnight on 2020-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -61,7 +61,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -69,7 +69,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/alpha/bigtable/backups/create b/gcloud/alpha/bigtable/backups/create index e56f8121a..d09cedd17 100644 --- a/gcloud/alpha/bigtable/backups/create +++ b/gcloud/alpha/bigtable/backups/create @@ -14,30 +14,30 @@ DESCRIPTION (ALPHA) Creates a backup of a Cloud Bigtable table. EXAMPLES - To create a backup 'BACKUP_NAME' asyncronously from table 'TABLE_NAME' - which expires at '2019-03-30T10:49:41Z', run: + To create a backup BACKUP_NAME asyncronously from table TABLE_NAME which + expires at 2019-03-30T10:49:41Z, run: $ gcloud alpha bigtable backups create BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ --table=TABLE_NAME --expiration-date=2019-03-30T10:49:41Z \ --async - To create a backup 'BACKUP_NAME' syncronously from table 'TABLE_NAME' which + To create a backup BACKUP_NAME syncronously from table TABLE_NAME which expires in 2 weeks from now, run: $ gcloud alpha bigtable backups create BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ --table=TABLE_NAME --retention-period=2w - To create a hot backup 'BACKUP_NAME' from table 'TABLE_NAME' which expires - in 2 weeks from now, run: + To create a hot backup BACKUP_NAME from table TABLE_NAME which expires in 2 + weeks from now, run: $ gcloud alpha bigtable backups create BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ --table=TABLE_NAME --retention-period=2w --backup-type=HOT - To create a hot backup 'BACKUP_NAME' from table 'TABLE_NAME' which will be - converted to a standard backup at '2019-03-31T10:49:41Z' and expires in 2 + To create a hot backup BACKUP_NAME from table TABLE_NAME which will be + converted to a standard backup at 2019-03-31T10:49:41Z and expires in 2 weeks from now, run: $ gcloud alpha bigtable backups create BACKUP_NAME \ @@ -45,7 +45,7 @@ EXAMPLES --table=TABLE_NAME --retention-period=2w --backup-type=HOT \ --hot-to-standard-time=2019-03-31T10:49:41Z - To create a hot backup 'BACKUP_NAME' from table 'TABLE_NAME' which will be + To create a hot backup BACKUP_NAME from table TABLE_NAME which will be converted to a standard backup in 1 week from now and expires in 2 weeks from now, run: @@ -78,7 +78,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -86,7 +86,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/alpha/bigtable/backups/delete b/gcloud/alpha/bigtable/backups/delete index 6abaea691..4a3ddbfb6 100644 --- a/gcloud/alpha/bigtable/backups/delete +++ b/gcloud/alpha/bigtable/backups/delete @@ -38,7 +38,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -46,7 +46,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/alpha/bigtable/backups/describe b/gcloud/alpha/bigtable/backups/describe index a44277fe0..7188021ae 100644 --- a/gcloud/alpha/bigtable/backups/describe +++ b/gcloud/alpha/bigtable/backups/describe @@ -39,7 +39,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -47,7 +47,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/alpha/bigtable/backups/get-iam-policy b/gcloud/alpha/bigtable/backups/get-iam-policy index f2460bd9f..2e17e529b 100644 --- a/gcloud/alpha/bigtable/backups/get-iam-policy +++ b/gcloud/alpha/bigtable/backups/get-iam-policy @@ -12,11 +12,11 @@ DESCRIPTION (ALPHA) Get an IAM policy on a Cloud Bigtable Backup. EXAMPLES - To get the IAM policy on the backup 'my-backup' in instance 'my-instance' - and cluster 'my-cluster', run: + To get the IAM policy on the backup my-backup in instance my-instance and + cluster my-cluster, run: $ gcloud alpha bigtable backups get-iam-policy my-backup \ - --instance='my-instance' --cluster='my-cluster' + --instance=`my-instance` --cluster=`my-cluster` See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -45,7 +45,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -53,7 +53,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/alpha/bigtable/backups/remove-iam-policy-binding b/gcloud/alpha/bigtable/backups/remove-iam-policy-binding index dcfc5a6f5..fbf948799 100644 --- a/gcloud/alpha/bigtable/backups/remove-iam-policy-binding +++ b/gcloud/alpha/bigtable/backups/remove-iam-policy-binding @@ -14,26 +14,25 @@ DESCRIPTION binding consists of a member, a role, and an optional condition. EXAMPLES - To remove an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with backup 'my-backup' in instance 'my-instance' and - cluster 'my-cluster', run: + To remove an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with backup my-backup in instance my-instance and + cluster my-cluster, run: $ gcloud alpha bigtable backups remove-iam-policy-binding \ - my-backup --instance='my-instance' --cluster='my-cluster' \ - --member='user:test-user@gmail.com' --role='roles/editor' + my-backup --instance=`my-instance` --cluster=`my-cluster` \ + --member=`user:test-user@gmail.com` --role=`roles/editor` To remove an IAM policy binding which expires at the end of the year 2020 - for the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' - with backup 'my-backup' in instance 'my-instance' and cluster 'my-cluster', - run: + for the role of roles/bigtable.admin and the user test-user@gmail.com with + backup my-backup in instance my-instance and cluster my-cluster, run: $ gcloud alpha bigtable backups remove-iam-policy-binding \ - my-backup --instance='my-instance' --cluster='my-cluster' \ - --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,descrip\ - tion=Expires at midnight on 2020-12-31' + my-backup --instance=`my-instance` --cluster=`my-cluster` \ + --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,\ + description=Expires at midnight on 2020-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -62,7 +61,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -70,7 +69,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/alpha/bigtable/backups/set-iam-policy b/gcloud/alpha/bigtable/backups/set-iam-policy index 62a6621a6..e4f1bc0e4 100644 --- a/gcloud/alpha/bigtable/backups/set-iam-policy +++ b/gcloud/alpha/bigtable/backups/set-iam-policy @@ -11,11 +11,11 @@ DESCRIPTION (ALPHA) Set an IAM policy on a Cloud Bigtable Backup. EXAMPLES - To set the IAM policy from file 'my-policy' on the backup 'my-backup' in - instance 'my-instance' and cluster 'my-cluster', run: + To set the IAM policy from file my-policy on the backup my-backup in + instance my-instance and cluster my-cluster, run: $ gcloud alpha bigtable backups set-iam-policy my-backup \ - --instance='my-instance' --cluster='my-cluster' my-policy + --instance=`my-instance` --cluster=`my-cluster` my-policy See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -44,7 +44,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -52,7 +52,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/alpha/bigtable/backups/update b/gcloud/alpha/bigtable/backups/update index d668164d3..8efd1fd38 100644 --- a/gcloud/alpha/bigtable/backups/update +++ b/gcloud/alpha/bigtable/backups/update @@ -14,27 +14,27 @@ DESCRIPTION --expiration-date and --retention-period. EXAMPLES - To update the expire time of backup 'BACKUP_NAME' to 7 days from now, run: + To update the expire time of backup BACKUP_NAME to 7 days from now, run: $ gcloud alpha bigtable backups update BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ --retention-period=7d - To update the hot-to-standard time of backup 'BACKUP_NAME' to - '2019-03-31T10:49:41Z', run: + To update the hot-to-standard time of backup BACKUP_NAME to + 2019-03-31T10:49:41Z, run: $ gcloud alpha bigtable backups update BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ --hot-to-standard-time=2019-03-31T10:49:41Z - To update the hot-to-standard time of backup 'BACKUP_NAME' to 7 days from + To update the hot-to-standard time of backup BACKUP_NAME to 7 days from now, run: $ gcloud alpha bigtable backups update BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ --hot-to-standard-time=+P7d - To clear the hot-to-standard time of backup 'BACKUP_NAME', run: + To clear the hot-to-standard time of backup BACKUP_NAME, run: $ gcloud alpha bigtable backups update BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ @@ -64,7 +64,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -72,7 +72,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/alpha/bigtable/instances/add-iam-policy-binding b/gcloud/alpha/bigtable/instances/add-iam-policy-binding index b27ce997f..5d052c1f9 100644 --- a/gcloud/alpha/bigtable/instances/add-iam-policy-binding +++ b/gcloud/alpha/bigtable/instances/add-iam-policy-binding @@ -13,23 +13,23 @@ DESCRIPTION consists of a member, a role, and an optional condition. EXAMPLES - To add an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with instance 'my-instance', run: + To add an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with instance my-instance, run: $ gcloud alpha bigtable instances add-iam-policy-binding \ - my-instance --member='user:test-user@gmail.com' \ - --role='roles/editor' + my-instance --member=`user:test-user@gmail.com` \ + --role=`roles/editor` To add an IAM policy binding which expires at the end of the year 2018 for - the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' with - instance 'my-instance', run: + the role of roles/bigtable.admin and the user test-user@gmail.com with + instance my-instance, run: $ gcloud alpha bigtable instances add-iam-policy-binding \ - my-instance --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2019-01-01T00:00:00Z"),title=expires_end_of_2018,descrip\ - tion=Expires at midnight on 2018-12-31' + my-instance --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2019-01-01T00:00:00Z"),title=expires_end_of_2018,\ + description=Expires at midnight on 2018-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. diff --git a/gcloud/alpha/bigtable/instances/remove-iam-policy-binding b/gcloud/alpha/bigtable/instances/remove-iam-policy-binding index a6e4c9b70..7735ebf15 100644 --- a/gcloud/alpha/bigtable/instances/remove-iam-policy-binding +++ b/gcloud/alpha/bigtable/instances/remove-iam-policy-binding @@ -13,23 +13,23 @@ DESCRIPTION binding consists of a member, a role, and an optional condition. EXAMPLES - To remove an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with instance 'my-instance', run: + To remove an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with instance my-instance, run: $ gcloud alpha bigtable instances remove-iam-policy-binding \ - my-instance --member='user:test-user@gmail.com' \ - --role='roles/editor' + my-instance --member=`user:test-user@gmail.com` \ + --role=`roles/editor` To remove an IAM policy binding which expires at the end of the year 2018 - for the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' - with instance 'my-instance', run: + for the role of roles/bigtable.admin and the user test-user@gmail.com with + instance my-instance, run: $ gcloud alpha bigtable instances remove-iam-policy-binding \ - my-instance --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2019-01-01T00:00:00Z"),title=expires_end_of_2018,descrip\ - tion=Expires at midnight on 2018-12-31' + my-instance --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2019-01-01T00:00:00Z"),title=expires_end_of_2018,\ + description=Expires at midnight on 2018-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. diff --git a/gcloud/alpha/bigtable/instances/tables/add-iam-policy-binding b/gcloud/alpha/bigtable/instances/tables/add-iam-policy-binding index d95b79f87..0f34959f8 100644 --- a/gcloud/alpha/bigtable/instances/tables/add-iam-policy-binding +++ b/gcloud/alpha/bigtable/instances/tables/add-iam-policy-binding @@ -13,24 +13,24 @@ DESCRIPTION consists of a member, a role, and an optional condition. EXAMPLES - To add an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with table 'my-table' in instance 'my-instance', run: + To add an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with table my-table in instance my-instance, run: $ gcloud alpha bigtable instances tables add-iam-policy-binding \ - my-table --instance='my-instance' \ - --member='user:test-user@gmail.com' --role='roles/editor' + my-table --instance=`my-instance` \ + --member=`user:test-user@gmail.com` --role=`roles/editor` To add an IAM policy binding which expires at the end of the year 2019 for - the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' with - table 'my-table' in instance 'my-instance', run: + the role of roles/bigtable.admin and the user test-user@gmail.com with + table my-table in instance my-instance, run: $ gcloud alpha bigtable instances tables add-iam-policy-binding \ - my-table --instance='my-instance' \ - --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,descrip\ - tion=Expires at midnight on 2019-12-31' + my-table --instance=`my-instance` \ + --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,\ + description=Expires at midnight on 2019-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -59,7 +59,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/bigtable/instances/tables/config/export b/gcloud/alpha/bigtable/instances/tables/config/export index 79723edb9..52498c117 100644 --- a/gcloud/alpha/bigtable/instances/tables/config/export +++ b/gcloud/alpha/bigtable/instances/tables/config/export @@ -63,7 +63,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▫ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/bigtable/instances/tables/create b/gcloud/alpha/bigtable/instances/tables/create index 41f721f3d..02cfc12e1 100644 --- a/gcloud/alpha/bigtable/instances/tables/create +++ b/gcloud/alpha/bigtable/instances/tables/create @@ -104,7 +104,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/bigtable/instances/tables/delete b/gcloud/alpha/bigtable/instances/tables/delete index 1352a0d78..afef26a88 100644 --- a/gcloud/alpha/bigtable/instances/tables/delete +++ b/gcloud/alpha/bigtable/instances/tables/delete @@ -39,7 +39,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/bigtable/instances/tables/describe b/gcloud/alpha/bigtable/instances/tables/describe index 4b1dcd213..9b33d1f84 100644 --- a/gcloud/alpha/bigtable/instances/tables/describe +++ b/gcloud/alpha/bigtable/instances/tables/describe @@ -40,7 +40,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/bigtable/instances/tables/get-iam-policy b/gcloud/alpha/bigtable/instances/tables/get-iam-policy index 7cd1adf1c..d6b1eb1ef 100644 --- a/gcloud/alpha/bigtable/instances/tables/get-iam-policy +++ b/gcloud/alpha/bigtable/instances/tables/get-iam-policy @@ -11,11 +11,10 @@ DESCRIPTION (ALPHA) Get an IAM policy on a Cloud Bigtable table. EXAMPLES - To get the IAM policy on the table 'my-table' in instance 'my-instance', - run: + To get the IAM policy on the table my-table in instance my-instance, run: $ gcloud alpha bigtable instances tables get-iam-policy my-table \ - --instance='my-instance' + --instance=`my-instance` See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -44,7 +43,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/bigtable/instances/tables/remove-iam-policy-binding b/gcloud/alpha/bigtable/instances/tables/remove-iam-policy-binding index 43672344a..1d5e48fd3 100644 --- a/gcloud/alpha/bigtable/instances/tables/remove-iam-policy-binding +++ b/gcloud/alpha/bigtable/instances/tables/remove-iam-policy-binding @@ -13,24 +13,24 @@ DESCRIPTION binding consists of a member, a role, and an optional condition. EXAMPLES - To remove an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with table 'my-table' in instance 'my-instance', run: + To remove an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with table my-table in instance my-instance, run: $ gcloud alpha bigtable instances tables remove-iam-policy-binding \ - my-table --instance='my-instance' \ - --member='user:test-user@gmail.com' --role='roles/editor' + my-table --instance=`my-instance` \ + --member=`user:test-user@gmail.com` --role=`roles/editor` To remove an IAM policy binding which expires at the end of the year 2019 - for the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' - with table 'my-table' in instance 'my-instance', run: + for the role of roles/bigtable.admin and the user test-user@gmail.com with + table my-table in instance my-instance, run: $ gcloud alpha bigtable instances tables remove-iam-policy-binding \ - my-table --instance='my-instance' \ - --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,descrip\ - tion=Expires at midnight on 2019-12-31' + my-table --instance=`my-instance` \ + --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,\ + description=Expires at midnight on 2019-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -59,7 +59,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/bigtable/instances/tables/restore b/gcloud/alpha/bigtable/instances/tables/restore index 6b80096c8..eacfa40b0 100644 --- a/gcloud/alpha/bigtable/instances/tables/restore +++ b/gcloud/alpha/bigtable/instances/tables/restore @@ -54,7 +54,7 @@ REQUIRED FLAGS this group are specified. --destination-instance=DESTINATION_INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument --destination on the command line with a @@ -85,7 +85,7 @@ REQUIRED FLAGS this group are specified. --source-cluster=SOURCE_CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument --source on the command line with a fully @@ -93,7 +93,7 @@ REQUIRED FLAGS ▸ provide the argument --source-cluster on the command line. --source-instance=SOURCE_INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument --source on the command line with a fully diff --git a/gcloud/alpha/bigtable/instances/tables/set-iam-policy b/gcloud/alpha/bigtable/instances/tables/set-iam-policy index 748283805..367d8adb3 100644 --- a/gcloud/alpha/bigtable/instances/tables/set-iam-policy +++ b/gcloud/alpha/bigtable/instances/tables/set-iam-policy @@ -10,11 +10,11 @@ DESCRIPTION (ALPHA) Set an IAM policy on a Cloud Bigtable table. EXAMPLES - To set the IAM policy from file 'my-policy' on the table 'my-table' in - instance 'my-instance', run: + To set the IAM policy from file my-policy on the table my-table in instance + my-instance, run: $ gcloud alpha bigtable instances tables set-iam-policy my-table \ - --instance='my-instance' my-policy + --instance=`my-instance` my-policy See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -43,7 +43,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/bigtable/instances/tables/undelete b/gcloud/alpha/bigtable/instances/tables/undelete index 27c7bb61e..28462ed5e 100644 --- a/gcloud/alpha/bigtable/instances/tables/undelete +++ b/gcloud/alpha/bigtable/instances/tables/undelete @@ -39,7 +39,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/bigtable/instances/tables/update b/gcloud/alpha/bigtable/instances/tables/update index d13e8b17a..d8379c74f 100644 --- a/gcloud/alpha/bigtable/instances/tables/update +++ b/gcloud/alpha/bigtable/instances/tables/update @@ -82,7 +82,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/bigtable/operations/describe b/gcloud/alpha/bigtable/operations/describe index 306a35985..0ace659ef 100644 --- a/gcloud/alpha/bigtable/operations/describe +++ b/gcloud/alpha/bigtable/operations/describe @@ -9,7 +9,7 @@ DESCRIPTION (ALPHA) Describe a Cloud Bigtable operation. EXAMPLES - To view details for operation 'OPERATION_ID', run: + To view details for operation OPERATION_ID, run: $ gcloud alpha bigtable operations describe OPERATION_ID diff --git a/gcloud/alpha/bigtable/tables/add-iam-policy-binding b/gcloud/alpha/bigtable/tables/add-iam-policy-binding index df01a259a..53e2deca0 100644 --- a/gcloud/alpha/bigtable/tables/add-iam-policy-binding +++ b/gcloud/alpha/bigtable/tables/add-iam-policy-binding @@ -13,23 +13,23 @@ DESCRIPTION consists of a member, a role, and an optional condition. EXAMPLES - To add an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with table 'my-table' in instance 'my-instance', run: + To add an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with table my-table in instance my-instance, run: $ gcloud alpha bigtable tables add-iam-policy-binding my-table \ - --instance='my-instance' --member='user:test-user@gmail.com' \ - --role='roles/editor' + --instance=`my-instance` --member=`user:test-user@gmail.com` \ + --role=`roles/editor` To add an IAM policy binding which expires at the end of the year 2019 for - the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' with - table 'my-table' in instance 'my-instance', run: + the role of roles/bigtable.admin and the user test-user@gmail.com with + table my-table in instance my-instance, run: $ gcloud alpha bigtable tables add-iam-policy-binding my-table \ - --instance='my-instance' --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,descrip\ - tion=Expires at midnight on 2019-12-31' + --instance=`my-instance` --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,\ + description=Expires at midnight on 2019-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -58,7 +58,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/bigtable/tables/config/export b/gcloud/alpha/bigtable/tables/config/export index 4d99b3ef8..1ca953e35 100644 --- a/gcloud/alpha/bigtable/tables/config/export +++ b/gcloud/alpha/bigtable/tables/config/export @@ -63,7 +63,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▫ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/bigtable/tables/create b/gcloud/alpha/bigtable/tables/create index 7233fee56..fcec2315e 100644 --- a/gcloud/alpha/bigtable/tables/create +++ b/gcloud/alpha/bigtable/tables/create @@ -103,7 +103,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/bigtable/tables/delete b/gcloud/alpha/bigtable/tables/delete index 9445cd5da..e7b42e790 100644 --- a/gcloud/alpha/bigtable/tables/delete +++ b/gcloud/alpha/bigtable/tables/delete @@ -37,7 +37,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/bigtable/tables/describe b/gcloud/alpha/bigtable/tables/describe index ebfd95eeb..c2cfc783c 100644 --- a/gcloud/alpha/bigtable/tables/describe +++ b/gcloud/alpha/bigtable/tables/describe @@ -38,7 +38,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/bigtable/tables/get-iam-policy b/gcloud/alpha/bigtable/tables/get-iam-policy index 0db601a52..ea1075d4d 100644 --- a/gcloud/alpha/bigtable/tables/get-iam-policy +++ b/gcloud/alpha/bigtable/tables/get-iam-policy @@ -11,11 +11,10 @@ DESCRIPTION (ALPHA) Get an IAM policy on a Cloud Bigtable table. EXAMPLES - To get the IAM policy on the table 'my-table' in instance 'my-instance', - run: + To get the IAM policy on the table my-table in instance my-instance, run: $ gcloud alpha bigtable tables get-iam-policy my-table \ - --instance='my-instance' + --instance=`my-instance` See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -44,7 +43,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/bigtable/tables/remove-iam-policy-binding b/gcloud/alpha/bigtable/tables/remove-iam-policy-binding index ce90f7897..5d229d13c 100644 --- a/gcloud/alpha/bigtable/tables/remove-iam-policy-binding +++ b/gcloud/alpha/bigtable/tables/remove-iam-policy-binding @@ -13,23 +13,23 @@ DESCRIPTION binding consists of a member, a role, and an optional condition. EXAMPLES - To remove an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with table 'my-table' in instance 'my-instance', run: + To remove an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with table my-table in instance my-instance, run: $ gcloud alpha bigtable tables remove-iam-policy-binding my-table \ - --instance='my-instance' --member='user:test-user@gmail.com' \ - --role='roles/editor' + --instance=`my-instance` --member=`user:test-user@gmail.com` \ + --role=`roles/editor` To remove an IAM policy binding which expires at the end of the year 2019 - for the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' - with table 'my-table' in instance 'my-instance', run: + for the role of roles/bigtable.admin and the user test-user@gmail.com with + table my-table in instance my-instance, run: $ gcloud alpha bigtable tables remove-iam-policy-binding my-table \ - --instance='my-instance' --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,descrip\ - tion=Expires at midnight on 2019-12-31' + --instance=`my-instance` --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,\ + description=Expires at midnight on 2019-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -58,7 +58,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/bigtable/tables/restore b/gcloud/alpha/bigtable/tables/restore index 025312b95..63ec74e8c 100644 --- a/gcloud/alpha/bigtable/tables/restore +++ b/gcloud/alpha/bigtable/tables/restore @@ -53,7 +53,7 @@ REQUIRED FLAGS this group are specified. --destination-instance=DESTINATION_INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument --destination on the command line with a @@ -84,7 +84,7 @@ REQUIRED FLAGS this group are specified. --source-cluster=SOURCE_CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument --source on the command line with a fully @@ -92,7 +92,7 @@ REQUIRED FLAGS ▸ provide the argument --source-cluster on the command line. --source-instance=SOURCE_INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument --source on the command line with a fully diff --git a/gcloud/alpha/bigtable/tables/set-iam-policy b/gcloud/alpha/bigtable/tables/set-iam-policy index f543392bb..85975f02b 100644 --- a/gcloud/alpha/bigtable/tables/set-iam-policy +++ b/gcloud/alpha/bigtable/tables/set-iam-policy @@ -10,11 +10,11 @@ DESCRIPTION (ALPHA) Set an IAM policy on a Cloud Bigtable table. EXAMPLES - To set the IAM policy from file 'my-policy' on the table 'my-table' in - instance 'my-instance', run: + To set the IAM policy from file my-policy on the table my-table in instance + my-instance, run: $ gcloud alpha bigtable tables set-iam-policy my-table \ - --instance='my-instance' my-policy + --instance=`my-instance` my-policy See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -43,7 +43,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/bigtable/tables/undelete b/gcloud/alpha/bigtable/tables/undelete index 926025784..bf6adb1d7 100644 --- a/gcloud/alpha/bigtable/tables/undelete +++ b/gcloud/alpha/bigtable/tables/undelete @@ -39,7 +39,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/bigtable/tables/update b/gcloud/alpha/bigtable/tables/update index 22e3a408d..241a6e7d9 100644 --- a/gcloud/alpha/bigtable/tables/update +++ b/gcloud/alpha/bigtable/tables/update @@ -82,7 +82,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/alpha/blockchain-validator/blockchain-validator-configs/create b/gcloud/alpha/blockchain-validator/blockchain-validator-configs/create index b09b37a80..5b6eba1f0 100644 --- a/gcloud/alpha/blockchain-validator/blockchain-validator-configs/create +++ b/gcloud/alpha/blockchain-validator/blockchain-validator-configs/create @@ -127,9 +127,11 @@ OPTIONAL FLAGS --labels=path_to_file.(yaml|json) --location=LOCATION - For resources [blockchainValidatorConfig, secret], provides fallback - value for resource location attribute. When the resource's full URI - path is not provided, location will fallback to this flag value. + For resources [blockchain_validator_config, + existing-seed-phrase-reference-secret, seed-phrase-reference-secret], + provides fallback value for resource location attribute. When the + resource's full URI path is not provided, location will fallback to + this flag value. --request-id=REQUEST_ID An optional request ID to identify requests. Specify a unique request diff --git a/gcloud/alpha/cloudlocationfinder/cloud-locations/describe b/gcloud/alpha/cloudlocationfinder/cloud-locations/describe index 37e6d112e..799893657 100644 --- a/gcloud/alpha/cloudlocationfinder/cloud-locations/describe +++ b/gcloud/alpha/cloudlocationfinder/cloud-locations/describe @@ -58,6 +58,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the cloudlocationfinder/v1alpha API. The full documentation for this API can be found at: + https://cloud.google.com/location-finder/docs NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/composer/environments/restart-web-server b/gcloud/alpha/composer/environments/restart-web-server index 1db186e0d..b7fe4700b 100644 --- a/gcloud/alpha/composer/environments/restart-web-server +++ b/gcloud/alpha/composer/environments/restart-web-server @@ -66,7 +66,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 composer environments restart-web-server $ gcloud beta composer environments restart-web-server diff --git a/gcloud/alpha/compute/backend-buckets/add-iam-policy-binding b/gcloud/alpha/compute/backend-buckets/add-iam-policy-binding index 20eeeaf4a..24665f63c 100644 --- a/gcloud/alpha/compute/backend-buckets/add-iam-policy-binding +++ b/gcloud/alpha/compute/backend-buckets/add-iam-policy-binding @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha compute backend-buckets add-iam-policy-binding BACKEND_BUCKET - --member=PRINCIPAL --role=ROLE [GCLOUD_WIDE_FLAG ...] + --member=PRINCIPAL --role=ROLE [--global | --region=REGION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Add an IAM policy binding to a Compute Engine backend bucket. @@ -12,34 +13,31 @@ DESCRIPTION EXAMPLES To add an IAM policy binding for the role of 'compute.loadBalancerServiceUser' for the user 'test-user@gmail.com' with - backend bucket 'my-backend-bucket' run: + backend service 'my-backend-bucket' and region 'REGION', run: $ gcloud alpha compute backend-buckets add-iam-policy-binding \ - my-backend-bucket --member='user:test-user@gmail.com' \ - --role='roles/compute.loadBalancerServiceUser' + my-backend-bucket --region=REGION \ + --member='user:test-user@gmail.com' \ + --role='roles/compute.loadBalancerServiceUser' + + $ gcloud alpha compute backend-buckets add-iam-policy-binding \ + my-backend-bucket --global --member='user:test-user@gmail.com' \ + --role='roles/compute.loadBalancerServiceUser' + + $ gcloud alpha compute backend-buckets add-iam-policy-binding \ + my-backend-bucket --member='user:test-user@gmail.com' \ + --role='roles/compute.loadBalancerServiceUser' See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. POSITIONAL ARGUMENTS - Backend bucket resource - The backend bucket for which to add the IAM - policy to. This represents a Cloud resource. (NOTE) Some attributes are - not given arguments in this group but can be set in other ways. + BACKEND_BUCKET + ID of the backend bucket or fully qualified identifier for the backend + bucket. - To set the project attribute: - ◆ provide the argument backend_bucket 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. - - BACKEND_BUCKET - ID of the backend bucket or fully qualified identifier for the - backend bucket. - - To set the backend_bucket attribute: - ▸ provide the argument backend_bucket on the command line. + To set the backend_bucket attribute: + + provide the argument backend_bucket on the command line. REQUIRED FLAGS --member=PRINCIPAL @@ -62,6 +60,16 @@ REQUIRED FLAGS for a custom role, such as organizations/{ORGANIZATION_ID}/roles/logging.viewer. +OPTIONAL FLAGS + At most one of these can be specified: + + --global + If set, the backend bucket is global. + + --region=REGION + Region of the backend bucket to operate on. Overrides the default + compute/region property value for this command invocation. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/compute/backend-buckets/get-iam-policy b/gcloud/alpha/compute/backend-buckets/get-iam-policy index 55d46a05d..f688346e7 100644 --- a/gcloud/alpha/compute/backend-buckets/get-iam-policy +++ b/gcloud/alpha/compute/backend-buckets/get-iam-policy @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud alpha compute backend-buckets get-iam-policy BACKEND_BUCKET - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + [--global | --region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute backend-buckets get-iam-policy displays the @@ -18,28 +18,32 @@ DESCRIPTION EXAMPLES To print the IAM policy for a given backend bucket, run: + $ gcloud alpha compute backend-buckets get-iam-policy \ + my-backend-bucket --region=REGION + + $ gcloud alpha compute backend-buckets get-iam-policy \ + my-backend-bucket --global + $ gcloud alpha compute backend-buckets get-iam-policy \ my-backend-bucket POSITIONAL ARGUMENTS - Backend bucket resource - The network to display the IAM policy for. This - represents a Cloud resource. (NOTE) Some attributes are not given - arguments in this group but can be set in other ways. + BACKEND_BUCKET + ID of the backend bucket or fully qualified identifier for the backend + bucket. - To set the project attribute: - ◆ provide the argument backend_bucket on the command line with a fully - specified name; - ◆ provide the argument --project on the command line; - ◆ set the property core/project. + To set the backend_bucket attribute: + + provide the argument backend_bucket on the command line. - This must be specified. +FLAGS + At most one of these can be specified: - BACKEND_BUCKET - ID of the backend bucket or fully qualified identifier for the - backend bucket. + --global + If set, the backend bucket is global. - To set the backend_bucket attribute: - ▸ provide the argument backend_bucket on the command line. + --region=REGION + Region of the backend bucket to operate on. Overrides the default + compute/region property value for this command invocation. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/compute/backend-buckets/remove-iam-policy-binding b/gcloud/alpha/compute/backend-buckets/remove-iam-policy-binding index 8196ef832..ccd459c8e 100644 --- a/gcloud/alpha/compute/backend-buckets/remove-iam-policy-binding +++ b/gcloud/alpha/compute/backend-buckets/remove-iam-policy-binding @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha compute backend-buckets remove-iam-policy-binding - BACKEND_BUCKET --member=PRINCIPAL --role=ROLE [GCLOUD_WIDE_FLAG ...] + BACKEND_BUCKET --member=PRINCIPAL --role=ROLE + [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Remove an IAM policy binding from a Compute Engine backend bucket. @@ -12,34 +13,31 @@ DESCRIPTION EXAMPLES To remove an IAM policy binding for the role of 'roles/compute.loadBalancerServiceUser' for the user 'test-user@gmail.com' - with backend bucket 'my-backend-bucket' run: + with backend bucket 'my-backend-bucket' and region 'REGION', run: $ gcloud alpha compute backend-buckets remove-iam-policy-binding \ - my-backend-bucket --member='user:test-user@gmail.com' \ - --role='roles/compute.loadBalancerServiceUser' + my-backend-bucket --region=REGION \ + --member='user:test-user@gmail.com' \ + --role='roles/compute.loadBalancerServiceUser' + + $ gcloud alpha compute backend-buckets remove-iam-policy-binding \ + my-backend-bucket --global --member='user:test-user@gmail.com' \ + --role='roles/compute.loadBalancerServiceUser' + + $ gcloud alpha compute backend-buckets remove-iam-policy-binding \ + my-backend-bucket --member='user:test-user@gmail.com' \ + --role='roles/compute.loadBalancerServiceUser' See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. POSITIONAL ARGUMENTS - Backend bucket resource - The backend bucket for which to remove the IAM - policy from. This represents a Cloud resource. (NOTE) Some attributes are - not given arguments in this group but can be set in other ways. + BACKEND_BUCKET + ID of the backend bucket or fully qualified identifier for the backend + bucket. - To set the project attribute: - ◆ provide the argument backend_bucket 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. - - BACKEND_BUCKET - ID of the backend bucket or fully qualified identifier for the - backend bucket. - - To set the backend_bucket attribute: - ▸ provide the argument backend_bucket on the command line. + To set the backend_bucket attribute: + + provide the argument backend_bucket on the command line. REQUIRED FLAGS --member=PRINCIPAL @@ -63,6 +61,16 @@ REQUIRED FLAGS --role=ROLE The role to remove the principal from. +OPTIONAL FLAGS + At most one of these can be specified: + + --global + If set, the backend bucket is global. + + --region=REGION + Region of the backend bucket to operate on. Overrides the default + compute/region property value for this command invocation. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/compute/backend-buckets/set-iam-policy b/gcloud/alpha/compute/backend-buckets/set-iam-policy index cebd70203..6f40cf894 100644 --- a/gcloud/alpha/compute/backend-buckets/set-iam-policy +++ b/gcloud/alpha/compute/backend-buckets/set-iam-policy @@ -4,16 +4,21 @@ NAME SYNOPSIS gcloud alpha compute backend-buckets set-iam-policy BACKEND_BUCKET - POLICY_FILE [GCLOUD_WIDE_FLAG ...] + POLICY_FILE [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Sets the IAM policy for the given backend bucket as defined in a JSON or YAML file. EXAMPLES - The following command reads an IAM policy defined in a JSON file called - 'policy.json' and sets it for the backend bucket called - 'my-backend-bucket': + The following command will read an IAM policy defined in a JSON file + 'policy.json' and set it for the backend bucket my-backend-bucket: + + $ gcloud alpha compute backend-buckets set-iam-policy \ + my-backend-bucket policy.json --region=REGION + + $ gcloud alpha compute backend-buckets set-iam-policy \ + my-backend-bucket policy.json --global $ gcloud alpha compute backend-buckets set-iam-policy \ my-backend-bucket policy.json @@ -22,24 +27,12 @@ EXAMPLES policy file format and contents. POSITIONAL ARGUMENTS - Backend bucket resource - The backend bucket to set the IAM policy for. - This represents a Cloud resource. (NOTE) Some attributes are not given - arguments in this group but can be set in other ways. + BACKEND_BUCKET + ID of the backend bucket or fully qualified identifier for the backend + bucket. - To set the project attribute: - ◆ provide the argument backend_bucket 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. - - BACKEND_BUCKET - ID of the backend bucket or fully qualified identifier for the - backend bucket. - - To set the backend_bucket attribute: - ▸ provide the argument backend_bucket on the command line. + To set the backend_bucket attribute: + + provide the argument backend_bucket on the command line. POLICY_FILE Path to a local JSON or YAML formatted file containing a valid policy. @@ -48,6 +41,16 @@ POSITIONAL ARGUMENTS JSON or YAML file conforming to the structure of a Policy (https://cloud.google.com/iam/reference/rest/v1/Policy). +FLAGS + At most one of these can be specified: + + --global + If set, the backend bucket is global. + + --region=REGION + Region of the backend bucket to setIamPolicy. Overrides the default + compute/region property value for this command invocation. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/compute/interconnects/groups/create-members b/gcloud/alpha/compute/interconnects/groups/create-members index c041a7d2d..4bb89f16b 100644 --- a/gcloud/alpha/compute/interconnects/groups/create-members +++ b/gcloud/alpha/compute/interconnects/groups/create-members @@ -10,6 +10,7 @@ SYNOPSIS [--intent-mismatch-behavior=INTENT_MISMATCH_BEHAVIOR] [--interconnect-type=INTERCONNECT_TYPE] [--link-type=LINK_TYPE] [--noc-contact-email=NOC_CONTACT_EMAIL] + [--remote-location=REMOTE_LOCATION] [--requested-features=[FEATURES,...]] [--requested-link-count=REQUESTED_LINK_COUNT] [GCLOUD_WIDE_FLAG ...] @@ -102,6 +103,9 @@ OPTIONAL FLAGS Email address to contact the customer NOC for operations and maintenance notifications regarding this interconnect. + --remote-location=REMOTE_LOCATION + The location of the interconnect for Cross-Cloud Interconnect. + --requested-features=[FEATURES,...] List of features requested for this interconnect. FEATURES must be one of: diff --git a/gcloud/alpha/compute/org-security-policies/rules/add-preconfig-waf-exclusion b/gcloud/alpha/compute/org-security-policies/rules/add-preconfig-waf-exclusion new file mode 100644 index 000000000..0770a61d2 --- /dev/null +++ b/gcloud/alpha/compute/org-security-policies/rules/add-preconfig-waf-exclusion @@ -0,0 +1,148 @@ +NAME + gcloud alpha compute org-security-policies rules + add-preconfig-waf-exclusion - add an exclusion configuration for + preconfigured WAF evaluation into a security policy rule + +SYNOPSIS + gcloud alpha compute org-security-policies rules + add-preconfig-waf-exclusion PRIORITY --security-policy=SECURITY_POLICY + --target-rule-set=TARGET_RULE_SET [--organization=ORGANIZATION] + [--request-cookie-to-exclude=[op=OP],[val=VAL]] + [--request-header-to-exclude=[op=OP],[val=VAL]] + [--request-query-param-to-exclude=[op=OP],[val=VAL]] + [--request-uri-to-exclude=[op=OP],[val=VAL]] + [--target-rule-ids=[RULE_ID,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute org-security-policies rules + add-preconfig-waf-exclusion is used to add an exclusion configuration for + preconfigured WAF evaluation into a security policy rule. + + Note that request field exclusions are associated with a target, which can + be a single rule set, or a rule set plus a list of rule IDs under the rule + set. + +EXAMPLES + To add specific request field exclusions that are associated with the + target of 'sqli-stable': ['owasp-crs-v030001-id942110-sqli', + 'owasp-crs-v030001-id942120-sqli'], run: + + $ gcloud alpha compute org-security-policies rules \ + add-preconfig-waf-exclusion 1000 --security-policy=1234567890 \ + --target-rule-set=sqli-stable \ + --target-rule-ids='owasp-crs-v030001-id942110-sqli',\ + 'owasp-crs-v030001-id942120-sqli' \ + --request-header-to-exclude='op=EQUALS,val=abc' \ + --request-header-to-exclude='op=STARTS_WITH,val=xyz' \ + --request-uri-to-exclude='op=EQUALS_ANY' + + To add specific request field exclusions that are associated with the + target of 'sqli-stable': [], run: + + $ gcloud alpha compute org-security-policies rules \ + add-preconfig-waf-exclusion 1000 --security-policy=1234567890 \ + --target-rule-set=sqli-stable \ + --request-cookie-to-exclude='op=EQUALS_ANY' + +POSITIONAL ARGUMENTS + PRIORITY + Priority of the security policy rule to add preconfig WAF exclusion. + +REQUIRED FLAGS + --security-policy=SECURITY_POLICY + short name of the security policy into which the rule should be + updated. + + --target-rule-set=TARGET_RULE_SET + Target WAF rule set where the request field exclusions being added + would apply. + + This, together with the target rule IDs (if given), determines the + target for associating request field exclusions. See --target-rule-ids. + +OPTIONAL FLAGS + --organization=ORGANIZATION + Organization which the organization security policy belongs to. Must be + set if SECURITY_POLICY is short name. + + --request-cookie-to-exclude=[op=OP],[val=VAL] + Adds a request cookie to the request field exclusions associated with + the rule set and rule IDs (if given). This specifies a request cookie + whose value will be excluded from inspection during preconfigured WAF + evaluation. + + You can specify an exact match or a partial match by using a field + operator and a field value. Available field operators are: + ◆ EQUALS: the operator matches if the field value equals the + specified value. + ◆ STARTS_WITH: the operator matches if the field value starts with + the specified value. + ◆ ENDS_WITH: the operator matches if the field value ends with the + specified value. + ◆ CONTAINS: the operator matches if the field value contains the + specified value. + ◆ EQUALS_ANY: the operator matches if the field value is any value. + + A field value must be given if the field operator is not EQUALS_ANY, + and cannot be given if the field operator is EQUALS_ANY. For example, + --request-header-to-exclude op=EQUALS,val=abc or + --request-header-to-exclude op=EQUALS_ANY. + + This flag can be repeated to specify multiple request headers to + exclude. For example, --request-header-to-exclude op=EQUALS,val=abc + --request-header-to-exclude op=STARTS_WITH,val=xyz. + + --request-header-to-exclude=[op=OP],[val=VAL] + Adds a request header to the request field exclusions associated with + the rule set and rule IDs (if given). This specifies a request header + whose value will be excluded from inspection during preconfigured WAF + evaluation. + + Refer to the syntax under --request-cookie-to-exclude. + + This flag can be repeated to specify multiple request headers. + + --request-query-param-to-exclude=[op=OP],[val=VAL] + Adds a request query parameter to the request field exclusions + associated with the rule set and rule IDs (if given). This specifies a + request query parameter in the query string or in the POST body whose + value will be excluded from inspection during preconfigured WAF + evaluation. + + Refer to the syntax under --request-cookie-to-exclude. + + This flag can be repeated to specify multiple request query parameters. + + --request-uri-to-exclude=[op=OP],[val=VAL] + Adds a request URI to the request field exclusions associated with the + rule set and rule IDs (if given). This specifies a request URI from the + request line to be excluded from inspection during preconfigured WAF + evaluation. + + Refer to the syntax under --request-cookie-to-exclude. + + This flag can be repeated to specify multiple request URIs. + + --target-rule-ids=[RULE_ID,...] + A comma-separated list of target rule IDs under the WAF rule set where + the request field exclusions being added would apply. If omitted, the + added request field exclusions will be associated with the rule set + only, which would apply to all the rule IDs under the rule set. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta compute org-security-policies rules \ + add-preconfig-waf-exclusion + diff --git a/gcloud/alpha/compute/org-security-policies/rules/help b/gcloud/alpha/compute/org-security-policies/rules/help index 505a82791..d8e9e7c17 100644 --- a/gcloud/alpha/compute/org-security-policies/rules/help +++ b/gcloud/alpha/compute/org-security-policies/rules/help @@ -18,6 +18,10 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + add-preconfig-waf-exclusion + (ALPHA) Add an exclusion configuration for preconfigured WAF evaluation + into a security policy rule. + create (ALPHA) Create a Compute Engine security policy rule. @@ -27,6 +31,10 @@ COMMANDS describe (ALPHA) Describe a Compute Engine organization security policy rule. + remove-preconfig-waf-exclusion + (ALPHA) Remove an exclusion configuration for preconfigured WAF + evaluation from a security policy rule. + update (ALPHA) Update a Compute Engine security policy rule. diff --git a/gcloud/alpha/compute/org-security-policies/rules/remove-preconfig-waf-exclusion b/gcloud/alpha/compute/org-security-policies/rules/remove-preconfig-waf-exclusion new file mode 100644 index 000000000..535ab610b --- /dev/null +++ b/gcloud/alpha/compute/org-security-policies/rules/remove-preconfig-waf-exclusion @@ -0,0 +1,167 @@ +NAME + gcloud alpha compute org-security-policies rules + remove-preconfig-waf-exclusion - remove an exclusion configuration for + preconfigured WAF evaluation from a security policy rule + +SYNOPSIS + gcloud alpha compute org-security-policies rules + remove-preconfig-waf-exclusion PRIORITY + --security-policy=SECURITY_POLICY --target-rule-set=TARGET_RULE_SET + [--organization=ORGANIZATION] + [--request-cookie-to-exclude=[op=OP],[val=VAL]] + [--request-header-to-exclude=[op=OP],[val=VAL]] + [--request-query-param-to-exclude=[op=OP],[val=VAL]] + [--request-uri-to-exclude=[op=OP],[val=VAL]] + [--target-rule-ids=[RULE_ID,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute org-security-policies rules + remove-preconfig-waf-exclusion is used to remove an exclusion configuration + for preconfigured WAF evaluation from a security policy rule. + + Note that request field exclusions are associated with a target, which can + be a single rule set, or a rule set plus a list of rule IDs under the rule + set. + + It is possible to remove request field exclusions at 3 levels: + ▪ Remove specific request field exclusions that are associated with a + matching target. + ▪ Remove all the request field exclusions that are associated with a + matching target. + ▪ Remove all the request field exclusions that are configured under the + security policy rule, regardless of the target. + +EXAMPLES + To remove specific request field exclusions that are associated with the + target of 'sqli-stable': ['owasp-crs-v030001-id942110-sqli', + 'owasp-crs-v030001-id942120-sqli'], run: + + $ gcloud alpha compute org-security-policies rules \ + remove-preconfig-waf-exclusion 1000 \ + --security-policy=1234567890 --target-rule-set=sqli-stable \ + --target-rule-ids='owasp-crs-v030001-id942110-sqli',\ + 'owasp-crs-v030001-id942120-sqli' \ + --request-header-to-exclude='op=EQUALS,val=abc' \ + --request-header-to-exclude='op=STARTS_WITH,val=xyz' \ + --request-uri-to-exclude='op=EQUALS_ANY' + + To remove all the request field exclusions that are associated with the + target of 'sqli-stable': ['owasp-crs-v030001-id942110-sqli', + 'owasp-crs-v030001-id942120-sqli'], run: + + $ gcloud alpha compute org-security-policies rules \ + remove-preconfig-waf-exclusion 1000 \ + --security-policy=1234567890 --target-rule-set=sqli-stable \ + --target-rule-ids='owasp-crs-v030001-id942110-sqli',\ + 'owasp-crs-v030001-id942120-sqli' + + To remove all the request field exclusions that are associated with the + target of 'sqli-stable': [], run: + + $ gcloud alpha compute org-security-policies rules \ + remove-preconfig-waf-exclusion 1000 \ + --security-policy=1234567890 --target-rule-set=sqli-stable + + To remove all the request field exclusions that are configured under the + security policy rule, regardless of the target, run: + + $ gcloud alpha compute org-security-policies rules \ + remove-preconfig-waf-exclusion 1000 \ + --security-policy=1234567890 --target-rule-set=* + +POSITIONAL ARGUMENTS + PRIORITY + Priority of the security policy rule to remove preconfig WAF exclusion. + +REQUIRED FLAGS + --security-policy=SECURITY_POLICY + short name of the security policy into which the rule should be + updated. + + --target-rule-set=TARGET_RULE_SET + Target WAF rule set from where to remove the request field exclusions. + + This, together with the target rule IDs (if given), determines the + target for associating request field exclusions. See --target-rule-ids. + + Note that the removal of request field exclusions is restricted to + those associated with a matching target. Set this flag to * if you want + to remove request field exclusions regardless of the target. + +OPTIONAL FLAGS + --organization=ORGANIZATION + Organization which the organization security policy belongs to. Must be + set if SECURITY_POLICY is short name. + + --request-cookie-to-exclude=[op=OP],[val=VAL] + Removes a request cookie from the existing request field exclusions + associated with the rule set and rule IDs (if given). + + You can specify an exact match or a partial match by using a field + operator and a field value. Available field operators are: + ◆ EQUALS: the operator matches if the field value equals the + specified value. + ◆ STARTS_WITH: the operator matches if the field value starts with + the specified value. + ◆ ENDS_WITH: the operator matches if the field value ends with the + specified value. + ◆ CONTAINS: the operator matches if the field value contains the + specified value. + ◆ EQUALS_ANY: the operator matches if the field value is any value. + + A field value must be given if the field operator is not EQUALS_ANY, + and cannot be given if the field operator is EQUALS_ANY. For example, + --request-header-to-exclude op=EQUALS,val=abc or + --request-header-to-exclude op=EQUALS_ANY. + + This flag can be repeated to specify multiple request headers to + exclude. For example, --request-header-to-exclude op=EQUALS,val=abc + --request-header-to-exclude op=STARTS_WITH,val=xyz. + + --request-header-to-exclude=[op=OP],[val=VAL] + Removes a request header from the existing request field exclusions + associated with the rule set and rule IDs (if given). + + Refer to the syntax under --request-cookie-to-exclude. + + This flag can be repeated to specify multiple request headers. + + --request-query-param-to-exclude=[op=OP],[val=VAL] + Removes a request query parameter from the existing request field + exclusions associated with the rule set and rule IDs (if given). + + Refer to the syntax under --request-cookie-to-exclude. + + This flag can be repeated to specify multiple request query parameters. + + --request-uri-to-exclude=[op=OP],[val=VAL] + Removes a request URI from the existing request field exclusions + associated with the rule set and rule IDs (if given). + + Refer to the syntax under --request-cookie-to-exclude. + + This flag can be repeated to specify multiple request URIs. + + --target-rule-ids=[RULE_ID,...] + A comma-separated list of target rule IDs under the WAF rule set from + where to remove the request field exclusions. If omitted, the removal + of request field exclusions is restricted to those associated with the + rule set only, without specific rule IDs. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta compute org-security-policies rules \ + remove-preconfig-waf-exclusion + diff --git a/gcloud/alpha/compute/reservations/sub-blocks/describe b/gcloud/alpha/compute/reservations/sub-blocks/describe index 60293b2f5..47eceedcb 100644 --- a/gcloud/alpha/compute/reservations/sub-blocks/describe +++ b/gcloud/alpha/compute/reservations/sub-blocks/describe @@ -1,6 +1,6 @@ NAME gcloud alpha compute reservations sub-blocks describe - describe a Compute - Engine reservation sub block + Engine reservation sub-block SYNOPSIS gcloud alpha compute reservations sub-blocks describe RESERVATION @@ -8,11 +8,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Describe a Compute Engine reservation sub block. + (ALPHA) Describe a Compute Engine reservation sub-block. EXAMPLES - To describe a reservation sub block in reservation exr1 in my-zone with - block name my-block and sub block name my-sub-block, run: + To describe a reservation sub-block in reservation exr1 in my-zone with + block name my-block and sub-block name my-sub-block, run: $ gcloud alpha compute reservations sub-blocks describe exr1 \ --zone=my-zone --block-name=my-block \ diff --git a/gcloud/alpha/compute/reservations/sub-blocks/help b/gcloud/alpha/compute/reservations/sub-blocks/help index bb60cd61c..4027d0d60 100644 --- a/gcloud/alpha/compute/reservations/sub-blocks/help +++ b/gcloud/alpha/compute/reservations/sub-blocks/help @@ -17,14 +17,13 @@ COMMANDS COMMAND is one of the following: describe - (ALPHA) Describe a Compute Engine reservation sub block. + (ALPHA) Describe a Compute Engine reservation sub-block. list - (ALPHA) List Compute Engine reservation sub blocks. + (ALPHA) List Compute Engine reservation sub-blocks. perform-maintenance - (ALPHA) Perform maintenance on a reservation sub block within a - reservation. + (ALPHA) Perform maintenance on a reservation sub-block. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/compute/reservations/sub-blocks/list b/gcloud/alpha/compute/reservations/sub-blocks/list index d5634a630..3361af656 100644 --- a/gcloud/alpha/compute/reservations/sub-blocks/list +++ b/gcloud/alpha/compute/reservations/sub-blocks/list @@ -1,6 +1,6 @@ NAME gcloud alpha compute reservations sub-blocks list - list Compute Engine - reservation sub blocks + reservation sub-blocks SYNOPSIS gcloud alpha compute reservations sub-blocks list RESERVATION @@ -10,10 +10,10 @@ SYNOPSIS DESCRIPTION (ALPHA) gcloud alpha compute reservations sub-blocks list displays all - Compute Engine reservation sub blocks in an extended reservation's block. + Compute Engine reservation sub-blocks in an extended reservation's block. EXAMPLES - To list all reservation sub blocks in an extended reservation's block + To list all reservation sub-blocks in an extended reservation's block my-block in table form, run: $ gcloud alpha compute reservations sub-blocks list \ diff --git a/gcloud/alpha/compute/reservations/sub-blocks/perform-maintenance b/gcloud/alpha/compute/reservations/sub-blocks/perform-maintenance index 8f1e4e40b..fb734dee1 100644 --- a/gcloud/alpha/compute/reservations/sub-blocks/perform-maintenance +++ b/gcloud/alpha/compute/reservations/sub-blocks/perform-maintenance @@ -1,6 +1,6 @@ NAME gcloud alpha compute reservations sub-blocks perform-maintenance - perform - maintenance on a reservation sub block within a reservation + maintenance on a reservation sub-block SYNOPSIS gcloud alpha compute reservations sub-blocks perform-maintenance @@ -8,12 +8,11 @@ SYNOPSIS [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Perform maintenance on a reservation sub block within a - reservation. + (ALPHA) Perform maintenance on a reservation sub-block. EXAMPLES - To perform maintenance on a reservation sub block in reservation exr-1 in - ZONE with block name block-1 and sub block name sub-block-1, run: + To perform maintenance on a reservation sub-block in reservation exr-1 in + ZONE with block name block-1 and sub-block name sub-block-1, run: $ gcloud alpha compute reservations sub-blocks perform-maintenance \ exr-1 --zone=ZONE --block-name=block-1 \ @@ -64,5 +63,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud compute reservations sub-blocks perform-maintenance + + $ gcloud beta compute reservations sub-blocks perform-maintenance diff --git a/gcloud/alpha/compute/storage-pools/create b/gcloud/alpha/compute/storage-pools/create index 989ae98b2..935947948 100644 --- a/gcloud/alpha/compute/storage-pools/create +++ b/gcloud/alpha/compute/storage-pools/create @@ -101,7 +101,7 @@ OPTIONAL FLAGS Throughput in MB/s with which to provision the pool. --zone=ZONE - For resources [storage pool, storage pool type], provides fallback + For resources [storage-pool-type, storage_pool], provides fallback value for resource zone attribute. When the resource's full URI path is not provided, zone will fallback to this flag value. diff --git a/gcloud/alpha/compute/tpus/queued-resources/create b/gcloud/alpha/compute/tpus/queued-resources/create index 4e7bbcfe2..71e19d336 100644 --- a/gcloud/alpha/compute/tpus/queued-resources/create +++ b/gcloud/alpha/compute/tpus/queued-resources/create @@ -326,8 +326,8 @@ OPTIONAL FLAGS default project. Full reservation name format is: - - projects//reservations/. + projects//locations//reservations/, + projects//zones//reservations/. --reservation-host-folder=RESERVATION_HOST_FOLDER The folder hosting the reservation that the TPU should use. Only one diff --git a/gcloud/alpha/compute/tpus/tpu-vm/create b/gcloud/alpha/compute/tpus/tpu-vm/create index 3f11a0b43..79842c91a 100644 --- a/gcloud/alpha/compute/tpus/tpu-vm/create +++ b/gcloud/alpha/compute/tpus/tpu-vm/create @@ -5,8 +5,9 @@ SYNOPSIS gcloud alpha compute tpus tpu-vm create (TPU : --zone=ZONE) --version=VERSION [--async] [--autocheckpoint-enabled] [--boot-disk=[KEY=VALUE,...]] [--data-disk=[mode=MODE],[source=SOURCE]] - [--description=DESCRIPTION] [--internal-ips] [--labels=[KEY=VALUE,...]] - [--metadata=[KEY=VALUE,...]] [--metadata-from-file=[KEY=VALUE,...]] + [--description=DESCRIPTION] [--image=IMAGE] [--internal-ips] + [--labels=[KEY=VALUE,...]] [--metadata=[KEY=VALUE,...]] + [--metadata-from-file=[KEY=VALUE,...]] [--network=NETWORK; default="default"] [--preemptible] [--provisioning-model=PROVISIONING_MODEL] [--queue-count=QUEUE_COUNT] [--range=RANGE] [--reservation=RESERVATION] [--reserved] @@ -130,6 +131,11 @@ OPTIONAL FLAGS --description=DESCRIPTION Text description of the TPU. + --image=IMAGE + Specifies the full URI of the machine image to use for creating the TPU + VM's boot disk. If specified, this will override the boot image that + would normally be used by the specified --runtime-version. + --internal-ips Indicate that the IP addresses for the node should be internal. The default is that external IP addresses will be associated with the TPU diff --git a/gcloud/alpha/container/ai/help b/gcloud/alpha/container/ai/help index 3fe1342a0..8adf97f81 100644 --- a/gcloud/alpha/container/ai/help +++ b/gcloud/alpha/container/ai/help @@ -18,9 +18,6 @@ GROUPS profiles (ALPHA) Quickstart engine for GKE AI workloads. - recommender - (ALPHA) (DEPRECATED) Recommendation engine for GKE AI workloads. - NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/container/ai/profiles/accelerators/list b/gcloud/alpha/container/ai/profiles/accelerators/list index ba8a01c0e..a41887285 100644 --- a/gcloud/alpha/container/ai/profiles/accelerators/list +++ b/gcloud/alpha/container/ai/profiles/accelerators/list @@ -4,8 +4,7 @@ NAME SYNOPSIS gcloud alpha container ai profiles accelerators list --model=MODEL - [--format=FORMAT; default="table"] - [--max-ntpot-milliseconds=MAX_NTPOT_MILLISECONDS] + [--format=FORMAT] [--max-ntpot-milliseconds=MAX_NTPOT_MILLISECONDS] [--model-server=MODEL_SERVER] [--model-server-version=MODEL_SERVER_VERSION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] @@ -29,10 +28,8 @@ REQUIRED FLAGS The model. FLAGS - --format=FORMAT; default="table" - The output format. Default is table, which displays select information - in a table format. Use --format=yaml to display all details. FORMAT - must be one of: table, yaml. + --format=FORMAT + The format to use for the output. Default is table. yaml|table --max-ntpot-milliseconds=MAX_NTPOT_MILLISECONDS The maximum normalized time per output token (NTPOT) in milliseconds. diff --git a/gcloud/alpha/container/ai/recommender/accelerators/list b/gcloud/alpha/container/ai/recommender/accelerators/list deleted file mode 100644 index ec91c9417..000000000 --- a/gcloud/alpha/container/ai/recommender/accelerators/list +++ /dev/null @@ -1,102 +0,0 @@ -NAME - gcloud alpha container ai recommender accelerators list - list compatible - accelerator profiles - -SYNOPSIS - gcloud alpha container ai recommender accelerators list --model=MODEL - [--format=FORMAT; default="table"] - [--max-ntpot-milliseconds=MAX_NTPOT_MILLISECONDS] - [--model-server=MODEL_SERVER] - [--model-server-version=MODEL_SERVER_VERSION] [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) (DEPRECATED) List compatible accelerator profiles. - - This command group is deprecated. Use gcloud alpha container ai profiles - command group instead. - - This command lists all supported accelerators with their performance - details. By default, the supported accelerators are displayed in a table - format with select information for each accelerator. To see all details, - use --format=yaml. - - To get supported model, model servers, and model server versions, run - gcloud alpha container ai recommender models list, gcloud alpha container - ai recommender model-servers list, and gcloud alpha container ai - recommender model-server-versions list. Alternatively, run gcloud alpha - container ai recommender model-and-server-combinations list to get all - supported model and server combinations. - -REQUIRED FLAGS - --model=MODEL - The model. - -FLAGS - --format=FORMAT; default="table" - The output format. Default is table, which displays select information - in a table format. Use --format=yaml to display all details. FORMAT - must be one of: table, yaml. - - --max-ntpot-milliseconds=MAX_NTPOT_MILLISECONDS - The maximum normalized time per output token (NTPOT) in milliseconds. - NTPOT is measured as the request_latency / output_tokens. If this field - is set, the command will only return accelerators that can meet the - target ntpot milliseconds and display their throughput performance at - the target latency. Otherwise, the command will return all accelerators - and display their highest throughput performance. - - --model-server=MODEL_SERVER - The model server. If not specified, this defaults to any model server. - - --model-server-version=MODEL_SERVER_VERSION - The model server version. If not specified, this defaults to the latest - version. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - - --uri - Print a list of resource URIs instead of the default output, and change - the command output to a list of URIs. If this flag is used with - --format, the formatting is applied on this URI list. To display URIs - alongside other keys instead, use the uri() transform. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -NOTES - This command is currently in 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/container/ai/recommender/help b/gcloud/alpha/container/ai/recommender/help deleted file mode 100644 index a69f2b83d..000000000 --- a/gcloud/alpha/container/ai/recommender/help +++ /dev/null @@ -1,58 +0,0 @@ -NAME - gcloud alpha container ai recommender - recommendation engine for GKE AI - workloads - -SYNOPSIS - gcloud alpha container ai recommender GROUP [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) (DEPRECATED) Recommendation engine for GKE AI workloads. - - This command group is deprecated. Use gcloud alpha container ai profiles - command group instead. - - The GKE Inference Recommender helps simplify deploying AI inference on - Google Kubernetes Engine (GKE). It provides tailored recommendations based - on Google's internal benchmarks. Provide inputs like your preferred - open-source model (e.g. Llama, Gemma, or Mistral) and your application's - performance target. Based on these inputs, the recommender generates - accelerator choices with performance metrics, and detailed, ready-to-deploy - recommendations for compute, load balancing, and autoscaling. These - recommendations are provided as standard Kubernetes YAML manifests, which - you can deploy or modify. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -GROUPS - GROUP is one of the following: - - accelerators - (ALPHA) (DEPRECATED) Manage supported accelerators for GKE recommender. - - manifests - (ALPHA) (DEPRECATED) Generate optimized Kubernetes manifests. - - model-and-server-combinations - (ALPHA) (DEPRECATED) Manage supported model and model servers for GKE - recommender. - - model-server-versions - (ALPHA) (DEPRECATED) Manage supported model server versions for GKE - recommender. - - model-servers - (ALPHA) (DEPRECATED) Manage supported model servers for GKE - recommender. - - models - (ALPHA) (DEPRECATED) Manage supported models for GKE recommender. - -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/container/ai/recommender/manifests/create b/gcloud/alpha/container/ai/recommender/manifests/create deleted file mode 100644 index 627c18d46..000000000 --- a/gcloud/alpha/container/ai/recommender/manifests/create +++ /dev/null @@ -1,76 +0,0 @@ -NAME - gcloud alpha container ai recommender manifests create - generate - ready-to-deploy Kubernetes manifests with compute, load balancing, and - autoscaling capabilities - -SYNOPSIS - gcloud alpha container ai recommender manifests create - --accelerator-type=ACCELERATOR_TYPE --model=MODEL - --model-server=MODEL_SERVER - [--model-server-version=MODEL_SERVER_VERSION] [--namespace=NAMESPACE] - [--output=OUTPUT; default="all"] [--output-path=OUTPUT_PATH] - [--target-ntpot-milliseconds=TARGET_NTPOT_MILLISECONDS] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) (DEPRECATED) Generate ready-to-deploy Kubernetes manifests with - compute, load balancing, and autoscaling capabilities. - - This command group is deprecated. Use gcloud alpha container ai profiles - command group instead. - - To get supported model, model servers, and model server versions, run - gcloud alpha container ai recommender model-and-server-combinations list. - To get supported accelerators with their performance metrics, run gcloud - alpha container ai recommender accelerators list. - -REQUIRED FLAGS - --accelerator-type=ACCELERATOR_TYPE - The accelerator type. - - --model=MODEL - The model. - - --model-server=MODEL_SERVER - The model server. - -OPTIONAL FLAGS - --model-server-version=MODEL_SERVER_VERSION - The model server version. If not specified, this defaults to the latest - version. - - --namespace=NAMESPACE - The namespace to deploy the manifests in. Default namespace is - 'default'. - - --output=OUTPUT; default="all" - The output to display. Default is all. OUTPUT must be one of: manifest, - comments, all. - - --output-path=OUTPUT_PATH - The path to save the output to. If not specified, output to the - terminal. - - --target-ntpot-milliseconds=TARGET_NTPOT_MILLISECONDS - The maximum normalized time per output token (NTPOT) in milliseconds. - NTPOT is measured as the request_latency / output_tokens. If this is - set, the manifests will include Horizontal Pod Autoscaler (HPA) - resources which automatically adjust the model server replica count in - response to changes in model server load to keep p50 NTPOT below the - specified threshold. If the provided target-ntpot-milliseconds is too - low to achieve, the HPA manifest will not be generated. - -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/container/ai/recommender/manifests/help b/gcloud/alpha/container/ai/recommender/manifests/help deleted file mode 100644 index 8c0911545..000000000 --- a/gcloud/alpha/container/ai/recommender/manifests/help +++ /dev/null @@ -1,32 +0,0 @@ -NAME - gcloud alpha container ai recommender manifests - generate optimized - Kubernetes manifests - -SYNOPSIS - gcloud alpha container ai recommender manifests COMMAND - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) (DEPRECATED) Generate optimized Kubernetes manifests. - - This command group is deprecated. Use gcloud alpha container ai profiles - command group instead. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - create - (ALPHA) (DEPRECATED) Generate ready-to-deploy Kubernetes manifests with - compute, load balancing, and autoscaling capabilities. - -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/container/ai/recommender/model-and-server-combinations/help b/gcloud/alpha/container/ai/recommender/model-and-server-combinations/help deleted file mode 100644 index e51397e3c..000000000 --- a/gcloud/alpha/container/ai/recommender/model-and-server-combinations/help +++ /dev/null @@ -1,32 +0,0 @@ -NAME - gcloud alpha container ai recommender model-and-server-combinations - - manage supported model and model servers for GKE recommender - -SYNOPSIS - gcloud alpha container ai recommender model-and-server-combinations COMMAND - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) (DEPRECATED) Manage supported model and model servers for GKE - recommender. - - This command group is deprecated. Use gcloud alpha container ai profiles - command group instead. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - list - (ALPHA) (DEPRECATED) List supported model and server combinations. - -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/container/ai/recommender/model-server-versions/help b/gcloud/alpha/container/ai/recommender/model-server-versions/help deleted file mode 100644 index 5070d7575..000000000 --- a/gcloud/alpha/container/ai/recommender/model-server-versions/help +++ /dev/null @@ -1,32 +0,0 @@ -NAME - gcloud alpha container ai recommender model-server-versions - manage - supported model server versions for GKE recommender - -SYNOPSIS - gcloud alpha container ai recommender model-server-versions COMMAND - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) (DEPRECATED) Manage supported model server versions for GKE - recommender. - - This command group is deprecated. Use gcloud alpha container ai profiles - command group instead. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - list - (ALPHA) (DEPRECATED) List supported model server versions. - -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/container/clusters/create b/gcloud/alpha/container/clusters/create index e6a6ae73c..34f8a2d6b 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -31,7 +31,7 @@ SYNOPSIS [--disable-default-snat] [--disable-l4-lb-firewall-reconciliation] [--disable-pod-cidr-overprovision] [--disk-size=DISK_SIZE] [--disk-type=DISK_TYPE] - [--enable-authorized-networks-on-private-endpoint] + [--enable-authorized-networks-on-private-endpoint] [--enable-auto-ipam] [--enable-autorepair] [--no-enable-autoupgrade] [--enable-cilium-clusterwide-network-policy] [--enable-cloud-logging] [--enable-cloud-monitoring] [--enable-cloud-run-alpha] @@ -45,13 +45,13 @@ SYNOPSIS [--enable-ip-alias] [--enable-kubernetes-alpha] [--enable-kubernetes-unstable-apis=API,[API,...]] [--enable-l4-ilb-subsetting] [--enable-legacy-authorization] - [--enable-logging-monitoring-system-only] [--enable-managed-prometheus] - [--enable-master-global-access] [--enable-multi-networking] - [--enable-nested-virtualization] [--enable-network-policy] - [--enable-pod-security-policy] [--enable-ray-cluster-logging] - [--enable-ray-cluster-monitoring] [--enable-service-externalips] - [--enable-shielded-nodes] [--enable-stackdriver-kubernetes] - [--enable-vertical-pod-autoscaling] + [--enable-legacy-lustre-port] [--enable-logging-monitoring-system-only] + [--enable-managed-prometheus] [--enable-master-global-access] + [--enable-multi-networking] [--enable-nested-virtualization] + [--enable-network-policy] [--enable-pod-security-policy] + [--enable-ray-cluster-logging] [--enable-ray-cluster-monitoring] + [--enable-service-externalips] [--enable-shielded-nodes] + [--enable-stackdriver-kubernetes] [--enable-vertical-pod-autoscaling] [--fleet-project=PROJECT_ID_OR_NUMBER] [--gateway-api=GATEWAY_API] [--hpa-profile=HPA_PROFILE] [--identity-provider=IDENTITY_PROVIDER] [--image-type=IMAGE_TYPE] @@ -80,7 +80,7 @@ SYNOPSIS [--placement-policy=PLACEMENT_POLICY] [--placement-type=PLACEMENT_TYPE] [--preemptible] [--private-endpoint-subnetwork=NAME] [--private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE] - [--release-channel=[CHANNEL]] [--resource-manager-tags=[KEY=VALUE,...]] + [--release-channel=CHANNEL] [--resource-manager-tags=[KEY=VALUE,...]] [--security-group=SECURITY_GROUP] [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--spot] @@ -227,8 +227,8 @@ FLAGS ADDON must be one of: HttpLoadBalancing, HorizontalPodAutoscaling, KubernetesDashboard, NetworkPolicy, NodeLocalDNS, ConfigConnector, GcePersistentDiskCsiDriver, GcpFilestoreCsiDriver, BackupRestore, - GcsFuseCsiDriver, ParallelstoreCsiDriver, RayOperator, Istio, - CloudBuild, CloudRun. + GcsFuseCsiDriver, ParallelstoreCsiDriver, LustreCsiDriver, RayOperator, + Istio, CloudBuild, CloudRun. --allow-route-overlap Allows the provided cluster CIDRs to overlap with existing routes that @@ -505,6 +505,10 @@ FLAGS Enable enforcement of --master-authorized-networks CIDR ranges for traffic reaching cluster's control plane via private IP. + --enable-auto-ipam + Enable the Auto IP Address Management (Auto IPAM) feature for the + cluster. + --enable-autorepair Enable node autorepair feature for a cluster's default node pool(s). @@ -668,6 +672,10 @@ FLAGS instead. For instructions, see https://cloud.google.com/kubernetes-engine/docs/how-to/routes-based-cluster + Note: For IPv6-only clusters, these flags are a no-op as IP Aliases do + not apply, and any specified IP address ranges for Pods and Services + will be ignored. + You can't specify both --enable-ip-alias and --no-enable-ip-alias. If you omit both --enable-ip-alias and --no-enable-ip-alias, the default is a VPC-native cluster. @@ -698,6 +706,12 @@ FLAGS permissions instead, create or update your cluster with the option --no-enable-legacy-authorization. + --enable-legacy-lustre-port + Allow the Lustre CSI driver to initialize LNet (the virtual network + layer for Lustre kernel module) using port 6988. This flag is required + to workaround a port conflict with the gke-metadata-server on GKE + nodes. + --enable-logging-monitoring-system-only (DEPRECATED) Enable Cloud Operations system-only monitoring and logging. @@ -1225,7 +1239,7 @@ FLAGS PRIVATE_IPV6_GOOGLE_ACCESS_TYPE must be one of: bidirectional, disabled, outbound-only. - --release-channel=[CHANNEL] + --release-channel=CHANNEL Release channel a cluster is subscribed to. If left unspecified and a version is specified, the cluster is enrolled @@ -1241,8 +1255,15 @@ FLAGS CHANNEL must be one of: - rapid + None + Use 'None' to opt-out of any release channel. + extended + Clusters subscribed to 'extended' can remain on a minor version for + 24 months from when the minor version is made available in the + Regular channel. + + rapid 'rapid' channel is offered on an early access basis for customers who want to test new releases. @@ -1250,28 +1271,15 @@ FLAGS to unresolved issues with no known workaround and are not subject to any SLAs. - regular - + regular Clusters subscribed to 'regular' receive versions that are considered GA quality. 'regular' is intended for production users who want to take advantage of new features. - extended - - Clusters subscribed to 'extended' can remain on a minor version for 24 months - from when the minor version is made available in the Regular channel. - - stable - + stable Clusters subscribed to 'stable' receive versions that are known to be stable and reliable in production. - None - - Use 'None' to opt-out of any release channel. - - CHANNEL must be one of: rapid, regular, extended, stable, None. - --resource-manager-tags=[KEY=VALUE,...] Applies the specified comma-separated resource manager tags that has the GCE_FIREWALL purpose to all nodes in the new default node pool(s) @@ -1362,8 +1370,8 @@ FLAGS VM instances. --stack-type=STACK_TYPE - IP stack type of the node VMs. STACK_TYPE must be one of: ipv4, - ipv4-ipv6. + IP stack type of the cluster nodes. STACK_TYPE must be one of: ipv4, + ipv4-ipv6, ipv6. --storage-pools=STORAGE_POOL,[...] A list of storage pools where the cluster's boot disks will be @@ -1438,6 +1446,8 @@ FLAGS 'fs.mqueue.*', and 'net.*', and sysctls under the groups.) singleProcessOomKill true or false + maxParallelImagePulls integer (The value must be + between [2, 5].) KEY VALUE policy either 'Static' or 'None' @@ -1474,6 +1484,8 @@ FLAGS net.ipv4.tcp_wmem Any positive integer tuple net.ipv4.tcp_tw_reuse Must be {0, 1, 2} + net.ipv4.tcp_max_orphans Must be between + [16384, 262144] net.netfilter.nf_conntrack_max Must be between [65536, 4194304] net.netfilter.nf_conntrack_buckets Must be between @@ -1499,9 +1511,40 @@ FLAGS [0, 184467440736927743 99] + fs.aio-max-nr Must be between + [65536, 4194304] + fs.file-max Must be between + [104857, 67108864] + fs.inotify.max_user_instances Must be between + [8192, 1048576] + fs.inotify.max_user_watches Must be between + [8192, 1048576] + fs.nr_open Must be between + [1048576, + 2147483584] + vm.dirty_background_ratio Must be between + [1, 100] + vm.dirty_expire_centisecs Must be between + [0, 6000] + vm.dirty_ratio Must be between + [1, 100] + vm.dirty_writeback_centisecs Must be between + [0, 1000] vm.max_map_count Must be between [65536, 2147483647] + vm.overcommit_memory Must be one of {0, + 1, 2} + vm.overcommit_ratio Must be between + [0, 100] + vm.vfs_cache_pressure Must be between + [0, 100] + vm.swappiness Must be between + [0, 200] + vm.watermark_scale_factor Must be between + [10, 3000] + vm.min_free_kbytes Must be between + [67584, 1048576] List of supported hugepage size in 'hugepageConfig'. @@ -1522,6 +1565,47 @@ FLAGS ◆ CGROUP_MODE_V2: Use cgroupv2 on the node pool. ◆ CGROUP_MODE_UNSPECIFIED: Use the default GKE cgroup configuration. + Supported values for 'transparentHugepageEnabled' under 'linuxConfig' + which controls transparent hugepage support for anonymous memory. + + ◆ TRANSPARENT_HUGEPAGE_ENABLED_ALWAYS: Transparent hugepage is + enabled system wide. + ◆ TRANSPARENT_HUGEPAGE_ENABLED_MADVISE: Transparent hugepage is + enabled inside MADV_HUGEPAGE regions. This is the default kernel + configuration. + ◆ TRANSPARENT_HUGEPAGE_ENABLED_NEVER: Transparent hugepage is + disabled. + ◆ TRANSPARENT_HUGEPAGE_ENABLED_UNSPECIFIED: Default value. GKE will + not modify the kernel configuration. + + Supported values for 'transparentHugepageDefrag' under 'linuxConfig' + which defines the transparent hugepage defrag configuration on the + node. + + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_ALWAYS: It means that an application + requesting THP will stall on allocation failure and directly reclaim + pages and compact memory in an effort to allocate a THP immediately. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_DEFER: It means that an application + will wake kswapd in the background to reclaim pages and wake + kcompactd to compact memory so that THP is available in the near + future. It is the responsibility of khugepaged to then install the + THP pages later. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_DEFER_WITH_MADVISE: It means that an + application will enter direct reclaim and compaction like always, but + only for regions that have used madvise(MADV_HUGEPAGE); all other + regions will wake kswapd in the background to reclaim pages and wake + kcompactd to compact memory so that THP is available in the near + future. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_MADVISE: It means that an application + will enter direct reclaim and compaction like always, but only for + regions that have used madvise(MADV_HUGEPAGE); all other regions will + wake kswapd in the background to reclaim pages and wake kcompactd to + compact memory so that THP is available in the near future. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_NEVER: It means that an application + will never enter direct reclaim or compaction. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_UNSPECIFIED: Default value. GKE will + not modify the kernel configuration. + Note, updating the system configuration of an existing node pool requires recreation of the nodes which which might cause a disruption. diff --git a/gcloud/alpha/container/clusters/create-auto b/gcloud/alpha/container/clusters/create-auto index a3713a57e..8b4abac67 100644 --- a/gcloud/alpha/container/clusters/create-auto +++ b/gcloud/alpha/container/clusters/create-auto @@ -17,17 +17,19 @@ SYNOPSIS [--create-subnetwork=[KEY=VALUE,...]] [--database-encryption-key=DATABASE_ENCRYPTION_KEY] [--disable-l4-lb-firewall-reconciliation] - [--enable-authorized-networks-on-private-endpoint] + [--enable-authorized-networks-on-private-endpoint] [--enable-auto-ipam] [--enable-backup-restore] [--enable-cilium-clusterwide-network-policy] - [--enable-dns-access] [--enable-fleet] [--enable-google-cloud-access] - [--enable-ip-access] [--enable-kubernetes-unstable-apis=API,[API,...]] + [--enable-confidential-nodes] [--enable-dns-access] [--enable-fleet] + [--enable-google-cloud-access] [--enable-ip-access] + [--enable-kubernetes-unstable-apis=API,[API,...]] + [--enable-legacy-lustre-port] [--enable-lustre-csi-driver] [--enable-master-global-access] [--enable-multi-networking] [--enable-ray-cluster-logging] [--enable-ray-cluster-monitoring] [--enable-ray-operator] [--fleet-project=PROJECT_ID_OR_NUMBER] [--hpa-profile=HPA_PROFILE] [--labels=[KEY=VALUE,...]] [--logging=[COMPONENT,...]] [--monitoring=[COMPONENT,...]] [--network=NETWORK] [--private-endpoint-subnetwork=NAME] - [--release-channel=[CHANNEL]] [--security-group=SECURITY_GROUP] + [--release-channel=CHANNEL] [--security-group=SECURITY_GROUP] [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] [--subnetwork=SUBNETWORK] [--tier=TIER] [--workload-policies=WORKLOAD_POLICIES] @@ -262,6 +264,10 @@ FLAGS Enable enforcement of --master-authorized-networks CIDR ranges for traffic reaching cluster's control plane via private IP. + --enable-auto-ipam + Enable the Auto IP Address Management (Auto IPAM) feature for the + cluster. + --enable-backup-restore Enable the Backup for GKE add-on. This add-on is disabled by default. To learn more, see the Backup for GKE overview: @@ -271,6 +277,11 @@ FLAGS Enable Cilium Clusterwide Network Policies on the cluster. Disabled by default. + --enable-confidential-nodes + Enable confidential nodes for the cluster. Enabling Confidential Nodes + will create nodes using Confidential VM + https://cloud.google.com/compute/confidential-vm/docs/about-cvm. + --enable-dns-access Enable access to the cluster's control plane over DNS-based endpoint. @@ -296,6 +307,16 @@ FLAGS expected to be production ready and should be avoided in production-grade environments. + --enable-legacy-lustre-port + Allow the Lustre CSI driver to initialize LNet (the virtual network + layer for Lustre kernel module) using port 6988. This flag is required + to workaround a port conflict with the gke-metadata-server on GKE + nodes. + + --enable-lustre-csi-driver + Enable the Lustre CSI Driver GKE add-on. This add-on is disabled by + default. + --enable-master-global-access Use with private clusters to allow access to the master's private endpoint from any Google Cloud region or on-premises environment @@ -379,7 +400,7 @@ FLAGS Sets the subnetwork GKE uses to provision the control plane's private endpoint. - --release-channel=[CHANNEL] + --release-channel=CHANNEL Release channel a cluster is subscribed to. If left unspecified and a version is specified, the cluster is enrolled @@ -395,8 +416,12 @@ FLAGS CHANNEL must be one of: - rapid + extended + Clusters subscribed to 'extended' can remain on a minor version for + 24 months from when the minor version is made available in the + Regular channel. + rapid 'rapid' channel is offered on an early access basis for customers who want to test new releases. @@ -404,24 +429,15 @@ FLAGS to unresolved issues with no known workaround and are not subject to any SLAs. - regular - + regular Clusters subscribed to 'regular' receive versions that are considered GA quality. 'regular' is intended for production users who want to take advantage of new features. - extended - - Clusters subscribed to 'extended' can remain on a minor version for 24 months - from when the minor version is made available in the Regular channel. - - stable - + stable Clusters subscribed to 'stable' receive versions that are known to be stable and reliable in production. - CHANNEL must be one of: rapid, regular, extended, stable. - --security-group=SECURITY_GROUP The name of the RBAC security group for use with Google security groups in Kubernetes RBAC diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index c3ea53506..98aaca14e 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -24,6 +24,7 @@ SYNOPSIS | --enable-intra-node-visibility | --enable-kubernetes-unstable-apis=API,[API,...] | --enable-l4-ilb-subsetting | --enable-legacy-authorization + | --enable-legacy-lustre-port | --enable-logging-monitoring-system-only | --enable-multi-networking | --enable-network-policy | --enable-pod-security-policy | --enable-private-nodes | --[no-]enable-ray-cluster-logging @@ -38,7 +39,7 @@ SYNOPSIS | --notification-config=[pubsub=ENABLED|DISABLED, pubsub-topic=TOPIC,...] | --patch-update=[PATCH_UPDATE] | --private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE - | --release-channel=[CHANNEL] | --remove-labels=[KEY,...] + | --release-channel=CHANNEL | --remove-labels=[KEY,...] | --remove-workload-policies=REMOVE_WORKLOAD_POLICIES | --security-group=SECURITY_GROUP | --security-posture=SECURITY_POSTURE @@ -85,6 +86,7 @@ SYNOPSIS | --disable-dataplane-v2-flow-observability | --enable-dataplane-v2-flow-observability --disable-dataplane-v2-metrics | --enable-dataplane-v2-metrics + | --disable-auto-ipam | --enable-auto-ipam | --disable-l4-lb-firewall-reconciliation | --enable-l4-lb-firewall-reconciliation | --enable-authorized-networks-on-private-endpoint @@ -424,6 +426,12 @@ REQUIRED FLAGS use RBAC permissions instead, create or update your cluster with the option --no-enable-legacy-authorization. + --enable-legacy-lustre-port + Allow the Lustre CSI driver to initialize LNet (the virtual network + layer for Lustre kernel module) using port 6988. This flag is + required to workaround a port conflict with the gke-metadata-server + on GKE nodes. + --enable-logging-monitoring-system-only (DEPRECATED) Enable Cloud Operations system-only monitoring and logging. @@ -642,7 +650,7 @@ REQUIRED FLAGS PRIVATE_IPV6_GOOGLE_ACCESS_TYPE must be one of: bidirectional, disabled, outbound-only. - --release-channel=[CHANNEL] + --release-channel=CHANNEL Subscribe or unsubscribe this cluster to a release channel. When a cluster is subscribed to a release channel, Google maintains @@ -653,8 +661,15 @@ REQUIRED FLAGS CHANNEL must be one of: - rapid + None + Use 'None' to opt-out of any release channel. + extended + Clusters subscribed to 'extended' can remain on a minor version + for 24 months from when the minor version is made available in + the Regular channel. + + rapid 'rapid' channel is offered on an early access basis for customers who want to test new releases. @@ -662,27 +677,14 @@ REQUIRED FLAGS to unresolved issues with no known workaround and are not subject to any SLAs. - regular - + regular Clusters subscribed to 'regular' receive versions that are considered GA quality. 'regular' is intended for production users who want to take advantage of new features. - extended - - Clusters subscribed to 'extended' can remain on a minor version for 24 months - from when the minor version is made available in the Regular channel. - - stable - - Clusters subscribed to 'stable' receive versions that are known to - be stable and reliable in production. - - None - - Use 'None' to opt-out of any release channel. - - CHANNEL must be one of: rapid, regular, extended, stable, None. + stable + Clusters subscribed to 'stable' receive versions that are known + to be stable and reliable in production. --remove-labels=[KEY,...] Labels to remove from the Google Cloud resources in use by the @@ -747,7 +749,7 @@ REQUIRED FLAGS existing username. --stack-type=STACK_TYPE - IP stack type of the node VMs. STACK_TYPE must be one of: ipv4, + IP stack type of the cluster nodes. STACK_TYPE must be one of: ipv4, ipv4-ipv6. --start-credential-rotation @@ -1263,6 +1265,16 @@ REQUIRED FLAGS --enable-dataplane-v2-metrics Exposes advanced datapath flow metrics on node port. + At most one of these can be specified: + + --disable-auto-ipam + Disable the Auto IP Address Management (Auto IPAM) feature for the + cluster. + + --enable-auto-ipam + Enable the Auto IP Address Management (Auto IPAM) feature for the + cluster. + At most one of these can be specified: --disable-l4-lb-firewall-reconciliation diff --git a/gcloud/alpha/container/fleet/config-management/disable b/gcloud/alpha/container/fleet/config-management/disable index 3c9030367..d4098c815 100644 --- a/gcloud/alpha/container/fleet/config-management/disable +++ b/gcloud/alpha/container/fleet/config-management/disable @@ -27,10 +27,9 @@ FLAGS At most one of these can be specified: --fleet-default-member-config - Disable fleet-default membership configuration - (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) - without disabling the feature. Does not change existing membership - configurations. Exits silently if the feature is not enabled. + Disable the fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features). + Does not change existing membership configurations. --force Disable this feature, even if it is currently in use. Force diff --git a/gcloud/alpha/container/hub/config-management/disable b/gcloud/alpha/container/hub/config-management/disable index 9fefba8f8..9b710dd00 100644 --- a/gcloud/alpha/container/hub/config-management/disable +++ b/gcloud/alpha/container/hub/config-management/disable @@ -27,10 +27,9 @@ FLAGS At most one of these can be specified: --fleet-default-member-config - Disable fleet-default membership configuration - (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) - without disabling the feature. Does not change existing membership - configurations. Exits silently if the feature is not enabled. + Disable the fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features). + Does not change existing membership configurations. --force Disable this feature, even if it is currently in use. Force diff --git a/gcloud/alpha/container/node-pools/create b/gcloud/alpha/container/node-pools/create index 28e8a4b3c..108ef5dec 100644 --- a/gcloud/alpha/container/node-pools/create +++ b/gcloud/alpha/container/node-pools/create @@ -52,6 +52,7 @@ SYNOPSIS [--sandbox=[type=TYPE]] [--secondary-boot-disk=[disk-image=DISK_IMAGE,[mode=MODE],...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] + [--sole-tenant-min-node-cpus=SOLE_TENANT_MIN_NODE_CPUS] [--sole-tenant-node-affinity-file=SOLE_TENANT_NODE_AFFINITY_FILE] [--spot] [--standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, @@ -705,6 +706,11 @@ FLAGS --shielded-secure-boot The instance will boot with secure boot enabled. + --sole-tenant-min-node-cpus=SOLE_TENANT_MIN_NODE_CPUS + A integer value that specifies the minimum number of vCPUs that each + sole tenant node must have to use CPU overcommit. If not specified, the + CPU overcommit feature is disabled. + --sole-tenant-node-affinity-file=SOLE_TENANT_NODE_AFFINITY_FILE JSON/YAML file containing the configuration of desired sole tenant nodes onto which this node pool could be backed by. These rules filter @@ -816,6 +822,8 @@ FLAGS 'fs.mqueue.*', and 'net.*', and sysctls under the groups.) singleProcessOomKill true or false + maxParallelImagePulls integer (The value must be + between [2, 5].) KEY VALUE policy either 'Static' or 'None' @@ -852,6 +860,8 @@ FLAGS net.ipv4.tcp_wmem Any positive integer tuple net.ipv4.tcp_tw_reuse Must be {0, 1, 2} + net.ipv4.tcp_max_orphans Must be between + [16384, 262144] net.netfilter.nf_conntrack_max Must be between [65536, 4194304] net.netfilter.nf_conntrack_buckets Must be between @@ -877,9 +887,40 @@ FLAGS [0, 184467440736927743 99] + fs.aio-max-nr Must be between + [65536, 4194304] + fs.file-max Must be between + [104857, 67108864] + fs.inotify.max_user_instances Must be between + [8192, 1048576] + fs.inotify.max_user_watches Must be between + [8192, 1048576] + fs.nr_open Must be between + [1048576, + 2147483584] + vm.dirty_background_ratio Must be between + [1, 100] + vm.dirty_expire_centisecs Must be between + [0, 6000] + vm.dirty_ratio Must be between + [1, 100] + vm.dirty_writeback_centisecs Must be between + [0, 1000] vm.max_map_count Must be between [65536, 2147483647] + vm.overcommit_memory Must be one of {0, + 1, 2} + vm.overcommit_ratio Must be between + [0, 100] + vm.vfs_cache_pressure Must be between + [0, 100] + vm.swappiness Must be between + [0, 200] + vm.watermark_scale_factor Must be between + [10, 3000] + vm.min_free_kbytes Must be between + [67584, 1048576] List of supported hugepage size in 'hugepageConfig'. @@ -900,6 +941,47 @@ FLAGS ◆ CGROUP_MODE_V2: Use cgroupv2 on the node pool. ◆ CGROUP_MODE_UNSPECIFIED: Use the default GKE cgroup configuration. + Supported values for 'transparentHugepageEnabled' under 'linuxConfig' + which controls transparent hugepage support for anonymous memory. + + ◆ TRANSPARENT_HUGEPAGE_ENABLED_ALWAYS: Transparent hugepage is + enabled system wide. + ◆ TRANSPARENT_HUGEPAGE_ENABLED_MADVISE: Transparent hugepage is + enabled inside MADV_HUGEPAGE regions. This is the default kernel + configuration. + ◆ TRANSPARENT_HUGEPAGE_ENABLED_NEVER: Transparent hugepage is + disabled. + ◆ TRANSPARENT_HUGEPAGE_ENABLED_UNSPECIFIED: Default value. GKE will + not modify the kernel configuration. + + Supported values for 'transparentHugepageDefrag' under 'linuxConfig' + which defines the transparent hugepage defrag configuration on the + node. + + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_ALWAYS: It means that an application + requesting THP will stall on allocation failure and directly reclaim + pages and compact memory in an effort to allocate a THP immediately. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_DEFER: It means that an application + will wake kswapd in the background to reclaim pages and wake + kcompactd to compact memory so that THP is available in the near + future. It is the responsibility of khugepaged to then install the + THP pages later. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_DEFER_WITH_MADVISE: It means that an + application will enter direct reclaim and compaction like always, but + only for regions that have used madvise(MADV_HUGEPAGE); all other + regions will wake kswapd in the background to reclaim pages and wake + kcompactd to compact memory so that THP is available in the near + future. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_MADVISE: It means that an application + will enter direct reclaim and compaction like always, but only for + regions that have used madvise(MADV_HUGEPAGE); all other regions will + wake kswapd in the background to reclaim pages and wake kcompactd to + compact memory so that THP is available in the near future. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_NEVER: It means that an application + will never enter direct reclaim or compaction. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_UNSPECIFIED: Default value. GKE will + not modify the kernel configuration. + Note, updating the system configuration of an existing node pool requires recreation of the nodes which which might cause a disruption. diff --git a/gcloud/alpha/container/node-pools/update b/gcloud/alpha/container/node-pools/update index e2c3a8699..439fa557a 100644 --- a/gcloud/alpha/container/node-pools/update +++ b/gcloud/alpha/container/node-pools/update @@ -344,6 +344,8 @@ REQUIRED FLAGS 'fs.mqueue.*', and 'net.*', and sysctls under the groups.) singleProcessOomKill true or false + maxParallelImagePulls integer (The value must be + between [2, 5].) KEY VALUE policy either 'Static' or @@ -387,6 +389,8 @@ REQUIRED FLAGS integer tuple net.ipv4.tcp_tw_reuse Must be {0, 1, 2} + net.ipv4.tcp_max_orphans Must be between + [16384, 262144] net.netfilter.nf_conntrack_max Must be between [65536, 4194304] net.netfilter.nf_conntrack_buckets Must be between @@ -414,9 +418,41 @@ REQUIRED FLAGS [0, 1844674407369277 4399] + fs.aio-max-nr Must be between + [65536, 4194304] + fs.file-max Must be between + [104857, + 67108864] + fs.inotify.max_user_instances Must be between + [8192, 1048576] + fs.inotify.max_user_watches Must be between + [8192, 1048576] + fs.nr_open Must be between + [1048576, + 2147483584] + vm.dirty_background_ratio Must be between + [1, 100] + vm.dirty_expire_centisecs Must be between + [0, 6000] + vm.dirty_ratio Must be between + [1, 100] + vm.dirty_writeback_centisecs Must be between + [0, 1000] vm.max_map_count Must be between [65536, 2147483647] + vm.overcommit_memory Must be one of + {0, 1, 2} + vm.overcommit_ratio Must be between + [0, 100] + vm.vfs_cache_pressure Must be between + [0, 100] + vm.swappiness Must be between + [0, 200] + vm.watermark_scale_factor Must be between + [10, 3000] + vm.min_free_kbytes Must be between + [67584, 1048576] List of supported hugepage size in 'hugepageConfig'. @@ -438,6 +474,49 @@ REQUIRED FLAGS ▸ CGROUP_MODE_UNSPECIFIED: Use the default GKE cgroup configuration. + Supported values for 'transparentHugepageEnabled' under 'linuxConfig' + which controls transparent hugepage support for anonymous memory. + + ▸ TRANSPARENT_HUGEPAGE_ENABLED_ALWAYS: Transparent hugepage is + enabled system wide. + ▸ TRANSPARENT_HUGEPAGE_ENABLED_MADVISE: Transparent hugepage is + enabled inside MADV_HUGEPAGE regions. This is the default kernel + configuration. + ▸ TRANSPARENT_HUGEPAGE_ENABLED_NEVER: Transparent hugepage is + disabled. + ▸ TRANSPARENT_HUGEPAGE_ENABLED_UNSPECIFIED: Default value. GKE will + not modify the kernel configuration. + + Supported values for 'transparentHugepageDefrag' under 'linuxConfig' + which defines the transparent hugepage defrag configuration on the + node. + + ▸ TRANSPARENT_HUGEPAGE_DEFRAG_ALWAYS: It means that an application + requesting THP will stall on allocation failure and directly + reclaim pages and compact memory in an effort to allocate a THP + immediately. + ▸ TRANSPARENT_HUGEPAGE_DEFRAG_DEFER: It means that an application + will wake kswapd in the background to reclaim pages and wake + kcompactd to compact memory so that THP is available in the near + future. It is the responsibility of khugepaged to then install the + THP pages later. + ▸ TRANSPARENT_HUGEPAGE_DEFRAG_DEFER_WITH_MADVISE: It means that an + application will enter direct reclaim and compaction like always, + but only for regions that have used madvise(MADV_HUGEPAGE); all + other regions will wake kswapd in the background to reclaim pages + and wake kcompactd to compact memory so that THP is available in + the near future. + ▸ TRANSPARENT_HUGEPAGE_DEFRAG_MADVISE: It means that an application + will enter direct reclaim and compaction like always, but only for + regions that have used madvise(MADV_HUGEPAGE); all other regions + will wake kswapd in the background to reclaim pages and wake + kcompactd to compact memory so that THP is available in the near + future. + ▸ TRANSPARENT_HUGEPAGE_DEFRAG_NEVER: It means that an application + will never enter direct reclaim or compaction. + ▸ TRANSPARENT_HUGEPAGE_DEFRAG_UNSPECIFIED: Default value. GKE will + not modify the kernel configuration. + Note, updating the system configuration of an existing node pool requires recreation of the nodes which which might cause a disruption. diff --git a/gcloud/alpha/container/vmware/admin-clusters/unenroll b/gcloud/alpha/container/vmware/admin-clusters/unenroll index d0a590ad7..b644afdb4 100644 --- a/gcloud/alpha/container/vmware/admin-clusters/unenroll +++ b/gcloud/alpha/container/vmware/admin-clusters/unenroll @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud alpha container vmware admin-clusters unenroll (ADMIN_CLUSTER : --location=LOCATION) [--allow-missing] [--async] - [--validate-only] [GCLOUD_WIDE_FLAG ...] + [--ignore-errors] [--validate-only] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Unenroll an Anthos on VMware admin cluster. @@ -59,6 +59,10 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --ignore-errors + If set, the unenrollment of a VMware admin cluster resource will + succeed even if errors occur during deletion. + --validate-only If set, only validate the request, but do not actually perform the operation. diff --git a/gcloud/alpha/developer-connect/connections/create b/gcloud/alpha/developer-connect/connections/create index 10f0bbae7..0ea3b4e7e 100644 --- a/gcloud/alpha/developer-connect/connections/create +++ b/gcloud/alpha/developer-connect/connections/create @@ -117,14 +117,20 @@ FLAGS --labels=path_to_file.(yaml|json) --location=LOCATION - For resources [connection, cryptoKey, service], provides fallback value + For resources [connection, + bitbucket-data-center-config-service-directory, + crypto-key-config-reference, + github-enterprise-config-service-directory, + gitlab-enterprise-config-service-directory], provides fallback value for resource location attribute. When the resource's full URI path is not provided, location will fallback to this flag value. --namespace=NAMESPACE - For resources [service], provides fallback value for resource namespace - attribute. When the resource's full URI path is not provided, namespace - will fallback to this flag value. + For resources [bitbucket-data-center-config-service-directory, + github-enterprise-config-service-directory, + gitlab-enterprise-config-service-directory], provides fallback value + for resource namespace attribute. When the resource's full URI path is + not provided, namespace will fallback to this flag value. --request-id=REQUEST_ID An optional request ID to identify requests. Specify a unique request @@ -142,9 +148,24 @@ FLAGS is not supported (00000000-0000-0000-0000-000000000000). --secret=SECRET - For resources [secretVersion], provides fallback value for resource - secret attribute. When the resource's full URI path is not provided, - secret will fallback to this flag value. + For resources + [bitbucket-cloud-config-authorizer-credential-user-token-secret-version, + bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version, + bitbucket-cloud-config-webhook-secret-version, + bitbucket-data-center-config-authorizer-credential-user-token-secret-version, + bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version, + bitbucket-data-center-config-webhook-secret-version, + github-config-authorizer-credential-oauth-token-secret-version, + github-enterprise-config-private-key-secret-version, + github-enterprise-config-webhook-secret-version, + gitlab-config-authorizer-credential-user-token-secret-version, + gitlab-config-read-authorizer-credential-user-token-secret-version, + gitlab-config-webhook-secret-version, + gitlab-enterprise-config-authorizer-credential-user-token-secret-version, + gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version, + gitlab-enterprise-config-webhook-secret-version], provides fallback + value for resource secret attribute. When the resource's full URI path + is not provided, secret will fallback to this flag value. --validate-only If set, validate the request, but do not actually post it. diff --git a/gcloud/alpha/developer-connect/connections/update b/gcloud/alpha/developer-connect/connections/update index 6254df47c..a03cd6050 100644 --- a/gcloud/alpha/developer-connect/connections/update +++ b/gcloud/alpha/developer-connect/connections/update @@ -81,14 +81,20 @@ FLAGS client has an up-to-date value before proceeding. --location=LOCATION - For resources [connection, cryptoKey, service], provides fallback value + For resources [connection, + bitbucket-data-center-config-service-directory, + crypto-key-config-reference, + github-enterprise-config-service-directory, + gitlab-enterprise-config-service-directory], provides fallback value for resource location attribute. When the resource's full URI path is not provided, location will fallback to this flag value. --namespace=NAMESPACE - For resources [service], provides fallback value for resource namespace - attribute. When the resource's full URI path is not provided, namespace - will fallback to this flag value. + For resources [bitbucket-data-center-config-service-directory, + github-enterprise-config-service-directory, + gitlab-enterprise-config-service-directory], provides fallback value + for resource namespace attribute. When the resource's full URI path is + not provided, namespace will fallback to this flag value. --request-id=REQUEST_ID An optional request ID to identify requests. Specify a unique request @@ -106,9 +112,21 @@ FLAGS is not supported (00000000-0000-0000-0000-000000000000). --secret=SECRET - For resources [secretVersion], provides fallback value for resource - secret attribute. When the resource's full URI path is not provided, - secret will fallback to this flag value. + For resources + [bitbucket-cloud-config-authorizer-credential-user-token-secret-version, + bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version, + bitbucket-data-center-config-authorizer-credential-user-token-secret-version, + bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version, + github-config-authorizer-credential-oauth-token-secret-version, + github-enterprise-config-private-key-secret-version, + github-enterprise-config-webhook-secret-version, + gitlab-config-authorizer-credential-user-token-secret-version, + gitlab-config-read-authorizer-credential-user-token-secret-version, + gitlab-enterprise-config-authorizer-credential-user-token-secret-version, + gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version], + provides fallback value for resource secret attribute. When the + resource's full URI path is not provided, secret will fallback to this + flag value. --[no-]validate-only If set, validate the request, but do not actually post it. Use diff --git a/gcloud/alpha/edge-cloud/container/vpn-connections/create b/gcloud/alpha/edge-cloud/container/vpn-connections/create index ccff78186..92b5b590f 100644 --- a/gcloud/alpha/edge-cloud/container/vpn-connections/create +++ b/gcloud/alpha/edge-cloud/container/vpn-connections/create @@ -98,7 +98,7 @@ OPTIONAL FLAGS numbers. --location=LOCATION - For resources [vpn connection, cluster], provides fallback value for + For resources [cluster, vpn_connection], provides fallback value for resource location attribute. When the resource's full URI path is not provided, location will fallback to this flag value. diff --git a/gcloud/alpha/firestore/databases/clone b/gcloud/alpha/firestore/databases/clone new file mode 100644 index 000000000..8c0b9550a --- /dev/null +++ b/gcloud/alpha/firestore/databases/clone @@ -0,0 +1,138 @@ +NAME + gcloud alpha firestore databases clone - clone a Google Cloud Firestore + database from another + +SYNOPSIS + gcloud alpha firestore databases clone + --destination-database=DESTINATION_DATABASE + --snapshot-time=SNAPSHOT_TIME --source-database=SOURCE_DATABASE + [--tags=[KEY=VALUE,...]] + [--encryption-type=ENCRYPTION_TYPE : --kms-key-name=KMS_KEY_NAME] + [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + To clone a database from another: + + $ gcloud alpha firestore databases clone \ + --source-database=projects/PROJECT_ID/databases/\ + SOURCE_DATABASE --snapshot-time=2025-05-26T10:20:00.00Z \ + --destination-database=DATABASE_ID + + To clone to a CMEK-enabled database: + + $ gcloud alpha firestore databases clone \ + --source-database=projects/PROJECT_ID/databases/\ + SOURCE_DATABASE --snapshot-time=2025-05-26T10:20:00.00Z \ + --destination-database=DATABASE_ID \ + --encryption-type=customer-managed-encryption \ + --kms-key-name=projects/PROJECT_ID/locations/LOCATION_ID/\ + keyRings/KEY_RING_ID/cryptoKeys/CRYPTO_KEY_ID + +REQUIRED FLAGS + --destination-database=DESTINATION_DATABASE + Destination database to clone to. Destination database will be created + in the same location as the source database. + + This value should be 4-63 characters. Valid characters are + /[a-z][0-9]-/ with first character a letter and the last a letter or a + number. Must not be UUID-like /[0-9a-f]8(-[0-9a-f]4)3-[0-9a-f]12/. + + Using "(default)" database ID is also allowed. + + For example, to clone to database testdb: + + $ gcloud alpha firestore databases clone \ + --destination-database=testdb + + --snapshot-time=SNAPSHOT_TIME + Snapshot time at which to clone. This must be a whole minute, in the + past, and not earlier than the source database's earliest_version_time. + Additionally, if older than one hour in the past, PITR must be enabled + on the source database. + + For example, to restore from snapshot 2025-05-26T10:20:00.00Z of source + database source-db: + + $ gcloud alpha firestore databases clone \ + --source-database=projects/PROJECT_ID/databases/source-db \ + --snapshot-time=2025-05-26T10:20:00.00Z + + --source-database=SOURCE_DATABASE + The source database to clone from. + + For example, to clone from database source-db: + + $ gcloud alpha firestore databases clone \ + --source-database=projects/PROJECT_ID/databases/source-db + +OPTIONAL FLAGS + --tags=[KEY=VALUE,...] + Tags to attach to the destination database. Example: + --tags=key1=value1,key2=value2 + + For example, to attach tags to a database: + + $ --tags=key1=value1,key2=value2 + + The encryption configuration of the new database being created from the + database. If not specified, the same encryption settings as the database + will be used. + + To create a CMEK-enabled database: + + $ gcloud alpha firestore databases clone \ + --encryption-type=customer-managed-encryption \ + --kms-key-name=projects/PROJECT_ID/locations/LOCATION_ID/\ + keyRings/KEY_RING_ID/cryptoKeys/CRYPTO_KEY_ID + + To create a Google-default-encrypted database: + + $ gcloud alpha firestore databases clone \ + --encryption-type=google-default-encryption + + To create a database using the same encryption settings as the database: + + $ gcloud alpha firestore databases clone \ + --encryption-type=use-source-encryption + + --encryption-type=ENCRYPTION_TYPE + The encryption type of the destination database. ENCRYPTION_TYPE must + be one of: use-source-encryption, customer-managed-encryption, + google-default-encryption. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --kms-key-name=KMS_KEY_NAME + The resource ID of a Cloud KMS key. If set, the database created will + be a Customer-Managed Encryption Key (CMEK) database encrypted with + this key. This feature is allowlist only in initial launch. + + Only a key in the same location as this database is allowed to be + used for encryption. For Firestore's nam5 multi-region, this + corresponds to Cloud KMS location us. For Firestore's eur3 + multi-region, this corresponds to Cloud KMS location europe. See + https://cloud.google.com/kms/docs/locations. + + This value should be the KMS key resource ID in the format of + projects/{project_id}/locations/{kms_location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}. + How to retrieve this resource ID is listed at + https://cloud.google.com/kms/docs/getting-resource-ids#getting_the_id_for_a_key_and_version. + + This flag must only be specified when encryption-type is + customer-managed-encryption. + +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/firestore/databases/create b/gcloud/alpha/firestore/databases/create index 363827d59..430a44171 100644 --- a/gcloud/alpha/firestore/databases/create +++ b/gcloud/alpha/firestore/databases/create @@ -112,9 +112,12 @@ OPTIONAL FLAGS https://cloud.google.com/kms/docs/getting-resource-ids#getting_the_id_for_a_key_and_version. --tags=[KEY=VALUE,...] - Tags to attach to the database + Tags to attach to the destination database. Example: + --tags=key1=value1,key2=value2 - Example: --tags=key1=value1,key2=value2 + For example, to attach tags to a database: + + $ --tags=key1=value1,key2=value2 --type=TYPE; default="firestore-native" The type of the database. TYPE must be one of: firestore-native, diff --git a/gcloud/alpha/firestore/databases/help b/gcloud/alpha/firestore/databases/help index 6a8e0c889..be64f0b4f 100644 --- a/gcloud/alpha/firestore/databases/help +++ b/gcloud/alpha/firestore/databases/help @@ -16,6 +16,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + clone + (ALPHA) Clone a Google Cloud Firestore database from another. + connection-string (ALPHA) Prints the mongo connection string for the given Firestore database. diff --git a/gcloud/alpha/firestore/databases/restore b/gcloud/alpha/firestore/databases/restore index cdfa4a287..9234f9e51 100644 --- a/gcloud/alpha/firestore/databases/restore +++ b/gcloud/alpha/firestore/databases/restore @@ -39,8 +39,7 @@ REQUIRED FLAGS This value should be 4-63 characters. Valid characters are /[a-z][0-9]-/ with first character a letter and the last a letter or a - number. Must not be UUID-like - /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. + number. Must not be UUID-like /[0-9a-f]8(-[0-9a-f]4)3-[0-9a-f]12/. Using "(default)" database ID is also allowed. @@ -61,9 +60,12 @@ REQUIRED FLAGS OPTIONAL FLAGS --tags=[KEY=VALUE,...] - Tags to attach to the database. + Tags to attach to the destination database. Example: + --tags=key1=value1,key2=value2 - Example: --tags=key1=value1,key2=value2 + For example, to attach tags to a database: + + $ --tags=key1=value1,key2=value2 The encryption configuration of the new database being created from the backup. If not specified, the same encryption settings as the backup will diff --git a/gcloud/alpha/iam/workforce-pools/providers/create-oidc b/gcloud/alpha/iam/workforce-pools/providers/create-oidc index 2076cdbc7..5bb175507 100644 --- a/gcloud/alpha/iam/workforce-pools/providers/create-oidc +++ b/gcloud/alpha/iam/workforce-pools/providers/create-oidc @@ -31,7 +31,7 @@ EXAMPLES --workforce-pool="my-workforce-pool" --location="global" \ --display-name="My Workforce Pool Provider" \ --description="My workforce pool provider description." \ - --disabled --detailed_audit_logging \ + --disabled --detailed-audit-logging \ --attribute-mapping="google.subject=assertion.sub" \ --attribute-condition="true" --client-id="client-id" \ --client-secret-value="client-secret" \ diff --git a/gcloud/alpha/iam/workforce-pools/providers/update-oidc b/gcloud/alpha/iam/workforce-pools/providers/update-oidc index af7e709ce..29dc897d9 100644 --- a/gcloud/alpha/iam/workforce-pools/providers/update-oidc +++ b/gcloud/alpha/iam/workforce-pools/providers/update-oidc @@ -32,7 +32,7 @@ EXAMPLES --workforce-pool="my-workforce-pool" --location="global" \ --display-name="My Workforce Pool Provider" \ --description="My workforce pool provider description." \ - --disabled --detailed_audit_logging \ + --disabled --detailed-audit-logging \ --attribute-mapping="google.subject=assertion.sub" \ --attribute-condition="true" --client-id="client-id" \ --client-secret-value="client-secret" \ diff --git a/gcloud/alpha/iap/help b/gcloud/alpha/iap/help index 7b211d823..6f5a315ae 100644 --- a/gcloud/alpha/iap/help +++ b/gcloud/alpha/iap/help @@ -23,10 +23,10 @@ GROUPS GROUP is one of the following: oauth-brands - (ALPHA) Manage IAP OAuth brands. + (ALPHA) (DEPRECATED) Manage IAP OAuth brands. oauth-clients - (ALPHA) Manage IAP OAuth clients. + (ALPHA) (DEPRECATED) Manage IAP OAuth clients. settings (ALPHA) Manage IAP settings. diff --git a/gcloud/alpha/iap/oauth-brands/create b/gcloud/alpha/iap/oauth-brands/create index bde09317a..07d6413f3 100644 --- a/gcloud/alpha/iap/oauth-brands/create +++ b/gcloud/alpha/iap/oauth-brands/create @@ -7,11 +7,13 @@ SYNOPSIS --support_email=SUPPORT_EMAIL [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) gcloud alpha iap oauth-brands create is used to create a Cloud - OAuth brand for the project. The brand is 'internal only', meaning OAuth - clients created under it only accept requests from users who belong to the - same G Suite account as the project. The brand is created in unreviewed - status. Your domain will not appear on the OAuth consent screen until it is + (ALPHA) (DEPRECATED) This command is deprecated. + + gcloud alpha iap oauth-brands create is used to create a Cloud OAuth brand + for the project. The brand is 'internal only', meaning OAuth clients + created under it only accept requests from users who belong to the same G + Suite account as the project. The brand is created in unreviewed status. + Your domain will not appear on the OAuth consent screen until it is reviewed after you manually start a review process in Google Cloud Platform Console. Note that the 'internal only' setting can be manually changed in Google Cloud Platform Console diff --git a/gcloud/alpha/iap/oauth-brands/describe b/gcloud/alpha/iap/oauth-brands/describe index fac7aff1d..f911a4721 100644 --- a/gcloud/alpha/iap/oauth-brands/describe +++ b/gcloud/alpha/iap/oauth-brands/describe @@ -5,8 +5,10 @@ SYNOPSIS gcloud alpha iap oauth-brands describe NAME [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) gcloud alpha iap oauth-brands describe is used to describe a Cloud - OAuth brand. + (ALPHA) (DEPRECATED) This command is deprecated. + + gcloud alpha iap oauth-brands describe is used to describe a Cloud OAuth + brand. EXAMPLES To describe a Cloud OAuth brand with name NAME, run: diff --git a/gcloud/alpha/iap/oauth-brands/help b/gcloud/alpha/iap/oauth-brands/help index 74410fdae..307beb254 100644 --- a/gcloud/alpha/iap/oauth-brands/help +++ b/gcloud/alpha/iap/oauth-brands/help @@ -5,7 +5,9 @@ SYNOPSIS gcloud alpha iap oauth-brands COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage IAP OAuth brands. + (ALPHA) (DEPRECATED) Manage IAP OAuth brands. + + This command is deprecated. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -16,13 +18,13 @@ COMMANDS COMMAND is one of the following: create - (ALPHA) Create a Cloud OAuth brand for the project. + (ALPHA) (DEPRECATED) Create a Cloud OAuth brand for the project. describe - (ALPHA) Describe a Cloud OAuth brand. + (ALPHA) (DEPRECATED) Describe a Cloud OAuth brand. list - (ALPHA) List Cloud OAuth brands in the project. + (ALPHA) (DEPRECATED) List Cloud OAuth brands in the project. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/iap/oauth-brands/list b/gcloud/alpha/iap/oauth-brands/list index dcef8ba48..bf7fdc338 100644 --- a/gcloud/alpha/iap/oauth-brands/list +++ b/gcloud/alpha/iap/oauth-brands/list @@ -6,8 +6,10 @@ SYNOPSIS [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) gcloud alpha iap oauth-brands list is used to list the Cloud OAuth - brand in the project. + (ALPHA) (DEPRECATED) This command is deprecated. + + gcloud alpha iap oauth-brands list is used to list the Cloud OAuth brand in + the project. EXAMPLES To list all Cloud OAuth brands in the current project, run: diff --git a/gcloud/alpha/iap/oauth-clients/create b/gcloud/alpha/iap/oauth-clients/create index 316dbfe63..64b8861e9 100644 --- a/gcloud/alpha/iap/oauth-clients/create +++ b/gcloud/alpha/iap/oauth-clients/create @@ -7,10 +7,12 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) gcloud alpha iap oauth-clients create is used to create an OAuth - client in the project to be used by Cloud IAP. To call this command, the - Cloud OAuth brand for the project must exist and be set for 'internal - only'. The new client is owned by Cloud IAP. + (ALPHA) (DEPRECATED) This command is deprecated. + + gcloud alpha iap oauth-clients create is used to create an OAuth client in + the project to be used by Cloud IAP. To call this command, the Cloud OAuth + brand for the project must exist and be set for 'internal only'. The new + client is owned by Cloud IAP. EXAMPLES To create a Cloud IAP OAuth client for the current project, run: diff --git a/gcloud/alpha/iap/oauth-clients/delete b/gcloud/alpha/iap/oauth-clients/delete index 26d6ceb4d..93fe0b781 100644 --- a/gcloud/alpha/iap/oauth-clients/delete +++ b/gcloud/alpha/iap/oauth-clients/delete @@ -6,9 +6,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) gcloud alpha iap oauth-clients delete is used to delete a Cloud IAP - OAuth client. Note this command cannot be used to delete any other type of - OAuth client in your project. + (ALPHA) (DEPRECATED) This command is deprecated. + + gcloud alpha iap oauth-clients delete is used to delete a Cloud IAP OAuth + client. Note this command cannot be used to delete any other type of OAuth + client in your project. EXAMPLES To delete a Cloud IAP OAuth client named CLIENT for the current project and diff --git a/gcloud/alpha/iap/oauth-clients/describe b/gcloud/alpha/iap/oauth-clients/describe index 960df1b6c..cd68394f1 100644 --- a/gcloud/alpha/iap/oauth-clients/describe +++ b/gcloud/alpha/iap/oauth-clients/describe @@ -6,9 +6,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) gcloud alpha iap oauth-clients describe is used to describe a Cloud - IAP OAuth client. Note this command cannot be used to describe any other - type of OAuth client in your project. + (ALPHA) (DEPRECATED) This command is deprecated. + + gcloud alpha iap oauth-clients describe is used to describe a Cloud IAP + OAuth client. Note this command cannot be used to describe any other type + of OAuth client in your project. EXAMPLES To describe a Cloud IAP OAuth client for the current project, run: diff --git a/gcloud/alpha/iap/oauth-clients/help b/gcloud/alpha/iap/oauth-clients/help index 15082d35e..7fffa973a 100644 --- a/gcloud/alpha/iap/oauth-clients/help +++ b/gcloud/alpha/iap/oauth-clients/help @@ -5,9 +5,13 @@ SYNOPSIS gcloud alpha iap oauth-clients COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage OAuth clients that are used by Cloud Identity-Aware Proxy. - Note this API cannot be used as a generic management API for all OAuth - clients in your project. + (ALPHA) (DEPRECATED) Manage IAP OAuth clients. + + This command is deprecated. + + Manage OAuth clients that are used by Cloud Identity-Aware Proxy. Note this + API cannot be used as a generic management API for all OAuth clients in + your project. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,19 +22,20 @@ COMMANDS COMMAND is one of the following: create - (ALPHA) Create a Cloud IAP OAuth client in the project. + (ALPHA) (DEPRECATED) Create a Cloud IAP OAuth client in the project. delete - (ALPHA) Delete a Cloud IAP OAuth client. + (ALPHA) (DEPRECATED) Delete a Cloud IAP OAuth client. describe - (ALPHA) Describe a Cloud IAP OAuth client. + (ALPHA) (DEPRECATED) Describe a Cloud IAP OAuth client. list - (ALPHA) List Cloud IAP OAuth clients in the Cloud OAuth brand. + (ALPHA) (DEPRECATED) List Cloud IAP OAuth clients in the Cloud OAuth + brand. reset-secret - (ALPHA) Reset a Cloud IAP OAuth client secret. + (ALPHA) (DEPRECATED) Reset a Cloud IAP OAuth client secret. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/iap/oauth-clients/list b/gcloud/alpha/iap/oauth-clients/list index 11f6328ac..809861bef 100644 --- a/gcloud/alpha/iap/oauth-clients/list +++ b/gcloud/alpha/iap/oauth-clients/list @@ -8,9 +8,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) gcloud alpha iap oauth-clients list is used to list Cloud IAP OAuth - clients in a Cloud OAuth brand. Note this command will not list any other - type of OAuth client in your project. + (ALPHA) (DEPRECATED) This command is deprecated. + + gcloud alpha iap oauth-clients list is used to list Cloud IAP OAuth clients + in a Cloud OAuth brand. Note this command will not list any other type of + OAuth client in your project. EXAMPLES To list the Cloud IAP OAuth clients for the current project, run: diff --git a/gcloud/alpha/iap/oauth-clients/reset-secret b/gcloud/alpha/iap/oauth-clients/reset-secret index d8fd6f526..4a97dc7be 100644 --- a/gcloud/alpha/iap/oauth-clients/reset-secret +++ b/gcloud/alpha/iap/oauth-clients/reset-secret @@ -7,9 +7,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) gcloud alpha iap oauth-clients reset-secret is used to reset a - Cloud IAP OAuth client secret. Note this command cannot be used to reset - the secret for any other type of OAuth client in your project. + (ALPHA) (DEPRECATED) This command is deprecated. + + gcloud alpha iap oauth-clients reset-secret is used to reset a Cloud IAP + OAuth client secret. Note this command cannot be used to reset the secret + for any other type of OAuth client in your project. EXAMPLES To reset a Cloud IAP OAuth client secret, run: diff --git a/gcloud/alpha/looker/instances/create b/gcloud/alpha/looker/instances/create index e2ee6eee3..116887683 100644 --- a/gcloud/alpha/looker/instances/create +++ b/gcloud/alpha/looker/instances/create @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud alpha looker instances create (INSTANCE : --region=REGION) --edition=EDITION --oauth-client-id=OAUTH_CLIENT_ID - --oauth-client-secret=OAUTH_CLIENT_SECRET [--async] [--fips-enabled] - [--kms-key=KMS_KEY] [--no-public-ip-enabled] + --oauth-client-secret=OAUTH_CLIENT_SECRET [--async] + [--class-type=CLASS_TYPE] [--fips-enabled] [--kms-key=KMS_KEY] + [--no-public-ip-enabled] [--consumer-network=CONSUMER_NETWORK --private-ip-enabled : --reserved-range=RESERVED_RANGE] [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE @@ -143,6 +144,10 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --class-type=CLASS_TYPE + The class type of the Looker instance. CLASS_TYPE must be one of: p1, + r1. + --fips-enabled This specifies whether FIPS is enabled on the Looker instance. diff --git a/gcloud/alpha/looker/instances/update b/gcloud/alpha/looker/instances/update index abd63b1f8..1cf0f693c 100644 --- a/gcloud/alpha/looker/instances/update +++ b/gcloud/alpha/looker/instances/update @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha looker instances update (INSTANCE : --region=REGION) [--allowed-email-domains=[ALLOWED_EMAIL_DOMAINS,...]] [--async] - [--custom-domain=CUSTOM_DOMAIN] + [--class-type=CLASS_TYPE] [--custom-domain=CUSTOM_DOMAIN] [--linked-lsp-project-number=LINKED_LSP_PROJECT_NUMBER] [--public-ip-enabled] [--add-developer-users=ADD_DEVELOPER_USERS @@ -12,7 +12,8 @@ SYNOPSIS --add-viewer-users=ADD_VIEWER_USERS] [--clear-psc-allowed-vpcs | --psc-allowed-vpcs=[PSC_ALLOWED_VPCS,...] --clear-psc-service-attachments - | --psc-service-attachment=[attachment=ATTACHMENT],[domain=DOMAIN]] + | --psc-service-attachment=[attachment=ATTACHMENT], + [domain=DOMAIN],[multiple-domains=MULTIPLE-DOMAINS]] [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE --deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE --deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--gemini-enabled @@ -83,6 +84,10 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --class-type=CLASS_TYPE + The class type of the Looker instance. CLASS_TYPE must be one of: p1, + r1. + Custom Domains - Looker (Google Cloud core) lets you serve your application through a custom domain. If you use a custom domain, Google will provide a managed auto-renewing SSL certificate for security. @@ -138,13 +143,17 @@ FLAGS --clear-psc-service-attachments Remove all allowed VPCs from the PSC config of the instance. - --psc-service-attachment=[attachment=ATTACHMENT],[domain=DOMAIN] + --psc-service-attachment=[attachment=ATTACHMENT],[domain=DOMAIN],[multiple-domains=MULTIPLE-DOMAINS] Service attachments representing egress connections for the Looker instance. This flag can be repeated. (Example: --psc-service-attachment domain="mydomain.com",attachment="projects/my-project/regions/us-east1/serviceAttachments/sa" --psc-service-attachments - domain="mydomain.com",attachment="projects/my-project/regions/us-east1/serviceAttachments/sa") + domain="mydomain2.com",attachment="projects/my-project/regions/us-east1/serviceAttachments/sa2") + + You can also assign multiple domains to a single service + attachment. (Example: --psc-service-attachment + multiple-domains="mydomain.com;mydomain2.com",attachment="projects/my-project/regions/us-east1/serviceAttachments/sa") Deny Maintanence Period - You must allow at least 48 hours of maintenance availability in a 60-day rolling window. Only contiguous availability diff --git a/gcloud/alpha/managed-kafka/schema-registries/subject/update b/gcloud/alpha/managed-kafka/schema-registries/subject/update index a276118ae..9637a89f8 100644 --- a/gcloud/alpha/managed-kafka/schema-registries/subject/update +++ b/gcloud/alpha/managed-kafka/schema-registries/subject/update @@ -5,8 +5,8 @@ NAME SYNOPSIS gcloud alpha managed-kafka schema-registries subject update (SUBJECT : --location=LOCATION --schema-registry=SCHEMA_REGISTRY) - (--compatibility=COMPATIBILITY | --mode=MODE) [--context=CONTEXT] - [GCLOUD_WIDE_FLAG ...] + (--compatibility=COMPATIBILITY | --delete-config | --delete-mode + | --mode=MODE) [--context=CONTEXT] [GCLOUD_WIDE_FLAG ...] EXAMPLES Modify the mode of the subject to READONLY: @@ -66,6 +66,12 @@ REQUIRED FLAGS --compatibility=COMPATIBILITY The compatibility of the subject to update. + --delete-config + Delete the config of the subject. + + --delete-mode + Delete the mode of the subject. + --mode=MODE The mode of the subject to update. diff --git a/gcloud/alpha/memorystore/instances/create b/gcloud/alpha/memorystore/instances/create index 26b193228..16062b607 100644 --- a/gcloud/alpha/memorystore/instances/create +++ b/gcloud/alpha/memorystore/instances/create @@ -14,6 +14,7 @@ SYNOPSIS [--psc-auto-connections=[network=NETWORK], [port=PORT],[projectId=PROJECTID]] [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] + [--simulate-maintenance-event] [--transit-encryption-mode=TRANSIT_ENCRYPTION_MODE] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC --persistence-config-mode=PERSISTENCE_CONFIG_MODE @@ -191,9 +192,9 @@ FLAGS --labels=path_to_file.(yaml|json) --location=LOCATION - For resources [instance, cryptoKey], provides fallback value for - resource location attribute. When the resource's full URI path is not - provided, location will fallback to this flag value. + For resources [instance, kms-key, primary-instance], provides fallback + value for resource location attribute. When the resource's full URI + path is not provided, location will fallback to this flag value. Maintenance policy per instance. @@ -319,6 +320,11 @@ FLAGS --shard-count=SHARD_COUNT Number of shards for the instance. + Arguments for the simulate maintenance event. + + --simulate-maintenance-event + Simulate a maintenance event. + --transit-encryption-mode=TRANSIT_ENCRYPTION_MODE In-transit encryption mode of the instance. TRANSIT_ENCRYPTION_MODE must be one of: diff --git a/gcloud/alpha/memorystore/instances/update b/gcloud/alpha/memorystore/instances/update index 194f1e4e2..af72a5062 100644 --- a/gcloud/alpha/memorystore/instances/update +++ b/gcloud/alpha/memorystore/instances/update @@ -9,6 +9,7 @@ SYNOPSIS [--location=LOCATION] [--mode=MODE] [--node-type=NODE_TYPE] [--[no-]ondemand-maintenance] [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] + [--[no-]simulate-maintenance-event] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC --clear-persistence-config --persistence-config-mode=PERSISTENCE_CONFIG_MODE @@ -106,9 +107,9 @@ FLAGS Engine version of the instance. --location=LOCATION - For resources [instance, cryptoKey], provides fallback value for - resource location attribute. When the resource's full URI path is not - provided, location will fallback to this flag value. + For resources [instance, kms-key, primary-instance], provides fallback + value for resource location attribute. When the resource's full URI + path is not provided, location will fallback to this flag value. --mode=MODE The mode config for the instance. MODE must be one of: @@ -163,6 +164,12 @@ FLAGS --shard-count=SHARD_COUNT Number of shards for the instance. + Arguments for the simulate maintenance event. + + --[no-]simulate-maintenance-event + Simulate a maintenance event. Use --simulate-maintenance-event to + enable and --no-simulate-maintenance-event to disable. + Represents persistence configuration for a instance. Configuration for AOF based persistence. diff --git a/gcloud/alpha/model-armor/floorsettings/describe b/gcloud/alpha/model-armor/floorsettings/describe index 315bdf0e3..f17f28089 100644 --- a/gcloud/alpha/model-armor/floorsettings/describe +++ b/gcloud/alpha/model-armor/floorsettings/describe @@ -25,7 +25,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 model-armor floorsettings describe + $ gcloud beta model-armor floorsettings describe + diff --git a/gcloud/alpha/model-armor/floorsettings/help b/gcloud/alpha/model-armor/floorsettings/help index df7d6e393..b06e302c4 100644 --- a/gcloud/alpha/model-armor/floorsettings/help +++ b/gcloud/alpha/model-armor/floorsettings/help @@ -25,7 +25,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 model-armor floorsettings + $ gcloud beta model-armor floorsettings + diff --git a/gcloud/alpha/model-armor/floorsettings/update b/gcloud/alpha/model-armor/floorsettings/update index 3b5380c53..d1e0ef032 100644 --- a/gcloud/alpha/model-armor/floorsettings/update +++ b/gcloud/alpha/model-armor/floorsettings/update @@ -121,7 +121,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 model-armor floorsettings update + $ gcloud beta model-armor floorsettings update + diff --git a/gcloud/alpha/netapp/volumes/create b/gcloud/alpha/netapp/volumes/create index 9da54b4d1..6be181f93 100644 --- a/gcloud/alpha/netapp/volumes/create +++ b/gcloud/alpha/netapp/volumes/create @@ -31,7 +31,7 @@ SYNOPSIS [--snap-reserve=SNAP_RESERVE] [--snapshot-daily=[hour=HOUR], [minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] - [--snapshot-directory=SNAPSHOT_DIRECTORY; default="true"] + [--snapshot-directory=SNAPSHOT_DIRECTORY] [--snapshot-hourly=[minute=MINUTE], [snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--snapshot-monthly=[day=DAY], @@ -231,7 +231,7 @@ OPTIONAL FLAGS --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] Make a snapshot every day e.g. at 06:00, 05:20, 23:50 - --snapshot-directory=SNAPSHOT_DIRECTORY; default="true" + --snapshot-directory=SNAPSHOT_DIRECTORY Snapshot Directory if enabled (true) makes the Volume contain a read-only .snapshot directory which provides access to each of the volume's snapshots diff --git a/gcloud/alpha/netapp/volumes/restore-backup-files b/gcloud/alpha/netapp/volumes/restore-backup-files index 302e121c4..3e2d243e2 100644 --- a/gcloud/alpha/netapp/volumes/restore-backup-files +++ b/gcloud/alpha/netapp/volumes/restore-backup-files @@ -115,5 +115,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta netapp volumes restore-backup-files diff --git a/gcloud/alpha/netapp/volumes/update b/gcloud/alpha/netapp/volumes/update index fe1893287..fb0b32619 100644 --- a/gcloud/alpha/netapp/volumes/update +++ b/gcloud/alpha/netapp/volumes/update @@ -21,7 +21,7 @@ SYNOPSIS [--snap-reserve=SNAP_RESERVE] [--snapshot-daily=[hour=HOUR], [minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] - [--snapshot-directory=SNAPSHOT_DIRECTORY; default="true"] + [--snapshot-directory=SNAPSHOT_DIRECTORY] [--snapshot-hourly=[minute=MINUTE], [snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--snapshot-monthly=[day=DAY], @@ -140,7 +140,7 @@ FLAGS --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] Make a snapshot every day e.g. at 06:00, 05:20, 23:50 - --snapshot-directory=SNAPSHOT_DIRECTORY; default="true" + --snapshot-directory=SNAPSHOT_DIRECTORY Snapshot Directory if enabled (true) makes the Volume contain a read-only .snapshot directory which provides access to each of the volume's snapshots diff --git a/gcloud/alpha/network-connectivity/internal-ranges/create b/gcloud/alpha/network-connectivity/internal-ranges/create index b64927ae6..f9cbbfee6 100644 --- a/gcloud/alpha/network-connectivity/internal-ranges/create +++ b/gcloud/alpha/network-connectivity/internal-ranges/create @@ -6,9 +6,9 @@ SYNOPSIS gcloud alpha network-connectivity internal-ranges create (INTERNAL_RANGE : --region=REGION) --network=NETWORK (--ip-cidr-range=IP_CIDR_RANGE | [--prefix-length=PREFIX_LENGTH - : --allocation_strategy=ALLOCATION_STRATEGY + : --allocation-strategy=ALLOCATION_STRATEGY --exclude-cidr-ranges=[EXCLUDE_CIDR_RANGES,...] - --first_available_ranges_lookup_size=FIRST_AVAILABLE_RANGES_LOOKUP_SIZE --target-cidr-range=[TARGET_CIDR_RANGE, + --first-available-ranges-lookup-size=FIRST_AVAILABLE_RANGES_LOOKUP_SIZE --target-cidr-range=[TARGET_CIDR_RANGE, ...]]) [--async] [--description=DESCRIPTION] [--immutable] [--labels=[KEY=VALUE,...]] [--overlaps=[OVERLAPS,...]] [--peering=PEERING; default="for-self"] @@ -95,7 +95,7 @@ REQUIRED FLAGS Additional options for the internal range's address auto-allocation (allowed only when prefix-length is set): - --allocation_strategy=ALLOCATION_STRATEGY + --allocation-strategy=ALLOCATION_STRATEGY Allocation strategy to be used when searching for a free range. ALLOCATION_STRATEGY must be one of: @@ -128,10 +128,10 @@ REQUIRED FLAGS This can be used to exclude specific ranges that are already intended to have some other use. - --first_available_ranges_lookup_size=FIRST_AVAILABLE_RANGES_LOOKUP_SIZE + --first-available-ranges-lookup-size=FIRST_AVAILABLE_RANGES_LOOKUP_SIZE The number of ranges to be considered when using the RANDOM_FIRST_N_AVAILABLE allocation strategy. This is only allowed - when allocation_strategy is set to RANDOM_FIRST_N_AVAILABLE. + when allocation-strategy is set to RANDOM_FIRST_N_AVAILABLE. --target-cidr-range=[TARGET_CIDR_RANGE,...] Can be set to narrow down or pick a different address space while diff --git a/gcloud/alpha/recaptcha/keys/create b/gcloud/alpha/recaptcha/keys/create index d8236e90d..0c5ff6c93 100644 --- a/gcloud/alpha/recaptcha/keys/create +++ b/gcloud/alpha/recaptcha/keys/create @@ -11,8 +11,10 @@ SYNOPSIS | [--web (--allow-all-domains | --domains=[DOMAINS,...]) : --allow-amp-traffic --integration-type=INTEGRATION_TYPE --security-preference=SECURITY_PREFERENCE - --testing-challenge=TESTING_CHALLENGE]) [--labels=[KEY=VALUE,...]] - [--testing-score=TESTING_SCORE] + --testing-challenge=TESTING_CHALLENGE + [--default-score-threshold=DEFAULT_SCORE_THRESHOLD + : --action-score-thresholds=[ACTION_SCORE_THRESHOLDS,...]]]) + [--labels=[KEY=VALUE,...]] [--testing-score=TESTING_SCORE] [--waf-service=WAF_SERVICE : --waf-feature=WAF_FEATURE] [GCLOUD_WIDE_FLAG ...] @@ -132,14 +134,12 @@ REQUIRED FLAGS Does not display the "I'm not a robot" checkbox, but may show CAPTCHA challenges after risk analysis + policy-based-challenge + Conditionally displays a challenge based on the score + score Shows no CAPTCHA challenge on the page - score-and-challenge - Conditionally displays a challenge based on the score. This is - in private preview. If you want to onboard, contact your Google - Cloud sales representative. - --security-preference=SECURITY_PREFERENCE Represents the possible challenge frequency and difficulty configurations for a web key. usability: show fewer and easier @@ -174,6 +174,42 @@ REQUIRED FLAGS Examples of valid domains: 'example.com' 'subdomain.example.com' + Configure if you want to use the POLICY_BASED_CHALLENGE option. + + --default-score-threshold=DEFAULT_SCORE_THRESHOLD + The global threshold to be used for POLICY_BASED_CHALLENGE if no + action specific one exists. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --action-score-thresholds=[ACTION_SCORE_THRESHOLDS,...] + The action to score threshold used for POLICY_BASED_CHALLENGE. + For example: --action-score-thresholds=login='{"scoreThreshold": + "0.3"}',signup='{"scoreThreshold": "0.1"}' or + --action-score-thresholds=file_path.(json|yaml). + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + scoreThreshold + Sets scoreThreshold value. + + Shorthand Example: + + --action-score-thresholds=string={scoreThreshold=float} + + JSON Example: + + --action-score-thresholds='{"string": {"scoreThreshold": float}}' + + File Example: + + --action-score-thresholds=path_to_file.(yaml|json) + OPTIONAL FLAGS --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/alpha/recaptcha/keys/update b/gcloud/alpha/recaptcha/keys/update index 50e4fa9a8..c97364e98 100644 --- a/gcloud/alpha/recaptcha/keys/update +++ b/gcloud/alpha/recaptcha/keys/update @@ -9,7 +9,9 @@ SYNOPSIS | [--ios : --allow-all-bundle-ids | --bundle-ids=[BUNDLE_IDS,...] --key-id=KEY_ID --private-key-file=PATH_TO_FILE --team-id=TEAM_ID] | [--web : --allow-amp-traffic - --security-preference=SECURITY_PREFERENCE --allow-all-domains + --security-preference=SECURITY_PREFERENCE + --action-score-thresholds=[ACTION_SCORE_THRESHOLDS,...] + --default-score-threshold=DEFAULT_SCORE_THRESHOLD --allow-all-domains | --domains=[DOMAINS,...]]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -138,6 +140,39 @@ FLAGS SECURITY_PREFERENCE must be one of: balance, challenge-security-preference-unspecified, security, usability. + Configure if you want to use the POLICY_BASED_CHALLENGE option. + + --action-score-thresholds=[ACTION_SCORE_THRESHOLDS,...] + The action to score threshold used for POLICY_BASED_CHALLENGE. + For example: --action-score-thresholds=login='{"scoreThreshold": + "0.3"}',signup='{"scoreThreshold": "0.1"}' or + --action-score-thresholds=file_path.(json|yaml). + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + scoreThreshold + Sets scoreThreshold value. + + Shorthand Example: + + --action-score-thresholds=string={scoreThreshold=float} + + JSON Example: + + --action-score-thresholds='{"string": {"scoreThreshold": float}}' + + File Example: + + --action-score-thresholds=path_to_file.(yaml|json) + + --default-score-threshold=DEFAULT_SCORE_THRESHOLD + The global threshold to be used for POLICY_BASED_CHALLENGE if no + action specific one exists. + At most one of these can be specified: --allow-all-domains diff --git a/gcloud/alpha/redis/clusters/update b/gcloud/alpha/redis/clusters/update index 2300104b8..5d3e46ae3 100644 --- a/gcloud/alpha/redis/clusters/update +++ b/gcloud/alpha/redis/clusters/update @@ -8,12 +8,12 @@ SYNOPSIS [--automated-backup-mode=AUTOMATED_BACKUP_MODE] [--automated-backup-start-time=AUTOMATED_BACKUP_START_TIME] [--automated-backup-ttl=AUTOMATED_BACKUP_TTL] [--deletion-protection] - [--node-type=NODE_TYPE] [--ondemand-maintenance] - [--persistence-mode=PERSISTENCE_MODE] + [--node-type=NODE_TYPE] [--persistence-mode=PERSISTENCE_MODE] [--rdb-snapshot-period=RDB_SNAPSHOT_PERIOD] [--rdb-snapshot-start-time=RDB_SNAPSHOT_START_TIME] [--remove-redis-config=[KEY,...]] [--replica-count=REPLICA_COUNT] - [--shard-count=SHARD_COUNT] [--update-redis-config=KEY=VALUE] + [--shard-count=SHARD_COUNT] [--simulate-maintenance-event] + [--update-redis-config=KEY=VALUE] [--maintenance-window-any | --maintenance-window-day=MAINTENANCE_WINDOW_DAY --maintenance-window-hour=MAINTENANCE_WINDOW_HOUR] @@ -112,9 +112,6 @@ FLAGS redis-highmem-medium, redis-highmem-xlarge, redis-shared-core-nano, redis-standard-small. - --ondemand-maintenance - Trigger an on-demand maintenance. - --persistence-mode=PERSISTENCE_MODE Operation mode for persistence. PERSISTENCE_MODE must be one of: @@ -153,6 +150,9 @@ FLAGS --shard-count=SHARD_COUNT The shard count of the cluster. + --simulate-maintenance-event + Trigger a simulation for maintenance event. + --update-redis-config=KEY=VALUE A list of Redis Cluster config KEY=VALUE pairs to update. If a config parameter is already set, its value is modified; otherwise a new Redis diff --git a/gcloud/alpha/run/jobs/create b/gcloud/alpha/run/jobs/create index 56434f664..9b035db11 100644 --- a/gcloud/alpha/run/jobs/create +++ b/gcloud/alpha/run/jobs/create @@ -4,9 +4,10 @@ NAME SYNOPSIS gcloud alpha run jobs create [JOB] [--binary-authorization=POLICY] [--breakglass=JUSTIFICATION] [--container=CONTAINER] - [--gpu-type=GPU_TYPE] [--key=KEY] [--labels=[KEY=VALUE,...]] - [--max-retries=MAX_RETRIES] [--parallelism=PARALLELISM] - [--region=REGION] [--service-account=SERVICE_ACCOUNT] + [--gpu-type=GPU_TYPE] [--[no-]gpu-zonal-redundancy] [--key=KEY] + [--labels=[KEY=VALUE,...]] [--max-retries=MAX_RETRIES] + [--parallelism=PARALLELISM] [--region=REGION] + [--service-account=SERVICE_ACCOUNT] [--set-cloudsql-instances=[CLOUDSQL-INSTANCES,...]] [--task-timeout=TASK_TIMEOUT] [--tasks=TASKS; default=1] [--vpc-connector=VPC_CONNECTOR] [--vpc-egress=VPC_EGRESS] @@ -83,6 +84,10 @@ FLAGS --gpu-type=GPU_TYPE The GPU type to use. + --[no-]gpu-zonal-redundancy + Set GPU zonal redundancy. Use --gpu-zonal-redundancy to enable and + --no-gpu-zonal-redundancy to disable. + --key=KEY CMEK key reference to encrypt the container with. diff --git a/gcloud/alpha/run/jobs/deploy b/gcloud/alpha/run/jobs/deploy index 6dc410ce9..ee9a65a0a 100644 --- a/gcloud/alpha/run/jobs/deploy +++ b/gcloud/alpha/run/jobs/deploy @@ -4,9 +4,10 @@ NAME SYNOPSIS gcloud alpha run jobs deploy [JOB] [--binary-authorization=POLICY] [--breakglass=JUSTIFICATION] [--container=CONTAINER] - [--gpu-type=GPU_TYPE] [--key=KEY] [--labels=[KEY=VALUE,...]] - [--max-retries=MAX_RETRIES] [--parallelism=PARALLELISM] - [--region=REGION] [--remove-containers=[CONTAINER,...]] + [--gpu-type=GPU_TYPE] [--[no-]gpu-zonal-redundancy] [--key=KEY] + [--labels=[KEY=VALUE,...]] [--max-retries=MAX_RETRIES] + [--parallelism=PARALLELISM] [--region=REGION] + [--remove-containers=[CONTAINER,...]] [--service-account=SERVICE_ACCOUNT] [--set-cloudsql-instances=[CLOUDSQL-INSTANCES,...]] [--task-timeout=TASK_TIMEOUT] [--tasks=TASKS; default=1] @@ -84,6 +85,10 @@ FLAGS --gpu-type=GPU_TYPE The GPU type to use. + --[no-]gpu-zonal-redundancy + Set GPU zonal redundancy. Use --gpu-zonal-redundancy to enable and + --no-gpu-zonal-redundancy to disable. + --key=KEY CMEK key reference to encrypt the container with. diff --git a/gcloud/alpha/run/jobs/update b/gcloud/alpha/run/jobs/update index 6c5490c8e..213a45fbf 100644 --- a/gcloud/alpha/run/jobs/update +++ b/gcloud/alpha/run/jobs/update @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud alpha run jobs update [JOB] [--breakglass=JUSTIFICATION] [--clear-vpc-connector] [--container=CONTAINER] [--gpu-type=GPU_TYPE] - [--key=KEY] [--max-retries=MAX_RETRIES] [--parallelism=PARALLELISM] - [--region=REGION] [--remove-containers=[CONTAINER,...]] + [--[no-]gpu-zonal-redundancy] [--key=KEY] [--max-retries=MAX_RETRIES] + [--parallelism=PARALLELISM] [--region=REGION] + [--remove-containers=[CONTAINER,...]] [--service-account=SERVICE_ACCOUNT] [--task-timeout=TASK_TIMEOUT] [--tasks=TASKS; default=1] [--vpc-connector=VPC_CONNECTOR] [--vpc-egress=VPC_EGRESS] @@ -83,6 +84,10 @@ FLAGS --gpu-type=GPU_TYPE The GPU type to use. + --[no-]gpu-zonal-redundancy + Set GPU zonal redundancy. Use --gpu-zonal-redundancy to enable and + --no-gpu-zonal-redundancy to disable. + --key=KEY CMEK key reference to encrypt the container with. diff --git a/gcloud/alpha/transfer/agents/help b/gcloud/alpha/transfer/agents/help index be7d69e05..3d58b2837 100644 --- a/gcloud/alpha/transfer/agents/help +++ b/gcloud/alpha/transfer/agents/help @@ -5,7 +5,7 @@ SYNOPSIS gcloud alpha transfer agents COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage agents. Agents arre lightweight applications that enable + (ALPHA) Manage agents. Agents are 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. diff --git a/gcloud/alpha/zone-management/auth/help b/gcloud/alpha/zone-management/auth/help new file mode 100644 index 000000000..826cc7bbc --- /dev/null +++ b/gcloud/alpha/zone-management/auth/help @@ -0,0 +1,26 @@ +NAME + gcloud alpha zone-management auth - zone Management Auth gcloud commands + +SYNOPSIS + gcloud alpha zone-management auth COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Zone Management Auth gcloud commands. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + print-identity-token + (ALPHA) Print an identity token for a specified audience. + +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/zone-management/auth/print-identity-token b/gcloud/alpha/zone-management/auth/print-identity-token new file mode 100644 index 000000000..7df815240 --- /dev/null +++ b/gcloud/alpha/zone-management/auth/print-identity-token @@ -0,0 +1,34 @@ +NAME + gcloud alpha zone-management auth print-identity-token - print an identity + token for a specified audience + +SYNOPSIS + gcloud alpha zone-management auth print-identity-token --audience=AUDIENCE + --cred-file=CRED_FILE [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + $ gcloud alpha zone-management auth print-identity-token \ + --audience=https://example.com --cred-file=/tmp/cred.json + +REQUIRED FLAGS + --audience=AUDIENCE + Intended recipient of the token. Currently, only one audience can be + specified. + + --cred-file=CRED_FILE + Path to a credential file. + +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/zone-management/help b/gcloud/alpha/zone-management/help new file mode 100644 index 000000000..7d72525e2 --- /dev/null +++ b/gcloud/alpha/zone-management/help @@ -0,0 +1,41 @@ +NAME + gcloud alpha zone-management - zone Management gcloud commands + +SYNOPSIS + gcloud alpha zone-management GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Zone Management gcloud commands. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + auth + (ALPHA) Zone Management Auth gcloud commands. + + identity-providers + (ALPHA) Zone Management Service Identity Provider gcloud commands. + + projects + (ALPHA) Zone Management Project gcloud commands. + + service-accounts + (ALPHA) Zone Management Service Account gcloud commands. + + services + (ALPHA) Zone Management Service gcloud commands. + + zones + (ALPHA) Zone Management Zone gcloud commands. + +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/zone-management/identity-providers/create b/gcloud/alpha/zone-management/identity-providers/create new file mode 100644 index 000000000..8eb00054a --- /dev/null +++ b/gcloud/alpha/zone-management/identity-providers/create @@ -0,0 +1,75 @@ +NAME + gcloud alpha zone-management identity-providers create - create identity + provider + +SYNOPSIS + gcloud alpha zone-management identity-providers create + (IDENTITY_PROVIDER : --location=LOCATION --organization=ORGANIZATION) + --config=CONFIG [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Creates an identity provider. + +EXAMPLES + To create an identity provider called test-identity-provider in + organization test-org, location us-central1 with the contents of + test-config.json: + + $ gcloud alpha zone-management identity-providers create \ + test-identity-provider --location=us-central1 \ + --organization=test-org --config=test-config.json + +POSITIONAL ARGUMENTS + IdentityProvider resource - Identity Provider to create. The arguments in + this group can be used to specify the attributes of this resource. + + This must be specified. + + IDENTITY_PROVIDER + ID of the identityProvider or fully qualified identifier for the + identityProvider. + + To set the identity_provider attribute: + ▸ provide the argument identity_provider on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. + + To set the location attribute: + ▸ provide the argument identity_provider on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + The organization name. + + To set the organization attribute: + ▸ provide the argument identity_provider on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +REQUIRED FLAGS + --config=CONFIG + The identity provider configuration file. + +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 edgecontainer/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/edge-cloud + +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/zone-management/identity-providers/delete b/gcloud/alpha/zone-management/identity-providers/delete new file mode 100644 index 000000000..16b24481a --- /dev/null +++ b/gcloud/alpha/zone-management/identity-providers/delete @@ -0,0 +1,74 @@ +NAME + gcloud alpha zone-management identity-providers delete - delete identity + provider + +SYNOPSIS + gcloud alpha zone-management identity-providers delete + (IDENTITY_PROVIDER : --location=LOCATION --organization=ORGANIZATION) + --zone=ZONE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Deletes an identity provider. + +EXAMPLES + To delete an identity provider called test-identity-provider in + organization test-org, location us-central1 and zone test-zone: + + $ gcloud alpha zone-management identity-providers delete delete \ + test-identity-provider --location=us-central1 \ + --organization=test-org --zone=test-zone + +POSITIONAL ARGUMENTS + IdentityProvider resource - The identity provider to delete. The arguments + in this group can be used to specify the attributes of this resource. + + This must be specified. + + IDENTITY_PROVIDER + ID of the identityProvider or fully qualified identifier for the + identityProvider. + + To set the identity_provider attribute: + ▸ provide the argument identity_provider on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. + + To set the location attribute: + ▸ provide the argument identity_provider on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + The organization name. + + To set the organization attribute: + ▸ provide the argument identity_provider on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +REQUIRED FLAGS + --zone=ZONE + Zone of the identity provider. + +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 edgecontainer/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/edge-cloud + +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/zone-management/identity-providers/describe b/gcloud/alpha/zone-management/identity-providers/describe new file mode 100644 index 000000000..61290e398 --- /dev/null +++ b/gcloud/alpha/zone-management/identity-providers/describe @@ -0,0 +1,75 @@ +NAME + gcloud alpha zone-management identity-providers describe - describes an + identity provider + +SYNOPSIS + gcloud alpha zone-management identity-providers describe + (IDENTITY_PROVIDER : --location=LOCATION --organization=ORGANIZATION) + --zone=ZONE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describes an identity provider. + +EXAMPLES + To describe an identity provider called test-identity-provider in + organization test-org, location us-central1 and zone test-zone: + + $ gcloud alpha zone-management identity-providers describe \ + test-identity-provider --location=us-central1 \ + --organization=test-org --zone=test-zone + +POSITIONAL ARGUMENTS + IdentityProvider resource - The identity provider to describe. The + arguments in this group can be used to specify the attributes of this + resource. + + This must be specified. + + IDENTITY_PROVIDER + ID of the identityProvider or fully qualified identifier for the + identityProvider. + + To set the identity_provider attribute: + ▸ provide the argument identity_provider on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. + + To set the location attribute: + ▸ provide the argument identity_provider on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + The organization name. + + To set the organization attribute: + ▸ provide the argument identity_provider on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +REQUIRED FLAGS + --zone=ZONE + Zone of the identity provider. + +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 edgecontainer/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/edge-cloud + +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/container/ai/recommender/model-servers/help b/gcloud/alpha/zone-management/identity-providers/help similarity index 51% rename from gcloud/alpha/container/ai/recommender/model-servers/help rename to gcloud/alpha/zone-management/identity-providers/help index 3bf460293..d1e500f30 100644 --- a/gcloud/alpha/container/ai/recommender/model-servers/help +++ b/gcloud/alpha/zone-management/identity-providers/help @@ -1,16 +1,13 @@ NAME - gcloud alpha container ai recommender model-servers - manage supported - model servers for GKE recommender + gcloud alpha zone-management identity-providers - zone Management Service + Identity Provider gcloud commands SYNOPSIS - gcloud alpha container ai recommender model-servers COMMAND + gcloud alpha zone-management identity-providers COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) (DEPRECATED) Manage supported model servers for GKE recommender. - - This command group is deprecated. Use gcloud alpha container ai profiles - command group instead. + (ALPHA) Zone Management Service Identity Provider gcloud commands. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -20,8 +17,17 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + create + (ALPHA) create identity provider. + + delete + (ALPHA) delete identity provider. + + describe + (ALPHA) describes an identity provider. + list - (ALPHA) (DEPRECATED) List supported model servers for a given model. + (ALPHA) list identity providers. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/container/ai/recommender/models/list b/gcloud/alpha/zone-management/identity-providers/list similarity index 56% rename from gcloud/alpha/container/ai/recommender/models/list rename to gcloud/alpha/zone-management/identity-providers/list index 58cd9185b..031617f28 100644 --- a/gcloud/alpha/container/ai/recommender/models/list +++ b/gcloud/alpha/zone-management/identity-providers/list @@ -1,16 +1,49 @@ NAME - gcloud alpha container ai recommender models list - list supported models + gcloud alpha zone-management identity-providers list - list identity + providers SYNOPSIS - gcloud alpha container ai recommender models list [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] + gcloud alpha zone-management identity-providers list --zone=ZONE + (--location=LOCATION : --organization=ORGANIZATION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) (DEPRECATED) List supported models. + (ALPHA) Lists identity providers in a given organization and location. - This command group is deprecated. Use gcloud alpha container ai profiles - command group instead. +EXAMPLES + To list identity providers in organization test-org, location us-central1 + and zone test-zone, run: + + $ gcloud alpha zone-management identity-providers list \ + --location=us-central1 --organization=test-org --zone=test-zone + +REQUIRED FLAGS + --zone=ZONE + Zone of the identity provider. + + Location resource - Parent Edge Container location to list all identity + providers. The arguments in this group can be used to specify the + attributes of this resource. + + 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. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --organization=ORGANIZATION + The organization name. + + To set the organization attribute: + ▸ provide the argument --location on the command line with a fully + specified name; + ▸ provide the argument --organization on the command line. LIST COMMAND FLAGS --filter=EXPRESSION @@ -52,6 +85,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +API REFERENCE + This command uses the edgecontainer/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/edge-cloud + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/zone-management/projects/describe b/gcloud/alpha/zone-management/projects/describe new file mode 100644 index 000000000..9ffeb7976 --- /dev/null +++ b/gcloud/alpha/zone-management/projects/describe @@ -0,0 +1,78 @@ +NAME + gcloud alpha zone-management projects describe - describe zonal project + +SYNOPSIS + gcloud alpha zone-management projects describe + (ZONAL_PROJECT + : --location=LOCATION --organization=ORGANIZATION --zone=ZONE) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a zonal project. + +EXAMPLES + To describe a zonal project test-zonal-project in zone test-zone in + organization test-org and location us-central1, run: + + $ gcloud alpha zone-management projects describe \ + test-zonal-project --location=us-central1 --zone=test-zone \ + --organization=test-org + +POSITIONAL ARGUMENTS + Zonal Project resource - Zonal Project The arguments in this group can be + used to specify the attributes of this resource. + + This must be specified. + + ZONAL_PROJECT + ID of the Zonal Project or fully qualified identifier for the Zonal + Project. + + To set the zonal_project attribute: + ▸ provide the argument zonal_project on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location name. + + To set the location attribute: + ▸ provide the argument zonal_project on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + The organization name. + + To set the organization attribute: + ▸ provide the argument zonal_project on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. + + To set the zone attribute: + ▸ provide the argument zonal_project on the command line with a + fully specified name; + ▸ provide the argument --zone on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgecontainer/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/edge-cloud + +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/zone-management/projects/enable b/gcloud/alpha/zone-management/projects/enable new file mode 100644 index 000000000..0d085fea1 --- /dev/null +++ b/gcloud/alpha/zone-management/projects/enable @@ -0,0 +1,86 @@ +NAME + gcloud alpha zone-management projects enable - enable zonal project + +SYNOPSIS + gcloud alpha zone-management projects enable ZONAL_PROJECT [--async] + [--location=LOCATION] [--organization=ORGANIZATION] [--zone=ZONE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Enables a zonal project. + +EXAMPLES + To enable a project called test-project in zone test-zone in organization + test-org and location us-central1, run: + + $ gcloud alpha zone-management projects enable test-project \ + --location=us-central1 --zone=test-zone --organization=test-org + +POSITIONAL ARGUMENTS + Zonal Project resource - Zonal Project 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 organization attribute: + ◆ provide the argument zonal_project on the command line with a fully + specified name; + ◆ provide the argument --organization on the command line. + + To set the location attribute: + ◆ provide the argument zonal_project on the command line with a fully + specified name; + ◆ provide the argument --location on the command line. + + To set the zone attribute: + ◆ provide the argument zonal_project on the command line with a fully + specified name; + ◆ provide the argument --zone on the command line. + + This must be specified. + + ZONAL_PROJECT + ID of the Zonal Project or fully qualified identifier for the Zonal + Project. + + To set the zonal_project attribute: + ▸ provide the argument zonal_project on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --location=LOCATION + For resources [location, zonal_project, zone], provides fallback value + for resource location attribute. When the resource's full URI path is + not provided, location will fallback to this flag value. + + --organization=ORGANIZATION + For resources [location, organization, zonal_project, zone], provides + fallback value for resource organization attribute. When the resource's + full URI path is not provided, organization will fallback to this flag + value. + + --zone=ZONE + For resources [zonal_project, zone], provides fallback value for + resource zone attribute. When the resource's full URI path is not + provided, zone will fallback to this flag value. + +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 edgecontainer/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/edge-cloud + +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/container/ai/recommender/models/help b/gcloud/alpha/zone-management/projects/help similarity index 53% rename from gcloud/alpha/container/ai/recommender/models/help rename to gcloud/alpha/zone-management/projects/help index e6d117e1c..d9ff325ed 100644 --- a/gcloud/alpha/container/ai/recommender/models/help +++ b/gcloud/alpha/zone-management/projects/help @@ -1,15 +1,12 @@ NAME - gcloud alpha container ai recommender models - manage supported models for - GKE recommender + gcloud alpha zone-management projects - zone Management Project gcloud + commands SYNOPSIS - gcloud alpha container ai recommender models COMMAND [GCLOUD_WIDE_FLAG ...] + gcloud alpha zone-management projects COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) (DEPRECATED) Manage supported models for GKE recommender. - - This command group is deprecated. Use gcloud alpha container ai profiles - command group instead. + (ALPHA) Zone Management Project gcloud commands. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -19,8 +16,14 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + describe + (ALPHA) describe zonal project. + + enable + (ALPHA) enable zonal project. + list - (ALPHA) (DEPRECATED) List supported models. + (ALPHA) List Zonal Projects. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/zone-management/projects/list b/gcloud/alpha/zone-management/projects/list new file mode 100644 index 000000000..6a538fd04 --- /dev/null +++ b/gcloud/alpha/zone-management/projects/list @@ -0,0 +1,101 @@ +NAME + gcloud alpha zone-management projects list - list Zonal Projects + +SYNOPSIS + gcloud alpha zone-management projects list + (--zone=ZONE : --location=LOCATION --organization=ORGANIZATION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Lists zonal projects in a given project and location. + +EXAMPLES + To list zonal projects in zone test-zone in organization test-org and + location us-central1, run: + + $ gcloud alpha zone-management projects list \ + --location=us-central1 --zone=test-zone --organization=test-org + +REQUIRED FLAGS + Zone resource - Parent Edge Container location to list all zonal projects + in a given location, zone and organization. The arguments in this group + can be used to specify the attributes of this resource. + + This must be specified. + + --zone=ZONE + ID of the zone or fully qualified identifier for the zone. + + To set the zone attribute: + ▸ provide the argument --zone on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location name. + + To set the location attribute: + ▸ provide the argument --zone on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + The organization name. + + To set the organization attribute: + ▸ provide the argument --zone on the command line with a fully + specified name; + ▸ provide the argument --organization 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 edgecontainer/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/edge-cloud + +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/zone-management/service-accounts/create b/gcloud/alpha/zone-management/service-accounts/create new file mode 100644 index 000000000..8b7423529 --- /dev/null +++ b/gcloud/alpha/zone-management/service-accounts/create @@ -0,0 +1,79 @@ +NAME + gcloud alpha zone-management service-accounts create - create service + account + +SYNOPSIS + gcloud alpha zone-management service-accounts create + (SERVICE_ACCOUNT : --location=LOCATION) --zone=ZONE [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Creates a service account. + +EXAMPLES + To create a service account called test-service-account in project + test-project and location us-central1, run: + + $ gcloud alpha zone-management service-accounts create \ + test-service-account --location=us-central1 \ + --project=test-project --zone=us-central1-edge-zone1 + +POSITIONAL ARGUMENTS + Service Account resource - Service Account to create. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument service_account 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. + + SERVICE_ACCOUNT + ID of the Service Account or fully qualified identifier for the + Service Account. + + To set the service_account attribute: + ▸ provide the argument service_account on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location name. + + To set the location attribute: + ▸ provide the argument service_account on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --zone=ZONE + Zone name. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgecontainer/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/edge-cloud + +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/zone-management/service-accounts/delete b/gcloud/alpha/zone-management/service-accounts/delete new file mode 100644 index 000000000..07d21c302 --- /dev/null +++ b/gcloud/alpha/zone-management/service-accounts/delete @@ -0,0 +1,75 @@ +NAME + gcloud alpha zone-management service-accounts delete - delete service + account + +SYNOPSIS + gcloud alpha zone-management service-accounts delete + (SERVICE_ACCOUNT : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Deletes a service account. + +EXAMPLES + To delete a service account called test-service-account in project + test-project and location us-central1, run: + + $ gcloud alpha zone-management service-accounts delete \ + test-service-account --location=us-central1 \ + --project=test-project + +POSITIONAL ARGUMENTS + Service Account resource - Service account 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 service_account 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. + + SERVICE_ACCOUNT + ID of the Service Account or fully qualified identifier for the + Service Account. + + To set the service_account attribute: + ▸ provide the argument service_account on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location name. + + To set the location attribute: + ▸ provide the argument service_account 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 edgecontainer/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/edge-cloud + +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/zone-management/service-accounts/describe b/gcloud/alpha/zone-management/service-accounts/describe new file mode 100644 index 000000000..fef59b7ab --- /dev/null +++ b/gcloud/alpha/zone-management/service-accounts/describe @@ -0,0 +1,68 @@ +NAME + gcloud alpha zone-management service-accounts describe - describe service + account + +SYNOPSIS + gcloud alpha zone-management service-accounts describe + (SERVICE_ACCOUNT : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describes a service account. + +EXAMPLES + To describe a service account called test-service-account in project + test-project and location us-central1, run: + + $ gcloud alpha zone-management service-accounts describe \ + test-service-account --location=us-central1 \ + --project=test-project + +POSITIONAL ARGUMENTS + Service Account resource - Service Account 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 service_account 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. + + SERVICE_ACCOUNT + ID of the Service Account or fully qualified identifier for the + Service Account. + + To set the service_account attribute: + ▸ provide the argument service_account on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location name. + + To set the location attribute: + ▸ provide the argument service_account on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgecontainer/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/edge-cloud + +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/zone-management/service-accounts/help b/gcloud/alpha/zone-management/service-accounts/help new file mode 100644 index 000000000..efb375fb8 --- /dev/null +++ b/gcloud/alpha/zone-management/service-accounts/help @@ -0,0 +1,43 @@ +NAME + gcloud alpha zone-management service-accounts - zone Management Service + Account gcloud commands + +SYNOPSIS + gcloud alpha zone-management service-accounts GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Zone Management Service Account gcloud commands. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + keys + (ALPHA) Zone Management Service Account Keys gcloud commands. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) create service account. + + delete + (ALPHA) delete service account. + + describe + (ALPHA) describe service account. + + list + (ALPHA) List service accounts. + +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/zone-management/service-accounts/keys/create b/gcloud/alpha/zone-management/service-accounts/keys/create new file mode 100644 index 000000000..0f1f65cc6 --- /dev/null +++ b/gcloud/alpha/zone-management/service-accounts/keys/create @@ -0,0 +1,78 @@ +NAME + gcloud alpha zone-management service-accounts keys create - creates service + account key + +SYNOPSIS + gcloud alpha zone-management service-accounts keys create OUTPUT_FILE + (--service-account=SERVICE_ACCOUNT : --location=LOCATION) + [--ca-cert-path=CA_CERT_PATH] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Creates service account key. + +EXAMPLES + To create service account key for a service account called + test-service-account in project test-project and location us-central1, run: + + $ gcloud alpha zone-management service-accounts keys create \ + --service_account=test-service-account --location=us-central1 \ + --project=test-project + +POSITIONAL ARGUMENTS + OUTPUT_FILE + Path to the file to write the private key response to. + +REQUIRED FLAGS + Service Account resource - Service Account to create key for. 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 --service-account 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. + + --service-account=SERVICE_ACCOUNT + ID of the Service Account or fully qualified identifier for the + Service Account. + + To set the service-account attribute: + ▸ provide the argument --service-account on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location name. + + To set the location attribute: + ▸ provide the argument --service-account on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +OPTIONAL FLAGS + --ca-cert-path=CA_CERT_PATH + Path to the CA certificate file. + +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 edgecontainer/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/edge-cloud + +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/container/ai/recommender/accelerators/help b/gcloud/alpha/zone-management/service-accounts/keys/help similarity index 52% rename from gcloud/alpha/container/ai/recommender/accelerators/help rename to gcloud/alpha/zone-management/service-accounts/keys/help index 80b159ce7..5495df216 100644 --- a/gcloud/alpha/container/ai/recommender/accelerators/help +++ b/gcloud/alpha/zone-management/service-accounts/keys/help @@ -1,16 +1,13 @@ NAME - gcloud alpha container ai recommender accelerators - manage supported - accelerators for GKE recommender + gcloud alpha zone-management service-accounts keys - zone Management + Service Account Keys gcloud commands SYNOPSIS - gcloud alpha container ai recommender accelerators COMMAND + gcloud alpha zone-management service-accounts keys COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) (DEPRECATED) Manage supported accelerators for GKE recommender. - - This command group is deprecated. Use gcloud alpha container ai profiles - command group instead. + (ALPHA) Zone Management Service Account Keys gcloud commands. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -20,8 +17,8 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: - list - (ALPHA) (DEPRECATED) List compatible accelerator profiles. + create + (ALPHA) Creates service account key. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/container/ai/recommender/model-server-versions/list b/gcloud/alpha/zone-management/service-accounts/list similarity index 61% rename from gcloud/alpha/container/ai/recommender/model-server-versions/list rename to gcloud/alpha/zone-management/service-accounts/list index 5cd078e68..dc89d7844 100644 --- a/gcloud/alpha/container/ai/recommender/model-server-versions/list +++ b/gcloud/alpha/zone-management/service-accounts/list @@ -1,31 +1,39 @@ NAME - gcloud alpha container ai recommender model-server-versions list - list - supported model server versions + gcloud alpha zone-management service-accounts list - list service accounts SYNOPSIS - gcloud alpha container ai recommender model-server-versions list - --model=MODEL --model-server=MODEL_SERVER [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] + gcloud alpha zone-management service-accounts list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) (DEPRECATED) List supported model server versions. + (ALPHA) Lists service accounts in a given project and location. - This command group is deprecated. Use gcloud alpha container ai profiles - command group instead. +EXAMPLES + To list service accounts in project test-project and location us-central1, + run: - To get supported model and model servers, run gcloud alpha container ai - recommender models list and gcloud alpha container ai recommender - model-servers list. Alternatively, run gcloud alpha container ai - recommender model-and-server-combinations list to get all supported model - and server combinations. + $ gcloud alpha zone-management service-accounts list \ + --location=us-central1 --project=test-project REQUIRED FLAGS - --model=MODEL - The model. + Location resource - Parent Edge Container location to list all service + accounts. This represents a Cloud resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. - --model-server=MODEL_SERVER - The model server. If not specified, this defaults to any model server. + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. LIST COMMAND FLAGS --filter=EXPRESSION @@ -67,6 +75,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +API REFERENCE + This command uses the edgecontainer/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/edge-cloud + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/zone-management/services/describe b/gcloud/alpha/zone-management/services/describe new file mode 100644 index 000000000..da8f641f2 --- /dev/null +++ b/gcloud/alpha/zone-management/services/describe @@ -0,0 +1,66 @@ +NAME + gcloud alpha zone-management services describe - describe zonal service + +SYNOPSIS + gcloud alpha zone-management services describe + (ZONAL_SERVICE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describes a zonal service. + +EXAMPLES + To describe a zonal service with Id zonal-service-id in project + test-project and location us-central1, run: + + $ gcloud alpha zone-management services describe zonal-service-id \ + --location=us-central1 --project=test-project + +POSITIONAL ARGUMENTS + Zonal Service resource - Zonal Service Id 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 zonal_service 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. + + ZONAL_SERVICE + ID of the Zonal Service or fully qualified identifier for the Zonal + Service. + + To set the zonal_service attribute: + ▸ provide the argument zonal_service on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location name. + + To set the location attribute: + ▸ provide the argument zonal_service on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgecontainer/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/edge-cloud + +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/zone-management/services/enable b/gcloud/alpha/zone-management/services/enable new file mode 100644 index 000000000..45b8d9306 --- /dev/null +++ b/gcloud/alpha/zone-management/services/enable @@ -0,0 +1,73 @@ +NAME + gcloud alpha zone-management services enable - enable zonal service + +SYNOPSIS + gcloud alpha zone-management services enable SERVICE_SELECTOR + --location=LOCATION [--async] [--cluster=CLUSTER] [--id=ID] + [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Enables a zonal service. + +EXAMPLES + To enable vertex service in location us-central1 in test-project project + and test-zone zone, run: + + $ gcloud alpha zone-management services enable vertex \ + --location=us-central1 --project=test-project --zone=test-zone + +POSITIONAL ARGUMENTS + SERVICE_SELECTOR + service name. + +REQUIRED FLAGS + Location resource - location. This represents a Cloud resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --cluster=CLUSTER + Cluster name. + + --id=ID + Zonal service ID. + + --zone=ZONE + Distributed Cloud Zone. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgecontainer/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/edge-cloud + +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/zone-management/services/help b/gcloud/alpha/zone-management/services/help new file mode 100644 index 000000000..99a12152b --- /dev/null +++ b/gcloud/alpha/zone-management/services/help @@ -0,0 +1,33 @@ +NAME + gcloud alpha zone-management services - zone Management Service gcloud + commands + +SYNOPSIS + gcloud alpha zone-management services COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Zone Management Service gcloud commands. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) describe zonal service. + + enable + (ALPHA) enable zonal service. + + list + (ALPHA) List Zonal Services. + +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/container/ai/recommender/model-servers/list b/gcloud/alpha/zone-management/services/list similarity index 65% rename from gcloud/alpha/container/ai/recommender/model-servers/list rename to gcloud/alpha/zone-management/services/list index 7eb91e38c..a794df3ea 100644 --- a/gcloud/alpha/container/ai/recommender/model-servers/list +++ b/gcloud/alpha/zone-management/services/list @@ -1,25 +1,39 @@ NAME - gcloud alpha container ai recommender model-servers list - list supported - model servers for a given model + gcloud alpha zone-management services list - list Zonal Services SYNOPSIS - gcloud alpha container ai recommender model-servers list --model=MODEL + gcloud alpha zone-management services list --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) (DEPRECATED) List supported model servers for a given model. + (ALPHA) Lists zonal services in a given project and location. - This command group is deprecated. Use gcloud alpha container ai profiles - command group instead. +EXAMPLES + To list zonal services in project test-project and location us-central1, + run: - To get supported models, run gcloud alpha container ai recommender models - list or to get all supported model and server combinations, run gcloud - alpha container ai recommender model-and-server-combinations list. + $ gcloud alpha zone-management services list \ + --location=us-central1 --project=test-project REQUIRED FLAGS - --model=MODEL - The model. + Location resource - Parent Edge Container location to list all zonal + services. This represents a Cloud resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. LIST COMMAND FLAGS --filter=EXPRESSION @@ -61,6 +75,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +API REFERENCE + This command uses the edgecontainer/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/edge-cloud + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/zone-management/zones/describe b/gcloud/alpha/zone-management/zones/describe new file mode 100644 index 000000000..ad88d777c --- /dev/null +++ b/gcloud/alpha/zone-management/zones/describe @@ -0,0 +1,65 @@ +NAME + gcloud alpha zone-management zones describe - describe zone + +SYNOPSIS + gcloud alpha zone-management zones describe + (ZONE : --location=LOCATION --organization=ORGANIZATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describes a zone. + +EXAMPLES + To describe a zone called test-zone in organization test-org and location + us-central1, run: $ gcloud alpha zone-management zones describe test-zone \ + --location=us-central1 --organization=test-org + +POSITIONAL ARGUMENTS + Zone resource - Zone The arguments in this group can be used to specify + the attributes of this resource. + + This must be specified. + + ZONE + ID of the zone or fully qualified identifier for the zone. + + To set the zone attribute: + ▸ provide the argument zone on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. + + To set the location attribute: + ▸ provide the argument zone on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + The organization name. + + To set the organization attribute: + ▸ provide the argument zone on the command line with a fully + specified name; + ▸ provide the argument --organization 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 edgecontainer/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/edge-cloud + +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/zone-management/zones/get-iam-policy b/gcloud/alpha/zone-management/zones/get-iam-policy new file mode 100644 index 000000000..ba0d1673b --- /dev/null +++ b/gcloud/alpha/zone-management/zones/get-iam-policy @@ -0,0 +1,95 @@ +NAME + gcloud alpha zone-management zones get-iam-policy - get IAM policy for a + project on the zone + +SYNOPSIS + gcloud alpha zone-management zones get-iam-policy + (ZONE : --location=LOCATION) [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Gets the IAM policy for a project on the zone. + +EXAMPLES + To get the IAM policy for a project called test-project on the zone + test-zone in location us-central1, run: + + $ gcloud alpha zone-management zones get-iam-policy test-zone \ + --project=test-project --location=us-central1 + +POSITIONAL ARGUMENTS + Zone resource - The name of the zone where the project is enabled. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument zone on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. This resource can be one of the + following types: [zone]. + + This must be specified. + + ZONE + ID of the zone or fully qualified identifier for the zone. + + To set the zone attribute: + ▸ provide the argument zone on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The global location name. + + To set the location attribute: + ▸ provide the argument zone on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +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 edgecontainer/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/edge-cloud + +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/zone-management/zones/help b/gcloud/alpha/zone-management/zones/help new file mode 100644 index 000000000..82ee90b54 --- /dev/null +++ b/gcloud/alpha/zone-management/zones/help @@ -0,0 +1,35 @@ +NAME + gcloud alpha zone-management zones - zone Management Zone gcloud commands + +SYNOPSIS + gcloud alpha zone-management zones COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Zone Management Zone gcloud commands. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) describe zone. + + get-iam-policy + (ALPHA) get IAM policy for a project on the zone. + + list + (ALPHA) list zones. + + set-iam-policy + (ALPHA) set IAM policy for a project on the zone. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/ai/recommender/model-and-server-combinations/list b/gcloud/alpha/zone-management/zones/list similarity index 59% rename from gcloud/alpha/container/ai/recommender/model-and-server-combinations/list rename to gcloud/alpha/zone-management/zones/list index 8673ddc49..709afea67 100644 --- a/gcloud/alpha/container/ai/recommender/model-and-server-combinations/list +++ b/gcloud/alpha/zone-management/zones/list @@ -1,33 +1,44 @@ NAME - gcloud alpha container ai recommender model-and-server-combinations list - - list supported model and server combinations + gcloud alpha zone-management zones list - list zones SYNOPSIS - gcloud alpha container ai recommender model-and-server-combinations list - [--model=MODEL] [--model-server=MODEL_SERVER] - [--model-server-version=MODEL_SERVER_VERSION] [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] + gcloud alpha zone-management zones list + (--location=LOCATION : --organization=ORGANIZATION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) (DEPRECATED) List supported model and server combinations. + (ALPHA) Lists zones in a given organization and location. - This command group is deprecated. Use gcloud alpha container ai profiles - command group instead. +EXAMPLES + To list zones in organization test-org and location us-central1, run: - This command lists all supported model, model server, and model server - version combinations. + $ gcloud alpha zone-management zones list --location=us-central1 \ + --organization=test-org -FLAGS - --model=MODEL - The model. If not specified, this defaults to any model. +REQUIRED FLAGS + Location resource - Parent Edge Container location to list all zones. The + arguments in this group can be used to specify the attributes of this + resource. - --model-server=MODEL_SERVER - The model server. If not specified, this defaults to any model server. + This must be specified. - --model-server-version=MODEL_SERVER_VERSION - The model server version. If not specified, this defaults to the any - model server version. + --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. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --organization=ORGANIZATION + The organization name. + + To set the organization attribute: + ▸ provide the argument --location on the command line with a fully + specified name; + ▸ provide the argument --organization on the command line. LIST COMMAND FLAGS --filter=EXPRESSION @@ -69,6 +80,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +API REFERENCE + This command uses the edgecontainer/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/edge-cloud + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/zone-management/zones/set-iam-policy b/gcloud/alpha/zone-management/zones/set-iam-policy new file mode 100644 index 000000000..68eb31daa --- /dev/null +++ b/gcloud/alpha/zone-management/zones/set-iam-policy @@ -0,0 +1,77 @@ +NAME + gcloud alpha zone-management zones set-iam-policy - set IAM policy for a + project on the zone + +SYNOPSIS + gcloud alpha zone-management zones set-iam-policy POLICY_FILE + (--zone=ZONE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Sets the IAM policy for a project on the zone. + +EXAMPLES + To set the IAM policy for a project called test-project in zone test-zone + in location us-central1 from a local file test-policy.json, run: + + $ gcloud alpha zone-management zones set-iam-policy \ + --project=test-project --location=us-central1 --zone=test-zone \ + test-policy.json + +POSITIONAL ARGUMENTS + POLICY_FILE + Path to a local JSON or YAML formatted file containing a valid policy. + + The output of the get-iam-policy command is a valid file, as is any + JSON or YAML file conforming to the structure of a Policy + (https://cloud.google.com/iam/reference/rest/v1/Policy). + +REQUIRED FLAGS + Zone resource - The name of the zone to set the IAM policy for the project + in. The arguments in this group can be used to specify the attributes of + this resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --zone on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. This resource can be one of the + following types: [zone]. + + This must be specified. + + --zone=ZONE + ID of the zone or fully qualified identifier for the zone. + + To set the zone attribute: + ▸ provide the argument --zone on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. + + To set the location attribute: + ▸ provide the argument --zone on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +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 edgecontainer/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/edge-cloud + +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/assured/workloads/create b/gcloud/assured/workloads/create index e838a91c9..89845e89b 100644 --- a/gcloud/assured/workloads/create +++ b/gcloud/assured/workloads/create @@ -86,13 +86,24 @@ REQUIRED FLAGS --compliance-regime=COMPLIANCE_REGIME The compliance regime of the new Assured Workloads environment. COMPLIANCE_REGIME must be one of: assured-workloads-for-partners, - au-regions-and-us-support, ca-protected-b, ca-regions-and-support, - canada-controlled-goods, cjis, eu-regions-and-support, fedramp-high, + au-regions-and-us-support, australia-data-boundary-and-support, + ca-protected-b, ca-regions-and-support, canada-controlled-goods, + canada-data-boundary-and-support, cjis, + data-boundary-for-canada-controlled-goods, + data-boundary-for-canada-protected-b, data-boundary-for-cjis, + data-boundary-for-fedramp-high, data-boundary-for-fedramp-moderate, + data-boundary-for-il2, data-boundary-for-il4, data-boundary-for-il5, + data-boundary-for-irs-publication-1075, data-boundary-for-itar, + eu-data-boundary-and-support, eu-regions-and-support, fedramp-high, fedramp-moderate, healthcare-and-life-sciences-controls, healthcare-and-life-sciences-controls-us-support, hipaa, hitrust, il2, - il4, il5, irs-1075, isr-regions, isr-regions-and-support, itar, - jp-regions-and-support, + il4, il5, irs-1075, isr-regions, isr-regions-and-support, + israel-data-boundary-and-support, itar, japan-data-boundary, + jp-regions-and-support, ksa-data-boundary-with-access-justifications, ksa-regions-and-support-with-sovereignty-controls, regional-controls, + regional-data-boundary, us-data-boundary-and-support, + us-data-boundary-for-healthcare-and-life-sciences, + us-data-boundary-for-healthcare-and-life-sciences-with-support, us-regional-access. --display-name=DISPLAY_NAME diff --git a/gcloud/beta/assured/workloads/create b/gcloud/beta/assured/workloads/create index 1cf18171a..cc26b690c 100644 --- a/gcloud/beta/assured/workloads/create +++ b/gcloud/beta/assured/workloads/create @@ -86,13 +86,24 @@ REQUIRED FLAGS --compliance-regime=COMPLIANCE_REGIME The compliance regime of the new Assured Workloads environment. COMPLIANCE_REGIME must be one of: assured-workloads-for-partners, - au-regions-and-us-support, ca-protected-b, ca-regions-and-support, - canada-controlled-goods, cjis, eu-regions-and-support, fedramp-high, + au-regions-and-us-support, australia-data-boundary-and-support, + ca-protected-b, ca-regions-and-support, canada-controlled-goods, + canada-data-boundary-and-support, cjis, + data-boundary-for-canada-controlled-goods, + data-boundary-for-canada-protected-b, data-boundary-for-cjis, + data-boundary-for-fedramp-high, data-boundary-for-fedramp-moderate, + data-boundary-for-il2, data-boundary-for-il4, data-boundary-for-il5, + data-boundary-for-irs-publication-1075, data-boundary-for-itar, + eu-data-boundary-and-support, eu-regions-and-support, fedramp-high, fedramp-moderate, healthcare-and-life-sciences-controls, healthcare-and-life-sciences-controls-us-support, hipaa, hitrust, il2, - il4, il5, irs-1075, isr-regions, isr-regions-and-support, itar, - jp-regions-and-support, + il4, il5, irs-1075, isr-regions, isr-regions-and-support, + israel-data-boundary-and-support, itar, japan-data-boundary, + jp-regions-and-support, ksa-data-boundary-with-access-justifications, ksa-regions-and-support-with-sovereignty-controls, regional-controls, + regional-data-boundary, us-data-boundary-and-support, + us-data-boundary-for-healthcare-and-life-sciences, + us-data-boundary-for-healthcare-and-life-sciences-with-support, us-regional-access. --display-name=DISPLAY_NAME diff --git a/gcloud/beta/bigtable/authorized-views/add-iam-policy-binding b/gcloud/beta/bigtable/authorized-views/add-iam-policy-binding index 07972a6d0..03660d514 100644 --- a/gcloud/beta/bigtable/authorized-views/add-iam-policy-binding +++ b/gcloud/beta/bigtable/authorized-views/add-iam-policy-binding @@ -14,26 +14,26 @@ DESCRIPTION binding consists of a member, a role, and an optional condition. EXAMPLES - To add an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table', run: + To add an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with authorized view my-authorized-view in instance + my-instance and table my-table, run: $ gcloud beta bigtable authorized-views add-iam-policy-binding \ - my-authorized-view --instance='my-instance' --table='my-table' \ - --member='user:test-user@gmail.com' --role='roles/editor' + my-authorized-view --instance=`my-instance` --table=`my-table` \ + --member=`user:test-user@gmail.com` --role=`roles/editor` To add an IAM policy binding which expires at the end of the year 2020 for - the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' with - authorized view 'my-authorized-view' in instance 'my-instance' and table - 'my-table', run: + the role of roles/bigtable.admin and the user test-user@gmail.com with + authorized view my-authorized-view in instance my-instance and table + my-table, run: $ gcloud beta bigtable authorized-views add-iam-policy-binding \ - my-authorized-view --instance='my-instance' --table='my-table' \ - --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,descrip\ - tion=Expires at midnight on 2020-12-31' + my-authorized-view --instance=`my-instance` --table=`my-table` \ + --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,\ + description=Expires at midnight on 2020-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -63,7 +63,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -71,7 +71,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a diff --git a/gcloud/beta/bigtable/authorized-views/create b/gcloud/beta/bigtable/authorized-views/create index 10d04705f..759f5a6fd 100644 --- a/gcloud/beta/bigtable/authorized-views/create +++ b/gcloud/beta/bigtable/authorized-views/create @@ -12,16 +12,16 @@ DESCRIPTION (BETA) Create a new Cloud Bigtable authorized view. EXAMPLES - To create an authorized view 'my-authorized-view' in instance 'my-instance' - and table 'my-table', using the definition file 'authorized_view.json': + To create an authorized view my-authorized-view in instance my-instance and + table my-table, using the definition file authorized_view.json: $ gcloud beta bigtable authorized-views create my-authorized-view \ --instance=test-instance --table=test-table \ --definition-file=authorized_view.json - To create an authorized view 'my-authorized-view' in instance 'my-instance' - and table 'my-table', using the pre-encoded definition file - 'authorized_view_pre_encoded.json': + To create an authorized view my-authorized-view in instance my-instance and + table my-table, using the pre-encoded definition file + authorized_view_pre_encoded.json: $ gcloud beta bigtable authorized-views create my-authorized-view \ --instance=test-instance --table=test-table \ @@ -52,7 +52,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -60,7 +60,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a @@ -76,7 +76,7 @@ FLAGS Path to a JSON or YAML file containing a valid authorized view protobuf. - The 'name' field is ignored. The name is deduced from the other command + The name field is ignored. The name is deduced from the other command line arguments. Example: { "subsetView": { "rowPrefixes": ["store1#"], "familySubsets": diff --git a/gcloud/beta/bigtable/authorized-views/delete b/gcloud/beta/bigtable/authorized-views/delete index a55b1c983..2f886c50b 100644 --- a/gcloud/beta/bigtable/authorized-views/delete +++ b/gcloud/beta/bigtable/authorized-views/delete @@ -11,8 +11,8 @@ DESCRIPTION (BETA) Delete new Cloud Bigtable authorized view. EXAMPLES - To delete the authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table': + To delete the authorized view my-authorized-view in instance my-instance + and table my-table: $ gcloud beta bigtable authorized-views delete my-authorized-view \ --instance=test-instance --table=test-table @@ -42,7 +42,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -50,7 +50,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a diff --git a/gcloud/beta/bigtable/authorized-views/describe b/gcloud/beta/bigtable/authorized-views/describe index 4c8a7827b..d0b5a901c 100644 --- a/gcloud/beta/bigtable/authorized-views/describe +++ b/gcloud/beta/bigtable/authorized-views/describe @@ -11,8 +11,8 @@ DESCRIPTION (BETA) Describe a Cloud Bigtable authorized view. EXAMPLES - To describe the authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table': + To describe the authorized view my-authorized-view in instance my-instance + and table my-table: $ gcloud beta bigtable authorized-views describe \ my-authorized-view --instance=test-instance --table=test-table @@ -42,7 +42,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -50,7 +50,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a diff --git a/gcloud/beta/bigtable/authorized-views/get-iam-policy b/gcloud/beta/bigtable/authorized-views/get-iam-policy index b164314c0..ca4fa9b05 100644 --- a/gcloud/beta/bigtable/authorized-views/get-iam-policy +++ b/gcloud/beta/bigtable/authorized-views/get-iam-policy @@ -12,11 +12,11 @@ DESCRIPTION (BETA) Get an IAM policy on a Cloud Bigtable authorized view. EXAMPLES - To get the IAM policy on the authorized view 'my-authorized-view' in - instance 'my-instance' and table 'my-table', run: + To get the IAM policy on the authorized view my-authorized-view in instance + my-instance and table my-table, run: $ gcloud beta bigtable authorized-views get-iam-policy \ - my-authorized-view --instance='my-instance' --table='my-table' + my-authorized-view --instance=`my-instance` --table=`my-table` See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -46,7 +46,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -54,7 +54,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a diff --git a/gcloud/beta/bigtable/authorized-views/list b/gcloud/beta/bigtable/authorized-views/list index e46b50c0e..ca93ceb7c 100644 --- a/gcloud/beta/bigtable/authorized-views/list +++ b/gcloud/beta/bigtable/authorized-views/list @@ -12,8 +12,7 @@ DESCRIPTION (BETA) List all authorized views of a Cloud Bigtable table. EXAMPLES - To list the authorized views in instance 'my-instance' and table - 'my-table': + To list the authorized views in instance my-instance and table my-table: $ gcloud beta bigtable authorized-views list \ --instance=test-instance --table=test-table @@ -42,7 +41,7 @@ REQUIRED FLAGS this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument --table on the command line with a fully diff --git a/gcloud/beta/bigtable/authorized-views/remove-iam-policy-binding b/gcloud/beta/bigtable/authorized-views/remove-iam-policy-binding index f7f68f052..8d73793ee 100644 --- a/gcloud/beta/bigtable/authorized-views/remove-iam-policy-binding +++ b/gcloud/beta/bigtable/authorized-views/remove-iam-policy-binding @@ -14,26 +14,26 @@ DESCRIPTION One binding consists of a member, a role, and an optional condition. EXAMPLES - To remove an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table', run: + To remove an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with authorized view my-authorized-view in instance + my-instance and table my-table, run: $ gcloud beta bigtable authorized-views remove-iam-policy-binding \ - my-authorized-view --instance='my-instance' --table='my-table' \ - --member='user:test-user@gmail.com' --role='roles/editor' + my-authorized-view --instance=`my-instance` --table=`my-table` \ + --member=`user:test-user@gmail.com` --role=`roles/editor` To remove an IAM policy binding which expires at the end of the year 2020 - for the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' - with authorized view 'my-authorized-view' in instance 'my-instance' and - cluster 'my-cluster', run: + for the role of roles/bigtable.admin and the user test-user@gmail.com with + authorized view my-authorized-view in instance my-instance and cluster + my-cluster, run: $ gcloud beta bigtable authorized-views remove-iam-policy-binding \ - my-authorized-view --instance='my-instance' --table='my-table' \ - --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,descrip\ - tion=Expires at midnight on 2020-12-31' + my-authorized-view --instance=`my-instance` --table=`my-table` \ + --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,\ + description=Expires at midnight on 2020-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -63,7 +63,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -71,7 +71,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a diff --git a/gcloud/beta/bigtable/authorized-views/set-iam-policy b/gcloud/beta/bigtable/authorized-views/set-iam-policy index f977663de..8af8818a8 100644 --- a/gcloud/beta/bigtable/authorized-views/set-iam-policy +++ b/gcloud/beta/bigtable/authorized-views/set-iam-policy @@ -11,11 +11,11 @@ DESCRIPTION (BETA) Set an IAM policy on a Cloud Bigtable authorized view. EXAMPLES - To set the IAM policy from file 'my-policy' on the authorized view - 'my-authorized-view' in instance 'my-instance' and table 'my-table', run: + To set the IAM policy from file my-policy on the authorized view + my-authorized-view in instance my-instance and table my-table, run: $ gcloud beta bigtable authorized-views set-iam-policy \ - my-authorized-view --instance='my-instance' --table='my-table' \ + my-authorized-view --instance=`my-instance` --table=`my-table` \ my-policy See https://cloud.google.com/iam/docs/managing-policies for more @@ -46,7 +46,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -54,7 +54,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a diff --git a/gcloud/beta/bigtable/authorized-views/update b/gcloud/beta/bigtable/authorized-views/update index f4d228a43..8e32f1155 100644 --- a/gcloud/beta/bigtable/authorized-views/update +++ b/gcloud/beta/bigtable/authorized-views/update @@ -12,25 +12,24 @@ DESCRIPTION (BETA) Update an existing Cloud Bigtable authorized view. EXAMPLES - To update the authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table', using the definition file - 'authorized_view.json': + To update the authorized view my-authorized-view in instance my-instance + and table my-table, using the definition file authorized_view.json: $ gcloud beta bigtable authorized-views update my-authorized-view \ --instance=test-instance --table=test-table \ --definition-file=authorized_view.json - To update the authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table', using the pre-encoded definition file - 'authorized_view_pre_encoded.json': + To update the authorized view my-authorized-view in instance my-instance + and table my-table, using the pre-encoded definition file + authorized_view_pre_encoded.json: $ gcloud beta bigtable authorized-views update my-authorized-view \ --instance=test-instance --table=test-table \ --definition-file=authorized_view_pre_encoded.json --pre-encoded - To update the authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table', using the definition file - 'authorized_view.json' and skip the prompt to proceed or cancel the update: + To update the authorized view my-authorized-view in instance my-instance + and table my-table, using the definition file authorized_view.json and skip + the prompt to proceed or cancel the update: $ gcloud beta bigtable authorized-views update my-authorized-view \ --instance=test-instance --table=test-table \ @@ -61,7 +60,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -69,7 +68,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a @@ -85,7 +84,7 @@ FLAGS Path to a JSON or YAML file containing a valid authorized view protobuf. - The 'name' field is ignored. The name is deduced from the other command + The name field is ignored. The name is deduced from the other command line arguments. Example: { "subsetView": { "rowPrefixes": ["store1"], "familySubsets": diff --git a/gcloud/beta/bigtable/backups/add-iam-policy-binding b/gcloud/beta/bigtable/backups/add-iam-policy-binding index 57210a50f..8928dbc77 100644 --- a/gcloud/beta/bigtable/backups/add-iam-policy-binding +++ b/gcloud/beta/bigtable/backups/add-iam-policy-binding @@ -14,25 +14,25 @@ DESCRIPTION consists of a member, a role, and an optional condition. EXAMPLES - To add an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with backup 'my-backup' in instance 'my-instance' and - cluster 'my-cluster', run: + To add an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with backup my-backup in instance my-instance and + cluster my-cluster, run: $ gcloud beta bigtable backups add-iam-policy-binding my-backup \ - --instance='my-instance' --cluster='my-cluster' \ - --member='user:test-user@gmail.com' --role='roles/editor' + --instance=`my-instance` --cluster=`my-cluster` \ + --member=`user:test-user@gmail.com` --role=`roles/editor` To add an IAM policy binding which expires at the end of the year 2020 for - the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' with - backup 'my-backup' in instance 'my-instance' and cluster 'my-cluster', run: + the role of roles/bigtable.admin and the user test-user@gmail.com with + backup my-backup in instance my-instance and cluster my-cluster, run: $ gcloud beta bigtable backups add-iam-policy-binding my-backup \ - --instance='my-instance' --cluster='my-cluster' \ - --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,descrip\ - tion=Expires at midnight on 2020-12-31' + --instance=`my-instance` --cluster=`my-cluster` \ + --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,\ + description=Expires at midnight on 2020-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -61,7 +61,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -69,7 +69,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/beta/bigtable/backups/create b/gcloud/beta/bigtable/backups/create index 864486953..464aa7521 100644 --- a/gcloud/beta/bigtable/backups/create +++ b/gcloud/beta/bigtable/backups/create @@ -14,30 +14,30 @@ DESCRIPTION (BETA) Creates a backup of a Cloud Bigtable table. EXAMPLES - To create a backup 'BACKUP_NAME' asyncronously from table 'TABLE_NAME' - which expires at '2019-03-30T10:49:41Z', run: + To create a backup BACKUP_NAME asyncronously from table TABLE_NAME which + expires at 2019-03-30T10:49:41Z, run: $ gcloud beta bigtable backups create BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ --table=TABLE_NAME --expiration-date=2019-03-30T10:49:41Z \ --async - To create a backup 'BACKUP_NAME' syncronously from table 'TABLE_NAME' which + To create a backup BACKUP_NAME syncronously from table TABLE_NAME which expires in 2 weeks from now, run: $ gcloud beta bigtable backups create BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ --table=TABLE_NAME --retention-period=2w - To create a hot backup 'BACKUP_NAME' from table 'TABLE_NAME' which expires - in 2 weeks from now, run: + To create a hot backup BACKUP_NAME from table TABLE_NAME which expires in 2 + weeks from now, run: $ gcloud beta bigtable backups create BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ --table=TABLE_NAME --retention-period=2w --backup-type=HOT - To create a hot backup 'BACKUP_NAME' from table 'TABLE_NAME' which will be - converted to a standard backup at '2019-03-31T10:49:41Z' and expires in 2 + To create a hot backup BACKUP_NAME from table TABLE_NAME which will be + converted to a standard backup at 2019-03-31T10:49:41Z and expires in 2 weeks from now, run: $ gcloud beta bigtable backups create BACKUP_NAME \ @@ -45,7 +45,7 @@ EXAMPLES --table=TABLE_NAME --retention-period=2w --backup-type=HOT \ --hot-to-standard-time=2019-03-31T10:49:41Z - To create a hot backup 'BACKUP_NAME' from table 'TABLE_NAME' which will be + To create a hot backup BACKUP_NAME from table TABLE_NAME which will be converted to a standard backup in 1 week from now and expires in 2 weeks from now, run: @@ -78,7 +78,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -86,7 +86,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/beta/bigtable/backups/delete b/gcloud/beta/bigtable/backups/delete index 557c72f6e..f37f3be2d 100644 --- a/gcloud/beta/bigtable/backups/delete +++ b/gcloud/beta/bigtable/backups/delete @@ -38,7 +38,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -46,7 +46,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/beta/bigtable/backups/describe b/gcloud/beta/bigtable/backups/describe index 67414ef80..5819bc450 100644 --- a/gcloud/beta/bigtable/backups/describe +++ b/gcloud/beta/bigtable/backups/describe @@ -39,7 +39,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -47,7 +47,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/beta/bigtable/backups/get-iam-policy b/gcloud/beta/bigtable/backups/get-iam-policy index c7d816a74..a9a5fc793 100644 --- a/gcloud/beta/bigtable/backups/get-iam-policy +++ b/gcloud/beta/bigtable/backups/get-iam-policy @@ -12,11 +12,11 @@ DESCRIPTION (BETA) Get an IAM policy on a Cloud Bigtable Backup. EXAMPLES - To get the IAM policy on the backup 'my-backup' in instance 'my-instance' - and cluster 'my-cluster', run: + To get the IAM policy on the backup my-backup in instance my-instance and + cluster my-cluster, run: $ gcloud beta bigtable backups get-iam-policy my-backup \ - --instance='my-instance' --cluster='my-cluster' + --instance=`my-instance` --cluster=`my-cluster` See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -45,7 +45,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -53,7 +53,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/beta/bigtable/backups/remove-iam-policy-binding b/gcloud/beta/bigtable/backups/remove-iam-policy-binding index dfc74f7b3..aeef3581a 100644 --- a/gcloud/beta/bigtable/backups/remove-iam-policy-binding +++ b/gcloud/beta/bigtable/backups/remove-iam-policy-binding @@ -14,26 +14,25 @@ DESCRIPTION binding consists of a member, a role, and an optional condition. EXAMPLES - To remove an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with backup 'my-backup' in instance 'my-instance' and - cluster 'my-cluster', run: + To remove an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with backup my-backup in instance my-instance and + cluster my-cluster, run: $ gcloud beta bigtable backups remove-iam-policy-binding my-backup \ - --instance='my-instance' --cluster='my-cluster' \ - --member='user:test-user@gmail.com' --role='roles/editor' + --instance=`my-instance` --cluster=`my-cluster` \ + --member=`user:test-user@gmail.com` --role=`roles/editor` To remove an IAM policy binding which expires at the end of the year 2020 - for the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' - with backup 'my-backup' in instance 'my-instance' and cluster 'my-cluster', - run: + for the role of roles/bigtable.admin and the user test-user@gmail.com with + backup my-backup in instance my-instance and cluster my-cluster, run: $ gcloud beta bigtable backups remove-iam-policy-binding my-backup \ - --instance='my-instance' --cluster='my-cluster' \ - --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,descrip\ - tion=Expires at midnight on 2020-12-31' + --instance=`my-instance` --cluster=`my-cluster` \ + --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,\ + description=Expires at midnight on 2020-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -62,7 +61,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -70,7 +69,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/beta/bigtable/backups/set-iam-policy b/gcloud/beta/bigtable/backups/set-iam-policy index 01664785f..c3eea8950 100644 --- a/gcloud/beta/bigtable/backups/set-iam-policy +++ b/gcloud/beta/bigtable/backups/set-iam-policy @@ -11,11 +11,11 @@ DESCRIPTION (BETA) Set an IAM policy on a Cloud Bigtable Backup. EXAMPLES - To set the IAM policy from file 'my-policy' on the backup 'my-backup' in - instance 'my-instance' and cluster 'my-cluster', run: + To set the IAM policy from file my-policy on the backup my-backup in + instance my-instance and cluster my-cluster, run: $ gcloud beta bigtable backups set-iam-policy my-backup \ - --instance='my-instance' --cluster='my-cluster' my-policy + --instance=`my-instance` --cluster=`my-cluster` my-policy See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -44,7 +44,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -52,7 +52,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/beta/bigtable/backups/update b/gcloud/beta/bigtable/backups/update index 3f3be7e37..184f23fa4 100644 --- a/gcloud/beta/bigtable/backups/update +++ b/gcloud/beta/bigtable/backups/update @@ -14,27 +14,27 @@ DESCRIPTION --expiration-date and --retention-period. EXAMPLES - To update the expire time of backup 'BACKUP_NAME' to 7 days from now, run: + To update the expire time of backup BACKUP_NAME to 7 days from now, run: $ gcloud beta bigtable backups update BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ --retention-period=7d - To update the hot-to-standard time of backup 'BACKUP_NAME' to - '2019-03-31T10:49:41Z', run: + To update the hot-to-standard time of backup BACKUP_NAME to + 2019-03-31T10:49:41Z, run: $ gcloud beta bigtable backups update BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ --hot-to-standard-time=2019-03-31T10:49:41Z - To update the hot-to-standard time of backup 'BACKUP_NAME' to 7 days from + To update the hot-to-standard time of backup BACKUP_NAME to 7 days from now, run: $ gcloud beta bigtable backups update BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ --hot-to-standard-time=+P7d - To clear the hot-to-standard time of backup 'BACKUP_NAME', run: + To clear the hot-to-standard time of backup BACKUP_NAME, run: $ gcloud beta bigtable backups update BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ @@ -64,7 +64,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -72,7 +72,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/beta/bigtable/instances/add-iam-policy-binding b/gcloud/beta/bigtable/instances/add-iam-policy-binding index 94ff36723..05b192845 100644 --- a/gcloud/beta/bigtable/instances/add-iam-policy-binding +++ b/gcloud/beta/bigtable/instances/add-iam-policy-binding @@ -13,23 +13,23 @@ DESCRIPTION consists of a member, a role, and an optional condition. EXAMPLES - To add an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with instance 'my-instance', run: + To add an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with instance my-instance, run: $ gcloud beta bigtable instances add-iam-policy-binding \ - my-instance --member='user:test-user@gmail.com' \ - --role='roles/editor' + my-instance --member=`user:test-user@gmail.com` \ + --role=`roles/editor` To add an IAM policy binding which expires at the end of the year 2018 for - the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' with - instance 'my-instance', run: + the role of roles/bigtable.admin and the user test-user@gmail.com with + instance my-instance, run: $ gcloud beta bigtable instances add-iam-policy-binding \ - my-instance --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2019-01-01T00:00:00Z"),title=expires_end_of_2018,descrip\ - tion=Expires at midnight on 2018-12-31' + my-instance --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2019-01-01T00:00:00Z"),title=expires_end_of_2018,\ + description=Expires at midnight on 2018-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. diff --git a/gcloud/beta/bigtable/instances/remove-iam-policy-binding b/gcloud/beta/bigtable/instances/remove-iam-policy-binding index f3a9b2cda..1e8527484 100644 --- a/gcloud/beta/bigtable/instances/remove-iam-policy-binding +++ b/gcloud/beta/bigtable/instances/remove-iam-policy-binding @@ -13,23 +13,23 @@ DESCRIPTION binding consists of a member, a role, and an optional condition. EXAMPLES - To remove an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with instance 'my-instance', run: + To remove an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with instance my-instance, run: $ gcloud beta bigtable instances remove-iam-policy-binding \ - my-instance --member='user:test-user@gmail.com' \ - --role='roles/editor' + my-instance --member=`user:test-user@gmail.com` \ + --role=`roles/editor` To remove an IAM policy binding which expires at the end of the year 2018 - for the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' - with instance 'my-instance', run: + for the role of roles/bigtable.admin and the user test-user@gmail.com with + instance my-instance, run: $ gcloud beta bigtable instances remove-iam-policy-binding \ - my-instance --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2019-01-01T00:00:00Z"),title=expires_end_of_2018,descrip\ - tion=Expires at midnight on 2018-12-31' + my-instance --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2019-01-01T00:00:00Z"),title=expires_end_of_2018,\ + description=Expires at midnight on 2018-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. diff --git a/gcloud/beta/bigtable/instances/tables/add-iam-policy-binding b/gcloud/beta/bigtable/instances/tables/add-iam-policy-binding index 9629899d2..99dfe0458 100644 --- a/gcloud/beta/bigtable/instances/tables/add-iam-policy-binding +++ b/gcloud/beta/bigtable/instances/tables/add-iam-policy-binding @@ -13,24 +13,24 @@ DESCRIPTION consists of a member, a role, and an optional condition. EXAMPLES - To add an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with table 'my-table' in instance 'my-instance', run: + To add an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with table my-table in instance my-instance, run: $ gcloud beta bigtable instances tables add-iam-policy-binding \ - my-table --instance='my-instance' \ - --member='user:test-user@gmail.com' --role='roles/editor' + my-table --instance=`my-instance` \ + --member=`user:test-user@gmail.com` --role=`roles/editor` To add an IAM policy binding which expires at the end of the year 2019 for - the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' with - table 'my-table' in instance 'my-instance', run: + the role of roles/bigtable.admin and the user test-user@gmail.com with + table my-table in instance my-instance, run: $ gcloud beta bigtable instances tables add-iam-policy-binding \ - my-table --instance='my-instance' \ - --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,descrip\ - tion=Expires at midnight on 2019-12-31' + my-table --instance=`my-instance` \ + --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,\ + description=Expires at midnight on 2019-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -59,7 +59,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/beta/bigtable/instances/tables/create b/gcloud/beta/bigtable/instances/tables/create index 34556d5da..3055d2c95 100644 --- a/gcloud/beta/bigtable/instances/tables/create +++ b/gcloud/beta/bigtable/instances/tables/create @@ -104,7 +104,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/beta/bigtable/instances/tables/delete b/gcloud/beta/bigtable/instances/tables/delete index 22597e8e0..d82d0bbbe 100644 --- a/gcloud/beta/bigtable/instances/tables/delete +++ b/gcloud/beta/bigtable/instances/tables/delete @@ -39,7 +39,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/beta/bigtable/instances/tables/describe b/gcloud/beta/bigtable/instances/tables/describe index dec1a9bf3..cd54f13ce 100644 --- a/gcloud/beta/bigtable/instances/tables/describe +++ b/gcloud/beta/bigtable/instances/tables/describe @@ -40,7 +40,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/beta/bigtable/instances/tables/get-iam-policy b/gcloud/beta/bigtable/instances/tables/get-iam-policy index e7c96695a..d7919c596 100644 --- a/gcloud/beta/bigtable/instances/tables/get-iam-policy +++ b/gcloud/beta/bigtable/instances/tables/get-iam-policy @@ -11,11 +11,10 @@ DESCRIPTION (BETA) Get an IAM policy on a Cloud Bigtable table. EXAMPLES - To get the IAM policy on the table 'my-table' in instance 'my-instance', - run: + To get the IAM policy on the table my-table in instance my-instance, run: $ gcloud beta bigtable instances tables get-iam-policy my-table \ - --instance='my-instance' + --instance=`my-instance` See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -44,7 +43,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/beta/bigtable/instances/tables/remove-iam-policy-binding b/gcloud/beta/bigtable/instances/tables/remove-iam-policy-binding index 5f1f39a78..f328da591 100644 --- a/gcloud/beta/bigtable/instances/tables/remove-iam-policy-binding +++ b/gcloud/beta/bigtable/instances/tables/remove-iam-policy-binding @@ -13,24 +13,24 @@ DESCRIPTION binding consists of a member, a role, and an optional condition. EXAMPLES - To remove an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with table 'my-table' in instance 'my-instance', run: + To remove an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with table my-table in instance my-instance, run: $ gcloud beta bigtable instances tables remove-iam-policy-binding \ - my-table --instance='my-instance' \ - --member='user:test-user@gmail.com' --role='roles/editor' + my-table --instance=`my-instance` \ + --member=`user:test-user@gmail.com` --role=`roles/editor` To remove an IAM policy binding which expires at the end of the year 2019 - for the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' - with table 'my-table' in instance 'my-instance', run: + for the role of roles/bigtable.admin and the user test-user@gmail.com with + table my-table in instance my-instance, run: $ gcloud beta bigtable instances tables remove-iam-policy-binding \ - my-table --instance='my-instance' \ - --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,descrip\ - tion=Expires at midnight on 2019-12-31' + my-table --instance=`my-instance` \ + --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,\ + description=Expires at midnight on 2019-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -59,7 +59,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/beta/bigtable/instances/tables/restore b/gcloud/beta/bigtable/instances/tables/restore index 629468f1a..55bd95466 100644 --- a/gcloud/beta/bigtable/instances/tables/restore +++ b/gcloud/beta/bigtable/instances/tables/restore @@ -54,7 +54,7 @@ REQUIRED FLAGS this group are specified. --destination-instance=DESTINATION_INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument --destination on the command line with a @@ -85,7 +85,7 @@ REQUIRED FLAGS this group are specified. --source-cluster=SOURCE_CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument --source on the command line with a fully @@ -93,7 +93,7 @@ REQUIRED FLAGS ▸ provide the argument --source-cluster on the command line. --source-instance=SOURCE_INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument --source on the command line with a fully diff --git a/gcloud/beta/bigtable/instances/tables/set-iam-policy b/gcloud/beta/bigtable/instances/tables/set-iam-policy index 803e1aede..aced46795 100644 --- a/gcloud/beta/bigtable/instances/tables/set-iam-policy +++ b/gcloud/beta/bigtable/instances/tables/set-iam-policy @@ -10,11 +10,11 @@ DESCRIPTION (BETA) Set an IAM policy on a Cloud Bigtable table. EXAMPLES - To set the IAM policy from file 'my-policy' on the table 'my-table' in - instance 'my-instance', run: + To set the IAM policy from file my-policy on the table my-table in instance + my-instance, run: $ gcloud beta bigtable instances tables set-iam-policy my-table \ - --instance='my-instance' my-policy + --instance=`my-instance` my-policy See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -43,7 +43,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/beta/bigtable/instances/tables/undelete b/gcloud/beta/bigtable/instances/tables/undelete index 59c60d3fd..15fdf38fd 100644 --- a/gcloud/beta/bigtable/instances/tables/undelete +++ b/gcloud/beta/bigtable/instances/tables/undelete @@ -39,7 +39,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/beta/bigtable/instances/tables/update b/gcloud/beta/bigtable/instances/tables/update index 4060788ac..db0ee6c33 100644 --- a/gcloud/beta/bigtable/instances/tables/update +++ b/gcloud/beta/bigtable/instances/tables/update @@ -82,7 +82,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/beta/bigtable/operations/describe b/gcloud/beta/bigtable/operations/describe index 505a076ec..6d70094c2 100644 --- a/gcloud/beta/bigtable/operations/describe +++ b/gcloud/beta/bigtable/operations/describe @@ -9,7 +9,7 @@ DESCRIPTION (BETA) Describe a Cloud Bigtable operation. EXAMPLES - To view details for operation 'OPERATION_ID', run: + To view details for operation OPERATION_ID, run: $ gcloud beta bigtable operations describe OPERATION_ID diff --git a/gcloud/beta/bigtable/tables/add-iam-policy-binding b/gcloud/beta/bigtable/tables/add-iam-policy-binding index 0a032cc02..589247209 100644 --- a/gcloud/beta/bigtable/tables/add-iam-policy-binding +++ b/gcloud/beta/bigtable/tables/add-iam-policy-binding @@ -13,23 +13,23 @@ DESCRIPTION consists of a member, a role, and an optional condition. EXAMPLES - To add an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with table 'my-table' in instance 'my-instance', run: + To add an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with table my-table in instance my-instance, run: $ gcloud beta bigtable tables add-iam-policy-binding my-table \ - --instance='my-instance' --member='user:test-user@gmail.com' \ - --role='roles/editor' + --instance=`my-instance` --member=`user:test-user@gmail.com` \ + --role=`roles/editor` To add an IAM policy binding which expires at the end of the year 2019 for - the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' with - table 'my-table' in instance 'my-instance', run: + the role of roles/bigtable.admin and the user test-user@gmail.com with + table my-table in instance my-instance, run: $ gcloud beta bigtable tables add-iam-policy-binding my-table \ - --instance='my-instance' --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,descrip\ - tion=Expires at midnight on 2019-12-31' + --instance=`my-instance` --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,\ + description=Expires at midnight on 2019-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -58,7 +58,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/beta/bigtable/tables/create b/gcloud/beta/bigtable/tables/create index b4b81832c..16ac3c230 100644 --- a/gcloud/beta/bigtable/tables/create +++ b/gcloud/beta/bigtable/tables/create @@ -103,7 +103,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/beta/bigtable/tables/delete b/gcloud/beta/bigtable/tables/delete index 8a8d0bd19..2cc5ca69f 100644 --- a/gcloud/beta/bigtable/tables/delete +++ b/gcloud/beta/bigtable/tables/delete @@ -37,7 +37,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/beta/bigtable/tables/describe b/gcloud/beta/bigtable/tables/describe index 6dcd87f7d..8c7e65578 100644 --- a/gcloud/beta/bigtable/tables/describe +++ b/gcloud/beta/bigtable/tables/describe @@ -38,7 +38,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/beta/bigtable/tables/get-iam-policy b/gcloud/beta/bigtable/tables/get-iam-policy index eb6ffa0e9..df2ac56d4 100644 --- a/gcloud/beta/bigtable/tables/get-iam-policy +++ b/gcloud/beta/bigtable/tables/get-iam-policy @@ -11,11 +11,10 @@ DESCRIPTION (BETA) Get an IAM policy on a Cloud Bigtable table. EXAMPLES - To get the IAM policy on the table 'my-table' in instance 'my-instance', - run: + To get the IAM policy on the table my-table in instance my-instance, run: $ gcloud beta bigtable tables get-iam-policy my-table \ - --instance='my-instance' + --instance=`my-instance` See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -44,7 +43,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/beta/bigtable/tables/remove-iam-policy-binding b/gcloud/beta/bigtable/tables/remove-iam-policy-binding index 1213bd542..986300927 100644 --- a/gcloud/beta/bigtable/tables/remove-iam-policy-binding +++ b/gcloud/beta/bigtable/tables/remove-iam-policy-binding @@ -13,23 +13,23 @@ DESCRIPTION binding consists of a member, a role, and an optional condition. EXAMPLES - To remove an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with table 'my-table' in instance 'my-instance', run: + To remove an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with table my-table in instance my-instance, run: $ gcloud beta bigtable tables remove-iam-policy-binding my-table \ - --instance='my-instance' --member='user:test-user@gmail.com' \ - --role='roles/editor' + --instance=`my-instance` --member=`user:test-user@gmail.com` \ + --role=`roles/editor` To remove an IAM policy binding which expires at the end of the year 2019 - for the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' - with table 'my-table' in instance 'my-instance', run: + for the role of roles/bigtable.admin and the user test-user@gmail.com with + table my-table in instance my-instance, run: $ gcloud beta bigtable tables remove-iam-policy-binding my-table \ - --instance='my-instance' --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,descrip\ - tion=Expires at midnight on 2019-12-31' + --instance=`my-instance` --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,\ + description=Expires at midnight on 2019-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -58,7 +58,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/beta/bigtable/tables/restore b/gcloud/beta/bigtable/tables/restore index 5f2a2c6fd..804a4afd7 100644 --- a/gcloud/beta/bigtable/tables/restore +++ b/gcloud/beta/bigtable/tables/restore @@ -53,7 +53,7 @@ REQUIRED FLAGS this group are specified. --destination-instance=DESTINATION_INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument --destination on the command line with a @@ -84,7 +84,7 @@ REQUIRED FLAGS this group are specified. --source-cluster=SOURCE_CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument --source on the command line with a fully @@ -92,7 +92,7 @@ REQUIRED FLAGS ▸ provide the argument --source-cluster on the command line. --source-instance=SOURCE_INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument --source on the command line with a fully diff --git a/gcloud/beta/bigtable/tables/set-iam-policy b/gcloud/beta/bigtable/tables/set-iam-policy index b07762f6c..8f2737acd 100644 --- a/gcloud/beta/bigtable/tables/set-iam-policy +++ b/gcloud/beta/bigtable/tables/set-iam-policy @@ -10,11 +10,11 @@ DESCRIPTION (BETA) Set an IAM policy on a Cloud Bigtable table. EXAMPLES - To set the IAM policy from file 'my-policy' on the table 'my-table' in - instance 'my-instance', run: + To set the IAM policy from file my-policy on the table my-table in instance + my-instance, run: $ gcloud beta bigtable tables set-iam-policy my-table \ - --instance='my-instance' my-policy + --instance=`my-instance` my-policy See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -43,7 +43,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/beta/bigtable/tables/undelete b/gcloud/beta/bigtable/tables/undelete index 3eb9da18a..642639833 100644 --- a/gcloud/beta/bigtable/tables/undelete +++ b/gcloud/beta/bigtable/tables/undelete @@ -39,7 +39,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/beta/bigtable/tables/update b/gcloud/beta/bigtable/tables/update index 14be37a6b..8ac6a0990 100644 --- a/gcloud/beta/bigtable/tables/update +++ b/gcloud/beta/bigtable/tables/update @@ -82,7 +82,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/beta/composer/environments/restart-web-server b/gcloud/beta/composer/environments/restart-web-server index 307547b8c..88bd3fac6 100644 --- a/gcloud/beta/composer/environments/restart-web-server +++ b/gcloud/beta/composer/environments/restart-web-server @@ -63,8 +63,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud composer environments restart-web-server $ gcloud alpha composer environments restart-web-server diff --git a/gcloud/beta/compute/interconnects/groups/create-members b/gcloud/beta/compute/interconnects/groups/create-members index 547335894..89ed80717 100644 --- a/gcloud/beta/compute/interconnects/groups/create-members +++ b/gcloud/beta/compute/interconnects/groups/create-members @@ -10,6 +10,7 @@ SYNOPSIS [--intent-mismatch-behavior=INTENT_MISMATCH_BEHAVIOR] [--interconnect-type=INTERCONNECT_TYPE] [--link-type=LINK_TYPE] [--noc-contact-email=NOC_CONTACT_EMAIL] + [--remote-location=REMOTE_LOCATION] [--requested-features=[FEATURES,...]] [--requested-link-count=REQUESTED_LINK_COUNT] [GCLOUD_WIDE_FLAG ...] @@ -102,6 +103,9 @@ OPTIONAL FLAGS Email address to contact the customer NOC for operations and maintenance notifications regarding this interconnect. + --remote-location=REMOTE_LOCATION + The location of the interconnect for Cross-Cloud Interconnect. + --requested-features=[FEATURES,...] List of features requested for this interconnect. FEATURES must be one of: diff --git a/gcloud/beta/compute/org-security-policies/rules/add-preconfig-waf-exclusion b/gcloud/beta/compute/org-security-policies/rules/add-preconfig-waf-exclusion new file mode 100644 index 000000000..ac676a135 --- /dev/null +++ b/gcloud/beta/compute/org-security-policies/rules/add-preconfig-waf-exclusion @@ -0,0 +1,146 @@ +NAME + gcloud beta compute org-security-policies rules add-preconfig-waf-exclusion + - add an exclusion configuration for preconfigured WAF evaluation into + a security policy rule + +SYNOPSIS + gcloud beta compute org-security-policies rules add-preconfig-waf-exclusion + PRIORITY --security-policy=SECURITY_POLICY + --target-rule-set=TARGET_RULE_SET [--organization=ORGANIZATION] + [--request-cookie-to-exclude=[op=OP],[val=VAL]] + [--request-header-to-exclude=[op=OP],[val=VAL]] + [--request-query-param-to-exclude=[op=OP],[val=VAL]] + [--request-uri-to-exclude=[op=OP],[val=VAL]] + [--target-rule-ids=[RULE_ID,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute org-security-policies rules + add-preconfig-waf-exclusion is used to add an exclusion configuration for + preconfigured WAF evaluation into a security policy rule. + + Note that request field exclusions are associated with a target, which can + be a single rule set, or a rule set plus a list of rule IDs under the rule + set. + +EXAMPLES + To add specific request field exclusions that are associated with the + target of 'sqli-stable': ['owasp-crs-v030001-id942110-sqli', + 'owasp-crs-v030001-id942120-sqli'], run: + + $ gcloud beta compute org-security-policies rules \ + add-preconfig-waf-exclusion 1000 --security-policy=1234567890 \ + --target-rule-set=sqli-stable \ + --target-rule-ids=owasp-crs-v030001-id942110-sqli,\ + owasp-crs-v030001-id942120-sqli \ + --request-header-to-exclude='op=EQUALS,val=abc' \ + --request-header-to-exclude='op=STARTS_WITH,val=xyz' \ + --request-uri-to-exclude='op=EQUALS_ANY' + + To add specific request field exclusions that are associated with the + target of 'sqli-stable': [], run: + + $ gcloud beta compute org-security-policies rules \ + add-preconfig-waf-exclusion 1000 --security-policy=1234567890 \ + --target-rule-set=sqli-stable \ + --request-cookie-to-exclude='op=EQUALS_ANY' + +POSITIONAL ARGUMENTS + PRIORITY + Priority of the security policy rule to add preconfig WAF exclusion. + +REQUIRED FLAGS + --security-policy=SECURITY_POLICY + short name of the security policy into which the rule should be + updated. + + --target-rule-set=TARGET_RULE_SET + Target WAF rule set where the request field exclusions being added + would apply. + + This, together with the target rule IDs (if given), determines the + target for associating request field exclusions. See --target-rule-ids. + +OPTIONAL FLAGS + --organization=ORGANIZATION + Organization which the organization security policy belongs to. Must be + set if SECURITY_POLICY is short name. + + --request-cookie-to-exclude=[op=OP],[val=VAL] + Adds a request cookie to the request field exclusions associated with + the rule set and rule IDs (if given). This specifies a request cookie + whose value will be excluded from inspection during preconfigured WAF + evaluation. + + You can specify an exact match or a partial match by using a field + operator and a field value. Available field operators are: + ◆ EQUALS: the operator matches if the field value equals the + specified value. + ◆ STARTS_WITH: the operator matches if the field value starts with + the specified value. + ◆ ENDS_WITH: the operator matches if the field value ends with the + specified value. + ◆ CONTAINS: the operator matches if the field value contains the + specified value. + ◆ EQUALS_ANY: the operator matches if the field value is any value. + + A field value must be given if the field operator is not EQUALS_ANY, + and cannot be given if the field operator is EQUALS_ANY. For example, + --request-header-to-exclude op=EQUALS,val=abc or + --request-header-to-exclude op=EQUALS_ANY. + + This flag can be repeated to specify multiple request headers to + exclude. For example, --request-header-to-exclude op=EQUALS,val=abc + --request-header-to-exclude op=STARTS_WITH,val=xyz. + + --request-header-to-exclude=[op=OP],[val=VAL] + Adds a request header to the request field exclusions associated with + the rule set and rule IDs (if given). This specifies a request header + whose value will be excluded from inspection during preconfigured WAF + evaluation. + + Refer to the syntax under --request-cookie-to-exclude. + + This flag can be repeated to specify multiple request headers. + + --request-query-param-to-exclude=[op=OP],[val=VAL] + Adds a request query parameter to the request field exclusions + associated with the rule set and rule IDs (if given). This specifies a + request query parameter in the query string or in the POST body whose + value will be excluded from inspection during preconfigured WAF + evaluation. + + Refer to the syntax under --request-cookie-to-exclude. + + This flag can be repeated to specify multiple request query parameters. + + --request-uri-to-exclude=[op=OP],[val=VAL] + Adds a request URI to the request field exclusions associated with the + rule set and rule IDs (if given). This specifies a request URI from the + request line to be excluded from inspection during preconfigured WAF + evaluation. + + Refer to the syntax under --request-cookie-to-exclude. + + This flag can be repeated to specify multiple request URIs. + + --target-rule-ids=[RULE_ID,...] + A comma-separated list of target rule IDs under the WAF rule set where + the request field exclusions being added would apply. If omitted, the + added request field exclusions will be associated with the rule set + only, which would apply to all the rule IDs under the rule set. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute org-security-policies rules \ + add-preconfig-waf-exclusion + diff --git a/gcloud/beta/compute/org-security-policies/rules/help b/gcloud/beta/compute/org-security-policies/rules/help index 14fe3a40c..142657b5c 100644 --- a/gcloud/beta/compute/org-security-policies/rules/help +++ b/gcloud/beta/compute/org-security-policies/rules/help @@ -18,6 +18,10 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + add-preconfig-waf-exclusion + (BETA) Add an exclusion configuration for preconfigured WAF evaluation + into a security policy rule. + create (BETA) Create a Compute Engine organizationsecurity policy rule. @@ -27,6 +31,10 @@ COMMANDS describe (BETA) Describe a Compute Engine organization security policy rule. + remove-preconfig-waf-exclusion + (BETA) Remove an exclusion configuration for preconfigured WAF + evaluation from a security policy rule. + update (BETA) Update a Compute Engine security policy rule. diff --git a/gcloud/beta/compute/org-security-policies/rules/remove-preconfig-waf-exclusion b/gcloud/beta/compute/org-security-policies/rules/remove-preconfig-waf-exclusion new file mode 100644 index 000000000..215861335 --- /dev/null +++ b/gcloud/beta/compute/org-security-policies/rules/remove-preconfig-waf-exclusion @@ -0,0 +1,165 @@ +NAME + gcloud beta compute org-security-policies rules + remove-preconfig-waf-exclusion - remove an exclusion configuration for + preconfigured WAF evaluation from a security policy rule + +SYNOPSIS + gcloud beta compute org-security-policies rules + remove-preconfig-waf-exclusion PRIORITY + --security-policy=SECURITY_POLICY --target-rule-set=TARGET_RULE_SET + [--organization=ORGANIZATION] + [--request-cookie-to-exclude=[op=OP],[val=VAL]] + [--request-header-to-exclude=[op=OP],[val=VAL]] + [--request-query-param-to-exclude=[op=OP],[val=VAL]] + [--request-uri-to-exclude=[op=OP],[val=VAL]] + [--target-rule-ids=[RULE_ID,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute org-security-policies rules + remove-preconfig-waf-exclusion is used to remove an exclusion configuration + for preconfigured WAF evaluation from a security policy rule. + + Note that request field exclusions are associated with a target, which can + be a single rule set, or a rule set plus a list of rule IDs under the rule + set. + + It is possible to remove request field exclusions at 3 levels: + ▪ Remove specific request field exclusions that are associated with a + matching target. + ▪ Remove all the request field exclusions that are associated with a + matching target. + ▪ Remove all the request field exclusions that are configured under the + security policy rule, regardless of the target. + +EXAMPLES + To remove specific request field exclusions that are associated with the + target of 'sqli-stable': ['owasp-crs-v030001-id942110-sqli', + 'owasp-crs-v030001-id942120-sqli'], run: + + $ gcloud beta compute org-security-policies rules \ + remove-preconfig-waf-exclusion 1000 \ + --security-policy=1234567890 --target-rule-set=sqli-stable \ + --target-rule-ids='owasp-crs-v030001-id942110-sqli',\ + 'owasp-crs-v030001-id942120-sqli' \ + --request-header-to-exclude='op=EQUALS,val=abc' \ + --request-header-to-exclude='op=STARTS_WITH,val=xyz' \ + --request-uri-to-exclude='op=EQUALS_ANY' + + To remove all the request field exclusions that are associated with the + target of 'sqli-stable': ['owasp-crs-v030001-id942110-sqli', + 'owasp-crs-v030001-id942120-sqli'], run: + + $ gcloud beta compute org-security-policies rules \ + remove-preconfig-waf-exclusion 1000 \ + --security-policy=1234567890 --target-rule-set=sqli-stable \ + --target-rule-ids='owasp-crs-v030001-id942110-sqli',\ + 'owasp-crs-v030001-id942120-sqli' + + To remove all the request field exclusions that are associated with the + target of 'sqli-stable': [], run: + + $ gcloud beta compute org-security-policies rules \ + remove-preconfig-waf-exclusion 1000 \ + --security-policy=1234567890 --target-rule-set=sqli-stable + + To remove all the request field exclusions that are configured under the + security policy rule, regardless of the target, run: + + $ gcloud beta compute org-security-policies rules \ + remove-preconfig-waf-exclusion 1000 \ + --security-policy=1234567890 --target-rule-set=* + +POSITIONAL ARGUMENTS + PRIORITY + Priority of the security policy rule to remove preconfig WAF exclusion. + +REQUIRED FLAGS + --security-policy=SECURITY_POLICY + short name of the security policy into which the rule should be + updated. + + --target-rule-set=TARGET_RULE_SET + Target WAF rule set from where to remove the request field exclusions. + + This, together with the target rule IDs (if given), determines the + target for associating request field exclusions. See --target-rule-ids. + + Note that the removal of request field exclusions is restricted to + those associated with a matching target. Set this flag to * if you want + to remove request field exclusions regardless of the target. + +OPTIONAL FLAGS + --organization=ORGANIZATION + Organization which the organization security policy belongs to. Must be + set if SECURITY_POLICY is short name. + + --request-cookie-to-exclude=[op=OP],[val=VAL] + Removes a request cookie from the existing request field exclusions + associated with the rule set and rule IDs (if given). + + You can specify an exact match or a partial match by using a field + operator and a field value. Available field operators are: + ◆ EQUALS: the operator matches if the field value equals the + specified value. + ◆ STARTS_WITH: the operator matches if the field value starts with + the specified value. + ◆ ENDS_WITH: the operator matches if the field value ends with the + specified value. + ◆ CONTAINS: the operator matches if the field value contains the + specified value. + ◆ EQUALS_ANY: the operator matches if the field value is any value. + + A field value must be given if the field operator is not EQUALS_ANY, + and cannot be given if the field operator is EQUALS_ANY. For example, + --request-header-to-exclude op=EQUALS,val=abc or + --request-header-to-exclude op=EQUALS_ANY. + + This flag can be repeated to specify multiple request headers to + exclude. For example, --request-header-to-exclude op=EQUALS,val=abc + --request-header-to-exclude op=STARTS_WITH,val=xyz. + + --request-header-to-exclude=[op=OP],[val=VAL] + Removes a request header from the existing request field exclusions + associated with the rule set and rule IDs (if given). + + Refer to the syntax under --request-cookie-to-exclude. + + This flag can be repeated to specify multiple request headers. + + --request-query-param-to-exclude=[op=OP],[val=VAL] + Removes a request query parameter from the existing request field + exclusions associated with the rule set and rule IDs (if given). + + Refer to the syntax under --request-cookie-to-exclude. + + This flag can be repeated to specify multiple request query parameters. + + --request-uri-to-exclude=[op=OP],[val=VAL] + Removes a request URI from the existing request field exclusions + associated with the rule set and rule IDs (if given). + + Refer to the syntax under --request-cookie-to-exclude. + + This flag can be repeated to specify multiple request URIs. + + --target-rule-ids=[RULE_ID,...] + A comma-separated list of target rule IDs under the WAF rule set from + where to remove the request field exclusions. If omitted, the removal + of request field exclusions is restricted to those associated with the + rule set only, without specific rule IDs. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute org-security-policies rules \ + remove-preconfig-waf-exclusion + diff --git a/gcloud/beta/compute/reservations/sub-blocks/describe b/gcloud/beta/compute/reservations/sub-blocks/describe index b82d2e3de..d157214fa 100644 --- a/gcloud/beta/compute/reservations/sub-blocks/describe +++ b/gcloud/beta/compute/reservations/sub-blocks/describe @@ -1,6 +1,6 @@ NAME gcloud beta compute reservations sub-blocks describe - describe a Compute - Engine reservation sub block + Engine reservation sub-block SYNOPSIS gcloud beta compute reservations sub-blocks describe RESERVATION @@ -8,11 +8,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Describe a Compute Engine reservation sub block. + (BETA) Describe a Compute Engine reservation sub-block. EXAMPLES - To describe a reservation sub block in reservation exr1 in my-zone with - block name my-block and sub block name my-sub-block, run: + To describe a reservation sub-block in reservation exr1 in my-zone with + block name my-block and sub-block name my-sub-block, run: $ gcloud beta compute reservations sub-blocks describe exr1 \ --zone=my-zone --block-name=my-block \ diff --git a/gcloud/beta/compute/reservations/sub-blocks/help b/gcloud/beta/compute/reservations/sub-blocks/help index cdfe21a1a..19e463ce8 100644 --- a/gcloud/beta/compute/reservations/sub-blocks/help +++ b/gcloud/beta/compute/reservations/sub-blocks/help @@ -17,10 +17,13 @@ COMMANDS COMMAND is one of the following: describe - (BETA) Describe a Compute Engine reservation sub block. + (BETA) Describe a Compute Engine reservation sub-block. list - (BETA) List Compute Engine reservation sub blocks. + (BETA) List Compute Engine reservation sub-blocks. + + perform-maintenance + (BETA) Perform maintenance on a reservation sub-block. NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/compute/reservations/sub-blocks/list b/gcloud/beta/compute/reservations/sub-blocks/list index 168d5096f..13d0927f4 100644 --- a/gcloud/beta/compute/reservations/sub-blocks/list +++ b/gcloud/beta/compute/reservations/sub-blocks/list @@ -1,6 +1,6 @@ NAME gcloud beta compute reservations sub-blocks list - list Compute Engine - reservation sub blocks + reservation sub-blocks SYNOPSIS gcloud beta compute reservations sub-blocks list RESERVATION @@ -10,10 +10,10 @@ SYNOPSIS DESCRIPTION (BETA) gcloud beta compute reservations sub-blocks list displays all - Compute Engine reservation sub blocks in an extended reservation's block. + Compute Engine reservation sub-blocks in an extended reservation's block. EXAMPLES - To list all reservation sub blocks in an extended reservation's block + To list all reservation sub-blocks in an extended reservation's block my-block in table form, run: $ gcloud beta compute reservations sub-blocks list \ diff --git a/gcloud/beta/compute/reservations/sub-blocks/perform-maintenance b/gcloud/beta/compute/reservations/sub-blocks/perform-maintenance new file mode 100644 index 000000000..33abeff8e --- /dev/null +++ b/gcloud/beta/compute/reservations/sub-blocks/perform-maintenance @@ -0,0 +1,69 @@ +NAME + gcloud beta compute reservations sub-blocks perform-maintenance - perform + maintenance on a reservation sub-block + +SYNOPSIS + gcloud beta compute reservations sub-blocks perform-maintenance RESERVATION + --block-name=BLOCK_NAME --sub-block-name=SUB_BLOCK_NAME [--zone=ZONE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Perform maintenance on a reservation sub-block. + +EXAMPLES + To perform maintenance on a reservation sub-block in reservation exr-1 in + ZONE with block name block-1 and sub-block name sub-block-1, run: + + $ gcloud beta compute reservations sub-blocks perform-maintenance \ + exr-1 --zone=ZONE --block-name=block-1 \ + --sub-block-name=sub-block-1 + +POSITIONAL ARGUMENTS + RESERVATION + Name of the reservation to perform-maintenance. + +REQUIRED FLAGS + --block-name=BLOCK_NAME + The name of the reservation block. + + --sub-block-name=SUB_BLOCK_NAME + The name of the reservation sub block. + +OPTIONAL FLAGS + --zone=ZONE + Zone of the reservation to perform-maintenance. If not specified and + the compute/zone property isn't set, you might be prompted to select a + zone (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute reservations sub-blocks perform-maintenance + + $ gcloud alpha compute reservations sub-blocks perform-maintenance + diff --git a/gcloud/beta/compute/storage-pools/create b/gcloud/beta/compute/storage-pools/create index 998f455bd..f0ddef2d0 100644 --- a/gcloud/beta/compute/storage-pools/create +++ b/gcloud/beta/compute/storage-pools/create @@ -101,7 +101,7 @@ OPTIONAL FLAGS Throughput in MB/s with which to provision the pool. --zone=ZONE - For resources [storage pool, storage pool type], provides fallback + For resources [storage-pool-type, storage_pool], provides fallback value for resource zone attribute. When the resource's full URI path is not provided, zone will fallback to this flag value. diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index 89a919855..3d67a2b26 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -31,7 +31,7 @@ SYNOPSIS [--disable-default-snat] [--disable-l4-lb-firewall-reconciliation] [--disable-pod-cidr-overprovision] [--disk-size=DISK_SIZE] [--disk-type=DISK_TYPE] - [--enable-authorized-networks-on-private-endpoint] + [--enable-authorized-networks-on-private-endpoint] [--enable-auto-ipam] [--enable-autorepair] [--no-enable-autoupgrade] [--enable-cilium-clusterwide-network-policy] [--enable-cloud-logging] [--enable-cloud-monitoring] [--enable-cloud-run-alpha] @@ -45,13 +45,13 @@ SYNOPSIS [--enable-ip-alias] [--enable-kubernetes-alpha] [--enable-kubernetes-unstable-apis=API,[API,...]] [--enable-l4-ilb-subsetting] [--enable-legacy-authorization] - [--enable-logging-monitoring-system-only] [--enable-managed-prometheus] - [--enable-master-global-access] [--enable-multi-networking] - [--enable-nested-virtualization] [--enable-network-policy] - [--enable-pod-security-policy] [--enable-ray-cluster-logging] - [--enable-ray-cluster-monitoring] [--enable-service-externalips] - [--enable-shielded-nodes] [--enable-stackdriver-kubernetes] - [--enable-vertical-pod-autoscaling] + [--enable-legacy-lustre-port] [--enable-logging-monitoring-system-only] + [--enable-managed-prometheus] [--enable-master-global-access] + [--enable-multi-networking] [--enable-nested-virtualization] + [--enable-network-policy] [--enable-pod-security-policy] + [--enable-ray-cluster-logging] [--enable-ray-cluster-monitoring] + [--enable-service-externalips] [--enable-shielded-nodes] + [--enable-stackdriver-kubernetes] [--enable-vertical-pod-autoscaling] [--fleet-project=PROJECT_ID_OR_NUMBER] [--gateway-api=GATEWAY_API] [--hpa-profile=HPA_PROFILE] [--identity-provider=IDENTITY_PROVIDER] [--image-type=IMAGE_TYPE] @@ -79,7 +79,7 @@ SYNOPSIS [--placement-policy=PLACEMENT_POLICY] [--placement-type=PLACEMENT_TYPE] [--preemptible] [--private-endpoint-subnetwork=NAME] [--private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE] - [--release-channel=[CHANNEL]] [--resource-manager-tags=[KEY=VALUE,...]] + [--release-channel=CHANNEL] [--resource-manager-tags=[KEY=VALUE,...]] [--security-group=SECURITY_GROUP] [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--spot] @@ -222,7 +222,8 @@ FLAGS ADDON must be one of: HttpLoadBalancing, HorizontalPodAutoscaling, KubernetesDashboard, NetworkPolicy, NodeLocalDNS, ConfigConnector, GcePersistentDiskCsiDriver, GcpFilestoreCsiDriver, BackupRestore, - GcsFuseCsiDriver, ParallelstoreCsiDriver, RayOperator, Istio, CloudRun. + GcsFuseCsiDriver, ParallelstoreCsiDriver, LustreCsiDriver, RayOperator, + Istio, CloudRun. --allow-route-overlap Allows the provided cluster CIDRs to overlap with existing routes that @@ -499,6 +500,10 @@ FLAGS Enable enforcement of --master-authorized-networks CIDR ranges for traffic reaching cluster's control plane via private IP. + --enable-auto-ipam + Enable the Auto IP Address Management (Auto IPAM) feature for the + cluster. + --enable-autorepair Enable node autorepair feature for a cluster's default node pool(s). @@ -662,6 +667,10 @@ FLAGS instead. For instructions, see https://cloud.google.com/kubernetes-engine/docs/how-to/routes-based-cluster + Note: For IPv6-only clusters, these flags are a no-op as IP Aliases do + not apply, and any specified IP address ranges for Pods and Services + will be ignored. + You can't specify both --enable-ip-alias and --no-enable-ip-alias. If you omit both --enable-ip-alias and --no-enable-ip-alias, the default is a VPC-native cluster. @@ -692,6 +701,12 @@ FLAGS permissions instead, create or update your cluster with the option --no-enable-legacy-authorization. + --enable-legacy-lustre-port + Allow the Lustre CSI driver to initialize LNet (the virtual network + layer for Lustre kernel module) using port 6988. This flag is required + to workaround a port conflict with the gke-metadata-server on GKE + nodes. + --enable-logging-monitoring-system-only (DEPRECATED) Enable Cloud Operations system-only monitoring and logging. @@ -1190,7 +1205,7 @@ FLAGS PRIVATE_IPV6_GOOGLE_ACCESS_TYPE must be one of: bidirectional, disabled, outbound-only. - --release-channel=[CHANNEL] + --release-channel=CHANNEL Release channel a cluster is subscribed to. If left unspecified and a version is specified, the cluster is enrolled @@ -1206,8 +1221,15 @@ FLAGS CHANNEL must be one of: - rapid + None + Use 'None' to opt-out of any release channel. + extended + Clusters subscribed to 'extended' can remain on a minor version for + 24 months from when the minor version is made available in the + Regular channel. + + rapid 'rapid' channel is offered on an early access basis for customers who want to test new releases. @@ -1215,28 +1237,15 @@ FLAGS to unresolved issues with no known workaround and are not subject to any SLAs. - regular - + regular Clusters subscribed to 'regular' receive versions that are considered GA quality. 'regular' is intended for production users who want to take advantage of new features. - extended - - Clusters subscribed to 'extended' can remain on a minor version for 24 months - from when the minor version is made available in the Regular channel. - - stable - + stable Clusters subscribed to 'stable' receive versions that are known to be stable and reliable in production. - None - - Use 'None' to opt-out of any release channel. - - CHANNEL must be one of: rapid, regular, extended, stable, None. - --resource-manager-tags=[KEY=VALUE,...] Applies the specified comma-separated resource manager tags that has the GCE_FIREWALL purpose to all nodes in the new default node pool(s) @@ -1327,7 +1336,7 @@ FLAGS VM instances. --stack-type=STACK_TYPE - IP stack type of the node VMs. STACK_TYPE must be one of: ipv4, + IP stack type of the cluster nodes. STACK_TYPE must be one of: ipv4, ipv4-ipv6. --storage-pools=STORAGE_POOL,[...] @@ -1403,6 +1412,8 @@ FLAGS 'fs.mqueue.*', and 'net.*', and sysctls under the groups.) singleProcessOomKill true or false + maxParallelImagePulls integer (The value must be + between [2, 5].) KEY VALUE policy either 'Static' or 'None' @@ -1439,6 +1450,8 @@ FLAGS net.ipv4.tcp_wmem Any positive integer tuple net.ipv4.tcp_tw_reuse Must be {0, 1, 2} + net.ipv4.tcp_max_orphans Must be between + [16384, 262144] net.netfilter.nf_conntrack_max Must be between [65536, 4194304] net.netfilter.nf_conntrack_buckets Must be between @@ -1464,9 +1477,40 @@ FLAGS [0, 184467440736927743 99] + fs.aio-max-nr Must be between + [65536, 4194304] + fs.file-max Must be between + [104857, 67108864] + fs.inotify.max_user_instances Must be between + [8192, 1048576] + fs.inotify.max_user_watches Must be between + [8192, 1048576] + fs.nr_open Must be between + [1048576, + 2147483584] + vm.dirty_background_ratio Must be between + [1, 100] + vm.dirty_expire_centisecs Must be between + [0, 6000] + vm.dirty_ratio Must be between + [1, 100] + vm.dirty_writeback_centisecs Must be between + [0, 1000] vm.max_map_count Must be between [65536, 2147483647] + vm.overcommit_memory Must be one of {0, + 1, 2} + vm.overcommit_ratio Must be between + [0, 100] + vm.vfs_cache_pressure Must be between + [0, 100] + vm.swappiness Must be between + [0, 200] + vm.watermark_scale_factor Must be between + [10, 3000] + vm.min_free_kbytes Must be between + [67584, 1048576] List of supported hugepage size in 'hugepageConfig'. @@ -1487,6 +1531,47 @@ FLAGS ◆ CGROUP_MODE_V2: Use cgroupv2 on the node pool. ◆ CGROUP_MODE_UNSPECIFIED: Use the default GKE cgroup configuration. + Supported values for 'transparentHugepageEnabled' under 'linuxConfig' + which controls transparent hugepage support for anonymous memory. + + ◆ TRANSPARENT_HUGEPAGE_ENABLED_ALWAYS: Transparent hugepage is + enabled system wide. + ◆ TRANSPARENT_HUGEPAGE_ENABLED_MADVISE: Transparent hugepage is + enabled inside MADV_HUGEPAGE regions. This is the default kernel + configuration. + ◆ TRANSPARENT_HUGEPAGE_ENABLED_NEVER: Transparent hugepage is + disabled. + ◆ TRANSPARENT_HUGEPAGE_ENABLED_UNSPECIFIED: Default value. GKE will + not modify the kernel configuration. + + Supported values for 'transparentHugepageDefrag' under 'linuxConfig' + which defines the transparent hugepage defrag configuration on the + node. + + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_ALWAYS: It means that an application + requesting THP will stall on allocation failure and directly reclaim + pages and compact memory in an effort to allocate a THP immediately. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_DEFER: It means that an application + will wake kswapd in the background to reclaim pages and wake + kcompactd to compact memory so that THP is available in the near + future. It is the responsibility of khugepaged to then install the + THP pages later. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_DEFER_WITH_MADVISE: It means that an + application will enter direct reclaim and compaction like always, but + only for regions that have used madvise(MADV_HUGEPAGE); all other + regions will wake kswapd in the background to reclaim pages and wake + kcompactd to compact memory so that THP is available in the near + future. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_MADVISE: It means that an application + will enter direct reclaim and compaction like always, but only for + regions that have used madvise(MADV_HUGEPAGE); all other regions will + wake kswapd in the background to reclaim pages and wake kcompactd to + compact memory so that THP is available in the near future. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_NEVER: It means that an application + will never enter direct reclaim or compaction. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_UNSPECIFIED: Default value. GKE will + not modify the kernel configuration. + Note, updating the system configuration of an existing node pool requires recreation of the nodes which which might cause a disruption. diff --git a/gcloud/beta/container/clusters/create-auto b/gcloud/beta/container/clusters/create-auto index 8c58b2e68..887de58cc 100644 --- a/gcloud/beta/container/clusters/create-auto +++ b/gcloud/beta/container/clusters/create-auto @@ -17,17 +17,19 @@ SYNOPSIS [--create-subnetwork=[KEY=VALUE,...]] [--database-encryption-key=DATABASE_ENCRYPTION_KEY] [--disable-l4-lb-firewall-reconciliation] - [--enable-authorized-networks-on-private-endpoint] + [--enable-authorized-networks-on-private-endpoint] [--enable-auto-ipam] [--enable-backup-restore] [--enable-cilium-clusterwide-network-policy] - [--enable-dns-access] [--enable-fleet] [--enable-google-cloud-access] - [--enable-ip-access] [--enable-kubernetes-unstable-apis=API,[API,...]] + [--enable-confidential-nodes] [--enable-dns-access] [--enable-fleet] + [--enable-google-cloud-access] [--enable-ip-access] + [--enable-kubernetes-unstable-apis=API,[API,...]] + [--enable-legacy-lustre-port] [--enable-lustre-csi-driver] [--enable-master-global-access] [--enable-multi-networking] [--enable-ray-cluster-logging] [--enable-ray-cluster-monitoring] [--enable-ray-operator] [--fleet-project=PROJECT_ID_OR_NUMBER] [--hpa-profile=HPA_PROFILE] [--labels=[KEY=VALUE,...]] [--logging=[COMPONENT,...]] [--monitoring=[COMPONENT,...]] [--network=NETWORK] [--private-endpoint-subnetwork=NAME] - [--release-channel=[CHANNEL]] [--security-group=SECURITY_GROUP] + [--release-channel=CHANNEL] [--security-group=SECURITY_GROUP] [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] [--subnetwork=SUBNETWORK] [--tier=TIER] [--workload-policies=WORKLOAD_POLICIES] @@ -261,6 +263,10 @@ FLAGS Enable enforcement of --master-authorized-networks CIDR ranges for traffic reaching cluster's control plane via private IP. + --enable-auto-ipam + Enable the Auto IP Address Management (Auto IPAM) feature for the + cluster. + --enable-backup-restore Enable the Backup for GKE add-on. This add-on is disabled by default. To learn more, see the Backup for GKE overview: @@ -270,6 +276,11 @@ FLAGS Enable Cilium Clusterwide Network Policies on the cluster. Disabled by default. + --enable-confidential-nodes + Enable confidential nodes for the cluster. Enabling Confidential Nodes + will create nodes using Confidential VM + https://cloud.google.com/compute/confidential-vm/docs/about-cvm. + --enable-dns-access Enable access to the cluster's control plane over DNS-based endpoint. @@ -295,6 +306,16 @@ FLAGS expected to be production ready and should be avoided in production-grade environments. + --enable-legacy-lustre-port + Allow the Lustre CSI driver to initialize LNet (the virtual network + layer for Lustre kernel module) using port 6988. This flag is required + to workaround a port conflict with the gke-metadata-server on GKE + nodes. + + --enable-lustre-csi-driver + Enable the Lustre CSI Driver GKE add-on. This add-on is disabled by + default. + --enable-master-global-access Use with private clusters to allow access to the master's private endpoint from any Google Cloud region or on-premises environment @@ -378,7 +399,7 @@ FLAGS Sets the subnetwork GKE uses to provision the control plane's private endpoint. - --release-channel=[CHANNEL] + --release-channel=CHANNEL Release channel a cluster is subscribed to. If left unspecified and a version is specified, the cluster is enrolled @@ -394,8 +415,12 @@ FLAGS CHANNEL must be one of: - rapid + extended + Clusters subscribed to 'extended' can remain on a minor version for + 24 months from when the minor version is made available in the + Regular channel. + rapid 'rapid' channel is offered on an early access basis for customers who want to test new releases. @@ -403,24 +428,15 @@ FLAGS to unresolved issues with no known workaround and are not subject to any SLAs. - regular - + regular Clusters subscribed to 'regular' receive versions that are considered GA quality. 'regular' is intended for production users who want to take advantage of new features. - extended - - Clusters subscribed to 'extended' can remain on a minor version for 24 months - from when the minor version is made available in the Regular channel. - - stable - + stable Clusters subscribed to 'stable' receive versions that are known to be stable and reliable in production. - CHANNEL must be one of: rapid, regular, extended, stable. - --security-group=SECURITY_GROUP The name of the RBAC security group for use with Google security groups in Kubernetes RBAC diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index ded164631..62f45cbf5 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -24,6 +24,7 @@ SYNOPSIS | --enable-intra-node-visibility | --enable-kubernetes-unstable-apis=API,[API,...] | --enable-l4-ilb-subsetting | --enable-legacy-authorization + | --enable-legacy-lustre-port | --enable-logging-monitoring-system-only | --enable-multi-networking | --enable-network-policy | --enable-pod-security-policy | --enable-private-nodes | --[no-]enable-ray-cluster-logging @@ -38,7 +39,7 @@ SYNOPSIS | --notification-config=[pubsub=ENABLED|DISABLED, pubsub-topic=TOPIC,...] | --patch-update=[PATCH_UPDATE] | --private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE - | --release-channel=[CHANNEL] | --remove-labels=[KEY,...] + | --release-channel=CHANNEL | --remove-labels=[KEY,...] | --remove-workload-policies=REMOVE_WORKLOAD_POLICIES | --security-group=SECURITY_GROUP | --security-posture=SECURITY_POSTURE | --set-password @@ -83,6 +84,7 @@ SYNOPSIS | --disable-dataplane-v2-flow-observability | --enable-dataplane-v2-flow-observability --disable-dataplane-v2-metrics | --enable-dataplane-v2-metrics + | --disable-auto-ipam | --enable-auto-ipam | --disable-l4-lb-firewall-reconciliation | --enable-l4-lb-firewall-reconciliation | --enable-authorized-networks-on-private-endpoint @@ -422,6 +424,12 @@ REQUIRED FLAGS use RBAC permissions instead, create or update your cluster with the option --no-enable-legacy-authorization. + --enable-legacy-lustre-port + Allow the Lustre CSI driver to initialize LNet (the virtual network + layer for Lustre kernel module) using port 6988. This flag is + required to workaround a port conflict with the gke-metadata-server + on GKE nodes. + --enable-logging-monitoring-system-only (DEPRECATED) Enable Cloud Operations system-only monitoring and logging. @@ -640,7 +648,7 @@ REQUIRED FLAGS PRIVATE_IPV6_GOOGLE_ACCESS_TYPE must be one of: bidirectional, disabled, outbound-only. - --release-channel=[CHANNEL] + --release-channel=CHANNEL Subscribe or unsubscribe this cluster to a release channel. When a cluster is subscribed to a release channel, Google maintains @@ -651,8 +659,15 @@ REQUIRED FLAGS CHANNEL must be one of: - rapid + None + Use 'None' to opt-out of any release channel. + extended + Clusters subscribed to 'extended' can remain on a minor version + for 24 months from when the minor version is made available in + the Regular channel. + + rapid 'rapid' channel is offered on an early access basis for customers who want to test new releases. @@ -660,27 +675,14 @@ REQUIRED FLAGS to unresolved issues with no known workaround and are not subject to any SLAs. - regular - + regular Clusters subscribed to 'regular' receive versions that are considered GA quality. 'regular' is intended for production users who want to take advantage of new features. - extended - - Clusters subscribed to 'extended' can remain on a minor version for 24 months - from when the minor version is made available in the Regular channel. - - stable - - Clusters subscribed to 'stable' receive versions that are known to - be stable and reliable in production. - - None - - Use 'None' to opt-out of any release channel. - - CHANNEL must be one of: rapid, regular, extended, stable, None. + stable + Clusters subscribed to 'stable' receive versions that are known + to be stable and reliable in production. --remove-labels=[KEY,...] Labels to remove from the Google Cloud resources in use by the @@ -735,7 +737,7 @@ REQUIRED FLAGS existing username. --stack-type=STACK_TYPE - IP stack type of the node VMs. STACK_TYPE must be one of: ipv4, + IP stack type of the cluster nodes. STACK_TYPE must be one of: ipv4, ipv4-ipv6. --start-credential-rotation @@ -1242,6 +1244,16 @@ REQUIRED FLAGS --enable-dataplane-v2-metrics Exposes advanced datapath flow metrics on node port. + At most one of these can be specified: + + --disable-auto-ipam + Disable the Auto IP Address Management (Auto IPAM) feature for the + cluster. + + --enable-auto-ipam + Enable the Auto IP Address Management (Auto IPAM) feature for the + cluster. + At most one of these can be specified: --disable-l4-lb-firewall-reconciliation diff --git a/gcloud/beta/container/fleet/config-management/disable b/gcloud/beta/container/fleet/config-management/disable index 789c563b5..57f24dd97 100644 --- a/gcloud/beta/container/fleet/config-management/disable +++ b/gcloud/beta/container/fleet/config-management/disable @@ -27,10 +27,9 @@ FLAGS At most one of these can be specified: --fleet-default-member-config - Disable fleet-default membership configuration - (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) - without disabling the feature. Does not change existing membership - configurations. Exits silently if the feature is not enabled. + Disable the fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features). + Does not change existing membership configurations. --force Disable this feature, even if it is currently in use. Force diff --git a/gcloud/beta/container/hub/config-management/disable b/gcloud/beta/container/hub/config-management/disable index b9370607e..3a05ab00e 100644 --- a/gcloud/beta/container/hub/config-management/disable +++ b/gcloud/beta/container/hub/config-management/disable @@ -27,10 +27,9 @@ FLAGS At most one of these can be specified: --fleet-default-member-config - Disable fleet-default membership configuration - (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) - without disabling the feature. Does not change existing membership - configurations. Exits silently if the feature is not enabled. + Disable the fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features). + Does not change existing membership configurations. --force Disable this feature, even if it is currently in use. Force diff --git a/gcloud/beta/container/node-pools/create b/gcloud/beta/container/node-pools/create index 3c1820911..9d8c6f728 100644 --- a/gcloud/beta/container/node-pools/create +++ b/gcloud/beta/container/node-pools/create @@ -51,6 +51,7 @@ SYNOPSIS [--sandbox=[type=TYPE]] [--secondary-boot-disk=[disk-image=DISK_IMAGE,[mode=MODE],...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] + [--sole-tenant-min-node-cpus=SOLE_TENANT_MIN_NODE_CPUS] [--sole-tenant-node-affinity-file=SOLE_TENANT_NODE_AFFINITY_FILE] [--spot] [--standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, @@ -689,6 +690,11 @@ FLAGS --shielded-secure-boot The instance will boot with secure boot enabled. + --sole-tenant-min-node-cpus=SOLE_TENANT_MIN_NODE_CPUS + A integer value that specifies the minimum number of vCPUs that each + sole tenant node must have to use CPU overcommit. If not specified, the + CPU overcommit feature is disabled. + --sole-tenant-node-affinity-file=SOLE_TENANT_NODE_AFFINITY_FILE JSON/YAML file containing the configuration of desired sole tenant nodes onto which this node pool could be backed by. These rules filter @@ -798,6 +804,8 @@ FLAGS 'fs.mqueue.*', and 'net.*', and sysctls under the groups.) singleProcessOomKill true or false + maxParallelImagePulls integer (The value must be + between [2, 5].) KEY VALUE policy either 'Static' or 'None' @@ -834,6 +842,8 @@ FLAGS net.ipv4.tcp_wmem Any positive integer tuple net.ipv4.tcp_tw_reuse Must be {0, 1, 2} + net.ipv4.tcp_max_orphans Must be between + [16384, 262144] net.netfilter.nf_conntrack_max Must be between [65536, 4194304] net.netfilter.nf_conntrack_buckets Must be between @@ -859,9 +869,40 @@ FLAGS [0, 184467440736927743 99] + fs.aio-max-nr Must be between + [65536, 4194304] + fs.file-max Must be between + [104857, 67108864] + fs.inotify.max_user_instances Must be between + [8192, 1048576] + fs.inotify.max_user_watches Must be between + [8192, 1048576] + fs.nr_open Must be between + [1048576, + 2147483584] + vm.dirty_background_ratio Must be between + [1, 100] + vm.dirty_expire_centisecs Must be between + [0, 6000] + vm.dirty_ratio Must be between + [1, 100] + vm.dirty_writeback_centisecs Must be between + [0, 1000] vm.max_map_count Must be between [65536, 2147483647] + vm.overcommit_memory Must be one of {0, + 1, 2} + vm.overcommit_ratio Must be between + [0, 100] + vm.vfs_cache_pressure Must be between + [0, 100] + vm.swappiness Must be between + [0, 200] + vm.watermark_scale_factor Must be between + [10, 3000] + vm.min_free_kbytes Must be between + [67584, 1048576] List of supported hugepage size in 'hugepageConfig'. @@ -882,6 +923,47 @@ FLAGS ◆ CGROUP_MODE_V2: Use cgroupv2 on the node pool. ◆ CGROUP_MODE_UNSPECIFIED: Use the default GKE cgroup configuration. + Supported values for 'transparentHugepageEnabled' under 'linuxConfig' + which controls transparent hugepage support for anonymous memory. + + ◆ TRANSPARENT_HUGEPAGE_ENABLED_ALWAYS: Transparent hugepage is + enabled system wide. + ◆ TRANSPARENT_HUGEPAGE_ENABLED_MADVISE: Transparent hugepage is + enabled inside MADV_HUGEPAGE regions. This is the default kernel + configuration. + ◆ TRANSPARENT_HUGEPAGE_ENABLED_NEVER: Transparent hugepage is + disabled. + ◆ TRANSPARENT_HUGEPAGE_ENABLED_UNSPECIFIED: Default value. GKE will + not modify the kernel configuration. + + Supported values for 'transparentHugepageDefrag' under 'linuxConfig' + which defines the transparent hugepage defrag configuration on the + node. + + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_ALWAYS: It means that an application + requesting THP will stall on allocation failure and directly reclaim + pages and compact memory in an effort to allocate a THP immediately. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_DEFER: It means that an application + will wake kswapd in the background to reclaim pages and wake + kcompactd to compact memory so that THP is available in the near + future. It is the responsibility of khugepaged to then install the + THP pages later. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_DEFER_WITH_MADVISE: It means that an + application will enter direct reclaim and compaction like always, but + only for regions that have used madvise(MADV_HUGEPAGE); all other + regions will wake kswapd in the background to reclaim pages and wake + kcompactd to compact memory so that THP is available in the near + future. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_MADVISE: It means that an application + will enter direct reclaim and compaction like always, but only for + regions that have used madvise(MADV_HUGEPAGE); all other regions will + wake kswapd in the background to reclaim pages and wake kcompactd to + compact memory so that THP is available in the near future. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_NEVER: It means that an application + will never enter direct reclaim or compaction. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_UNSPECIFIED: Default value. GKE will + not modify the kernel configuration. + Note, updating the system configuration of an existing node pool requires recreation of the nodes which which might cause a disruption. diff --git a/gcloud/beta/container/node-pools/update b/gcloud/beta/container/node-pools/update index 42152e312..28921303e 100644 --- a/gcloud/beta/container/node-pools/update +++ b/gcloud/beta/container/node-pools/update @@ -344,6 +344,8 @@ REQUIRED FLAGS 'fs.mqueue.*', and 'net.*', and sysctls under the groups.) singleProcessOomKill true or false + maxParallelImagePulls integer (The value must be + between [2, 5].) KEY VALUE policy either 'Static' or @@ -387,6 +389,8 @@ REQUIRED FLAGS integer tuple net.ipv4.tcp_tw_reuse Must be {0, 1, 2} + net.ipv4.tcp_max_orphans Must be between + [16384, 262144] net.netfilter.nf_conntrack_max Must be between [65536, 4194304] net.netfilter.nf_conntrack_buckets Must be between @@ -414,9 +418,41 @@ REQUIRED FLAGS [0, 1844674407369277 4399] + fs.aio-max-nr Must be between + [65536, 4194304] + fs.file-max Must be between + [104857, + 67108864] + fs.inotify.max_user_instances Must be between + [8192, 1048576] + fs.inotify.max_user_watches Must be between + [8192, 1048576] + fs.nr_open Must be between + [1048576, + 2147483584] + vm.dirty_background_ratio Must be between + [1, 100] + vm.dirty_expire_centisecs Must be between + [0, 6000] + vm.dirty_ratio Must be between + [1, 100] + vm.dirty_writeback_centisecs Must be between + [0, 1000] vm.max_map_count Must be between [65536, 2147483647] + vm.overcommit_memory Must be one of + {0, 1, 2} + vm.overcommit_ratio Must be between + [0, 100] + vm.vfs_cache_pressure Must be between + [0, 100] + vm.swappiness Must be between + [0, 200] + vm.watermark_scale_factor Must be between + [10, 3000] + vm.min_free_kbytes Must be between + [67584, 1048576] List of supported hugepage size in 'hugepageConfig'. @@ -438,6 +474,49 @@ REQUIRED FLAGS ▸ CGROUP_MODE_UNSPECIFIED: Use the default GKE cgroup configuration. + Supported values for 'transparentHugepageEnabled' under 'linuxConfig' + which controls transparent hugepage support for anonymous memory. + + ▸ TRANSPARENT_HUGEPAGE_ENABLED_ALWAYS: Transparent hugepage is + enabled system wide. + ▸ TRANSPARENT_HUGEPAGE_ENABLED_MADVISE: Transparent hugepage is + enabled inside MADV_HUGEPAGE regions. This is the default kernel + configuration. + ▸ TRANSPARENT_HUGEPAGE_ENABLED_NEVER: Transparent hugepage is + disabled. + ▸ TRANSPARENT_HUGEPAGE_ENABLED_UNSPECIFIED: Default value. GKE will + not modify the kernel configuration. + + Supported values for 'transparentHugepageDefrag' under 'linuxConfig' + which defines the transparent hugepage defrag configuration on the + node. + + ▸ TRANSPARENT_HUGEPAGE_DEFRAG_ALWAYS: It means that an application + requesting THP will stall on allocation failure and directly + reclaim pages and compact memory in an effort to allocate a THP + immediately. + ▸ TRANSPARENT_HUGEPAGE_DEFRAG_DEFER: It means that an application + will wake kswapd in the background to reclaim pages and wake + kcompactd to compact memory so that THP is available in the near + future. It is the responsibility of khugepaged to then install the + THP pages later. + ▸ TRANSPARENT_HUGEPAGE_DEFRAG_DEFER_WITH_MADVISE: It means that an + application will enter direct reclaim and compaction like always, + but only for regions that have used madvise(MADV_HUGEPAGE); all + other regions will wake kswapd in the background to reclaim pages + and wake kcompactd to compact memory so that THP is available in + the near future. + ▸ TRANSPARENT_HUGEPAGE_DEFRAG_MADVISE: It means that an application + will enter direct reclaim and compaction like always, but only for + regions that have used madvise(MADV_HUGEPAGE); all other regions + will wake kswapd in the background to reclaim pages and wake + kcompactd to compact memory so that THP is available in the near + future. + ▸ TRANSPARENT_HUGEPAGE_DEFRAG_NEVER: It means that an application + will never enter direct reclaim or compaction. + ▸ TRANSPARENT_HUGEPAGE_DEFRAG_UNSPECIFIED: Default value. GKE will + not modify the kernel configuration. + Note, updating the system configuration of an existing node pool requires recreation of the nodes which which might cause a disruption. diff --git a/gcloud/beta/container/vmware/admin-clusters/unenroll b/gcloud/beta/container/vmware/admin-clusters/unenroll index cfb71612c..dcd6dd4d1 100644 --- a/gcloud/beta/container/vmware/admin-clusters/unenroll +++ b/gcloud/beta/container/vmware/admin-clusters/unenroll @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud beta container vmware admin-clusters unenroll (ADMIN_CLUSTER : --location=LOCATION) [--allow-missing] [--async] - [--validate-only] [GCLOUD_WIDE_FLAG ...] + [--ignore-errors] [--validate-only] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Unenroll an Anthos on VMware admin cluster. @@ -59,6 +59,10 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --ignore-errors + If set, the unenrollment of a VMware admin cluster resource will + succeed even if errors occur during deletion. + --validate-only If set, only validate the request, but do not actually perform the operation. diff --git a/gcloud/beta/dataflow/flex-template/build b/gcloud/beta/dataflow/flex-template/build index 1c45ee13b..41238460d 100644 --- a/gcloud/beta/dataflow/flex-template/build +++ b/gcloud/beta/dataflow/flex-template/build @@ -90,11 +90,11 @@ REQUIRED FLAGS --flex-template-base-image=FLEX_TEMPLATE_BASE_IMAGE Flex template base image to be used while building the container - image. Allowed choices are JAVA8, JAVA11, JAVA17, JAVA21 or gcr.io - path of the specific version of the base image. For JAVA8, JAVA11, - JAVA17 and JAVA21 option, we use the latest base image version to - build the container. You can also provide a specific version from - this link https://gcr.io/dataflow-templates-base/ + image. Allowed choices are allowed labels (JAVA11, JAVA17, JAVA21, + PYTHON3, GO), or full gcr.io path of the specific version of the base + image. For labels, we use the latest base image version to build the + container. You can also provide a specific version from this link + https://gcr.io/dataflow-templates-base/ This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/beta/dataflow/jobs/archive b/gcloud/beta/dataflow/jobs/archive new file mode 100644 index 000000000..2bf9fb02a --- /dev/null +++ b/gcloud/beta/dataflow/jobs/archive @@ -0,0 +1,41 @@ +NAME + gcloud beta dataflow jobs archive - archives a job + +SYNOPSIS + gcloud beta dataflow jobs archive JOB_ID [--region=REGION_ID] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Archives a single job. The job must be in a terminal state, + otherwise the request will be rejected. + + This command will require confirmation to run. + +EXAMPLES + To archive job 2025-03-15_14_23_56-1234567890123456, run: + + $ gcloud beta dataflow jobs archive \ + 2025-03-15_14_23_56-1234567890123456 + +POSITIONAL ARGUMENTS + JOB_ID + Job ID to operate on. + +FLAGS + --region=REGION_ID + Region ID of the job's regional endpoint. Defaults to 'us-central1'. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud dataflow jobs archive + diff --git a/gcloud/beta/dataflow/jobs/help b/gcloud/beta/dataflow/jobs/help index b95036ddd..ba53888e0 100644 --- a/gcloud/beta/dataflow/jobs/help +++ b/gcloud/beta/dataflow/jobs/help @@ -16,6 +16,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + archive + (BETA) Archives a job. + cancel (BETA) Cancels all jobs that match the command line arguments. diff --git a/gcloud/beta/developer-connect/connections/create b/gcloud/beta/developer-connect/connections/create index c5f946365..6c7c05960 100644 --- a/gcloud/beta/developer-connect/connections/create +++ b/gcloud/beta/developer-connect/connections/create @@ -117,14 +117,20 @@ FLAGS --labels=path_to_file.(yaml|json) --location=LOCATION - For resources [connection, cryptoKey, service], provides fallback value + For resources [connection, + bitbucket-data-center-config-service-directory, + crypto-key-config-reference, + github-enterprise-config-service-directory, + gitlab-enterprise-config-service-directory], provides fallback value for resource location attribute. When the resource's full URI path is not provided, location will fallback to this flag value. --namespace=NAMESPACE - For resources [service], provides fallback value for resource namespace - attribute. When the resource's full URI path is not provided, namespace - will fallback to this flag value. + For resources [bitbucket-data-center-config-service-directory, + github-enterprise-config-service-directory, + gitlab-enterprise-config-service-directory], provides fallback value + for resource namespace attribute. When the resource's full URI path is + not provided, namespace will fallback to this flag value. --request-id=REQUEST_ID An optional request ID to identify requests. Specify a unique request @@ -142,9 +148,24 @@ FLAGS is not supported (00000000-0000-0000-0000-000000000000). --secret=SECRET - For resources [secretVersion], provides fallback value for resource - secret attribute. When the resource's full URI path is not provided, - secret will fallback to this flag value. + For resources + [bitbucket-cloud-config-authorizer-credential-user-token-secret-version, + bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version, + bitbucket-cloud-config-webhook-secret-version, + bitbucket-data-center-config-authorizer-credential-user-token-secret-version, + bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version, + bitbucket-data-center-config-webhook-secret-version, + github-config-authorizer-credential-oauth-token-secret-version, + github-enterprise-config-private-key-secret-version, + github-enterprise-config-webhook-secret-version, + gitlab-config-authorizer-credential-user-token-secret-version, + gitlab-config-read-authorizer-credential-user-token-secret-version, + gitlab-config-webhook-secret-version, + gitlab-enterprise-config-authorizer-credential-user-token-secret-version, + gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version, + gitlab-enterprise-config-webhook-secret-version], provides fallback + value for resource secret attribute. When the resource's full URI path + is not provided, secret will fallback to this flag value. --validate-only If set, validate the request, but do not actually post it. diff --git a/gcloud/beta/developer-connect/connections/update b/gcloud/beta/developer-connect/connections/update index d55d7996d..9581b2571 100644 --- a/gcloud/beta/developer-connect/connections/update +++ b/gcloud/beta/developer-connect/connections/update @@ -81,14 +81,20 @@ FLAGS client has an up-to-date value before proceeding. --location=LOCATION - For resources [connection, cryptoKey, service], provides fallback value + For resources [connection, + bitbucket-data-center-config-service-directory, + crypto-key-config-reference, + github-enterprise-config-service-directory, + gitlab-enterprise-config-service-directory], provides fallback value for resource location attribute. When the resource's full URI path is not provided, location will fallback to this flag value. --namespace=NAMESPACE - For resources [service], provides fallback value for resource namespace - attribute. When the resource's full URI path is not provided, namespace - will fallback to this flag value. + For resources [bitbucket-data-center-config-service-directory, + github-enterprise-config-service-directory, + gitlab-enterprise-config-service-directory], provides fallback value + for resource namespace attribute. When the resource's full URI path is + not provided, namespace will fallback to this flag value. --request-id=REQUEST_ID An optional request ID to identify requests. Specify a unique request @@ -106,9 +112,21 @@ FLAGS is not supported (00000000-0000-0000-0000-000000000000). --secret=SECRET - For resources [secretVersion], provides fallback value for resource - secret attribute. When the resource's full URI path is not provided, - secret will fallback to this flag value. + For resources + [bitbucket-cloud-config-authorizer-credential-user-token-secret-version, + bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version, + bitbucket-data-center-config-authorizer-credential-user-token-secret-version, + bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version, + github-config-authorizer-credential-oauth-token-secret-version, + github-enterprise-config-private-key-secret-version, + github-enterprise-config-webhook-secret-version, + gitlab-config-authorizer-credential-user-token-secret-version, + gitlab-config-read-authorizer-credential-user-token-secret-version, + gitlab-enterprise-config-authorizer-credential-user-token-secret-version, + gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version], + provides fallback value for resource secret attribute. When the + resource's full URI path is not provided, secret will fallback to this + flag value. --[no-]validate-only If set, validate the request, but do not actually post it. Use diff --git a/gcloud/beta/firestore/databases/create b/gcloud/beta/firestore/databases/create index 483687861..15a4cbab9 100644 --- a/gcloud/beta/firestore/databases/create +++ b/gcloud/beta/firestore/databases/create @@ -6,8 +6,8 @@ SYNOPSIS gcloud beta firestore databases create --location=LOCATION [--database=DATABASE; default="(default)"] [--delete-protection] [--edition=EDITION; default="standard"] [--enable-pitr] - [--kms-key-name=KMS_KEY_NAME] [--type=TYPE; default="firestore-native"] - [GCLOUD_WIDE_FLAG ...] + [--kms-key-name=KMS_KEY_NAME] [--tags=[KEY=VALUE,...]] + [--type=TYPE; default="firestore-native"] [GCLOUD_WIDE_FLAG ...] EXAMPLES To create a Firestore Enterprise database named foo in nam5 for use with @@ -20,6 +20,11 @@ EXAMPLES $ gcloud beta firestore databases create --location=nam5 + To create a Firestore Native database in us-central1 with tags. + + $ gcloud beta firestore databases create --location=us-central1 \ + --tags=key1=value1,key2=value2 + To create a Datastore Mode database in us-east1. $ gcloud beta firestore databases create --location=us-east1 \ @@ -106,6 +111,14 @@ OPTIONAL FLAGS How to retrieve this resource ID is listed at https://cloud.google.com/kms/docs/getting-resource-ids#getting_the_id_for_a_key_and_version. + --tags=[KEY=VALUE,...] + Tags to attach to the destination database. Example: + --tags=key1=value1,key2=value2 + + For example, to attach tags to a database: + + $ --tags=key1=value1,key2=value2 + --type=TYPE; default="firestore-native" The type of the database. TYPE must be one of: firestore-native, datastore-mode. diff --git a/gcloud/beta/firestore/databases/restore b/gcloud/beta/firestore/databases/restore index f3a6c64fd..2ff9bb45f 100644 --- a/gcloud/beta/firestore/databases/restore +++ b/gcloud/beta/firestore/databases/restore @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud beta firestore databases restore --destination-database=DESTINATION_DATABASE - --source-backup=SOURCE_BACKUP + --source-backup=SOURCE_BACKUP [--tags=[KEY=VALUE,...]] [--encryption-type=ENCRYPTION_TYPE : --kms-key-name=KMS_KEY_NAME] [GCLOUD_WIDE_FLAG ...] @@ -16,6 +16,13 @@ EXAMPLES --source-backup=projects/PROJECT_ID/locations/LOCATION_ID/\ backups/BACKUP_ID --destination-database=DATABASE_ID + To restore a database from a backup with tags. + + $ gcloud beta firestore databases restore \ + --source-backup=projects/PROJECT_ID/locations/LOCATION_ID/\ + backups/BACKUP_ID --destination-database=DATABASE_ID \ + --tags=key1=value1,key2=value2 + To restore to a CMEK-enabled database. $ gcloud beta firestore databases restore \ @@ -32,8 +39,7 @@ REQUIRED FLAGS This value should be 4-63 characters. Valid characters are /[a-z][0-9]-/ with first character a letter and the last a letter or a - number. Must not be UUID-like - /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. + number. Must not be UUID-like /[0-9a-f]8(-[0-9a-f]4)3-[0-9a-f]12/. Using "(default)" database ID is also allowed. @@ -53,6 +59,14 @@ REQUIRED FLAGS cf9f748a-7980-4703-b1a1-d1ffff591db0 OPTIONAL FLAGS + --tags=[KEY=VALUE,...] + Tags to attach to the destination database. Example: + --tags=key1=value1,key2=value2 + + For example, to attach tags to a database: + + $ --tags=key1=value1,key2=value2 + The encryption configuration of the new database being created from the backup. If not specified, the same encryption settings as the backup will be used. diff --git a/gcloud/beta/iam/workforce-pools/providers/create-oidc b/gcloud/beta/iam/workforce-pools/providers/create-oidc index ca39e2d7a..2175e7f66 100644 --- a/gcloud/beta/iam/workforce-pools/providers/create-oidc +++ b/gcloud/beta/iam/workforce-pools/providers/create-oidc @@ -31,7 +31,7 @@ EXAMPLES --workforce-pool="my-workforce-pool" --location="global" \ --display-name="My Workforce Pool Provider" \ --description="My workforce pool provider description." \ - --disabled --detailed_audit_logging \ + --disabled --detailed-audit-logging \ --attribute-mapping="google.subject=assertion.sub" \ --attribute-condition="true" --client-id="client-id" \ --client-secret-value="client-secret" \ diff --git a/gcloud/beta/iam/workforce-pools/providers/update-oidc b/gcloud/beta/iam/workforce-pools/providers/update-oidc index 78264c09b..0d676347f 100644 --- a/gcloud/beta/iam/workforce-pools/providers/update-oidc +++ b/gcloud/beta/iam/workforce-pools/providers/update-oidc @@ -32,7 +32,7 @@ EXAMPLES --workforce-pool="my-workforce-pool" --location="global" \ --display-name="My Workforce Pool Provider" \ --description="My workforce pool provider description." \ - --disabled --detailed_audit_logging \ + --disabled --detailed-audit-logging \ --attribute-mapping="google.subject=assertion.sub" \ --attribute-condition="true" --client-id="client-id" \ --client-secret-value="client-secret" \ diff --git a/gcloud/beta/iap/help b/gcloud/beta/iap/help index d5a93b716..5f17a5149 100644 --- a/gcloud/beta/iap/help +++ b/gcloud/beta/iap/help @@ -23,10 +23,10 @@ GROUPS GROUP is one of the following: oauth-brands - (BETA) Manage IAP OAuth brands. + (BETA) (DEPRECATED) Manage IAP OAuth brands. oauth-clients - (BETA) Manage IAP OAuth clients. + (BETA) (DEPRECATED) Manage IAP OAuth clients. settings (BETA) Manage IAP settings. diff --git a/gcloud/beta/iap/oauth-brands/create b/gcloud/beta/iap/oauth-brands/create index e0587043f..38b14430a 100644 --- a/gcloud/beta/iap/oauth-brands/create +++ b/gcloud/beta/iap/oauth-brands/create @@ -7,8 +7,10 @@ SYNOPSIS --support_email=SUPPORT_EMAIL [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta iap oauth-brands create is used to create a Cloud OAuth - brand for the project. The brand is 'internal only', meaning OAuth clients + (BETA) (DEPRECATED) This command is deprecated. + + gcloud beta iap oauth-brands create is used to create a Cloud OAuth brand + for the project. The brand is 'internal only', meaning OAuth clients created under it only accept requests from users who belong to the same G Suite account as the project. The brand is created in unreviewed status. Your domain will not appear on the OAuth consent screen until it is diff --git a/gcloud/beta/iap/oauth-brands/describe b/gcloud/beta/iap/oauth-brands/describe index 32752a3de..c4ca34079 100644 --- a/gcloud/beta/iap/oauth-brands/describe +++ b/gcloud/beta/iap/oauth-brands/describe @@ -5,8 +5,10 @@ SYNOPSIS gcloud beta iap oauth-brands describe NAME [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta iap oauth-brands describe is used to describe a Cloud - OAuth brand. + (BETA) (DEPRECATED) This command is deprecated. + + gcloud beta iap oauth-brands describe is used to describe a Cloud OAuth + brand. EXAMPLES To describe a Cloud OAuth brand with name NAME, run: diff --git a/gcloud/beta/iap/oauth-brands/help b/gcloud/beta/iap/oauth-brands/help index 7b64bc29e..b941be7cb 100644 --- a/gcloud/beta/iap/oauth-brands/help +++ b/gcloud/beta/iap/oauth-brands/help @@ -5,7 +5,9 @@ SYNOPSIS gcloud beta iap oauth-brands COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Manage IAP OAuth brands. + (BETA) (DEPRECATED) Manage IAP OAuth brands. + + This command is deprecated. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -16,13 +18,13 @@ COMMANDS COMMAND is one of the following: create - (BETA) Create a Cloud OAuth brand for the project. + (BETA) (DEPRECATED) Create a Cloud OAuth brand for the project. describe - (BETA) Describe a Cloud OAuth brand. + (BETA) (DEPRECATED) Describe a Cloud OAuth brand. list - (BETA) List Cloud OAuth brands in the project. + (BETA) (DEPRECATED) List Cloud OAuth brands in the project. NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/iap/oauth-brands/list b/gcloud/beta/iap/oauth-brands/list index c977a2a37..b970baadb 100644 --- a/gcloud/beta/iap/oauth-brands/list +++ b/gcloud/beta/iap/oauth-brands/list @@ -6,8 +6,10 @@ SYNOPSIS [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta iap oauth-brands list is used to list the Cloud OAuth - brand in the project. + (BETA) (DEPRECATED) This command is deprecated. + + gcloud beta iap oauth-brands list is used to list the Cloud OAuth brand in + the project. EXAMPLES To list all Cloud OAuth brands in the current project, run: diff --git a/gcloud/beta/iap/oauth-clients/create b/gcloud/beta/iap/oauth-clients/create index 975c71d57..0979d58cf 100644 --- a/gcloud/beta/iap/oauth-clients/create +++ b/gcloud/beta/iap/oauth-clients/create @@ -7,10 +7,12 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta iap oauth-clients create is used to create an OAuth - client in the project to be used by Cloud IAP. To call this command, the - Cloud OAuth brand for the project must exist and be set for 'internal - only'. The new client is owned by Cloud IAP. + (BETA) (DEPRECATED) This command is deprecated. + + gcloud beta iap oauth-clients create is used to create an OAuth client in + the project to be used by Cloud IAP. To call this command, the Cloud OAuth + brand for the project must exist and be set for 'internal only'. The new + client is owned by Cloud IAP. EXAMPLES To create a Cloud IAP OAuth client for the current project, run: diff --git a/gcloud/beta/iap/oauth-clients/delete b/gcloud/beta/iap/oauth-clients/delete index 483dc8773..3687ebd29 100644 --- a/gcloud/beta/iap/oauth-clients/delete +++ b/gcloud/beta/iap/oauth-clients/delete @@ -6,9 +6,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta iap oauth-clients delete is used to delete a Cloud IAP - OAuth client. Note this command cannot be used to delete any other type of - OAuth client in your project. + (BETA) (DEPRECATED) This command is deprecated. + + gcloud beta iap oauth-clients delete is used to delete a Cloud IAP OAuth + client. Note this command cannot be used to delete any other type of OAuth + client in your project. EXAMPLES To delete a Cloud IAP OAuth client named CLIENT for the current project and diff --git a/gcloud/beta/iap/oauth-clients/describe b/gcloud/beta/iap/oauth-clients/describe index f52c43515..34514faee 100644 --- a/gcloud/beta/iap/oauth-clients/describe +++ b/gcloud/beta/iap/oauth-clients/describe @@ -6,9 +6,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta iap oauth-clients describe is used to describe a Cloud - IAP OAuth client. Note this command cannot be used to describe any other - type of OAuth client in your project. + (BETA) (DEPRECATED) This command is deprecated. + + gcloud beta iap oauth-clients describe is used to describe a Cloud IAP + OAuth client. Note this command cannot be used to describe any other type + of OAuth client in your project. EXAMPLES To describe a Cloud IAP OAuth client for the current project, run: diff --git a/gcloud/beta/iap/oauth-clients/help b/gcloud/beta/iap/oauth-clients/help index 0f68777eb..9848685d1 100644 --- a/gcloud/beta/iap/oauth-clients/help +++ b/gcloud/beta/iap/oauth-clients/help @@ -5,9 +5,13 @@ SYNOPSIS gcloud beta iap oauth-clients COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Manage OAuth clients that are used by Cloud Identity-Aware Proxy. - Note this API cannot be used as a generic management API for all OAuth - clients in your project. + (BETA) (DEPRECATED) Manage IAP OAuth clients. + + This command is deprecated. + + Manage OAuth clients that are used by Cloud Identity-Aware Proxy. Note this + API cannot be used as a generic management API for all OAuth clients in + your project. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,19 +22,20 @@ COMMANDS COMMAND is one of the following: create - (BETA) Create a Cloud IAP OAuth client in the project. + (BETA) (DEPRECATED) Create a Cloud IAP OAuth client in the project. delete - (BETA) Delete a Cloud IAP OAuth client. + (BETA) (DEPRECATED) Delete a Cloud IAP OAuth client. describe - (BETA) Describe a Cloud IAP OAuth client. + (BETA) (DEPRECATED) Describe a Cloud IAP OAuth client. list - (BETA) List Cloud IAP OAuth clients in the Cloud OAuth brand. + (BETA) (DEPRECATED) List Cloud IAP OAuth clients in the Cloud OAuth + brand. reset-secret - (BETA) Reset a Cloud IAP OAuth client secret. + (BETA) (DEPRECATED) Reset a Cloud IAP OAuth client secret. NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/iap/oauth-clients/list b/gcloud/beta/iap/oauth-clients/list index 8422cc0f4..1dc46ceee 100644 --- a/gcloud/beta/iap/oauth-clients/list +++ b/gcloud/beta/iap/oauth-clients/list @@ -8,9 +8,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta iap oauth-clients list is used to list Cloud IAP OAuth - clients in a Cloud OAuth brand. Note this command will not list any other - type of OAuth client in your project. + (BETA) (DEPRECATED) This command is deprecated. + + gcloud beta iap oauth-clients list is used to list Cloud IAP OAuth clients + in a Cloud OAuth brand. Note this command will not list any other type of + OAuth client in your project. EXAMPLES To list the Cloud IAP OAuth clients for the current project, run: diff --git a/gcloud/beta/iap/oauth-clients/reset-secret b/gcloud/beta/iap/oauth-clients/reset-secret index 68737b19b..a585908da 100644 --- a/gcloud/beta/iap/oauth-clients/reset-secret +++ b/gcloud/beta/iap/oauth-clients/reset-secret @@ -7,9 +7,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta iap oauth-clients reset-secret is used to reset a Cloud - IAP OAuth client secret. Note this command cannot be used to reset the - secret for any other type of OAuth client in your project. + (BETA) (DEPRECATED) This command is deprecated. + + gcloud beta iap oauth-clients reset-secret is used to reset a Cloud IAP + OAuth client secret. Note this command cannot be used to reset the secret + for any other type of OAuth client in your project. EXAMPLES To reset a Cloud IAP OAuth client secret, run: diff --git a/gcloud/beta/memorystore/instances/create b/gcloud/beta/memorystore/instances/create index de880a85c..f64a1ffac 100644 --- a/gcloud/beta/memorystore/instances/create +++ b/gcloud/beta/memorystore/instances/create @@ -14,6 +14,7 @@ SYNOPSIS [--psc-auto-connections=[network=NETWORK], [port=PORT],[projectId=PROJECTID]] [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] + [--simulate-maintenance-event] [--transit-encryption-mode=TRANSIT_ENCRYPTION_MODE] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC --persistence-config-mode=PERSISTENCE_CONFIG_MODE @@ -191,9 +192,9 @@ FLAGS --labels=path_to_file.(yaml|json) --location=LOCATION - For resources [instance, cryptoKey], provides fallback value for - resource location attribute. When the resource's full URI path is not - provided, location will fallback to this flag value. + For resources [instance, kms-key, primary-instance], provides fallback + value for resource location attribute. When the resource's full URI + path is not provided, location will fallback to this flag value. Maintenance policy per instance. @@ -319,6 +320,11 @@ FLAGS --shard-count=SHARD_COUNT Number of shards for the instance. + Arguments for the simulate maintenance event. + + --simulate-maintenance-event + Simulate a maintenance event. + --transit-encryption-mode=TRANSIT_ENCRYPTION_MODE In-transit encryption mode of the instance. TRANSIT_ENCRYPTION_MODE must be one of: diff --git a/gcloud/beta/memorystore/instances/update b/gcloud/beta/memorystore/instances/update index 941855d0e..d056a059e 100644 --- a/gcloud/beta/memorystore/instances/update +++ b/gcloud/beta/memorystore/instances/update @@ -9,6 +9,7 @@ SYNOPSIS [--location=LOCATION] [--mode=MODE] [--node-type=NODE_TYPE] [--[no-]ondemand-maintenance] [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] + [--[no-]simulate-maintenance-event] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC --clear-persistence-config --persistence-config-mode=PERSISTENCE_CONFIG_MODE @@ -106,9 +107,9 @@ FLAGS Engine version of the instance. --location=LOCATION - For resources [instance, cryptoKey], provides fallback value for - resource location attribute. When the resource's full URI path is not - provided, location will fallback to this flag value. + For resources [instance, kms-key, primary-instance], provides fallback + value for resource location attribute. When the resource's full URI + path is not provided, location will fallback to this flag value. --mode=MODE The mode config for the instance. MODE must be one of: @@ -163,6 +164,12 @@ FLAGS --shard-count=SHARD_COUNT Number of shards for the instance. + Arguments for the simulate maintenance event. + + --[no-]simulate-maintenance-event + Simulate a maintenance event. Use --simulate-maintenance-event to + enable and --no-simulate-maintenance-event to disable. + Represents persistence configuration for a instance. Configuration for AOF based persistence. diff --git a/gcloud/beta/model-armor/floorsettings/describe b/gcloud/beta/model-armor/floorsettings/describe new file mode 100644 index 000000000..cdda9e750 --- /dev/null +++ b/gcloud/beta/model-armor/floorsettings/describe @@ -0,0 +1,31 @@ +NAME + gcloud beta model-armor floorsettings describe - describe the FloorSetting + resource + +SYNOPSIS + gcloud beta model-armor floorsettings describe [--full-uri=FULL_URI] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Displays the floor setting resource with the given name. + +FLAGS + --full-uri=FULL_URI + Full uri of the floor setting + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud model-armor floorsettings describe + + $ gcloud alpha model-armor floorsettings describe + diff --git a/gcloud/beta/model-armor/floorsettings/help b/gcloud/beta/model-armor/floorsettings/help new file mode 100644 index 000000000..461dea2fc --- /dev/null +++ b/gcloud/beta/model-armor/floorsettings/help @@ -0,0 +1,31 @@ +NAME + gcloud beta model-armor floorsettings - manage FloorSettings resources + +SYNOPSIS + gcloud beta model-armor floorsettings COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage FloorSettings resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (BETA) Describe the FloorSetting resource. + + update + (BETA) Update the FloorSetting resource. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud model-armor floorsettings + + $ gcloud alpha model-armor floorsettings + diff --git a/gcloud/beta/model-armor/floorsettings/update b/gcloud/beta/model-armor/floorsettings/update new file mode 100644 index 000000000..fe5bf2a5c --- /dev/null +++ b/gcloud/beta/model-armor/floorsettings/update @@ -0,0 +1,127 @@ +NAME + gcloud beta model-armor floorsettings update - update the FloorSetting + resource + +SYNOPSIS + gcloud beta model-armor floorsettings update --full-uri=FULL_URI + [--enable-floor-setting-enforcement=ENABLE_FLOOR_SETTING_ENFORCEMENT] + [--malicious-uri-filter-settings-enforcement=MALICIOUS_URI_FILTER_SETTINGS_ENFORCEMENT] + [--add-rai-settings-filters=confidenceLevel=CONFIDENCELEVEL], + [filterType=FILTERTYPE] | --clear-rai-settings-filters + | --rai-settings-filters=confidenceLevel=CONFIDENCELEVEL], + [filterType=FILTERTYPE] + | --remove-rai-settings-filters=confidenceLevel=CONFIDENCELEVEL], + [filterType=FILTERTYPE]] + [--advanced-config-deidentify-template=ADVANCED_CONFIG_DEIDENTIFY_TEMPLATE --advanced-config-inspect-template=ADVANCED_CONFIG_INSPECT_TEMPLATE --basic-config-filter-enforcement=BASIC_CONFIG_FILTER_ENFORCEMENT] + [--pi-and-jailbreak-filter-settings-confidence-level=PI_AND_JAILBREAK_FILTER_SETTINGS_CONFIDENCE_LEVEL --pi-and-jailbreak-filter-settings-enforcement=PI_AND_JAILBREAK_FILTER_SETTINGS_ENFORCEMENT] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Updates the floor setting resource with the given name. + +REQUIRED FLAGS + --full-uri=FULL_URI + Full uri of the floor setting + +OPTIONAL FLAGS + --enable-floor-setting-enforcement=ENABLE_FLOOR_SETTING_ENFORCEMENT + Enable or disable the floor setting enforcement + + Malicious uri filter settings. + + --malicious-uri-filter-settings-enforcement=MALICIOUS_URI_FILTER_SETTINGS_ENFORCEMENT + Malicious URI filter settings. + + RAI filter settings. + + At most one of these can be specified: + + --add-rai-settings-filters=confidenceLevel=CONFIDENCELEVEL],[filterType=FILTERTYPE] + Add rai filter settings. Sets add_rai_settings_filters value. + + Shorthand Example: + + --add-rai-settings-filters=string,string + + JSON Example: + + --add-rai-settings-filters=["string"] + + File Example: + + --add-rai-settings-filters=path_to_file.(yaml|json) + + --clear-rai-settings-filters + Clear all rai filter settings. + + --rai-settings-filters=confidenceLevel=CONFIDENCELEVEL],[filterType=FILTERTYPE] + Set rai_settings_filters to new value. List of Responsible AI filters + enabled for floor setting. Sets rai_settings_filters value. + + Shorthand Example: + + --rai-settings-filters=string,string + + JSON Example: + + --rai-settings-filters=["string"] + + File Example: + + --rai-settings-filters=path_to_file.(yaml|json) + + --remove-rai-settings-filters=confidenceLevel=CONFIDENCELEVEL],[filterType=FILTERTYPE] + Remove rai filter settings. Sets remove_rai_settings_filters value. + + Shorthand Example: + + --remove-rai-settings-filters=string,string + + JSON Example: + + --remove-rai-settings-filters=["string"] + + File Example: + + --remove-rai-settings-filters=path_to_file.(yaml|json) + + SDP filter settings. + + --advanced-config-deidentify-template=ADVANCED_CONFIG_DEIDENTIFY_TEMPLATE + The sdp filter settings enforcement. The value can be either "enable" + or "disable". + + --advanced-config-inspect-template=ADVANCED_CONFIG_INSPECT_TEMPLATE + The sdp filter settings enforcement. The value can be either "enable" + or "disable". + + --basic-config-filter-enforcement=BASIC_CONFIG_FILTER_ENFORCEMENT + The sdp filter settings enforcement. The value can be either + "ENABLED" or "DISABLED" + + PI and jailbreak filter settings. + + --pi-and-jailbreak-filter-settings-confidence-level=PI_AND_JAILBREAK_FILTER_SETTINGS_CONFIDENCE_LEVEL + The pi and jailbreak filter settings confidence level. The value can + be either "high", "medium-and-above" or "low-and-above" + + --pi-and-jailbreak-filter-settings-enforcement=PI_AND_JAILBREAK_FILTER_SETTINGS_ENFORCEMENT + The pi and jailbreak filter settings enforcement. The value can be + either "enable" or "disable". + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud model-armor floorsettings update + + $ gcloud alpha model-armor floorsettings update + diff --git a/gcloud/beta/model-armor/help b/gcloud/beta/model-armor/help index 856f56502..3b717a99e 100644 --- a/gcloud/beta/model-armor/help +++ b/gcloud/beta/model-armor/help @@ -19,6 +19,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + floorsettings + (BETA) Manage FloorSettings resources. + templates (BETA) Manage Template resources. diff --git a/gcloud/beta/netapp/volumes/create b/gcloud/beta/netapp/volumes/create index 74c2b39d2..2c8747f61 100644 --- a/gcloud/beta/netapp/volumes/create +++ b/gcloud/beta/netapp/volumes/create @@ -34,7 +34,7 @@ SYNOPSIS [--snap-reserve=SNAP_RESERVE] [--snapshot-daily=[hour=HOUR], [minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] - [--snapshot-directory=SNAPSHOT_DIRECTORY; default="true"] + [--snapshot-directory=SNAPSHOT_DIRECTORY] [--snapshot-hourly=[minute=MINUTE], [snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--snapshot-monthly=[day=DAY], @@ -249,7 +249,7 @@ OPTIONAL FLAGS --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] Make a snapshot every day e.g. at 06:00, 05:20, 23:50 - --snapshot-directory=SNAPSHOT_DIRECTORY; default="true" + --snapshot-directory=SNAPSHOT_DIRECTORY Snapshot Directory if enabled (true) makes the Volume contain a read-only .snapshot directory which provides access to each of the volume's snapshots diff --git a/gcloud/beta/netapp/volumes/help b/gcloud/beta/netapp/volumes/help index 02064c54e..3c1c643cd 100644 --- a/gcloud/beta/netapp/volumes/help +++ b/gcloud/beta/netapp/volumes/help @@ -39,6 +39,9 @@ COMMANDS list (BETA) List Cloud NetApp Volumes. + restore-backup-files + (BETA) Restore specific files from a backup to a Volume. + revert (BETA) Revert a Cloud NetApp Volume back to a specified Snapshot. diff --git a/gcloud/beta/netapp/volumes/restore-backup-files b/gcloud/beta/netapp/volumes/restore-backup-files new file mode 100644 index 000000000..c7b1f9d4f --- /dev/null +++ b/gcloud/beta/netapp/volumes/restore-backup-files @@ -0,0 +1,119 @@ +NAME + gcloud beta netapp volumes restore-backup-files - restore specific files + from a backup to a Volume + +SYNOPSIS + gcloud beta netapp volumes restore-backup-files + (VOLUME : --location=LOCATION) --file-list=FILE_LIST,[FILE_LIST,...] + --restore-destination-path=RESTORE_DESTINATION_PATH + (--backup=BACKUP : --backup_vault=BACKUP_VAULT) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Restore specific files from a backup to a Volume + +EXAMPLES + The following command restores file1.txt and file2.txt from the given + backup to a Volume named NAME to the directory + /path/to/destination/directory. + + $ gcloud beta netapp volumes restore-backup-files NAME \ + --location=us-central1 --backup=backup-1 \ + --file-list=file1.txt,file2.txt \ + --restore-destination-path=/path/to/destination/directory + +POSITIONAL ARGUMENTS + Volume resource - The Volume to restore into. 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; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + 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 argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the volume. + + To set the location attribute: + ▸ provide the argument volume on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +REQUIRED FLAGS + --file-list=FILE_LIST,[FILE_LIST,...] + List of files to be restored in the form of their absolute path as in + source volume. + + --restore-destination-path=RESTORE_DESTINATION_PATH + Name of the absolute directory path in the destination volume.. + + Backup resource - The Backup from which files are restored back to the + 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 --backup on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --backup on the command line with a fully + specified name; + ◆ set the property netapp/location. + + This must be specified. + + --backup=BACKUP + ID of the backup or fully qualified identifier for the backup. + + To set the backup attribute: + ▸ provide the argument --backup on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --backup_vault=BACKUP_VAULT + The Backup Vault of the backup. + + To set the backup_vault attribute: + ▸ provide the argument --backup on the command line with a fully + specified name; + ▸ provide the argument --backup_vault on the command line; + ▸ provide the argument --backup-vault on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp volumes restore-backup-files + diff --git a/gcloud/beta/netapp/volumes/update b/gcloud/beta/netapp/volumes/update index de90f63e4..204ada226 100644 --- a/gcloud/beta/netapp/volumes/update +++ b/gcloud/beta/netapp/volumes/update @@ -24,7 +24,7 @@ SYNOPSIS [--snap-reserve=SNAP_RESERVE] [--snapshot-daily=[hour=HOUR], [minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] - [--snapshot-directory=SNAPSHOT_DIRECTORY; default="true"] + [--snapshot-directory=SNAPSHOT_DIRECTORY] [--snapshot-hourly=[minute=MINUTE], [snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--snapshot-monthly=[day=DAY], @@ -158,7 +158,7 @@ FLAGS --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] Make a snapshot every day e.g. at 06:00, 05:20, 23:50 - --snapshot-directory=SNAPSHOT_DIRECTORY; default="true" + --snapshot-directory=SNAPSHOT_DIRECTORY Snapshot Directory if enabled (true) makes the Volume contain a read-only .snapshot directory which provides access to each of the volume's snapshots diff --git a/gcloud/beta/network-connectivity/hubs/accept-spoke b/gcloud/beta/network-connectivity/hubs/accept-spoke index ac2c77d9b..5ca262776 100644 --- a/gcloud/beta/network-connectivity/hubs/accept-spoke +++ b/gcloud/beta/network-connectivity/hubs/accept-spoke @@ -15,8 +15,8 @@ EXAMPLES To accept a spoke named my-spoke into a hub named my-hub, run: $ gcloud beta network-connectivity hubs accept-spoke my-hub \ - --spoke="https://www.googleapis.com/networkconnectivity/v1/proje\ - cts/spoke-project/locations/global/hubs/my-spoke" + --spoke="https://networkconnectivity.googleapis.com/v1/projects/\ + spoke-project/locations/global/spokes/my-spoke" POSITIONAL ARGUMENTS Hub resource - Name of the hub to accept the spoke into. This represents a diff --git a/gcloud/beta/network-connectivity/hubs/reject-spoke b/gcloud/beta/network-connectivity/hubs/reject-spoke index e9ff98d7e..f06dd684e 100644 --- a/gcloud/beta/network-connectivity/hubs/reject-spoke +++ b/gcloud/beta/network-connectivity/hubs/reject-spoke @@ -16,9 +16,8 @@ EXAMPLES my-reason, run: $ gcloud beta network-connectivity hubs reject-spoke my-hub \ - --spoke="https://www.googleapis.com/networkconnectivity/v1/proje\ - cts/spoke-project/locations/global/hubs/my-spoke" \ - --details=my-reason + --spoke="https://networkconnectivity.googleapis.com/v1/projects/\ + spoke-project/locations/global/spokes/my-spoke" --details=my-reason POSITIONAL ARGUMENTS Hub resource - Name of the hub to reject the spoke from. This represents a diff --git a/gcloud/beta/redis/clusters/update b/gcloud/beta/redis/clusters/update index 47b09db17..9b50dd390 100644 --- a/gcloud/beta/redis/clusters/update +++ b/gcloud/beta/redis/clusters/update @@ -8,12 +8,12 @@ SYNOPSIS [--automated-backup-mode=AUTOMATED_BACKUP_MODE] [--automated-backup-start-time=AUTOMATED_BACKUP_START_TIME] [--automated-backup-ttl=AUTOMATED_BACKUP_TTL] [--deletion-protection] - [--node-type=NODE_TYPE] [--ondemand-maintenance] - [--persistence-mode=PERSISTENCE_MODE] + [--node-type=NODE_TYPE] [--persistence-mode=PERSISTENCE_MODE] [--rdb-snapshot-period=RDB_SNAPSHOT_PERIOD] [--rdb-snapshot-start-time=RDB_SNAPSHOT_START_TIME] [--remove-redis-config=[KEY,...]] [--replica-count=REPLICA_COUNT] - [--shard-count=SHARD_COUNT] [--update-redis-config=KEY=VALUE] + [--shard-count=SHARD_COUNT] [--simulate-maintenance-event] + [--update-redis-config=KEY=VALUE] [--maintenance-window-any | --maintenance-window-day=MAINTENANCE_WINDOW_DAY --maintenance-window-hour=MAINTENANCE_WINDOW_HOUR] @@ -112,9 +112,6 @@ FLAGS redis-highmem-medium, redis-highmem-xlarge, redis-shared-core-nano, redis-standard-small. - --ondemand-maintenance - Trigger an on-demand maintenance. - --persistence-mode=PERSISTENCE_MODE Operation mode for persistence. PERSISTENCE_MODE must be one of: @@ -153,6 +150,9 @@ FLAGS --shard-count=SHARD_COUNT The shard count of the cluster. + --simulate-maintenance-event + Trigger a simulation for maintenance event. + --update-redis-config=KEY=VALUE A list of Redis Cluster config KEY=VALUE pairs to update. If a config parameter is already set, its value is modified; otherwise a new Redis diff --git a/gcloud/beta/run/jobs/create b/gcloud/beta/run/jobs/create index 99b08ac85..e905841a5 100644 --- a/gcloud/beta/run/jobs/create +++ b/gcloud/beta/run/jobs/create @@ -4,9 +4,10 @@ NAME SYNOPSIS gcloud beta run jobs create [JOB] [--binary-authorization=POLICY] [--breakglass=JUSTIFICATION] [--container=CONTAINER] - [--gpu-type=GPU_TYPE] [--key=KEY] [--labels=[KEY=VALUE,...]] - [--max-retries=MAX_RETRIES] [--parallelism=PARALLELISM] - [--region=REGION] [--service-account=SERVICE_ACCOUNT] + [--gpu-type=GPU_TYPE] [--[no-]gpu-zonal-redundancy] [--key=KEY] + [--labels=[KEY=VALUE,...]] [--max-retries=MAX_RETRIES] + [--parallelism=PARALLELISM] [--region=REGION] + [--service-account=SERVICE_ACCOUNT] [--set-cloudsql-instances=[CLOUDSQL-INSTANCES,...]] [--task-timeout=TASK_TIMEOUT] [--tasks=TASKS; default=1] [--vpc-connector=VPC_CONNECTOR] [--vpc-egress=VPC_EGRESS] @@ -82,6 +83,10 @@ FLAGS --gpu-type=GPU_TYPE The GPU type to use. + --[no-]gpu-zonal-redundancy + Set GPU zonal redundancy. Use --gpu-zonal-redundancy to enable and + --no-gpu-zonal-redundancy to disable. + --key=KEY CMEK key reference to encrypt the container with. diff --git a/gcloud/beta/run/jobs/deploy b/gcloud/beta/run/jobs/deploy index 95c8055fe..22e614fb7 100644 --- a/gcloud/beta/run/jobs/deploy +++ b/gcloud/beta/run/jobs/deploy @@ -4,9 +4,10 @@ NAME SYNOPSIS gcloud beta run jobs deploy [JOB] [--binary-authorization=POLICY] [--breakglass=JUSTIFICATION] [--container=CONTAINER] - [--gpu-type=GPU_TYPE] [--key=KEY] [--labels=[KEY=VALUE,...]] - [--max-retries=MAX_RETRIES] [--parallelism=PARALLELISM] - [--region=REGION] [--remove-containers=[CONTAINER,...]] + [--gpu-type=GPU_TYPE] [--[no-]gpu-zonal-redundancy] [--key=KEY] + [--labels=[KEY=VALUE,...]] [--max-retries=MAX_RETRIES] + [--parallelism=PARALLELISM] [--region=REGION] + [--remove-containers=[CONTAINER,...]] [--service-account=SERVICE_ACCOUNT] [--set-cloudsql-instances=[CLOUDSQL-INSTANCES,...]] [--task-timeout=TASK_TIMEOUT] [--tasks=TASKS; default=1] @@ -83,6 +84,10 @@ FLAGS --gpu-type=GPU_TYPE The GPU type to use. + --[no-]gpu-zonal-redundancy + Set GPU zonal redundancy. Use --gpu-zonal-redundancy to enable and + --no-gpu-zonal-redundancy to disable. + --key=KEY CMEK key reference to encrypt the container with. diff --git a/gcloud/beta/run/jobs/update b/gcloud/beta/run/jobs/update index ef8afd65b..0ae310f5e 100644 --- a/gcloud/beta/run/jobs/update +++ b/gcloud/beta/run/jobs/update @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud beta run jobs update [JOB] [--breakglass=JUSTIFICATION] [--clear-vpc-connector] [--container=CONTAINER] [--gpu-type=GPU_TYPE] - [--key=KEY] [--max-retries=MAX_RETRIES] [--parallelism=PARALLELISM] - [--region=REGION] [--remove-containers=[CONTAINER,...]] + [--[no-]gpu-zonal-redundancy] [--key=KEY] [--max-retries=MAX_RETRIES] + [--parallelism=PARALLELISM] [--region=REGION] + [--remove-containers=[CONTAINER,...]] [--service-account=SERVICE_ACCOUNT] [--task-timeout=TASK_TIMEOUT] [--tasks=TASKS; default=1] [--vpc-connector=VPC_CONNECTOR] [--vpc-egress=VPC_EGRESS] @@ -83,6 +84,10 @@ FLAGS --gpu-type=GPU_TYPE The GPU type to use. + --[no-]gpu-zonal-redundancy + Set GPU zonal redundancy. Use --gpu-zonal-redundancy to enable and + --no-gpu-zonal-redundancy to disable. + --key=KEY CMEK key reference to encrypt the container with. diff --git a/gcloud/beta/saas-runtime/releases/create b/gcloud/beta/saas-runtime/releases/create index 2ca81358d..c68888621 100644 --- a/gcloud/beta/saas-runtime/releases/create +++ b/gcloud/beta/saas-runtime/releases/create @@ -130,9 +130,9 @@ OPTIONAL FLAGS --labels=path_to_file.(yaml|json) --location=LOCATION - For resources [release, unitKind], provides fallback value for resource - location attribute. When the resource's full URI path is not provided, - location will fallback to this flag value. + For resources [release, unit-kind], provides fallback value for + resource location attribute. When the resource's full URI path is not + provided, location will fallback to this flag value. --upgradeable-from-releases=[UPGRADEABLE_FROM_RELEASES,...] A list of releases from which a unit can be upgraded to this one diff --git a/gcloud/beta/saas-runtime/rollout-kinds/create b/gcloud/beta/saas-runtime/rollout-kinds/create index 75c51b54b..78dbf205c 100644 --- a/gcloud/beta/saas-runtime/rollout-kinds/create +++ b/gcloud/beta/saas-runtime/rollout-kinds/create @@ -98,7 +98,7 @@ OPTIONAL FLAGS --labels=path_to_file.(yaml|json) --location=LOCATION - For resources [rolloutKindId, unitKind], provides fallback value for + For resources [rollout_kind, unit-kind], provides fallback value for resource location attribute. When the resource's full URI path is not provided, location will fallback to this flag value. diff --git a/gcloud/beta/saas-runtime/rollouts/create b/gcloud/beta/saas-runtime/rollouts/create index 38de13557..16d9ed567 100644 --- a/gcloud/beta/saas-runtime/rollouts/create +++ b/gcloud/beta/saas-runtime/rollouts/create @@ -76,9 +76,9 @@ OPTIONAL FLAGS --labels=path_to_file.(yaml|json) --location=LOCATION - For resources [rolloutId, release, rolloutKindId], provides fallback - value for resource location attribute. When the resource's full URI - path is not provided, location will fallback to this flag value. + For resources [release, rollout, rollout-kind], provides fallback value + for resource location attribute. When the resource's full URI path is + not provided, location will fallback to this flag value. RolloutKindId resource - Name of the RolloutKind this rollout is stemming from and adhering to. This represents a Cloud resource. (NOTE) Some diff --git a/gcloud/beta/saas-runtime/unit-kinds/create b/gcloud/beta/saas-runtime/unit-kinds/create index 9d10cdfe6..56354a295 100644 --- a/gcloud/beta/saas-runtime/unit-kinds/create +++ b/gcloud/beta/saas-runtime/unit-kinds/create @@ -184,9 +184,9 @@ OPTIONAL FLAGS --labels=path_to_file.(yaml|json) --location=LOCATION - For resources [unitKind, release, saas], provides fallback value for - resource location attribute. When the resource's full URI path is not - provided, location will fallback to this flag value. + For resources [default-release, saas, unit_kind], provides fallback + value for resource location attribute. When the resource's full URI + path is not provided, location will fallback to this flag value. --output-variable-mappings=[from=FROM],[to=TO],[variable=VARIABLE] List of inputVariables for this release that will either be retrieved diff --git a/gcloud/beta/saas-runtime/unit-kinds/update b/gcloud/beta/saas-runtime/unit-kinds/update index 44e106f0d..a14cf1259 100644 --- a/gcloud/beta/saas-runtime/unit-kinds/update +++ b/gcloud/beta/saas-runtime/unit-kinds/update @@ -58,9 +58,9 @@ POSITIONAL ARGUMENTS FLAGS --location=LOCATION - For resources [unitKind, release, saas], provides fallback value for - resource location attribute. When the resource's full URI path is not - provided, location will fallback to this flag value. + For resources [default-release, saas, unit_kind], provides fallback + value for resource location attribute. When the resource's full URI + path is not provided, location will fallback to this flag value. Saas resource - A reference to the Saas that defines the product (managed service) that the producer wants to manage with Saas Runtime. Immutable diff --git a/gcloud/beta/saas-runtime/unit-operations/create b/gcloud/beta/saas-runtime/unit-operations/create index b69e6298b..4dab1a62e 100644 --- a/gcloud/beta/saas-runtime/unit-operations/create +++ b/gcloud/beta/saas-runtime/unit-operations/create @@ -102,10 +102,10 @@ OPTIONAL FLAGS --labels=path_to_file.(yaml|json) --location=LOCATION - For resources [unitOperation, parentUnitOperation, release, rolloutId, - unit], provides fallback value for resource location attribute. When - the resource's full URI path is not provided, location will fallback to - this flag value. + For resources [parent-unit-operation, provision-release, rollout, unit, + unit_operation, upgrade-release], provides fallback value for resource + location attribute. When the resource's full URI path is not provided, + location will fallback to this flag value. ParentUnitOperation resource - Reference to parent resource: Unit Operation. If an operation needs to create other operations as part of its diff --git a/gcloud/beta/saas-runtime/unit-operations/update b/gcloud/beta/saas-runtime/unit-operations/update index cbaeb9e34..83b887aa8 100644 --- a/gcloud/beta/saas-runtime/unit-operations/update +++ b/gcloud/beta/saas-runtime/unit-operations/update @@ -66,10 +66,10 @@ FLAGS the operation is already executing. (Optional) --location=LOCATION - For resources [unitOperation, parentUnitOperation, release, rolloutId], - provides fallback value for resource location attribute. When the - resource's full URI path is not provided, location will fallback to - this flag value. + For resources [parent-unit-operation, provision-release, rollout, + unit_operation, upgrade-release], provides fallback value for resource + location attribute. When the resource's full URI path is not provided, + location will fallback to this flag value. A time specification to schedule the maintenance. diff --git a/gcloud/beta/saas-runtime/units/create b/gcloud/beta/saas-runtime/units/create index b9c021272..ff7cd1e3c 100644 --- a/gcloud/beta/saas-runtime/units/create +++ b/gcloud/beta/saas-runtime/units/create @@ -67,7 +67,7 @@ FLAGS --labels=path_to_file.(yaml|json) --location=LOCATION - For resources [unit, tenant, unitKind], provides fallback value for + For resources [unit, tenant, unit-kind], provides fallback value for resource location attribute. When the resource's full URI path is not provided, location will fallback to this flag value. diff --git a/gcloud/beta/saas-runtime/units/update b/gcloud/beta/saas-runtime/units/update index ce6db1ffa..1bfe0c6fb 100644 --- a/gcloud/beta/saas-runtime/units/update +++ b/gcloud/beta/saas-runtime/units/update @@ -45,7 +45,7 @@ POSITIONAL ARGUMENTS FLAGS --location=LOCATION - For resources [unit, tenant, unitKind], provides fallback value for + For resources [unit, tenant, unit-kind], provides fallback value for resource location attribute. When the resource's full URI path is not provided, location will fallback to this flag value. diff --git a/gcloud/beta/workbench/instances/create b/gcloud/beta/workbench/instances/create index e7202f153..d27eef00b 100644 --- a/gcloud/beta/workbench/instances/create +++ b/gcloud/beta/workbench/instances/create @@ -23,7 +23,7 @@ SYNOPSIS | [(--vm-image-family=VM_IMAGE_FAMILY | --vm-image-name=VM_IMAGE_NAME) : --vm-image-project=VM_IMAGE_PROJECT; - default="deeplearning-platform-release"] + default="cloud-notebooks-managed"] --custom-gpu-driver-path=CUSTOM_GPU_DRIVER_PATH --install-gpu-driver --data-disk-encryption=DATA_DISK_ENCRYPTION --data-disk-size=DATA_DISK_SIZE --data-disk-type=DATA_DISK_TYPE @@ -258,7 +258,7 @@ FLAGS The tag of the container image. If not specified, this defaults to the latest tag. - --vm-image-project=VM_IMAGE_PROJECT; default="deeplearning-platform-release" + --vm-image-project=VM_IMAGE_PROJECT; default="cloud-notebooks-managed" The ID of the Google Cloud project that this VM image belongs to. Format: projects/{project_id}. diff --git a/gcloud/bigtable/authorized-views/add-iam-policy-binding b/gcloud/bigtable/authorized-views/add-iam-policy-binding index 5a89279e3..8c345b4ed 100644 --- a/gcloud/bigtable/authorized-views/add-iam-policy-binding +++ b/gcloud/bigtable/authorized-views/add-iam-policy-binding @@ -14,26 +14,26 @@ DESCRIPTION consists of a member, a role, and an optional condition. EXAMPLES - To add an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table', run: + To add an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with authorized view my-authorized-view in instance + my-instance and table my-table, run: $ gcloud bigtable authorized-views add-iam-policy-binding \ - my-authorized-view --instance='my-instance' --table='my-table' \ - --member='user:test-user@gmail.com' --role='roles/editor' + my-authorized-view --instance=`my-instance` --table=`my-table` \ + --member=`user:test-user@gmail.com` --role=`roles/editor` To add an IAM policy binding which expires at the end of the year 2020 for - the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' with - authorized view 'my-authorized-view' in instance 'my-instance' and table - 'my-table', run: + the role of roles/bigtable.admin and the user test-user@gmail.com with + authorized view my-authorized-view in instance my-instance and table + my-table, run: $ gcloud bigtable authorized-views add-iam-policy-binding \ - my-authorized-view --instance='my-instance' --table='my-table' \ - --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,descrip\ - tion=Expires at midnight on 2020-12-31' + my-authorized-view --instance=`my-instance` --table=`my-table` \ + --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,\ + description=Expires at midnight on 2020-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -63,7 +63,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -71,7 +71,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a diff --git a/gcloud/bigtable/authorized-views/create b/gcloud/bigtable/authorized-views/create index 6357a5dd4..2be541c72 100644 --- a/gcloud/bigtable/authorized-views/create +++ b/gcloud/bigtable/authorized-views/create @@ -12,16 +12,16 @@ DESCRIPTION Create a new Cloud Bigtable authorized view. EXAMPLES - To create an authorized view 'my-authorized-view' in instance 'my-instance' - and table 'my-table', using the definition file 'authorized_view.json': + To create an authorized view my-authorized-view in instance my-instance and + table my-table, using the definition file authorized_view.json: $ gcloud bigtable authorized-views create my-authorized-view \ --instance=test-instance --table=test-table \ --definition-file=authorized_view.json - To create an authorized view 'my-authorized-view' in instance 'my-instance' - and table 'my-table', using the pre-encoded definition file - 'authorized_view_pre_encoded.json': + To create an authorized view my-authorized-view in instance my-instance and + table my-table, using the pre-encoded definition file + authorized_view_pre_encoded.json: $ gcloud bigtable authorized-views create my-authorized-view \ --instance=test-instance --table=test-table \ @@ -52,7 +52,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -60,7 +60,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a @@ -76,7 +76,7 @@ FLAGS Path to a JSON or YAML file containing a valid authorized view protobuf. - The 'name' field is ignored. The name is deduced from the other command + The name field is ignored. The name is deduced from the other command line arguments. Example: { "subsetView": { "rowPrefixes": ["store1#"], "familySubsets": diff --git a/gcloud/bigtable/authorized-views/delete b/gcloud/bigtable/authorized-views/delete index 11d8b9a8c..d2f1af46f 100644 --- a/gcloud/bigtable/authorized-views/delete +++ b/gcloud/bigtable/authorized-views/delete @@ -11,8 +11,8 @@ DESCRIPTION Delete new Cloud Bigtable authorized view. EXAMPLES - To delete the authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table': + To delete the authorized view my-authorized-view in instance my-instance + and table my-table: $ gcloud bigtable authorized-views delete my-authorized-view \ --instance=test-instance --table=test-table @@ -42,7 +42,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -50,7 +50,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a diff --git a/gcloud/bigtable/authorized-views/describe b/gcloud/bigtable/authorized-views/describe index 5b4f3532c..1864145cd 100644 --- a/gcloud/bigtable/authorized-views/describe +++ b/gcloud/bigtable/authorized-views/describe @@ -11,8 +11,8 @@ DESCRIPTION Describe a Cloud Bigtable authorized view. EXAMPLES - To describe the authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table': + To describe the authorized view my-authorized-view in instance my-instance + and table my-table: $ gcloud bigtable authorized-views describe my-authorized-view \ --instance=test-instance --table=test-table @@ -42,7 +42,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -50,7 +50,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a diff --git a/gcloud/bigtable/authorized-views/get-iam-policy b/gcloud/bigtable/authorized-views/get-iam-policy index d15bf1052..4847aa328 100644 --- a/gcloud/bigtable/authorized-views/get-iam-policy +++ b/gcloud/bigtable/authorized-views/get-iam-policy @@ -12,11 +12,11 @@ DESCRIPTION Get an IAM policy on a Cloud Bigtable authorized view. EXAMPLES - To get the IAM policy on the authorized view 'my-authorized-view' in - instance 'my-instance' and table 'my-table', run: + To get the IAM policy on the authorized view my-authorized-view in instance + my-instance and table my-table, run: $ gcloud bigtable authorized-views get-iam-policy \ - my-authorized-view --instance='my-instance' --table='my-table' + my-authorized-view --instance=`my-instance` --table=`my-table` See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -46,7 +46,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -54,7 +54,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a diff --git a/gcloud/bigtable/authorized-views/list b/gcloud/bigtable/authorized-views/list index 7d207d381..26c584682 100644 --- a/gcloud/bigtable/authorized-views/list +++ b/gcloud/bigtable/authorized-views/list @@ -11,8 +11,7 @@ DESCRIPTION List all authorized views of a Cloud Bigtable table. EXAMPLES - To list the authorized views in instance 'my-instance' and table - 'my-table': + To list the authorized views in instance my-instance and table my-table: $ gcloud bigtable authorized-views list --instance=test-instance \ --table=test-table @@ -41,7 +40,7 @@ REQUIRED FLAGS this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument --table on the command line with a fully diff --git a/gcloud/bigtable/authorized-views/remove-iam-policy-binding b/gcloud/bigtable/authorized-views/remove-iam-policy-binding index 8e7c2d786..1f7882272 100644 --- a/gcloud/bigtable/authorized-views/remove-iam-policy-binding +++ b/gcloud/bigtable/authorized-views/remove-iam-policy-binding @@ -14,26 +14,26 @@ DESCRIPTION binding consists of a member, a role, and an optional condition. EXAMPLES - To remove an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table', run: + To remove an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with authorized view my-authorized-view in instance + my-instance and table my-table, run: $ gcloud bigtable authorized-views remove-iam-policy-binding \ - my-authorized-view --instance='my-instance' --table='my-table' \ - --member='user:test-user@gmail.com' --role='roles/editor' + my-authorized-view --instance=`my-instance` --table=`my-table` \ + --member=`user:test-user@gmail.com` --role=`roles/editor` To remove an IAM policy binding which expires at the end of the year 2020 - for the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' - with authorized view 'my-authorized-view' in instance 'my-instance' and - cluster 'my-cluster', run: + for the role of roles/bigtable.admin and the user test-user@gmail.com with + authorized view my-authorized-view in instance my-instance and cluster + my-cluster, run: $ gcloud bigtable authorized-views remove-iam-policy-binding \ - my-authorized-view --instance='my-instance' --table='my-table' \ - --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,descrip\ - tion=Expires at midnight on 2020-12-31' + my-authorized-view --instance=`my-instance` --table=`my-table` \ + --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,\ + description=Expires at midnight on 2020-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -63,7 +63,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -71,7 +71,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a diff --git a/gcloud/bigtable/authorized-views/set-iam-policy b/gcloud/bigtable/authorized-views/set-iam-policy index abcdb7d28..47f8af947 100644 --- a/gcloud/bigtable/authorized-views/set-iam-policy +++ b/gcloud/bigtable/authorized-views/set-iam-policy @@ -11,11 +11,11 @@ DESCRIPTION Set an IAM policy on a Cloud Bigtable authorized view. EXAMPLES - To set the IAM policy from file 'my-policy' on the authorized view - 'my-authorized-view' in instance 'my-instance' and table 'my-table', run: + To set the IAM policy from file my-policy on the authorized view + my-authorized-view in instance my-instance and table my-table, run: $ gcloud bigtable authorized-views set-iam-policy \ - my-authorized-view --instance='my-instance' --table='my-table' \ + my-authorized-view --instance=`my-instance` --table=`my-table` \ my-policy See https://cloud.google.com/iam/docs/managing-policies for more @@ -46,7 +46,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -54,7 +54,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a diff --git a/gcloud/bigtable/authorized-views/update b/gcloud/bigtable/authorized-views/update index 83f51c0b3..e37acb59b 100644 --- a/gcloud/bigtable/authorized-views/update +++ b/gcloud/bigtable/authorized-views/update @@ -12,25 +12,24 @@ DESCRIPTION Update an existing Cloud Bigtable authorized view. EXAMPLES - To update the authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table', using the definition file - 'authorized_view.json': + To update the authorized view my-authorized-view in instance my-instance + and table my-table, using the definition file authorized_view.json: $ gcloud bigtable authorized-views update my-authorized-view \ --instance=test-instance --table=test-table \ --definition-file=authorized_view.json - To update the authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table', using the pre-encoded definition file - 'authorized_view_pre_encoded.json': + To update the authorized view my-authorized-view in instance my-instance + and table my-table, using the pre-encoded definition file + authorized_view_pre_encoded.json: $ gcloud bigtable authorized-views update my-authorized-view \ --instance=test-instance --table=test-table \ --definition-file=authorized_view_pre_encoded.json --pre-encoded - To update the authorized view 'my-authorized-view' in instance - 'my-instance' and table 'my-table', using the definition file - 'authorized_view.json' and skip the prompt to proceed or cancel the update: + To update the authorized view my-authorized-view in instance my-instance + and table my-table, using the definition file authorized_view.json and skip + the prompt to proceed or cancel the update: $ gcloud bigtable authorized-views update my-authorized-view \ --instance=test-instance --table=test-table \ @@ -61,7 +60,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument authorized_view on the command line with a @@ -69,7 +68,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --instance on the command line. --table=TABLE - Name of the Cloud Bigtable table. + Name of the Bigtable table. To set the table attribute: ▸ provide the argument authorized_view on the command line with a @@ -85,7 +84,7 @@ FLAGS Path to a JSON or YAML file containing a valid authorized view protobuf. - The 'name' field is ignored. The name is deduced from the other command + The name field is ignored. The name is deduced from the other command line arguments. Example: { "subsetView": { "rowPrefixes": ["store1"], "familySubsets": diff --git a/gcloud/bigtable/backups/add-iam-policy-binding b/gcloud/bigtable/backups/add-iam-policy-binding index 1f08e3f71..a9a76ed48 100644 --- a/gcloud/bigtable/backups/add-iam-policy-binding +++ b/gcloud/bigtable/backups/add-iam-policy-binding @@ -14,25 +14,25 @@ DESCRIPTION of a member, a role, and an optional condition. EXAMPLES - To add an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with backup 'my-backup' in instance 'my-instance' and - cluster 'my-cluster', run: + To add an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with backup my-backup in instance my-instance and + cluster my-cluster, run: $ gcloud bigtable backups add-iam-policy-binding my-backup \ - --instance='my-instance' --cluster='my-cluster' \ - --member='user:test-user@gmail.com' --role='roles/editor' + --instance=`my-instance` --cluster=`my-cluster` \ + --member=`user:test-user@gmail.com` --role=`roles/editor` To add an IAM policy binding which expires at the end of the year 2020 for - the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' with - backup 'my-backup' in instance 'my-instance' and cluster 'my-cluster', run: + the role of roles/bigtable.admin and the user test-user@gmail.com with + backup my-backup in instance my-instance and cluster my-cluster, run: $ gcloud bigtable backups add-iam-policy-binding my-backup \ - --instance='my-instance' --cluster='my-cluster' \ - --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,descrip\ - tion=Expires at midnight on 2020-12-31' + --instance=`my-instance` --cluster=`my-cluster` \ + --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,\ + description=Expires at midnight on 2020-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -61,7 +61,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -69,7 +69,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/bigtable/backups/create b/gcloud/bigtable/backups/create index ead23eb13..c8b421480 100644 --- a/gcloud/bigtable/backups/create +++ b/gcloud/bigtable/backups/create @@ -13,30 +13,30 @@ DESCRIPTION Creates a backup of a Cloud Bigtable table. EXAMPLES - To create a backup 'BACKUP_NAME' asyncronously from table 'TABLE_NAME' - which expires at '2019-03-30T10:49:41Z', run: + To create a backup BACKUP_NAME asyncronously from table TABLE_NAME which + expires at 2019-03-30T10:49:41Z, run: $ gcloud bigtable backups create BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ --table=TABLE_NAME --expiration-date=2019-03-30T10:49:41Z \ --async - To create a backup 'BACKUP_NAME' syncronously from table 'TABLE_NAME' which + To create a backup BACKUP_NAME syncronously from table TABLE_NAME which expires in 2 weeks from now, run: $ gcloud bigtable backups create BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ --table=TABLE_NAME --retention-period=2w - To create a hot backup 'BACKUP_NAME' from table 'TABLE_NAME' which expires - in 2 weeks from now, run: + To create a hot backup BACKUP_NAME from table TABLE_NAME which expires in 2 + weeks from now, run: $ gcloud bigtable backups create BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ --table=TABLE_NAME --retention-period=2w --backup-type=HOT - To create a hot backup 'BACKUP_NAME' from table 'TABLE_NAME' which will be - converted to a standard backup at '2019-03-31T10:49:41Z' and expires in 2 + To create a hot backup BACKUP_NAME from table TABLE_NAME which will be + converted to a standard backup at 2019-03-31T10:49:41Z and expires in 2 weeks from now, run: $ gcloud bigtable backups create BACKUP_NAME \ @@ -44,7 +44,7 @@ EXAMPLES --table=TABLE_NAME --retention-period=2w --backup-type=HOT \ --hot-to-standard-time=2019-03-31T10:49:41Z - To create a hot backup 'BACKUP_NAME' from table 'TABLE_NAME' which will be + To create a hot backup BACKUP_NAME from table TABLE_NAME which will be converted to a standard backup in 1 week from now and expires in 2 weeks from now, run: @@ -77,7 +77,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -85,7 +85,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/bigtable/backups/delete b/gcloud/bigtable/backups/delete index b6ecf9063..dd6e154c8 100644 --- a/gcloud/bigtable/backups/delete +++ b/gcloud/bigtable/backups/delete @@ -38,7 +38,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -46,7 +46,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/bigtable/backups/describe b/gcloud/bigtable/backups/describe index 0afed8493..7bc74e2d6 100644 --- a/gcloud/bigtable/backups/describe +++ b/gcloud/bigtable/backups/describe @@ -38,7 +38,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -46,7 +46,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/bigtable/backups/get-iam-policy b/gcloud/bigtable/backups/get-iam-policy index 7003ed48f..236b06fb8 100644 --- a/gcloud/bigtable/backups/get-iam-policy +++ b/gcloud/bigtable/backups/get-iam-policy @@ -12,11 +12,11 @@ DESCRIPTION Get an IAM policy on a Cloud Bigtable Backup. EXAMPLES - To get the IAM policy on the backup 'my-backup' in instance 'my-instance' - and cluster 'my-cluster', run: + To get the IAM policy on the backup my-backup in instance my-instance and + cluster my-cluster, run: $ gcloud bigtable backups get-iam-policy my-backup \ - --instance='my-instance' --cluster='my-cluster' + --instance=`my-instance` --cluster=`my-cluster` See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -45,7 +45,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -53,7 +53,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/bigtable/backups/remove-iam-policy-binding b/gcloud/bigtable/backups/remove-iam-policy-binding index 1b942af12..de95a2e71 100644 --- a/gcloud/bigtable/backups/remove-iam-policy-binding +++ b/gcloud/bigtable/backups/remove-iam-policy-binding @@ -14,26 +14,25 @@ DESCRIPTION consists of a member, a role, and an optional condition. EXAMPLES - To remove an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with backup 'my-backup' in instance 'my-instance' and - cluster 'my-cluster', run: + To remove an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with backup my-backup in instance my-instance and + cluster my-cluster, run: $ gcloud bigtable backups remove-iam-policy-binding my-backup \ - --instance='my-instance' --cluster='my-cluster' \ - --member='user:test-user@gmail.com' --role='roles/editor' + --instance=`my-instance` --cluster=`my-cluster` \ + --member=`user:test-user@gmail.com` --role=`roles/editor` To remove an IAM policy binding which expires at the end of the year 2020 - for the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' - with backup 'my-backup' in instance 'my-instance' and cluster 'my-cluster', - run: + for the role of roles/bigtable.admin and the user test-user@gmail.com with + backup my-backup in instance my-instance and cluster my-cluster, run: $ gcloud bigtable backups remove-iam-policy-binding my-backup \ - --instance='my-instance' --cluster='my-cluster' \ - --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,descrip\ - tion=Expires at midnight on 2020-12-31' + --instance=`my-instance` --cluster=`my-cluster` \ + --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2021-01-01T00:00:00Z"),title=expires_end_of_2020,\ + description=Expires at midnight on 2020-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -62,7 +61,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -70,7 +69,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/bigtable/backups/set-iam-policy b/gcloud/bigtable/backups/set-iam-policy index a5d73343d..d3b54b1c6 100644 --- a/gcloud/bigtable/backups/set-iam-policy +++ b/gcloud/bigtable/backups/set-iam-policy @@ -11,11 +11,11 @@ DESCRIPTION Set an IAM policy on a Cloud Bigtable Backup. EXAMPLES - To set the IAM policy from file 'my-policy' on the backup 'my-backup' in - instance 'my-instance' and cluster 'my-cluster', run: + To set the IAM policy from file my-policy on the backup my-backup in + instance my-instance and cluster my-cluster, run: $ gcloud bigtable backups set-iam-policy my-backup \ - --instance='my-instance' --cluster='my-cluster' my-policy + --instance=`my-instance` --cluster=`my-cluster` my-policy See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -44,7 +44,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -52,7 +52,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/bigtable/backups/update b/gcloud/bigtable/backups/update index 14afbef56..513405b51 100644 --- a/gcloud/bigtable/backups/update +++ b/gcloud/bigtable/backups/update @@ -14,27 +14,27 @@ DESCRIPTION and --retention-period. EXAMPLES - To update the expire time of backup 'BACKUP_NAME' to 7 days from now, run: + To update the expire time of backup BACKUP_NAME to 7 days from now, run: $ gcloud bigtable backups update BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ --retention-period=7d - To update the hot-to-standard time of backup 'BACKUP_NAME' to - '2019-03-31T10:49:41Z', run: + To update the hot-to-standard time of backup BACKUP_NAME to + 2019-03-31T10:49:41Z, run: $ gcloud bigtable backups update BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ --hot-to-standard-time=2019-03-31T10:49:41Z - To update the hot-to-standard time of backup 'BACKUP_NAME' to 7 days from + To update the hot-to-standard time of backup BACKUP_NAME to 7 days from now, run: $ gcloud bigtable backups update BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ --hot-to-standard-time=+P7d - To clear the hot-to-standard time of backup 'BACKUP_NAME', run: + To clear the hot-to-standard time of backup BACKUP_NAME, run: $ gcloud bigtable backups update BACKUP_NAME \ --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \ @@ -64,7 +64,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully @@ -72,7 +72,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --cluster on the command line. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully diff --git a/gcloud/bigtable/instances/add-iam-policy-binding b/gcloud/bigtable/instances/add-iam-policy-binding index 984dae0ed..3cfe1bb11 100644 --- a/gcloud/bigtable/instances/add-iam-policy-binding +++ b/gcloud/bigtable/instances/add-iam-policy-binding @@ -13,22 +13,22 @@ DESCRIPTION consists of a member, a role, and an optional condition. EXAMPLES - To add an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with instance 'my-instance', run: + To add an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with instance my-instance, run: $ gcloud bigtable instances add-iam-policy-binding my-instance \ - --member='user:test-user@gmail.com' --role='roles/editor' + --member=`user:test-user@gmail.com` --role=`roles/editor` To add an IAM policy binding which expires at the end of the year 2018 for - the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' with - instance 'my-instance', run: + the role of roles/bigtable.admin and the user test-user@gmail.com with + instance my-instance, run: $ gcloud bigtable instances add-iam-policy-binding my-instance \ - --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2019-01-01T00:00:00Z"),title=expires_end_of_2018,descrip\ - tion=Expires at midnight on 2018-12-31' + --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2019-01-01T00:00:00Z"),title=expires_end_of_2018,\ + description=Expires at midnight on 2018-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. diff --git a/gcloud/bigtable/instances/remove-iam-policy-binding b/gcloud/bigtable/instances/remove-iam-policy-binding index 5dea53433..c0107b2c6 100644 --- a/gcloud/bigtable/instances/remove-iam-policy-binding +++ b/gcloud/bigtable/instances/remove-iam-policy-binding @@ -13,22 +13,22 @@ DESCRIPTION consists of a member, a role, and an optional condition. EXAMPLES - To remove an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with instance 'my-instance', run: + To remove an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with instance my-instance, run: $ gcloud bigtable instances remove-iam-policy-binding my-instance \ - --member='user:test-user@gmail.com' --role='roles/editor' + --member=`user:test-user@gmail.com` --role=`roles/editor` To remove an IAM policy binding which expires at the end of the year 2018 - for the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' - with instance 'my-instance', run: + for the role of roles/bigtable.admin and the user test-user@gmail.com with + instance my-instance, run: $ gcloud bigtable instances remove-iam-policy-binding my-instance \ - --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2019-01-01T00:00:00Z"),title=expires_end_of_2018,descrip\ - tion=Expires at midnight on 2018-12-31' + --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2019-01-01T00:00:00Z"),title=expires_end_of_2018,\ + description=Expires at midnight on 2018-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. diff --git a/gcloud/bigtable/instances/tables/add-iam-policy-binding b/gcloud/bigtable/instances/tables/add-iam-policy-binding index 3a4e261f8..ae58957ef 100644 --- a/gcloud/bigtable/instances/tables/add-iam-policy-binding +++ b/gcloud/bigtable/instances/tables/add-iam-policy-binding @@ -13,23 +13,23 @@ DESCRIPTION of a member, a role, and an optional condition. EXAMPLES - To add an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with table 'my-table' in instance 'my-instance', run: + To add an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with table my-table in instance my-instance, run: $ gcloud bigtable instances tables add-iam-policy-binding my-table \ - --instance='my-instance' --member='user:test-user@gmail.com' \ - --role='roles/editor' + --instance=`my-instance` --member=`user:test-user@gmail.com` \ + --role=`roles/editor` To add an IAM policy binding which expires at the end of the year 2019 for - the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' with - table 'my-table' in instance 'my-instance', run: + the role of roles/bigtable.admin and the user test-user@gmail.com with + table my-table in instance my-instance, run: $ gcloud bigtable instances tables add-iam-policy-binding my-table \ - --instance='my-instance' --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,descrip\ - tion=Expires at midnight on 2019-12-31' + --instance=`my-instance` --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,\ + description=Expires at midnight on 2019-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -58,7 +58,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/bigtable/instances/tables/create b/gcloud/bigtable/instances/tables/create index 4caf810c5..200776e90 100644 --- a/gcloud/bigtable/instances/tables/create +++ b/gcloud/bigtable/instances/tables/create @@ -102,7 +102,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/bigtable/instances/tables/delete b/gcloud/bigtable/instances/tables/delete index 5cf5ff23b..314e494af 100644 --- a/gcloud/bigtable/instances/tables/delete +++ b/gcloud/bigtable/instances/tables/delete @@ -38,7 +38,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/bigtable/instances/tables/describe b/gcloud/bigtable/instances/tables/describe index d1248cf2e..108f1192e 100644 --- a/gcloud/bigtable/instances/tables/describe +++ b/gcloud/bigtable/instances/tables/describe @@ -39,7 +39,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/bigtable/instances/tables/get-iam-policy b/gcloud/bigtable/instances/tables/get-iam-policy index 3dd787a7d..8ea4e9109 100644 --- a/gcloud/bigtable/instances/tables/get-iam-policy +++ b/gcloud/bigtable/instances/tables/get-iam-policy @@ -11,11 +11,10 @@ DESCRIPTION Get an IAM policy on a Cloud Bigtable table. EXAMPLES - To get the IAM policy on the table 'my-table' in instance 'my-instance', - run: + To get the IAM policy on the table my-table in instance my-instance, run: $ gcloud bigtable instances tables get-iam-policy my-table \ - --instance='my-instance' + --instance=`my-instance` See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -44,7 +43,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/bigtable/instances/tables/remove-iam-policy-binding b/gcloud/bigtable/instances/tables/remove-iam-policy-binding index ac26e669c..3cf306ba9 100644 --- a/gcloud/bigtable/instances/tables/remove-iam-policy-binding +++ b/gcloud/bigtable/instances/tables/remove-iam-policy-binding @@ -13,24 +13,24 @@ DESCRIPTION consists of a member, a role, and an optional condition. EXAMPLES - To remove an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with table 'my-table' in instance 'my-instance', run: + To remove an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with table my-table in instance my-instance, run: $ gcloud bigtable instances tables remove-iam-policy-binding \ - my-table --instance='my-instance' \ - --member='user:test-user@gmail.com' --role='roles/editor' + my-table --instance=`my-instance` \ + --member=`user:test-user@gmail.com` --role=`roles/editor` To remove an IAM policy binding which expires at the end of the year 2019 - for the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' - with table 'my-table' in instance 'my-instance', run: + for the role of roles/bigtable.admin and the user test-user@gmail.com with + table my-table in instance my-instance, run: $ gcloud bigtable instances tables remove-iam-policy-binding \ - my-table --instance='my-instance' \ - --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,descrip\ - tion=Expires at midnight on 2019-12-31' + my-table --instance=`my-instance` \ + --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,\ + description=Expires at midnight on 2019-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -59,7 +59,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/bigtable/instances/tables/restore b/gcloud/bigtable/instances/tables/restore index 525afca25..e2df75956 100644 --- a/gcloud/bigtable/instances/tables/restore +++ b/gcloud/bigtable/instances/tables/restore @@ -54,7 +54,7 @@ REQUIRED FLAGS this group are specified. --destination-instance=DESTINATION_INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument --destination on the command line with a @@ -85,7 +85,7 @@ REQUIRED FLAGS this group are specified. --source-cluster=SOURCE_CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument --source on the command line with a fully @@ -93,7 +93,7 @@ REQUIRED FLAGS ▸ provide the argument --source-cluster on the command line. --source-instance=SOURCE_INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument --source on the command line with a fully diff --git a/gcloud/bigtable/instances/tables/set-iam-policy b/gcloud/bigtable/instances/tables/set-iam-policy index 57a868e01..a46f25440 100644 --- a/gcloud/bigtable/instances/tables/set-iam-policy +++ b/gcloud/bigtable/instances/tables/set-iam-policy @@ -10,11 +10,11 @@ DESCRIPTION Set an IAM policy on a Cloud Bigtable table. EXAMPLES - To set the IAM policy from file 'my-policy' on the table 'my-table' in - instance 'my-instance', run: + To set the IAM policy from file my-policy on the table my-table in instance + my-instance, run: $ gcloud bigtable instances tables set-iam-policy my-table \ - --instance='my-instance' my-policy + --instance=`my-instance` my-policy See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -43,7 +43,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/bigtable/instances/tables/undelete b/gcloud/bigtable/instances/tables/undelete index b3eaeed10..dd6bcae8c 100644 --- a/gcloud/bigtable/instances/tables/undelete +++ b/gcloud/bigtable/instances/tables/undelete @@ -39,7 +39,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/bigtable/instances/tables/update b/gcloud/bigtable/instances/tables/update index 4dc23073b..7a1635c31 100644 --- a/gcloud/bigtable/instances/tables/update +++ b/gcloud/bigtable/instances/tables/update @@ -80,7 +80,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/bigtable/operations/describe b/gcloud/bigtable/operations/describe index 28d9f154b..ded26295a 100644 --- a/gcloud/bigtable/operations/describe +++ b/gcloud/bigtable/operations/describe @@ -8,7 +8,7 @@ DESCRIPTION Describe a Cloud Bigtable operation. EXAMPLES - To view details for operation 'OPERATION_ID', run: + To view details for operation OPERATION_ID, run: $ gcloud bigtable operations describe OPERATION_ID diff --git a/gcloud/bigtable/tables/add-iam-policy-binding b/gcloud/bigtable/tables/add-iam-policy-binding index 2699aa5ed..0d7233d11 100644 --- a/gcloud/bigtable/tables/add-iam-policy-binding +++ b/gcloud/bigtable/tables/add-iam-policy-binding @@ -13,23 +13,23 @@ DESCRIPTION of a member, a role, and an optional condition. EXAMPLES - To add an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with table 'my-table' in instance 'my-instance', run: + To add an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with table my-table in instance my-instance, run: $ gcloud bigtable tables add-iam-policy-binding my-table \ - --instance='my-instance' --member='user:test-user@gmail.com' \ - --role='roles/editor' + --instance=`my-instance` --member=`user:test-user@gmail.com` \ + --role=`roles/editor` To add an IAM policy binding which expires at the end of the year 2019 for - the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' with - table 'my-table' in instance 'my-instance', run: + the role of roles/bigtable.admin and the user test-user@gmail.com with + table my-table in instance my-instance, run: $ gcloud bigtable tables add-iam-policy-binding my-table \ - --instance='my-instance' --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,descrip\ - tion=Expires at midnight on 2019-12-31' + --instance=`my-instance` --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,\ + description=Expires at midnight on 2019-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -58,7 +58,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/bigtable/tables/create b/gcloud/bigtable/tables/create index db1092c4c..16b0acf0b 100644 --- a/gcloud/bigtable/tables/create +++ b/gcloud/bigtable/tables/create @@ -96,7 +96,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/bigtable/tables/delete b/gcloud/bigtable/tables/delete index 2c1e8cb2b..2e2295516 100644 --- a/gcloud/bigtable/tables/delete +++ b/gcloud/bigtable/tables/delete @@ -37,7 +37,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/bigtable/tables/describe b/gcloud/bigtable/tables/describe index 888329a33..9a976e70c 100644 --- a/gcloud/bigtable/tables/describe +++ b/gcloud/bigtable/tables/describe @@ -37,7 +37,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/bigtable/tables/get-iam-policy b/gcloud/bigtable/tables/get-iam-policy index ae08cb16a..1686761a4 100644 --- a/gcloud/bigtable/tables/get-iam-policy +++ b/gcloud/bigtable/tables/get-iam-policy @@ -11,11 +11,10 @@ DESCRIPTION Get an IAM policy on a Cloud Bigtable table. EXAMPLES - To get the IAM policy on the table 'my-table' in instance 'my-instance', - run: + To get the IAM policy on the table my-table in instance my-instance, run: $ gcloud bigtable tables get-iam-policy my-table \ - --instance='my-instance' + --instance=`my-instance` See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -44,7 +43,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/bigtable/tables/remove-iam-policy-binding b/gcloud/bigtable/tables/remove-iam-policy-binding index 61a4be664..59e08b42e 100644 --- a/gcloud/bigtable/tables/remove-iam-policy-binding +++ b/gcloud/bigtable/tables/remove-iam-policy-binding @@ -13,23 +13,23 @@ DESCRIPTION consists of a member, a role, and an optional condition. EXAMPLES - To remove an IAM policy binding for the role of 'roles/editor' for the user - 'test-user@gmail.com' with table 'my-table' in instance 'my-instance', run: + To remove an IAM policy binding for the role of roles/editor for the user + test-user@gmail.com with table my-table in instance my-instance, run: $ gcloud bigtable tables remove-iam-policy-binding my-table \ - --instance='my-instance' --member='user:test-user@gmail.com' \ - --role='roles/editor' + --instance=`my-instance` --member=`user:test-user@gmail.com` \ + --role=`roles/editor` To remove an IAM policy binding which expires at the end of the year 2019 - for the role of 'roles/bigtable.admin' and the user 'test-user@gmail.com' - with table 'my-table' in instance 'my-instance', run: + for the role of roles/bigtable.admin and the user test-user@gmail.com with + table my-table in instance my-instance, run: $ gcloud bigtable tables remove-iam-policy-binding my-table \ - --instance='my-instance' --member='user:test-user@gmail.com' \ - --role='roles/bigtable.admin' \ - --condition='expression=request.time < - timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,descrip\ - tion=Expires at midnight on 2019-12-31' + --instance=`my-instance` --member=`user:test-user@gmail.com` \ + --role=`roles/bigtable.admin` \ + --condition=`expression=request.time < \ + timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,\ + description=Expires at midnight on 2019-12-31` See https://cloud.google.com/iam/docs/managing-policies for details of policy role and member types. @@ -58,7 +58,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/bigtable/tables/restore b/gcloud/bigtable/tables/restore index 8d37725a5..aa2e08fda 100644 --- a/gcloud/bigtable/tables/restore +++ b/gcloud/bigtable/tables/restore @@ -53,7 +53,7 @@ REQUIRED FLAGS this group are specified. --destination-instance=DESTINATION_INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument --destination on the command line with a @@ -84,7 +84,7 @@ REQUIRED FLAGS this group are specified. --source-cluster=SOURCE_CLUSTER - Name of the Cloud Bigtable cluster. + Name of the Bigtable cluster. To set the cluster attribute: ▸ provide the argument --source on the command line with a fully @@ -92,7 +92,7 @@ REQUIRED FLAGS ▸ provide the argument --source-cluster on the command line. --source-instance=SOURCE_INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument --source on the command line with a fully diff --git a/gcloud/bigtable/tables/set-iam-policy b/gcloud/bigtable/tables/set-iam-policy index 4338e3d8b..77c174f41 100644 --- a/gcloud/bigtable/tables/set-iam-policy +++ b/gcloud/bigtable/tables/set-iam-policy @@ -10,11 +10,11 @@ DESCRIPTION Set an IAM policy on a Cloud Bigtable table. EXAMPLES - To set the IAM policy from file 'my-policy' on the table 'my-table' in - instance 'my-instance', run: + To set the IAM policy from file my-policy on the table my-table in instance + my-instance, run: $ gcloud bigtable tables set-iam-policy my-table \ - --instance='my-instance' my-policy + --instance=`my-instance` my-policy See https://cloud.google.com/iam/docs/managing-policies for more information. @@ -43,7 +43,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/bigtable/tables/undelete b/gcloud/bigtable/tables/undelete index 95dbf1ee6..7ac244c12 100644 --- a/gcloud/bigtable/tables/undelete +++ b/gcloud/bigtable/tables/undelete @@ -38,7 +38,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/bigtable/tables/update b/gcloud/bigtable/tables/update index f06f7d53b..e4f08dadf 100644 --- a/gcloud/bigtable/tables/update +++ b/gcloud/bigtable/tables/update @@ -79,7 +79,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - Name of the Cloud Bigtable instance. + Name of the Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully diff --git a/gcloud/composer/environments/help b/gcloud/composer/environments/help index 14c2a35c5..b70fe8769 100644 --- a/gcloud/composer/environments/help +++ b/gcloud/composer/environments/help @@ -70,6 +70,9 @@ COMMANDS List Composer workloads, supported in Composer 3 environments or greater. + restart-web-server + Restart web server for a Cloud Composer environment. + run Run an Airflow sub-command remotely in a Cloud Composer environment. diff --git a/gcloud/composer/environments/restart-web-server b/gcloud/composer/environments/restart-web-server new file mode 100644 index 000000000..a569179fe --- /dev/null +++ b/gcloud/composer/environments/restart-web-server @@ -0,0 +1,71 @@ +NAME + gcloud composer environments restart-web-server - restart web server for a + Cloud Composer environment + +SYNOPSIS + gcloud composer environments restart-web-server + (ENVIRONMENT : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Restart web server for a Cloud Composer environment. + +EXAMPLES + To restart the Cloud Composer web server in an environment named env-1, + run: + + $ gcloud composer environments restart-web-server env-1 + +POSITIONAL ARGUMENTS + Environment resource - The environment to restart web server for. 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 environment 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. + + ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument environment on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument environment on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha composer environments restart-web-server + + $ gcloud beta composer environments restart-web-server + diff --git a/gcloud/compute/backend-services/create b/gcloud/compute/backend-services/create index 9cfa545ad..6c3240b77 100644 --- a/gcloud/compute/backend-services/create +++ b/gcloud/compute/backend-services/create @@ -40,7 +40,9 @@ SYNOPSIS [--session-affinity=SESSION_AFFINITY] [--signed-url-cache-max-age=SIGNED_URL_CACHE_MAX_AGE] [--subsetting-policy=SUBSETTING_POLICY; default="NONE"] - [--timeout=TIMEOUT; default="30s"] [--tracking-mode=TRACKING_MODE] + [--timeout=TIMEOUT; default="30s"] + [--tls-settings=[authenticationConfig=AUTHENTICATIONCONFIG],[sni=SNI]] + [--tracking-mode=TRACKING_MODE] [--cache-key-query-string-blacklist=[QUERY_STRING,...] | --cache-key-query-string-whitelist=QUERY_STRING,[...]] [--custom-metrics=[CUSTOM_METRICS,...] @@ -719,6 +721,14 @@ FLAGS The full range of timeout values allowed is 1 - 2,147,483,647 seconds. + --tls-settings=[authenticationConfig=AUTHENTICATIONCONFIG],[sni=SNI] + Configuration for Backend Authenticated TLS and mTLS. May only be + specified when the backend protocol is SSL, HTTPS or HTTP2. + + Example: $ gcloud compute backend-services create \ + --tls-settings='sni=example.com,authenticationConfig=${AUTH_CONF\ + IG_NAME}' + --tracking-mode=TRACKING_MODE Specifies the connection key used for connection tracking. The default value is PER_CONNECTION. Applicable only for backend service-based diff --git a/gcloud/compute/backend-services/update b/gcloud/compute/backend-services/update index e5810196e..b16deccb2 100644 --- a/gcloud/compute/backend-services/update +++ b/gcloud/compute/backend-services/update @@ -57,7 +57,9 @@ SYNOPSIS [--serve-while-stale=SERVE_WHILE_STALE | --no-serve-while-stale] [--service-bindings=SERVICE_BINDING,[...] | --no-service-bindings] [--service-lb-policy=SERVICE_LOAD_BALANCING_POLICY - | --no-service-lb-policy] [GCLOUD_WIDE_FLAG ...] + | --no-service-lb-policy] + [--tls-settings=[authenticationConfig=AUTHENTICATIONCONFIG],[sni=SNI] + | --no-tls-settings] [GCLOUD_WIDE_FLAG ...] DESCRIPTION gcloud compute backend-services update is used to update backend services. @@ -948,6 +950,19 @@ FLAGS No service load balancing policies should be attached to the backend service. + At most one of these can be specified: + + --tls-settings=[authenticationConfig=AUTHENTICATIONCONFIG],[sni=SNI] + Configuration for Backend Authenticated TLS and mTLS. May only be + specified when the backend protocol is SSL, HTTPS or HTTP2. + + Example: $ gcloud compute backend-services update \ + --tls-settings='sni=example.com,authenticationConfig=${AUTH_CONF\ + IG_NAME}' + + --no-tls-settings + Clears currently set backend service TLS settings. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/compute/interconnects/groups/create-members b/gcloud/compute/interconnects/groups/create-members index 8c6f96b1f..5f05a4889 100644 --- a/gcloud/compute/interconnects/groups/create-members +++ b/gcloud/compute/interconnects/groups/create-members @@ -10,6 +10,7 @@ SYNOPSIS [--intent-mismatch-behavior=INTENT_MISMATCH_BEHAVIOR] [--interconnect-type=INTERCONNECT_TYPE] [--link-type=LINK_TYPE] [--noc-contact-email=NOC_CONTACT_EMAIL] + [--remote-location=REMOTE_LOCATION] [--requested-features=[FEATURES,...]] [--requested-link-count=REQUESTED_LINK_COUNT] [GCLOUD_WIDE_FLAG ...] @@ -102,6 +103,9 @@ OPTIONAL FLAGS Email address to contact the customer NOC for operations and maintenance notifications regarding this interconnect. + --remote-location=REMOTE_LOCATION + The location of the interconnect for Cross-Cloud Interconnect. + --requested-features=[FEATURES,...] List of features requested for this interconnect. FEATURES must be one of: diff --git a/gcloud/compute/reservations/sub-blocks/describe b/gcloud/compute/reservations/sub-blocks/describe index deefaf295..04695e469 100644 --- a/gcloud/compute/reservations/sub-blocks/describe +++ b/gcloud/compute/reservations/sub-blocks/describe @@ -1,6 +1,6 @@ NAME gcloud compute reservations sub-blocks describe - describe a Compute Engine - reservation sub block + reservation sub-block SYNOPSIS gcloud compute reservations sub-blocks describe RESERVATION @@ -8,11 +8,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Describe a Compute Engine reservation sub block. + Describe a Compute Engine reservation sub-block. EXAMPLES - To describe a reservation sub block in reservation exr1 in my-zone with - block name my-block and sub block name my-sub-block, run: + To describe a reservation sub-block in reservation exr1 in my-zone with + block name my-block and sub-block name my-sub-block, run: $ gcloud compute reservations sub-blocks describe exr1 \ --zone=my-zone --block-name=my-block \ diff --git a/gcloud/compute/reservations/sub-blocks/help b/gcloud/compute/reservations/sub-blocks/help index 56878943c..88311cfea 100644 --- a/gcloud/compute/reservations/sub-blocks/help +++ b/gcloud/compute/reservations/sub-blocks/help @@ -17,10 +17,13 @@ COMMANDS COMMAND is one of the following: describe - Describe a Compute Engine reservation sub block. + Describe a Compute Engine reservation sub-block. list - List Compute Engine reservation sub blocks. + List Compute Engine reservation sub-blocks. + + perform-maintenance + Perform maintenance on a reservation sub-block. NOTES These variants are also available: diff --git a/gcloud/compute/reservations/sub-blocks/list b/gcloud/compute/reservations/sub-blocks/list index cb553de9d..86be8b276 100644 --- a/gcloud/compute/reservations/sub-blocks/list +++ b/gcloud/compute/reservations/sub-blocks/list @@ -1,6 +1,6 @@ NAME gcloud compute reservations sub-blocks list - list Compute Engine - reservation sub blocks + reservation sub-blocks SYNOPSIS gcloud compute reservations sub-blocks list RESERVATION @@ -10,10 +10,10 @@ SYNOPSIS DESCRIPTION gcloud compute reservations sub-blocks list displays all Compute Engine - reservation sub blocks in an extended reservation's block. + reservation sub-blocks in an extended reservation's block. EXAMPLES - To list all reservation sub blocks in an extended reservation's block + To list all reservation sub-blocks in an extended reservation's block my-block in table form, run: $ gcloud compute reservations sub-blocks list extended-reservation \ diff --git a/gcloud/compute/reservations/sub-blocks/perform-maintenance b/gcloud/compute/reservations/sub-blocks/perform-maintenance new file mode 100644 index 000000000..46e4de229 --- /dev/null +++ b/gcloud/compute/reservations/sub-blocks/perform-maintenance @@ -0,0 +1,67 @@ +NAME + gcloud compute reservations sub-blocks perform-maintenance - perform + maintenance on a reservation sub-block + +SYNOPSIS + gcloud compute reservations sub-blocks perform-maintenance RESERVATION + --block-name=BLOCK_NAME --sub-block-name=SUB_BLOCK_NAME [--zone=ZONE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Perform maintenance on a reservation sub-block. + +EXAMPLES + To perform maintenance on a reservation sub-block in reservation exr-1 in + ZONE with block name block-1 and sub-block name sub-block-1, run: + + $ gcloud compute reservations sub-blocks perform-maintenance exr-1 \ + --zone=ZONE --block-name=block-1 --sub-block-name=sub-block-1 + +POSITIONAL ARGUMENTS + RESERVATION + Name of the reservation to perform-maintenance. + +REQUIRED FLAGS + --block-name=BLOCK_NAME + The name of the reservation block. + + --sub-block-name=SUB_BLOCK_NAME + The name of the reservation sub block. + +OPTIONAL FLAGS + --zone=ZONE + Zone of the reservation to perform-maintenance. If not specified and + the compute/zone property isn't set, you might be prompted to select a + zone (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute reservations sub-blocks perform-maintenance + + $ gcloud beta compute reservations sub-blocks perform-maintenance + diff --git a/gcloud/compute/storage-pools/create b/gcloud/compute/storage-pools/create index e757718c3..4cef75ff9 100644 --- a/gcloud/compute/storage-pools/create +++ b/gcloud/compute/storage-pools/create @@ -101,7 +101,7 @@ OPTIONAL FLAGS Throughput in MB/s with which to provision the pool. --zone=ZONE - For resources [storage pool, storage pool type], provides fallback + For resources [storage-pool-type, storage_pool], provides fallback value for resource zone attribute. When the resource's full URI path is not provided, zone will fallback to this flag value. diff --git a/gcloud/container/clusters/create b/gcloud/container/clusters/create index cb8da1cab..215fc9d41 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -30,7 +30,7 @@ SYNOPSIS [--default-max-pods-per-node=DEFAULT_MAX_PODS_PER_NODE] [--disable-default-snat] [--disable-l4-lb-firewall-reconciliation] [--disk-size=DISK_SIZE] [--disk-type=DISK_TYPE] - [--enable-authorized-networks-on-private-endpoint] + [--enable-authorized-networks-on-private-endpoint] [--enable-auto-ipam] [--enable-autorepair] [--no-enable-autoupgrade] [--enable-cilium-clusterwide-network-policy] [--enable-cloud-logging] [--enable-cloud-monitoring] [--enable-cloud-run-alpha] @@ -44,12 +44,13 @@ SYNOPSIS [--enable-ip-alias] [--enable-kubernetes-alpha] [--enable-kubernetes-unstable-apis=API,[API,...]] [--enable-l4-ilb-subsetting] [--enable-legacy-authorization] - [--enable-managed-prometheus] [--enable-master-global-access] - [--enable-multi-networking] [--enable-nested-virtualization] - [--enable-network-policy] [--enable-ray-cluster-logging] - [--enable-ray-cluster-monitoring] [--enable-secret-manager] - [--enable-service-externalips] [--enable-shielded-nodes] - [--enable-stackdriver-kubernetes] [--enable-vertical-pod-autoscaling] + [--enable-legacy-lustre-port] [--enable-managed-prometheus] + [--enable-master-global-access] [--enable-multi-networking] + [--enable-nested-virtualization] [--enable-network-policy] + [--enable-ray-cluster-logging] [--enable-ray-cluster-monitoring] + [--enable-secret-manager] [--enable-service-externalips] + [--enable-shielded-nodes] [--enable-stackdriver-kubernetes] + [--enable-vertical-pod-autoscaling] [--fleet-project=PROJECT_ID_OR_NUMBER] [--gateway-api=GATEWAY_API] [--hpa-profile=HPA_PROFILE] [--image-type=IMAGE_TYPE] [--in-transit-encryption=IN_TRANSIT_ENCRYPTION] @@ -75,7 +76,7 @@ SYNOPSIS [--placement-policy=PLACEMENT_POLICY] [--placement-type=PLACEMENT_TYPE] [--preemptible] [--private-endpoint-subnetwork=NAME] [--private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE] - [--release-channel=[CHANNEL]] [--resource-manager-tags=[KEY=VALUE,...]] + [--release-channel=CHANNEL] [--resource-manager-tags=[KEY=VALUE,...]] [--security-group=SECURITY_GROUP] [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--spot] @@ -232,7 +233,8 @@ FLAGS ADDON must be one of: HttpLoadBalancing, HorizontalPodAutoscaling, KubernetesDashboard, NetworkPolicy, NodeLocalDNS, ConfigConnector, GcePersistentDiskCsiDriver, GcpFilestoreCsiDriver, BackupRestore, - GcsFuseCsiDriver, ParallelstoreCsiDriver, RayOperator, CloudRun. + GcsFuseCsiDriver, ParallelstoreCsiDriver, LustreCsiDriver, RayOperator, + CloudRun. --alpha-cluster-feature-gates=[FEATURE=true|false,...] Selectively enable or disable Kubernetes alpha and beta @@ -492,6 +494,10 @@ FLAGS Enable enforcement of --master-authorized-networks CIDR ranges for traffic reaching cluster's control plane via private IP. + --enable-auto-ipam + Enable the Auto IP Address Management (Auto IPAM) feature for the + cluster. + --enable-autorepair Enable node autorepair feature for a cluster's default node pool(s). @@ -641,6 +647,10 @@ FLAGS instead. For instructions, see https://cloud.google.com/kubernetes-engine/docs/how-to/routes-based-cluster + Note: For IPv6-only clusters, these flags are a no-op as IP Aliases do + not apply, and any specified IP address ranges for Pods and Services + will be ignored. + You can't specify both --enable-ip-alias and --no-enable-ip-alias. If you omit both --enable-ip-alias and --no-enable-ip-alias, the default is a VPC-native cluster. @@ -671,6 +681,12 @@ FLAGS permissions instead, create or update your cluster with the option --no-enable-legacy-authorization. + --enable-legacy-lustre-port + Allow the Lustre CSI driver to initialize LNet (the virtual network + layer for Lustre kernel module) using port 6988. This flag is required + to workaround a port conflict with the gke-metadata-server on GKE + nodes. + --enable-managed-prometheus Enables managed collection for Managed Service for Prometheus in the cluster. @@ -1153,7 +1169,7 @@ FLAGS PRIVATE_IPV6_GOOGLE_ACCESS_TYPE must be one of: bidirectional, disabled, outbound-only. - --release-channel=[CHANNEL] + --release-channel=CHANNEL Release channel a cluster is subscribed to. If left unspecified and a version is specified, the cluster is enrolled @@ -1169,8 +1185,15 @@ FLAGS CHANNEL must be one of: - rapid + None + Use 'None' to opt-out of any release channel. + extended + Clusters subscribed to 'extended' can remain on a minor version for + 24 months from when the minor version is made available in the + Regular channel. + + rapid 'rapid' channel is offered on an early access basis for customers who want to test new releases. @@ -1178,28 +1201,15 @@ FLAGS to unresolved issues with no known workaround and are not subject to any SLAs. - regular - + regular Clusters subscribed to 'regular' receive versions that are considered GA quality. 'regular' is intended for production users who want to take advantage of new features. - extended - - Clusters subscribed to 'extended' can remain on a minor version for 24 months - from when the minor version is made available in the Regular channel. - - stable - + stable Clusters subscribed to 'stable' receive versions that are known to be stable and reliable in production. - None - - Use 'None' to opt-out of any release channel. - - CHANNEL must be one of: rapid, regular, extended, stable, None. - --resource-manager-tags=[KEY=VALUE,...] Applies the specified comma-separated resource manager tags that has the GCE_FIREWALL purpose to all nodes in the new default node pool(s) @@ -1290,7 +1300,7 @@ FLAGS VM instances. --stack-type=STACK_TYPE - IP stack type of the node VMs. STACK_TYPE must be one of: ipv4, + IP stack type of the cluster nodes. STACK_TYPE must be one of: ipv4, ipv4-ipv6. --storage-pools=STORAGE_POOL,[...] @@ -1366,6 +1376,8 @@ FLAGS 'fs.mqueue.*', and 'net.*', and sysctls under the groups.) singleProcessOomKill true or false + maxParallelImagePulls integer (The value must be + between [2, 5].) KEY VALUE policy either 'Static' or 'None' @@ -1402,6 +1414,8 @@ FLAGS net.ipv4.tcp_wmem Any positive integer tuple net.ipv4.tcp_tw_reuse Must be {0, 1, 2} + net.ipv4.tcp_max_orphans Must be between + [16384, 262144] net.netfilter.nf_conntrack_max Must be between [65536, 4194304] net.netfilter.nf_conntrack_buckets Must be between @@ -1427,9 +1441,40 @@ FLAGS [0, 184467440736927743 99] + fs.aio-max-nr Must be between + [65536, 4194304] + fs.file-max Must be between + [104857, 67108864] + fs.inotify.max_user_instances Must be between + [8192, 1048576] + fs.inotify.max_user_watches Must be between + [8192, 1048576] + fs.nr_open Must be between + [1048576, + 2147483584] + vm.dirty_background_ratio Must be between + [1, 100] + vm.dirty_expire_centisecs Must be between + [0, 6000] + vm.dirty_ratio Must be between + [1, 100] + vm.dirty_writeback_centisecs Must be between + [0, 1000] vm.max_map_count Must be between [65536, 2147483647] + vm.overcommit_memory Must be one of {0, + 1, 2} + vm.overcommit_ratio Must be between + [0, 100] + vm.vfs_cache_pressure Must be between + [0, 100] + vm.swappiness Must be between + [0, 200] + vm.watermark_scale_factor Must be between + [10, 3000] + vm.min_free_kbytes Must be between + [67584, 1048576] List of supported hugepage size in 'hugepageConfig'. @@ -1450,6 +1495,47 @@ FLAGS ◆ CGROUP_MODE_V2: Use cgroupv2 on the node pool. ◆ CGROUP_MODE_UNSPECIFIED: Use the default GKE cgroup configuration. + Supported values for 'transparentHugepageEnabled' under 'linuxConfig' + which controls transparent hugepage support for anonymous memory. + + ◆ TRANSPARENT_HUGEPAGE_ENABLED_ALWAYS: Transparent hugepage is + enabled system wide. + ◆ TRANSPARENT_HUGEPAGE_ENABLED_MADVISE: Transparent hugepage is + enabled inside MADV_HUGEPAGE regions. This is the default kernel + configuration. + ◆ TRANSPARENT_HUGEPAGE_ENABLED_NEVER: Transparent hugepage is + disabled. + ◆ TRANSPARENT_HUGEPAGE_ENABLED_UNSPECIFIED: Default value. GKE will + not modify the kernel configuration. + + Supported values for 'transparentHugepageDefrag' under 'linuxConfig' + which defines the transparent hugepage defrag configuration on the + node. + + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_ALWAYS: It means that an application + requesting THP will stall on allocation failure and directly reclaim + pages and compact memory in an effort to allocate a THP immediately. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_DEFER: It means that an application + will wake kswapd in the background to reclaim pages and wake + kcompactd to compact memory so that THP is available in the near + future. It is the responsibility of khugepaged to then install the + THP pages later. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_DEFER_WITH_MADVISE: It means that an + application will enter direct reclaim and compaction like always, but + only for regions that have used madvise(MADV_HUGEPAGE); all other + regions will wake kswapd in the background to reclaim pages and wake + kcompactd to compact memory so that THP is available in the near + future. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_MADVISE: It means that an application + will enter direct reclaim and compaction like always, but only for + regions that have used madvise(MADV_HUGEPAGE); all other regions will + wake kswapd in the background to reclaim pages and wake kcompactd to + compact memory so that THP is available in the near future. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_NEVER: It means that an application + will never enter direct reclaim or compaction. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_UNSPECIFIED: Default value. GKE will + not modify the kernel configuration. + Note, updating the system configuration of an existing node pool requires recreation of the nodes which which might cause a disruption. diff --git a/gcloud/container/clusters/create-auto b/gcloud/container/clusters/create-auto index e55cedf80..bebdc5bff 100644 --- a/gcloud/container/clusters/create-auto +++ b/gcloud/container/clusters/create-auto @@ -18,17 +18,19 @@ SYNOPSIS [--create-subnetwork=[KEY=VALUE,...]] [--database-encryption-key=DATABASE_ENCRYPTION_KEY] [--disable-l4-lb-firewall-reconciliation] - [--enable-authorized-networks-on-private-endpoint] + [--enable-authorized-networks-on-private-endpoint] [--enable-auto-ipam] [--enable-backup-restore] [--enable-cilium-clusterwide-network-policy] - [--enable-dns-access] [--enable-fleet] [--enable-google-cloud-access] - [--enable-ip-access] [--enable-kubernetes-unstable-apis=API,[API,...]] + [--enable-confidential-nodes] [--enable-dns-access] [--enable-fleet] + [--enable-google-cloud-access] [--enable-ip-access] + [--enable-kubernetes-unstable-apis=API,[API,...]] + [--enable-legacy-lustre-port] [--enable-lustre-csi-driver] [--enable-master-global-access] [--enable-multi-networking] [--enable-ray-cluster-logging] [--enable-ray-cluster-monitoring] [--enable-ray-operator] [--enable-secret-manager] [--fleet-project=PROJECT_ID_OR_NUMBER] [--hpa-profile=HPA_PROFILE] [--labels=[KEY=VALUE,...]] [--logging=[COMPONENT,...]] [--monitoring=[COMPONENT,...]] [--network=NETWORK] - [--private-endpoint-subnetwork=NAME] [--release-channel=[CHANNEL]] + [--private-endpoint-subnetwork=NAME] [--release-channel=CHANNEL] [--security-group=SECURITY_GROUP] [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] [--subnetwork=SUBNETWORK] [--tier=TIER] @@ -266,6 +268,10 @@ FLAGS Enable enforcement of --master-authorized-networks CIDR ranges for traffic reaching cluster's control plane via private IP. + --enable-auto-ipam + Enable the Auto IP Address Management (Auto IPAM) feature for the + cluster. + --enable-backup-restore Enable the Backup for GKE add-on. This add-on is disabled by default. To learn more, see the Backup for GKE overview: @@ -275,6 +281,11 @@ FLAGS Enable Cilium Clusterwide Network Policies on the cluster. Disabled by default. + --enable-confidential-nodes + Enable confidential nodes for the cluster. Enabling Confidential Nodes + will create nodes using Confidential VM + https://cloud.google.com/compute/confidential-vm/docs/about-cvm. + --enable-dns-access Enable access to the cluster's control plane over DNS-based endpoint. @@ -300,6 +311,16 @@ FLAGS expected to be production ready and should be avoided in production-grade environments. + --enable-legacy-lustre-port + Allow the Lustre CSI driver to initialize LNet (the virtual network + layer for Lustre kernel module) using port 6988. This flag is required + to workaround a port conflict with the gke-metadata-server on GKE + nodes. + + --enable-lustre-csi-driver + Enable the Lustre CSI Driver GKE add-on. This add-on is disabled by + default. + --enable-master-global-access Use with private clusters to allow access to the master's private endpoint from any Google Cloud region or on-premises environment @@ -392,7 +413,7 @@ FLAGS Sets the subnetwork GKE uses to provision the control plane's private endpoint. - --release-channel=[CHANNEL] + --release-channel=CHANNEL Release channel a cluster is subscribed to. If left unspecified and a version is specified, the cluster is enrolled @@ -408,8 +429,12 @@ FLAGS CHANNEL must be one of: - rapid + extended + Clusters subscribed to 'extended' can remain on a minor version for + 24 months from when the minor version is made available in the + Regular channel. + rapid 'rapid' channel is offered on an early access basis for customers who want to test new releases. @@ -417,24 +442,15 @@ FLAGS to unresolved issues with no known workaround and are not subject to any SLAs. - regular - + regular Clusters subscribed to 'regular' receive versions that are considered GA quality. 'regular' is intended for production users who want to take advantage of new features. - extended - - Clusters subscribed to 'extended' can remain on a minor version for 24 months - from when the minor version is made available in the Regular channel. - - stable - + stable Clusters subscribed to 'stable' receive versions that are known to be stable and reliable in production. - CHANNEL must be one of: rapid, regular, extended, stable. - --security-group=SECURITY_GROUP The name of the RBAC security group for use with Google security groups in Kubernetes RBAC diff --git a/gcloud/container/clusters/update b/gcloud/container/clusters/update index 194d2eca8..5b7f862d4 100644 --- a/gcloud/container/clusters/update +++ b/gcloud/container/clusters/update @@ -24,8 +24,9 @@ SYNOPSIS | --enable-intra-node-visibility | --enable-kubernetes-unstable-apis=API,[API,...] | --enable-l4-ilb-subsetting | --enable-legacy-authorization - | --enable-multi-networking | --enable-network-policy - | --enable-private-nodes | --[no-]enable-ray-cluster-logging + | --enable-legacy-lustre-port | --enable-multi-networking + | --enable-network-policy | --enable-private-nodes + | --[no-]enable-ray-cluster-logging | --[no-]enable-ray-cluster-monitoring | --enable-secret-manager | --enable-service-externalips | --enable-shielded-nodes | --enable-stackdriver-kubernetes | --enable-vertical-pod-autoscaling @@ -38,7 +39,7 @@ SYNOPSIS | --notification-config=[pubsub=ENABLED|DISABLED, pubsub-topic=TOPIC,...] | --patch-update=[PATCH_UPDATE] | --private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE - | --release-channel=[CHANNEL] | --remove-labels=[KEY,...] + | --release-channel=CHANNEL | --remove-labels=[KEY,...] | --remove-workload-policies=REMOVE_WORKLOAD_POLICIES | --security-group=SECURITY_GROUP | --security-posture=SECURITY_POSTURE | --set-password @@ -80,6 +81,7 @@ SYNOPSIS | --disable-dataplane-v2-flow-observability | --enable-dataplane-v2-flow-observability --disable-dataplane-v2-metrics | --enable-dataplane-v2-metrics + | --disable-auto-ipam | --enable-auto-ipam | --disable-l4-lb-firewall-reconciliation | --enable-l4-lb-firewall-reconciliation | --enable-authorized-networks-on-private-endpoint @@ -413,6 +415,12 @@ REQUIRED FLAGS use RBAC permissions instead, create or update your cluster with the option --no-enable-legacy-authorization. + --enable-legacy-lustre-port + Allow the Lustre CSI driver to initialize LNet (the virtual network + layer for Lustre kernel module) using port 6988. This flag is + required to workaround a port conflict with the gke-metadata-server + on GKE nodes. + --enable-multi-networking Enables multi-networking on the cluster. Multi-networking is disabled by default. @@ -647,7 +655,7 @@ REQUIRED FLAGS PRIVATE_IPV6_GOOGLE_ACCESS_TYPE must be one of: bidirectional, disabled, outbound-only. - --release-channel=[CHANNEL] + --release-channel=CHANNEL Subscribe or unsubscribe this cluster to a release channel. When a cluster is subscribed to a release channel, Google maintains @@ -658,8 +666,15 @@ REQUIRED FLAGS CHANNEL must be one of: - rapid + None + Use 'None' to opt-out of any release channel. + extended + Clusters subscribed to 'extended' can remain on a minor version + for 24 months from when the minor version is made available in + the Regular channel. + + rapid 'rapid' channel is offered on an early access basis for customers who want to test new releases. @@ -667,27 +682,14 @@ REQUIRED FLAGS to unresolved issues with no known workaround and are not subject to any SLAs. - regular - + regular Clusters subscribed to 'regular' receive versions that are considered GA quality. 'regular' is intended for production users who want to take advantage of new features. - extended - - Clusters subscribed to 'extended' can remain on a minor version for 24 months - from when the minor version is made available in the Regular channel. - - stable - - Clusters subscribed to 'stable' receive versions that are known to - be stable and reliable in production. - - None - - Use 'None' to opt-out of any release channel. - - CHANNEL must be one of: rapid, regular, extended, stable, None. + stable + Clusters subscribed to 'stable' receive versions that are known + to be stable and reliable in production. --remove-labels=[KEY,...] Labels to remove from the Google Cloud resources in use by the @@ -742,7 +744,7 @@ REQUIRED FLAGS existing username. --stack-type=STACK_TYPE - IP stack type of the node VMs. STACK_TYPE must be one of: ipv4, + IP stack type of the cluster nodes. STACK_TYPE must be one of: ipv4, ipv4-ipv6. --start-credential-rotation @@ -1173,6 +1175,16 @@ REQUIRED FLAGS --enable-dataplane-v2-metrics Exposes advanced datapath flow metrics on node port. + At most one of these can be specified: + + --disable-auto-ipam + Disable the Auto IP Address Management (Auto IPAM) feature for the + cluster. + + --enable-auto-ipam + Enable the Auto IP Address Management (Auto IPAM) feature for the + cluster. + At most one of these can be specified: --disable-l4-lb-firewall-reconciliation diff --git a/gcloud/container/node-pools/create b/gcloud/container/node-pools/create index f5994624e..2a58bc0db 100644 --- a/gcloud/container/node-pools/create +++ b/gcloud/container/node-pools/create @@ -49,6 +49,7 @@ SYNOPSIS [--sandbox=[type=TYPE]] [--secondary-boot-disk=[disk-image=DISK_IMAGE,[mode=MODE],...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] + [--sole-tenant-min-node-cpus=SOLE_TENANT_MIN_NODE_CPUS] [--sole-tenant-node-affinity-file=SOLE_TENANT_NODE_AFFINITY_FILE] [--spot] [--standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, @@ -677,6 +678,11 @@ FLAGS --shielded-secure-boot The instance will boot with secure boot enabled. + --sole-tenant-min-node-cpus=SOLE_TENANT_MIN_NODE_CPUS + A integer value that specifies the minimum number of vCPUs that each + sole tenant node must have to use CPU overcommit. If not specified, the + CPU overcommit feature is disabled. + --sole-tenant-node-affinity-file=SOLE_TENANT_NODE_AFFINITY_FILE JSON/YAML file containing the configuration of desired sole tenant nodes onto which this node pool could be backed by. These rules filter @@ -786,6 +792,8 @@ FLAGS 'fs.mqueue.*', and 'net.*', and sysctls under the groups.) singleProcessOomKill true or false + maxParallelImagePulls integer (The value must be + between [2, 5].) KEY VALUE policy either 'Static' or 'None' @@ -822,6 +830,8 @@ FLAGS net.ipv4.tcp_wmem Any positive integer tuple net.ipv4.tcp_tw_reuse Must be {0, 1, 2} + net.ipv4.tcp_max_orphans Must be between + [16384, 262144] net.netfilter.nf_conntrack_max Must be between [65536, 4194304] net.netfilter.nf_conntrack_buckets Must be between @@ -847,9 +857,40 @@ FLAGS [0, 184467440736927743 99] + fs.aio-max-nr Must be between + [65536, 4194304] + fs.file-max Must be between + [104857, 67108864] + fs.inotify.max_user_instances Must be between + [8192, 1048576] + fs.inotify.max_user_watches Must be between + [8192, 1048576] + fs.nr_open Must be between + [1048576, + 2147483584] + vm.dirty_background_ratio Must be between + [1, 100] + vm.dirty_expire_centisecs Must be between + [0, 6000] + vm.dirty_ratio Must be between + [1, 100] + vm.dirty_writeback_centisecs Must be between + [0, 1000] vm.max_map_count Must be between [65536, 2147483647] + vm.overcommit_memory Must be one of {0, + 1, 2} + vm.overcommit_ratio Must be between + [0, 100] + vm.vfs_cache_pressure Must be between + [0, 100] + vm.swappiness Must be between + [0, 200] + vm.watermark_scale_factor Must be between + [10, 3000] + vm.min_free_kbytes Must be between + [67584, 1048576] List of supported hugepage size in 'hugepageConfig'. @@ -870,6 +911,47 @@ FLAGS ◆ CGROUP_MODE_V2: Use cgroupv2 on the node pool. ◆ CGROUP_MODE_UNSPECIFIED: Use the default GKE cgroup configuration. + Supported values for 'transparentHugepageEnabled' under 'linuxConfig' + which controls transparent hugepage support for anonymous memory. + + ◆ TRANSPARENT_HUGEPAGE_ENABLED_ALWAYS: Transparent hugepage is + enabled system wide. + ◆ TRANSPARENT_HUGEPAGE_ENABLED_MADVISE: Transparent hugepage is + enabled inside MADV_HUGEPAGE regions. This is the default kernel + configuration. + ◆ TRANSPARENT_HUGEPAGE_ENABLED_NEVER: Transparent hugepage is + disabled. + ◆ TRANSPARENT_HUGEPAGE_ENABLED_UNSPECIFIED: Default value. GKE will + not modify the kernel configuration. + + Supported values for 'transparentHugepageDefrag' under 'linuxConfig' + which defines the transparent hugepage defrag configuration on the + node. + + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_ALWAYS: It means that an application + requesting THP will stall on allocation failure and directly reclaim + pages and compact memory in an effort to allocate a THP immediately. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_DEFER: It means that an application + will wake kswapd in the background to reclaim pages and wake + kcompactd to compact memory so that THP is available in the near + future. It is the responsibility of khugepaged to then install the + THP pages later. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_DEFER_WITH_MADVISE: It means that an + application will enter direct reclaim and compaction like always, but + only for regions that have used madvise(MADV_HUGEPAGE); all other + regions will wake kswapd in the background to reclaim pages and wake + kcompactd to compact memory so that THP is available in the near + future. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_MADVISE: It means that an application + will enter direct reclaim and compaction like always, but only for + regions that have used madvise(MADV_HUGEPAGE); all other regions will + wake kswapd in the background to reclaim pages and wake kcompactd to + compact memory so that THP is available in the near future. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_NEVER: It means that an application + will never enter direct reclaim or compaction. + ◆ TRANSPARENT_HUGEPAGE_DEFRAG_UNSPECIFIED: Default value. GKE will + not modify the kernel configuration. + Note, updating the system configuration of an existing node pool requires recreation of the nodes which which might cause a disruption. diff --git a/gcloud/container/node-pools/update b/gcloud/container/node-pools/update index 9b7f11e92..42ba21800 100644 --- a/gcloud/container/node-pools/update +++ b/gcloud/container/node-pools/update @@ -345,6 +345,8 @@ REQUIRED FLAGS 'fs.mqueue.*', and 'net.*', and sysctls under the groups.) singleProcessOomKill true or false + maxParallelImagePulls integer (The value must be + between [2, 5].) KEY VALUE policy either 'Static' or @@ -388,6 +390,8 @@ REQUIRED FLAGS integer tuple net.ipv4.tcp_tw_reuse Must be {0, 1, 2} + net.ipv4.tcp_max_orphans Must be between + [16384, 262144] net.netfilter.nf_conntrack_max Must be between [65536, 4194304] net.netfilter.nf_conntrack_buckets Must be between @@ -415,9 +419,41 @@ REQUIRED FLAGS [0, 1844674407369277 4399] + fs.aio-max-nr Must be between + [65536, 4194304] + fs.file-max Must be between + [104857, + 67108864] + fs.inotify.max_user_instances Must be between + [8192, 1048576] + fs.inotify.max_user_watches Must be between + [8192, 1048576] + fs.nr_open Must be between + [1048576, + 2147483584] + vm.dirty_background_ratio Must be between + [1, 100] + vm.dirty_expire_centisecs Must be between + [0, 6000] + vm.dirty_ratio Must be between + [1, 100] + vm.dirty_writeback_centisecs Must be between + [0, 1000] vm.max_map_count Must be between [65536, 2147483647] + vm.overcommit_memory Must be one of + {0, 1, 2} + vm.overcommit_ratio Must be between + [0, 100] + vm.vfs_cache_pressure Must be between + [0, 100] + vm.swappiness Must be between + [0, 200] + vm.watermark_scale_factor Must be between + [10, 3000] + vm.min_free_kbytes Must be between + [67584, 1048576] List of supported hugepage size in 'hugepageConfig'. @@ -439,6 +475,49 @@ REQUIRED FLAGS ▸ CGROUP_MODE_UNSPECIFIED: Use the default GKE cgroup configuration. + Supported values for 'transparentHugepageEnabled' under 'linuxConfig' + which controls transparent hugepage support for anonymous memory. + + ▸ TRANSPARENT_HUGEPAGE_ENABLED_ALWAYS: Transparent hugepage is + enabled system wide. + ▸ TRANSPARENT_HUGEPAGE_ENABLED_MADVISE: Transparent hugepage is + enabled inside MADV_HUGEPAGE regions. This is the default kernel + configuration. + ▸ TRANSPARENT_HUGEPAGE_ENABLED_NEVER: Transparent hugepage is + disabled. + ▸ TRANSPARENT_HUGEPAGE_ENABLED_UNSPECIFIED: Default value. GKE will + not modify the kernel configuration. + + Supported values for 'transparentHugepageDefrag' under 'linuxConfig' + which defines the transparent hugepage defrag configuration on the + node. + + ▸ TRANSPARENT_HUGEPAGE_DEFRAG_ALWAYS: It means that an application + requesting THP will stall on allocation failure and directly + reclaim pages and compact memory in an effort to allocate a THP + immediately. + ▸ TRANSPARENT_HUGEPAGE_DEFRAG_DEFER: It means that an application + will wake kswapd in the background to reclaim pages and wake + kcompactd to compact memory so that THP is available in the near + future. It is the responsibility of khugepaged to then install the + THP pages later. + ▸ TRANSPARENT_HUGEPAGE_DEFRAG_DEFER_WITH_MADVISE: It means that an + application will enter direct reclaim and compaction like always, + but only for regions that have used madvise(MADV_HUGEPAGE); all + other regions will wake kswapd in the background to reclaim pages + and wake kcompactd to compact memory so that THP is available in + the near future. + ▸ TRANSPARENT_HUGEPAGE_DEFRAG_MADVISE: It means that an application + will enter direct reclaim and compaction like always, but only for + regions that have used madvise(MADV_HUGEPAGE); all other regions + will wake kswapd in the background to reclaim pages and wake + kcompactd to compact memory so that THP is available in the near + future. + ▸ TRANSPARENT_HUGEPAGE_DEFRAG_NEVER: It means that an application + will never enter direct reclaim or compaction. + ▸ TRANSPARENT_HUGEPAGE_DEFRAG_UNSPECIFIED: Default value. GKE will + not modify the kernel configuration. + Note, updating the system configuration of an existing node pool requires recreation of the nodes which which might cause a disruption. diff --git a/gcloud/container/vmware/admin-clusters/unenroll b/gcloud/container/vmware/admin-clusters/unenroll index 2dea24e95..2cb9e5715 100644 --- a/gcloud/container/vmware/admin-clusters/unenroll +++ b/gcloud/container/vmware/admin-clusters/unenroll @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud container vmware admin-clusters unenroll (ADMIN_CLUSTER : --location=LOCATION) [--allow-missing] [--async] - [--validate-only] [GCLOUD_WIDE_FLAG ...] + [--ignore-errors] [--validate-only] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Unenroll an Anthos on VMware admin cluster. @@ -59,6 +59,10 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --ignore-errors + If set, the unenrollment of a VMware admin cluster resource will + succeed even if errors occur during deletion. + --validate-only If set, only validate the request, but do not actually perform the operation. diff --git a/gcloud/database-migration/connection-profiles/create/postgresql b/gcloud/database-migration/connection-profiles/create/postgresql index 9bf34ed7e..89bfe5f31 100644 --- a/gcloud/database-migration/connection-profiles/create/postgresql +++ b/gcloud/database-migration/connection-profiles/create/postgresql @@ -11,7 +11,7 @@ SYNOPSIS [--ca-certificate=CA_CERTIFICATE : --ssl-type=SSL_TYPE --client-certificate=CLIENT_CERTIFICATE --private-key=PRIVATE_KEY] [--host=HOST --port=PORT --username=USERNAME (--password=PASSWORD - | --prompt-for-password)] + | --prompt-for-password) : --database=DATABASE] [--psc-service-attachment=PSC_SERVICE_ATTACHMENT | --static-ip-connectivity] [GCLOUD_WIDE_FLAG ...] @@ -137,6 +137,9 @@ FLAGS database. Database Migration Service encrypts the value when storing it. + --database=DATABASE + The name of the specific database within the host. + Exactly one of these must be specified: --password=PASSWORD diff --git a/gcloud/database-migration/connection-profiles/create/sqlserver b/gcloud/database-migration/connection-profiles/create/sqlserver index bee8f948b..45391a328 100644 --- a/gcloud/database-migration/connection-profiles/create/sqlserver +++ b/gcloud/database-migration/connection-profiles/create/sqlserver @@ -74,7 +74,7 @@ FLAGS Waits for the operation in progress to complete before returning. --database=DATABASE - The specific database within the host. + The name of the specific database within the host. --display-name=DISPLAY_NAME A user-friendly name for the connection profile. The display name can diff --git a/gcloud/database-migration/connection-profiles/update b/gcloud/database-migration/connection-profiles/update index aa08f38c9..de46f3ff1 100644 --- a/gcloud/database-migration/connection-profiles/update +++ b/gcloud/database-migration/connection-profiles/update @@ -97,7 +97,7 @@ FLAGS only supported for source connection profiles for SQL Server. --database=DATABASE - The specific database within the host. + The name of the specific database within the host. --database-service=DATABASE_SERVICE database service for the oracle connection profile. diff --git a/gcloud/database-migration/conversion-workspaces/help b/gcloud/database-migration/conversion-workspaces/help index 8e938bb85..86a2ff007 100644 --- a/gcloud/database-migration/conversion-workspaces/help +++ b/gcloud/database-migration/conversion-workspaces/help @@ -3,7 +3,7 @@ NAME Service conversion workspaces SYNOPSIS - gcloud database-migration conversion-workspaces COMMAND + gcloud database-migration conversion-workspaces GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -14,6 +14,12 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +GROUPS + GROUP is one of the following: + + mapping-rules + Manage Database Migration Service Conversion Workspace mapping rules. + COMMANDS COMMAND is one of the following: diff --git a/gcloud/database-migration/conversion-workspaces/mapping-rules/help b/gcloud/database-migration/conversion-workspaces/mapping-rules/help new file mode 100644 index 000000000..48d8825ae --- /dev/null +++ b/gcloud/database-migration/conversion-workspaces/mapping-rules/help @@ -0,0 +1,22 @@ +NAME + gcloud database-migration conversion-workspaces mapping-rules - manage + Database Migration Service Conversion Workspace mapping rules + +SYNOPSIS + gcloud database-migration conversion-workspaces mapping-rules COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Commands for managing Database Migration Service Conversion Workspace + mapping rules. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List Mapping Rules. diff --git a/gcloud/database-migration/conversion-workspaces/mapping-rules/list b/gcloud/database-migration/conversion-workspaces/mapping-rules/list new file mode 100644 index 000000000..9847d2234 --- /dev/null +++ b/gcloud/database-migration/conversion-workspaces/mapping-rules/list @@ -0,0 +1,95 @@ +NAME + gcloud database-migration conversion-workspaces mapping-rules list - list + Mapping Rules + +SYNOPSIS + gcloud database-migration conversion-workspaces mapping-rules list + (--conversion-workspace=CONVERSION_WORKSPACE : --region=REGION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List mapping rules. + +EXAMPLES + To list all mapping rules in a project and location us-central1, run: + + $ gcloud database-migration conversion-workspaces mapping-rules \ + list --conversion-workspace=my-conversion-workspace \ + --region=us-central1 + +REQUIRED FLAGS + Conversion workspace resource - The conversion workspace you want to list + mapping rules for. 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 --conversion-workspace 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. + + --conversion-workspace=CONVERSION_WORKSPACE + ID of the conversion_workspace or fully qualified identifier for the + conversion_workspace. + + To set the conversion_workspace attribute: + ▸ provide the argument --conversion-workspace on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --region=REGION + The name of the region. + + To set the region attribute: + ▸ provide the argument --conversion-workspace on the command line + with a fully specified name; + ▸ provide the argument --region on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --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 datamigration/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/database-migration/ diff --git a/gcloud/database-migration/private-connections/create b/gcloud/database-migration/private-connections/create index 1bcf773c7..4b4c908cc 100644 --- a/gcloud/database-migration/private-connections/create +++ b/gcloud/database-migration/private-connections/create @@ -5,20 +5,29 @@ NAME SYNOPSIS gcloud database-migration private-connections create (PRIVATE_CONNECTION : --region=REGION) --display-name=DISPLAY_NAME - (--subnet=SUBNET --vpc=VPC) [--no-async] [--labels=[KEY=VALUE,...]] - [--skip-validation] [GCLOUD_WIDE_FLAG ...] + (--network-attachment=NETWORK_ATTACHMENT | --subnet=SUBNET --vpc=VPC) + [--no-async] [--labels=[KEY=VALUE,...]] [--skip-validation] + [--validate-only] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a Database Migration private connection EXAMPLES - To create a private connection called 'my-private-connection', run: + To create a private connection with VPC Peering called + 'my-private-connection', run: $ gcloud database-migration private-connections create \ my-private-connection --region=us-central1 \ --display-name=my-private-connection --vpc=vpc-example \ --subnet=10.0.0.0/29 + To create a private connection with PSC Interface called 'my-privateConnection', run: + + $ gcloud database-migration private-connections create \ + my-private-connection --location=us-central1 \ + --display-name=my-private-connection \ + --network-attachment=network-attachment-example + To use a private connection, all migrations and connection profiles that use this configuration must be in the same region. POSITIONAL ARGUMENTS @@ -59,31 +68,40 @@ REQUIRED FLAGS include letters, numbers, spaces, and hyphens, and must start with a letter. The maximum length allowed is 60 characters. - This must be specified. + Exactly one of these must be specified: - --subnet=SUBNET - A free subnet for peering. (CIDR of /29). + Arguments for Private Service Connect Interface configuration. - This flag argument must be specified if any of the other arguments in - this group are specified. + --network-attachment=NETWORK_ATTACHMENT + Full URI of the network attachment that datastream will connect + to.For example, this would be of the + form:network-attachment=projects/test-project/regions/us-central1/networkAttachments/my-na - Vpc resource - Resource name of the private connection. This represents - a Cloud resource. (NOTE) Some attributes are not given arguments in this - group but can be set in other ways. + Arguments for VPC Peering configuration. - To set the project attribute: - ▸ provide the argument --vpc on the command line with a fully - specified name; - ▸ provide the argument --project on the command line; - ▸ set the property core/project. + --subnet=SUBNET + A free subnet for peering. (CIDR of /29). - This must be specified. + This flag argument must be specified if any of the other arguments + in this group are specified. - --vpc=VPC - ID of the vpc or fully qualified identifier for the vpc. + Vpc resource - Resource ID of the VPC network to peer with. 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 vpc attribute: - ▫ provide the argument --vpc on the command line. + To set the project attribute: + ▫ provide the argument --vpc 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. + + --vpc=VPC + ID of the vpc or fully qualified identifier for the vpc. + + To set the vpc attribute: + ◇ provide the argument --vpc on the command line. OPTIONAL FLAGS --no-async @@ -100,6 +118,10 @@ OPTIONAL FLAGS --skip-validation Creates the private connection without running prior verifications. + --validate-only + If set, the request will retrieve the project id to allow in the + network attachment Datastream will connect to. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/dataflow/flex-template/build b/gcloud/dataflow/flex-template/build index 8bb82320c..65fc4ea44 100644 --- a/gcloud/dataflow/flex-template/build +++ b/gcloud/dataflow/flex-template/build @@ -88,11 +88,11 @@ REQUIRED FLAGS --flex-template-base-image=FLEX_TEMPLATE_BASE_IMAGE Flex template base image to be used while building the container - image. Allowed choices are JAVA8, JAVA11, JAVA17, JAVA21 or gcr.io - path of the specific version of the base image. For JAVA8, JAVA11, - JAVA17 and JAVA21 option, we use the latest base image version to - build the container. You can also provide a specific version from - this link https://gcr.io/dataflow-templates-base/ + image. Allowed choices are allowed labels (JAVA11, JAVA17, JAVA21, + PYTHON3, GO), or full gcr.io path of the specific version of the base + image. For labels, we use the latest base image version to build the + container. You can also provide a specific version from this link + https://gcr.io/dataflow-templates-base/ This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/dataflow/jobs/archive b/gcloud/dataflow/jobs/archive new file mode 100644 index 000000000..b8474ec9c --- /dev/null +++ b/gcloud/dataflow/jobs/archive @@ -0,0 +1,39 @@ +NAME + gcloud dataflow jobs archive - archives a job + +SYNOPSIS + gcloud dataflow jobs archive JOB_ID [--region=REGION_ID] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Archives a single job. The job must be in a terminal state, otherwise the + request will be rejected. + + This command will require confirmation to run. + +EXAMPLES + To archive job 2025-03-15_14_23_56-1234567890123456, run: + + $ gcloud dataflow jobs archive 2025-03-15_14_23_56-1234567890123456 + +POSITIONAL ARGUMENTS + JOB_ID + Job ID to operate on. + +FLAGS + --region=REGION_ID + Region ID of the job's regional endpoint. Defaults to 'us-central1'. + +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 beta dataflow jobs archive + diff --git a/gcloud/dataflow/jobs/help b/gcloud/dataflow/jobs/help index c96adfcbb..b0883716a 100644 --- a/gcloud/dataflow/jobs/help +++ b/gcloud/dataflow/jobs/help @@ -16,6 +16,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + archive + Archives a job. + cancel Cancels all jobs that match the command line arguments. diff --git a/gcloud/developer-connect/connections/create b/gcloud/developer-connect/connections/create index 66a2999f7..85add8486 100644 --- a/gcloud/developer-connect/connections/create +++ b/gcloud/developer-connect/connections/create @@ -116,14 +116,20 @@ FLAGS --labels=path_to_file.(yaml|json) --location=LOCATION - For resources [connection, cryptoKey, service], provides fallback value + For resources [connection, + bitbucket-data-center-config-service-directory, + crypto-key-config-reference, + github-enterprise-config-service-directory, + gitlab-enterprise-config-service-directory], provides fallback value for resource location attribute. When the resource's full URI path is not provided, location will fallback to this flag value. --namespace=NAMESPACE - For resources [service], provides fallback value for resource namespace - attribute. When the resource's full URI path is not provided, namespace - will fallback to this flag value. + For resources [bitbucket-data-center-config-service-directory, + github-enterprise-config-service-directory, + gitlab-enterprise-config-service-directory], provides fallback value + for resource namespace attribute. When the resource's full URI path is + not provided, namespace will fallback to this flag value. --request-id=REQUEST_ID An optional request ID to identify requests. Specify a unique request @@ -141,9 +147,24 @@ FLAGS is not supported (00000000-0000-0000-0000-000000000000). --secret=SECRET - For resources [secretVersion], provides fallback value for resource - secret attribute. When the resource's full URI path is not provided, - secret will fallback to this flag value. + For resources + [bitbucket-cloud-config-authorizer-credential-user-token-secret-version, + bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version, + bitbucket-cloud-config-webhook-secret-version, + bitbucket-data-center-config-authorizer-credential-user-token-secret-version, + bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version, + bitbucket-data-center-config-webhook-secret-version, + github-config-authorizer-credential-oauth-token-secret-version, + github-enterprise-config-private-key-secret-version, + github-enterprise-config-webhook-secret-version, + gitlab-config-authorizer-credential-user-token-secret-version, + gitlab-config-read-authorizer-credential-user-token-secret-version, + gitlab-config-webhook-secret-version, + gitlab-enterprise-config-authorizer-credential-user-token-secret-version, + gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version, + gitlab-enterprise-config-webhook-secret-version], provides fallback + value for resource secret attribute. When the resource's full URI path + is not provided, secret will fallback to this flag value. --validate-only If set, validate the request, but do not actually post it. diff --git a/gcloud/developer-connect/connections/update b/gcloud/developer-connect/connections/update index 43cf1e6c6..c5c0e66fe 100644 --- a/gcloud/developer-connect/connections/update +++ b/gcloud/developer-connect/connections/update @@ -81,14 +81,20 @@ FLAGS client has an up-to-date value before proceeding. --location=LOCATION - For resources [connection, cryptoKey, service], provides fallback value + For resources [connection, + bitbucket-data-center-config-service-directory, + crypto-key-config-reference, + github-enterprise-config-service-directory, + gitlab-enterprise-config-service-directory], provides fallback value for resource location attribute. When the resource's full URI path is not provided, location will fallback to this flag value. --namespace=NAMESPACE - For resources [service], provides fallback value for resource namespace - attribute. When the resource's full URI path is not provided, namespace - will fallback to this flag value. + For resources [bitbucket-data-center-config-service-directory, + github-enterprise-config-service-directory, + gitlab-enterprise-config-service-directory], provides fallback value + for resource namespace attribute. When the resource's full URI path is + not provided, namespace will fallback to this flag value. --request-id=REQUEST_ID An optional request ID to identify requests. Specify a unique request @@ -106,9 +112,21 @@ FLAGS is not supported (00000000-0000-0000-0000-000000000000). --secret=SECRET - For resources [secretVersion], provides fallback value for resource - secret attribute. When the resource's full URI path is not provided, - secret will fallback to this flag value. + For resources + [bitbucket-cloud-config-authorizer-credential-user-token-secret-version, + bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version, + bitbucket-data-center-config-authorizer-credential-user-token-secret-version, + bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version, + github-config-authorizer-credential-oauth-token-secret-version, + github-enterprise-config-private-key-secret-version, + github-enterprise-config-webhook-secret-version, + gitlab-config-authorizer-credential-user-token-secret-version, + gitlab-config-read-authorizer-credential-user-token-secret-version, + gitlab-enterprise-config-authorizer-credential-user-token-secret-version, + gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version], + provides fallback value for resource secret attribute. When the + resource's full URI path is not provided, secret will fallback to this + flag value. --[no-]validate-only If set, validate the request, but do not actually post it. Use diff --git a/gcloud/edge-cloud/container/clusters/create b/gcloud/edge-cloud/container/clusters/create index 01e6d08a8..5e2412b06 100644 --- a/gcloud/edge-cloud/container/clusters/create +++ b/gcloud/edge-cloud/container/clusters/create @@ -14,6 +14,7 @@ SYNOPSIS [--control-plane-node-storage-schema=CONTROL_PLANE_NODE_STORAGE_SCHEMA] [--control-plane-shared-deployment-policy=CONTROL_PLANE_SHARED_DEPLOYMENT_POLICY] [--default-max-pods-per-node=DEFAULT_MAX_PODS_PER_NODE] + [--enable-google-group-authentication] [--external-lb-ipv4-address-pools=[EXTERNAL_LB_IPV4_ADDRESS,...]] [--fleet-project=FLEET_PROJECT] [--labels=[KEY=VALUE,...]] [--lro-timeout=LRO_TIMEOUT] @@ -123,6 +124,10 @@ FLAGS --default-max-pods-per-node=DEFAULT_MAX_PODS_PER_NODE The default maximum number of pods per node. + --enable-google-group-authentication + If set, the cluster will be configured to use Google Group + authentication. + --external-lb-ipv4-address-pools=[EXTERNAL_LB_IPV4_ADDRESS,...] IPv4 address pools that are used for data plane load balancing of local control plane clusters. Existing pools cannot be updated after cluster diff --git a/gcloud/edge-cloud/container/vpn-connections/create b/gcloud/edge-cloud/container/vpn-connections/create index 7208952fd..aa3de5a10 100644 --- a/gcloud/edge-cloud/container/vpn-connections/create +++ b/gcloud/edge-cloud/container/vpn-connections/create @@ -98,7 +98,7 @@ OPTIONAL FLAGS numbers. --location=LOCATION - For resources [vpn connection, cluster], provides fallback value for + For resources [cluster, vpn_connection], provides fallback value for resource location attribute. When the resource's full URI path is not provided, location will fallback to this flag value. diff --git a/gcloud/firestore/databases/create b/gcloud/firestore/databases/create index 75ed5ba7b..28a58efff 100644 --- a/gcloud/firestore/databases/create +++ b/gcloud/firestore/databases/create @@ -6,8 +6,8 @@ SYNOPSIS gcloud firestore databases create --location=LOCATION [--database=DATABASE; default="(default)"] [--delete-protection] [--edition=EDITION; default="standard"] [--enable-pitr] - [--kms-key-name=KMS_KEY_NAME] [--type=TYPE; default="firestore-native"] - [GCLOUD_WIDE_FLAG ...] + [--kms-key-name=KMS_KEY_NAME] [--tags=[KEY=VALUE,...]] + [--type=TYPE; default="firestore-native"] [GCLOUD_WIDE_FLAG ...] EXAMPLES To create a Firestore Enterprise database named foo in nam5 for use with @@ -20,6 +20,11 @@ EXAMPLES $ gcloud firestore databases create --location=nam5 + To create a Firestore Native database in us-central1 with tags. + + $ gcloud firestore databases create --location=us-central1 \ + --tags=key1=value1,key2=value2 + To create a Datastore Mode database in us-east1. $ gcloud firestore databases create --location=us-east1 \ @@ -105,6 +110,14 @@ OPTIONAL FLAGS How to retrieve this resource ID is listed at https://cloud.google.com/kms/docs/getting-resource-ids#getting_the_id_for_a_key_and_version. + --tags=[KEY=VALUE,...] + Tags to attach to the destination database. Example: + --tags=key1=value1,key2=value2 + + For example, to attach tags to a database: + + $ --tags=key1=value1,key2=value2 + --type=TYPE; default="firestore-native" The type of the database. TYPE must be one of: firestore-native, datastore-mode. diff --git a/gcloud/firestore/databases/restore b/gcloud/firestore/databases/restore index 33042a66a..1c8956740 100644 --- a/gcloud/firestore/databases/restore +++ b/gcloud/firestore/databases/restore @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud firestore databases restore --destination-database=DESTINATION_DATABASE - --source-backup=SOURCE_BACKUP + --source-backup=SOURCE_BACKUP [--tags=[KEY=VALUE,...]] [--encryption-type=ENCRYPTION_TYPE : --kms-key-name=KMS_KEY_NAME] [GCLOUD_WIDE_FLAG ...] @@ -16,6 +16,13 @@ EXAMPLES --source-backup=projects/PROJECT_ID/locations/LOCATION_ID/\ backups/BACKUP_ID --destination-database=DATABASE_ID + To restore a database from a backup with tags. + + $ gcloud firestore databases restore \ + --source-backup=projects/PROJECT_ID/locations/LOCATION_ID/\ + backups/BACKUP_ID --destination-database=DATABASE_ID \ + --tags=key1=value1,key2=value2 + To restore to a CMEK-enabled database. $ gcloud firestore databases restore \ @@ -32,8 +39,7 @@ REQUIRED FLAGS This value should be 4-63 characters. Valid characters are /[a-z][0-9]-/ with first character a letter and the last a letter or a - number. Must not be UUID-like - /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. + number. Must not be UUID-like /[0-9a-f]8(-[0-9a-f]4)3-[0-9a-f]12/. Using "(default)" database ID is also allowed. @@ -52,6 +58,14 @@ REQUIRED FLAGS cf9f748a-7980-4703-b1a1-d1ffff591db0 OPTIONAL FLAGS + --tags=[KEY=VALUE,...] + Tags to attach to the destination database. Example: + --tags=key1=value1,key2=value2 + + For example, to attach tags to a database: + + $ --tags=key1=value1,key2=value2 + The encryption configuration of the new database being created from the backup. If not specified, the same encryption settings as the backup will be used. diff --git a/gcloud/gemini/help b/gcloud/gemini/help index 170dc9a5f..ae709b486 100644 --- a/gcloud/gemini/help +++ b/gcloud/gemini/help @@ -1,11 +1,13 @@ NAME - gcloud gemini - manage code repository index resources + gcloud gemini - manage resources associated with Gemini Code Assist and + Gemini Cloud Assist SYNOPSIS gcloud gemini GROUP [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Manage code repository index resources. + gcloud gemini commands are not associated with Gemini CLI + (https://github.com/google-gemini/gemini-cli). GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/iam/workforce-pools/providers/create-oidc b/gcloud/iam/workforce-pools/providers/create-oidc index ad563152b..081a4b472 100644 --- a/gcloud/iam/workforce-pools/providers/create-oidc +++ b/gcloud/iam/workforce-pools/providers/create-oidc @@ -31,7 +31,7 @@ EXAMPLES --workforce-pool="my-workforce-pool" --location="global" \ --display-name="My Workforce Pool Provider" \ --description="My workforce pool provider description." \ - --disabled --detailed_audit_logging \ + --disabled --detailed-audit-logging \ --attribute-mapping="google.subject=assertion.sub" \ --attribute-condition="true" --client-id="client-id" \ --client-secret-value="client-secret" \ diff --git a/gcloud/iam/workforce-pools/providers/create-saml b/gcloud/iam/workforce-pools/providers/create-saml index 137c7ee38..41a4b8823 100644 --- a/gcloud/iam/workforce-pools/providers/create-saml +++ b/gcloud/iam/workforce-pools/providers/create-saml @@ -26,7 +26,7 @@ EXAMPLES --workforce-pool="my-workforce-pool" --location="global" \ --display-name="My Workforce Pool Provider" \ --description="My workforce pool provider description." \ - --disabled --detailed_audit_logging \ + --disabled --detailed-audit-logging \ --attribute-mapping="google.subject=assertion.sub" \ --attribute-condition="true" \ --idp-metadata-path="path/to/metdata/file.xml" diff --git a/gcloud/iam/workforce-pools/providers/update-oidc b/gcloud/iam/workforce-pools/providers/update-oidc index f3bd0fbed..7fed9d25d 100644 --- a/gcloud/iam/workforce-pools/providers/update-oidc +++ b/gcloud/iam/workforce-pools/providers/update-oidc @@ -32,7 +32,7 @@ EXAMPLES --workforce-pool="my-workforce-pool" --location="global" \ --display-name="My Workforce Pool Provider" \ --description="My workforce pool provider description." \ - --disabled --detailed_audit_logging \ + --disabled --detailed-audit-logging \ --attribute-mapping="google.subject=assertion.sub" \ --attribute-condition="true" --client-id="client-id" \ --client-secret-value="client-secret" \ diff --git a/gcloud/iam/workforce-pools/providers/update-saml b/gcloud/iam/workforce-pools/providers/update-saml index b75d3c68c..e73d3fa8b 100644 --- a/gcloud/iam/workforce-pools/providers/update-saml +++ b/gcloud/iam/workforce-pools/providers/update-saml @@ -27,7 +27,7 @@ EXAMPLES --workforce-pool="my-workforce-pool" --location="global" \ --display-name="My Workforce Pool Provider" \ --description="My workforce pool provider description." \ - --disabled --detailed_audit_logging \ + --disabled --detailed-audit-logging \ --attribute-mapping="google.subject=assertion.sub" \ --attribute-condition="true" \ --idp-metadata-path="path/to/metdata/file.xml" diff --git a/gcloud/iap/help b/gcloud/iap/help index 952cb2fdc..7a1baf969 100644 --- a/gcloud/iap/help +++ b/gcloud/iap/help @@ -23,10 +23,10 @@ GROUPS GROUP is one of the following: oauth-brands - Manage IAP OAuth brands. + (DEPRECATED) Manage IAP OAuth brands. oauth-clients - Manage IAP OAuth clients. + (DEPRECATED) Manage IAP OAuth clients. settings Manage IAP settings. diff --git a/gcloud/iap/oauth-brands/create b/gcloud/iap/oauth-brands/create index 07c5207ba..1d9a22d74 100644 --- a/gcloud/iap/oauth-brands/create +++ b/gcloud/iap/oauth-brands/create @@ -6,6 +6,8 @@ SYNOPSIS --support_email=SUPPORT_EMAIL [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. + gcloud iap oauth-brands create is used to create a Cloud OAuth brand for the project. The brand is 'internal only', meaning OAuth clients created under it only accept requests from users who belong to the same G Suite diff --git a/gcloud/iap/oauth-brands/describe b/gcloud/iap/oauth-brands/describe index 9dd21f563..25e006626 100644 --- a/gcloud/iap/oauth-brands/describe +++ b/gcloud/iap/oauth-brands/describe @@ -5,6 +5,8 @@ SYNOPSIS gcloud iap oauth-brands describe NAME [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. + gcloud iap oauth-brands describe is used to describe a Cloud OAuth brand. EXAMPLES diff --git a/gcloud/iap/oauth-brands/help b/gcloud/iap/oauth-brands/help index 774b04241..f0e9adb07 100644 --- a/gcloud/iap/oauth-brands/help +++ b/gcloud/iap/oauth-brands/help @@ -5,7 +5,9 @@ SYNOPSIS gcloud iap oauth-brands COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Manage IAP OAuth brands. + (DEPRECATED) Manage IAP OAuth brands. + + This command is deprecated. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -16,13 +18,13 @@ COMMANDS COMMAND is one of the following: create - Create a Cloud OAuth brand for the project. + (DEPRECATED) Create a Cloud OAuth brand for the project. describe - Describe a Cloud OAuth brand. + (DEPRECATED) Describe a Cloud OAuth brand. list - List Cloud OAuth brands in the project. + (DEPRECATED) List Cloud OAuth brands in the project. NOTES These variants are also available: diff --git a/gcloud/iap/oauth-brands/list b/gcloud/iap/oauth-brands/list index fe9b4ad2a..17afcc036 100644 --- a/gcloud/iap/oauth-brands/list +++ b/gcloud/iap/oauth-brands/list @@ -6,6 +6,8 @@ SYNOPSIS [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. + gcloud iap oauth-brands list is used to list the Cloud OAuth brand in the project. diff --git a/gcloud/iap/oauth-clients/create b/gcloud/iap/oauth-clients/create index f06eb2f43..5da23f886 100644 --- a/gcloud/iap/oauth-clients/create +++ b/gcloud/iap/oauth-clients/create @@ -7,6 +7,8 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. + gcloud iap oauth-clients create is used to create an OAuth client in the project to be used by Cloud IAP. To call this command, the Cloud OAuth brand for the project must exist and be set for 'internal only'. The new diff --git a/gcloud/iap/oauth-clients/delete b/gcloud/iap/oauth-clients/delete index f4f509516..df85913e0 100644 --- a/gcloud/iap/oauth-clients/delete +++ b/gcloud/iap/oauth-clients/delete @@ -6,6 +6,8 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. + gcloud iap oauth-clients delete is used to delete a Cloud IAP OAuth client. Note this command cannot be used to delete any other type of OAuth client in your project. diff --git a/gcloud/iap/oauth-clients/describe b/gcloud/iap/oauth-clients/describe index 2ca654453..6bd15812b 100644 --- a/gcloud/iap/oauth-clients/describe +++ b/gcloud/iap/oauth-clients/describe @@ -6,6 +6,8 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. + gcloud iap oauth-clients describe is used to describe a Cloud IAP OAuth client. Note this command cannot be used to describe any other type of OAuth client in your project. diff --git a/gcloud/iap/oauth-clients/help b/gcloud/iap/oauth-clients/help index e595f05c7..5cac67c6d 100644 --- a/gcloud/iap/oauth-clients/help +++ b/gcloud/iap/oauth-clients/help @@ -5,6 +5,10 @@ SYNOPSIS gcloud iap oauth-clients COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Manage IAP OAuth clients. + + This command is deprecated. + Manage OAuth clients that are used by Cloud Identity-Aware Proxy. Note this API cannot be used as a generic management API for all OAuth clients in your project. @@ -18,19 +22,19 @@ COMMANDS COMMAND is one of the following: create - Create a Cloud IAP OAuth client in the project. + (DEPRECATED) Create a Cloud IAP OAuth client in the project. delete - Delete a Cloud IAP OAuth client. + (DEPRECATED) Delete a Cloud IAP OAuth client. describe - Describe a Cloud IAP OAuth client. + (DEPRECATED) Describe a Cloud IAP OAuth client. list - List Cloud IAP OAuth clients in the Cloud OAuth brand. + (DEPRECATED) List Cloud IAP OAuth clients in the Cloud OAuth brand. reset-secret - Reset a Cloud IAP OAuth client secret. + (DEPRECATED) Reset a Cloud IAP OAuth client secret. NOTES These variants are also available: diff --git a/gcloud/iap/oauth-clients/list b/gcloud/iap/oauth-clients/list index 955ba1d96..8a137f3b9 100644 --- a/gcloud/iap/oauth-clients/list +++ b/gcloud/iap/oauth-clients/list @@ -7,6 +7,8 @@ SYNOPSIS [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. + gcloud iap oauth-clients list is used to list Cloud IAP OAuth clients in a Cloud OAuth brand. Note this command will not list any other type of OAuth client in your project. diff --git a/gcloud/iap/oauth-clients/reset-secret b/gcloud/iap/oauth-clients/reset-secret index 747ccd68d..5ab0f81e7 100644 --- a/gcloud/iap/oauth-clients/reset-secret +++ b/gcloud/iap/oauth-clients/reset-secret @@ -7,6 +7,8 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated. + gcloud iap oauth-clients reset-secret is used to reset a Cloud IAP OAuth client secret. Note this command cannot be used to reset the secret for any other type of OAuth client in your project. diff --git a/gcloud/looker/instances/create b/gcloud/looker/instances/create index 486b55402..34652eb08 100644 --- a/gcloud/looker/instances/create +++ b/gcloud/looker/instances/create @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud looker instances create (INSTANCE : --region=REGION) --edition=EDITION --oauth-client-id=OAUTH_CLIENT_ID - --oauth-client-secret=OAUTH_CLIENT_SECRET [--async] [--fips-enabled] - [--kms-key=KMS_KEY] [--no-public-ip-enabled] + --oauth-client-secret=OAUTH_CLIENT_SECRET [--async] + [--class-type=CLASS_TYPE] [--fips-enabled] [--kms-key=KMS_KEY] + [--no-public-ip-enabled] [--consumer-network=CONSUMER_NETWORK --private-ip-enabled : --reserved-range=RESERVED_RANGE] [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE @@ -141,6 +142,10 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --class-type=CLASS_TYPE + The class type of the Looker instance. CLASS_TYPE must be one of: p1, + r1. + --fips-enabled This specifies whether FIPS is enabled on the Looker instance. diff --git a/gcloud/looker/instances/update b/gcloud/looker/instances/update index 3e7871728..5547fd5d5 100644 --- a/gcloud/looker/instances/update +++ b/gcloud/looker/instances/update @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud looker instances update (INSTANCE : --region=REGION) [--allowed-email-domains=[ALLOWED_EMAIL_DOMAINS,...]] [--async] - [--custom-domain=CUSTOM_DOMAIN] + [--class-type=CLASS_TYPE] [--custom-domain=CUSTOM_DOMAIN] [--linked-lsp-project-number=LINKED_LSP_PROJECT_NUMBER] [--public-ip-enabled] [--add-developer-users=ADD_DEVELOPER_USERS @@ -12,7 +12,8 @@ SYNOPSIS --add-viewer-users=ADD_VIEWER_USERS] [--clear-psc-allowed-vpcs | --psc-allowed-vpcs=[PSC_ALLOWED_VPCS,...] --clear-psc-service-attachments - | --psc-service-attachment=[attachment=ATTACHMENT],[domain=DOMAIN]] + | --psc-service-attachment=[attachment=ATTACHMENT], + [domain=DOMAIN],[multiple-domains=MULTIPLE-DOMAINS]] [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE --deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE --deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--maintenance-window-day=MAINTENANCE_WINDOW_DAY @@ -80,6 +81,10 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --class-type=CLASS_TYPE + The class type of the Looker instance. CLASS_TYPE must be one of: p1, + r1. + Custom Domains - Looker (Google Cloud core) lets you serve your application through a custom domain. If you use a custom domain, Google will provide a managed auto-renewing SSL certificate for security. @@ -135,13 +140,17 @@ FLAGS --clear-psc-service-attachments Remove all allowed VPCs from the PSC config of the instance. - --psc-service-attachment=[attachment=ATTACHMENT],[domain=DOMAIN] + --psc-service-attachment=[attachment=ATTACHMENT],[domain=DOMAIN],[multiple-domains=MULTIPLE-DOMAINS] Service attachments representing egress connections for the Looker instance. This flag can be repeated. (Example: --psc-service-attachment domain="mydomain.com",attachment="projects/my-project/regions/us-east1/serviceAttachments/sa" --psc-service-attachments - domain="mydomain.com",attachment="projects/my-project/regions/us-east1/serviceAttachments/sa") + domain="mydomain2.com",attachment="projects/my-project/regions/us-east1/serviceAttachments/sa2") + + You can also assign multiple domains to a single service + attachment. (Example: --psc-service-attachment + multiple-domains="mydomain.com;mydomain2.com",attachment="projects/my-project/regions/us-east1/serviceAttachments/sa") Deny Maintanence Period - You must allow at least 48 hours of maintenance availability in a 60-day rolling window. Only contiguous availability diff --git a/gcloud/memorystore/instances/create b/gcloud/memorystore/instances/create index 55a870b11..31a29c00d 100644 --- a/gcloud/memorystore/instances/create +++ b/gcloud/memorystore/instances/create @@ -14,6 +14,7 @@ SYNOPSIS [--psc-auto-connections=[network=NETWORK], [port=PORT],[projectId=PROJECTID]] [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] + [--simulate-maintenance-event] [--transit-encryption-mode=TRANSIT_ENCRYPTION_MODE] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC --persistence-config-mode=PERSISTENCE_CONFIG_MODE @@ -191,9 +192,9 @@ FLAGS --labels=path_to_file.(yaml|json) --location=LOCATION - For resources [instance, cryptoKey], provides fallback value for - resource location attribute. When the resource's full URI path is not - provided, location will fallback to this flag value. + For resources [instance, kms-key, primary-instance], provides fallback + value for resource location attribute. When the resource's full URI + path is not provided, location will fallback to this flag value. Maintenance policy per instance. @@ -319,6 +320,11 @@ FLAGS --shard-count=SHARD_COUNT Number of shards for the instance. + Arguments for the simulate maintenance event. + + --simulate-maintenance-event + Simulate a maintenance event. + --transit-encryption-mode=TRANSIT_ENCRYPTION_MODE In-transit encryption mode of the instance. TRANSIT_ENCRYPTION_MODE must be one of: diff --git a/gcloud/memorystore/instances/update b/gcloud/memorystore/instances/update index 26f437051..190fb981e 100644 --- a/gcloud/memorystore/instances/update +++ b/gcloud/memorystore/instances/update @@ -9,6 +9,7 @@ SYNOPSIS [--location=LOCATION] [--mode=MODE] [--node-type=NODE_TYPE] [--[no-]ondemand-maintenance] [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] + [--[no-]simulate-maintenance-event] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC --clear-persistence-config --persistence-config-mode=PERSISTENCE_CONFIG_MODE @@ -106,9 +107,9 @@ FLAGS Engine version of the instance. --location=LOCATION - For resources [instance, cryptoKey], provides fallback value for - resource location attribute. When the resource's full URI path is not - provided, location will fallback to this flag value. + For resources [instance, kms-key, primary-instance], provides fallback + value for resource location attribute. When the resource's full URI + path is not provided, location will fallback to this flag value. --mode=MODE The mode config for the instance. MODE must be one of: @@ -163,6 +164,12 @@ FLAGS --shard-count=SHARD_COUNT Number of shards for the instance. + Arguments for the simulate maintenance event. + + --[no-]simulate-maintenance-event + Simulate a maintenance event. Use --simulate-maintenance-event to + enable and --no-simulate-maintenance-event to disable. + Represents persistence configuration for a instance. Configuration for AOF based persistence. diff --git a/gcloud/model-armor/floorsettings/describe b/gcloud/model-armor/floorsettings/describe index 7250b8c9e..6115425f2 100644 --- a/gcloud/model-armor/floorsettings/describe +++ b/gcloud/model-armor/floorsettings/describe @@ -22,7 +22,9 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This variant is also available: + These variants are also available: $ gcloud alpha model-armor floorsettings describe + $ gcloud beta model-armor floorsettings describe + diff --git a/gcloud/model-armor/floorsettings/help b/gcloud/model-armor/floorsettings/help index 8e447aad3..b934e8439 100644 --- a/gcloud/model-armor/floorsettings/help +++ b/gcloud/model-armor/floorsettings/help @@ -22,7 +22,9 @@ COMMANDS Update the FloorSetting resource. NOTES - This variant is also available: + These variants are also available: $ gcloud alpha model-armor floorsettings + $ gcloud beta model-armor floorsettings + diff --git a/gcloud/model-armor/floorsettings/update b/gcloud/model-armor/floorsettings/update index f296294dc..c34e5f573 100644 --- a/gcloud/model-armor/floorsettings/update +++ b/gcloud/model-armor/floorsettings/update @@ -117,7 +117,9 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This variant is also available: + These variants are also available: $ gcloud alpha model-armor floorsettings update + $ gcloud beta model-armor floorsettings update + diff --git a/gcloud/netapp/volumes/create b/gcloud/netapp/volumes/create index 9ebd7bd07..74d07af24 100644 --- a/gcloud/netapp/volumes/create +++ b/gcloud/netapp/volumes/create @@ -31,7 +31,7 @@ SYNOPSIS [--snap-reserve=SNAP_RESERVE] [--snapshot-daily=[hour=HOUR], [minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] - [--snapshot-directory=SNAPSHOT_DIRECTORY; default="true"] + [--snapshot-directory=SNAPSHOT_DIRECTORY] [--snapshot-hourly=[minute=MINUTE], [snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--snapshot-monthly=[day=DAY], @@ -246,7 +246,7 @@ OPTIONAL FLAGS --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] Make a snapshot every day e.g. at 06:00, 05:20, 23:50 - --snapshot-directory=SNAPSHOT_DIRECTORY; default="true" + --snapshot-directory=SNAPSHOT_DIRECTORY Snapshot Directory if enabled (true) makes the Volume contain a read-only .snapshot directory which provides access to each of the volume's snapshots diff --git a/gcloud/netapp/volumes/update b/gcloud/netapp/volumes/update index 1a4891c8c..cd15003d2 100644 --- a/gcloud/netapp/volumes/update +++ b/gcloud/netapp/volumes/update @@ -24,7 +24,7 @@ SYNOPSIS [--snap-reserve=SNAP_RESERVE] [--snapshot-daily=[hour=HOUR], [minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] - [--snapshot-directory=SNAPSHOT_DIRECTORY; default="true"] + [--snapshot-directory=SNAPSHOT_DIRECTORY] [--snapshot-hourly=[minute=MINUTE], [snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--snapshot-monthly=[day=DAY], @@ -158,7 +158,7 @@ FLAGS --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] Make a snapshot every day e.g. at 06:00, 05:20, 23:50 - --snapshot-directory=SNAPSHOT_DIRECTORY; default="true" + --snapshot-directory=SNAPSHOT_DIRECTORY Snapshot Directory if enabled (true) makes the Volume contain a read-only .snapshot directory which provides access to each of the volume's snapshots diff --git a/gcloud/network-connectivity/hubs/accept-spoke b/gcloud/network-connectivity/hubs/accept-spoke index 17a38bc37..25d717da8 100644 --- a/gcloud/network-connectivity/hubs/accept-spoke +++ b/gcloud/network-connectivity/hubs/accept-spoke @@ -14,8 +14,8 @@ EXAMPLES To accept a spoke named my-spoke into a hub named my-hub, run: $ gcloud network-connectivity hubs accept-spoke my-hub \ - --spoke="https://www.googleapis.com/networkconnectivity/v1/proje\ - cts/spoke-project/locations/global/hubs/my-spoke" + --spoke="https://networkconnectivity.googleapis.com/v1/projects/\ + spoke-project/locations/global/spokes/my-spoke" POSITIONAL ARGUMENTS Hub resource - Name of the hub to accept the spoke into. This represents a diff --git a/gcloud/network-connectivity/hubs/reject-spoke b/gcloud/network-connectivity/hubs/reject-spoke index 481f9026a..fe025ff6d 100644 --- a/gcloud/network-connectivity/hubs/reject-spoke +++ b/gcloud/network-connectivity/hubs/reject-spoke @@ -15,9 +15,8 @@ EXAMPLES my-reason, run: $ gcloud network-connectivity hubs reject-spoke my-hub \ - --spoke="https://www.googleapis.com/networkconnectivity/v1/proje\ - cts/spoke-project/locations/global/hubs/my-spoke" \ - --details=my-reason + --spoke="https://networkconnectivity.googleapis.com/v1/projects/\ + spoke-project/locations/global/spokes/my-spoke" --details=my-reason POSITIONAL ARGUMENTS Hub resource - Name of the hub to reject the spoke from. This represents a diff --git a/gcloud/network-connectivity/internal-ranges/create b/gcloud/network-connectivity/internal-ranges/create index a65121b11..63a1efc69 100644 --- a/gcloud/network-connectivity/internal-ranges/create +++ b/gcloud/network-connectivity/internal-ranges/create @@ -6,9 +6,9 @@ SYNOPSIS gcloud network-connectivity internal-ranges create (INTERNAL_RANGE : --region=REGION) --network=NETWORK (--ip-cidr-range=IP_CIDR_RANGE | [--prefix-length=PREFIX_LENGTH - : --allocation_strategy=ALLOCATION_STRATEGY + : --allocation-strategy=ALLOCATION_STRATEGY --exclude-cidr-ranges=[EXCLUDE_CIDR_RANGES,...] - --first_available_ranges_lookup_size=FIRST_AVAILABLE_RANGES_LOOKUP_SIZE --target-cidr-range=[TARGET_CIDR_RANGE, + --first-available-ranges-lookup-size=FIRST_AVAILABLE_RANGES_LOOKUP_SIZE --target-cidr-range=[TARGET_CIDR_RANGE, ...]]) [--async] [--description=DESCRIPTION] [--immutable] [--labels=[KEY=VALUE,...]] [--overlaps=[OVERLAPS,...]] [--peering=PEERING; default="for-self"] @@ -94,7 +94,7 @@ REQUIRED FLAGS Additional options for the internal range's address auto-allocation (allowed only when prefix-length is set): - --allocation_strategy=ALLOCATION_STRATEGY + --allocation-strategy=ALLOCATION_STRATEGY Allocation strategy to be used when searching for a free range. ALLOCATION_STRATEGY must be one of: @@ -127,10 +127,10 @@ REQUIRED FLAGS This can be used to exclude specific ranges that are already intended to have some other use. - --first_available_ranges_lookup_size=FIRST_AVAILABLE_RANGES_LOOKUP_SIZE + --first-available-ranges-lookup-size=FIRST_AVAILABLE_RANGES_LOOKUP_SIZE The number of ranges to be considered when using the RANDOM_FIRST_N_AVAILABLE allocation strategy. This is only allowed - when allocation_strategy is set to RANDOM_FIRST_N_AVAILABLE. + when allocation-strategy is set to RANDOM_FIRST_N_AVAILABLE. --target-cidr-range=[TARGET_CIDR_RANGE,...] Can be set to narrow down or pick a different address space while diff --git a/gcloud/network-connectivity/service-connection-policies/create b/gcloud/network-connectivity/service-connection-policies/create index 57afa2ec9..9c3762742 100644 --- a/gcloud/network-connectivity/service-connection-policies/create +++ b/gcloud/network-connectivity/service-connection-policies/create @@ -143,9 +143,9 @@ OPTIONAL FLAGS List of label KEY=VALUE pairs to add. --region=REGION - For resources [service connection policy, subnetwork], provides - fallback value for resource region attribute. When the resource's full - URI path is not provided, region will fallback to this flag value. + For resources [service_connection_policy, subnets], provides fallback + value for resource region attribute. When the resource's full URI path + is not provided, region will fallback to this flag value. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/network-connectivity/service-connection-policies/update b/gcloud/network-connectivity/service-connection-policies/update index dfa090ec2..d2c97e5ca 100644 --- a/gcloud/network-connectivity/service-connection-policies/update +++ b/gcloud/network-connectivity/service-connection-policies/update @@ -84,9 +84,9 @@ FLAGS Max number of PSC connections for this policy. --region=REGION - For resources [service connection policy, subnetwork], provides - fallback value for resource region attribute. When the resource's full - URI path is not provided, region will fallback to this flag value. + For resources [service_connection_policy, subnets], provides fallback + value for resource region attribute. When the resource's full URI path + is not provided, region will fallback to this flag value. Subnetwork resource - Subnetwork to use for IP address management. This represents a Cloud resource. (NOTE) Some attributes are not given diff --git a/gcloud/network-services/service-lb-policies/create b/gcloud/network-services/service-lb-policies/create index 825a9bccf..e0ef55334 100644 --- a/gcloud/network-services/service-lb-policies/create +++ b/gcloud/network-services/service-lb-policies/create @@ -7,6 +7,9 @@ SYNOPSIS (SERVICE_LB_POLICY : --location=LOCATION) [--async] [--auto-capacity-drain] [--description=DESCRIPTION] [--failover-health-threshold=FAILOVER_HEALTH_THRESHOLD] + [--isolation-config-granularity=ISOLATION_CONFIG_GRANULARITY; + default="unspecified"] + [--isolation-config-mode=ISOLATION_CONFIG_MODE; default="unspecified"] [--load-balancing-algorithm=LOAD_BALANCING_ALGORITHM; default="waterfall-by-region"] [GCLOUD_WIDE_FLAG ...] @@ -77,6 +80,31 @@ FLAGS 99. The default value is 50 for Proxyless service mesh, and 70 for others. + --isolation-config-granularity=ISOLATION_CONFIG_GRANULARITY; default="unspecified" + The granularity of the isolation. ISOLATION_CONFIG_GRANULARITY must be + one of: + + region + Traffic for this service will be isolated at the nearest cloud + region. + + unspecified + No isolation is configured for the backend service. Traffic can + overflow based on the load balancing algorithm. + + --isolation-config-mode=ISOLATION_CONFIG_MODE; default="unspecified" + The granularity of the isolation. ISOLATION_CONFIG_MODE must be one of: + + nearest + Traffic will be sent to the nearest location. + + strict + Traffic will fail if no serving backends are available in the same + region as the load balancer. + + unspecified + No isolation mode is configured for the backend service. + --load-balancing-algorithm=LOAD_BALANCING_ALGORITHM; default="waterfall-by-region" The global load balancing algorithm to be used. LOAD_BALANCING_ALGORITHM must be one of: diff --git a/gcloud/network-services/service-lb-policies/update b/gcloud/network-services/service-lb-policies/update index d8d45b22c..d926459df 100644 --- a/gcloud/network-services/service-lb-policies/update +++ b/gcloud/network-services/service-lb-policies/update @@ -7,6 +7,9 @@ SYNOPSIS (SERVICE_LB_POLICY : --location=LOCATION) [--async] [--auto-capacity-drain] [--description=DESCRIPTION] [--failover-health-threshold=FAILOVER_HEALTH_THRESHOLD] + [--isolation-config-granularity=ISOLATION_CONFIG_GRANULARITY; + default="unspecified"] + [--isolation-config-mode=ISOLATION_CONFIG_MODE; default="unspecified"] [--load-balancing-algorithm=LOAD_BALANCING_ALGORITHM; default="waterfall-by-region"] [GCLOUD_WIDE_FLAG ...] @@ -76,6 +79,31 @@ FLAGS 99. The default value is 50 for Proxyless service mesh, and 70 for others. + --isolation-config-granularity=ISOLATION_CONFIG_GRANULARITY; default="unspecified" + The granularity of the isolation. ISOLATION_CONFIG_GRANULARITY must be + one of: + + region + Traffic for this service will be isolated at the nearest cloud + region. + + unspecified + No isolation is configured for the backend service. Traffic can + overflow based on the load balancing algorithm. + + --isolation-config-mode=ISOLATION_CONFIG_MODE; default="unspecified" + The granularity of the isolation. ISOLATION_CONFIG_MODE must be one of: + + nearest + Traffic will be sent to the nearest location. + + strict + Traffic will fail if no serving backends are available in the same + region as the load balancer. + + unspecified + No isolation mode is configured for the backend service. + --load-balancing-algorithm=LOAD_BALANCING_ALGORITHM; default="waterfall-by-region" The global load balancing algorithm to be used. LOAD_BALANCING_ALGORITHM must be one of: diff --git a/gcloud/oracle-database/autonomous-databases/create b/gcloud/oracle-database/autonomous-databases/create index ef47f56d7..e6efd6e42 100644 --- a/gcloud/oracle-database/autonomous-databases/create +++ b/gcloud/oracle-database/autonomous-databases/create @@ -107,9 +107,10 @@ FLAGS --labels=path_to_file.(yaml|json) --location=LOCATION - For resources [autonomousDatabase], provides fallback value for - resource location attribute. When the resource's full URI path is not - provided, location will fallback to this flag value. + For resources [autonomous_database, source-config-autonomous-database], + provides fallback value for resource location attribute. When the + resource's full URI path is not provided, location will fallback to + this flag value. Network resource - The name of the VPC network used by the Autonomous Database in the following format: diff --git a/gcloud/oracle-database/autonomous-databases/switchover b/gcloud/oracle-database/autonomous-databases/switchover index f21be6d46..09f387c20 100644 --- a/gcloud/oracle-database/autonomous-databases/switchover +++ b/gcloud/oracle-database/autonomous-databases/switchover @@ -80,9 +80,10 @@ OPTIONAL FLAGS complete. --location=LOCATION - For resources [autonomousDatabase], provides fallback value for - resource location attribute. When the resource's full URI path is not - provided, location will fallback to this flag value. + For resources [autonomous_database, peer-autonomous-database], provides + fallback value for resource location attribute. When the resource's + full URI path is not provided, location will fallback to this flag + value. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/oracle-database/cloud-vm-clusters/create b/gcloud/oracle-database/cloud-vm-clusters/create index 8511f9998..ccd51b399 100644 --- a/gcloud/oracle-database/cloud-vm-clusters/create +++ b/gcloud/oracle-database/cloud-vm-clusters/create @@ -147,7 +147,7 @@ OPTIONAL FLAGS --labels=path_to_file.(yaml|json) --location=LOCATION - For resources [cloudVmCluster, cloudExadataInfrastructure], provides + For resources [cloud_vm_cluster, exadata-infrastructure], provides fallback value for resource location attribute. When the resource's full URI path is not provided, location will fallback to this flag value. diff --git a/gcloud/recaptcha/keys/create b/gcloud/recaptcha/keys/create index 305355f42..5b073139b 100644 --- a/gcloud/recaptcha/keys/create +++ b/gcloud/recaptcha/keys/create @@ -11,8 +11,10 @@ SYNOPSIS | [--web (--allow-all-domains | --domains=[DOMAINS,...]) : --allow-amp-traffic --integration-type=INTEGRATION_TYPE --security-preference=SECURITY_PREFERENCE - --testing-challenge=TESTING_CHALLENGE]) [--labels=[KEY=VALUE,...]] - [--testing-score=TESTING_SCORE] + --testing-challenge=TESTING_CHALLENGE + [--default-score-threshold=DEFAULT_SCORE_THRESHOLD + : --action-score-thresholds=[ACTION_SCORE_THRESHOLDS,...]]]) + [--labels=[KEY=VALUE,...]] [--testing-score=TESTING_SCORE] [--waf-service=WAF_SERVICE : --waf-feature=WAF_FEATURE] [GCLOUD_WIDE_FLAG ...] @@ -132,14 +134,12 @@ REQUIRED FLAGS Does not display the "I'm not a robot" checkbox, but may show CAPTCHA challenges after risk analysis + policy-based-challenge + Conditionally displays a challenge based on the score + score Shows no CAPTCHA challenge on the page - score-and-challenge - Conditionally displays a challenge based on the score. This is - in private preview. If you want to onboard, contact your Google - Cloud sales representative. - --security-preference=SECURITY_PREFERENCE Represents the possible challenge frequency and difficulty configurations for a web key. usability: show fewer and easier @@ -174,6 +174,42 @@ REQUIRED FLAGS Examples of valid domains: 'example.com' 'subdomain.example.com' + Configure if you want to use the POLICY_BASED_CHALLENGE option. + + --default-score-threshold=DEFAULT_SCORE_THRESHOLD + The global threshold to be used for POLICY_BASED_CHALLENGE if no + action specific one exists. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --action-score-thresholds=[ACTION_SCORE_THRESHOLDS,...] + The action to score threshold used for POLICY_BASED_CHALLENGE. + For example: --action-score-thresholds=login='{"scoreThreshold": + "0.3"}',signup='{"scoreThreshold": "0.1"}' or + --action-score-thresholds=file_path.(json|yaml). + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + scoreThreshold + Sets scoreThreshold value. + + Shorthand Example: + + --action-score-thresholds=string={scoreThreshold=float} + + JSON Example: + + --action-score-thresholds='{"string": {"scoreThreshold": float}}' + + File Example: + + --action-score-thresholds=path_to_file.(yaml|json) + OPTIONAL FLAGS --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/recaptcha/keys/update b/gcloud/recaptcha/keys/update index ef8b1b6a7..39064f0dd 100644 --- a/gcloud/recaptcha/keys/update +++ b/gcloud/recaptcha/keys/update @@ -9,7 +9,9 @@ SYNOPSIS | [--ios : --allow-all-bundle-ids | --bundle-ids=[BUNDLE_IDS,...] --key-id=KEY_ID --private-key-file=PATH_TO_FILE --team-id=TEAM_ID] | [--web : --allow-amp-traffic - --security-preference=SECURITY_PREFERENCE --allow-all-domains + --security-preference=SECURITY_PREFERENCE + --action-score-thresholds=[ACTION_SCORE_THRESHOLDS,...] + --default-score-threshold=DEFAULT_SCORE_THRESHOLD --allow-all-domains | --domains=[DOMAINS,...]]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -138,6 +140,39 @@ FLAGS SECURITY_PREFERENCE must be one of: balance, challenge-security-preference-unspecified, security, usability. + Configure if you want to use the POLICY_BASED_CHALLENGE option. + + --action-score-thresholds=[ACTION_SCORE_THRESHOLDS,...] + The action to score threshold used for POLICY_BASED_CHALLENGE. + For example: --action-score-thresholds=login='{"scoreThreshold": + "0.3"}',signup='{"scoreThreshold": "0.1"}' or + --action-score-thresholds=file_path.(json|yaml). + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + scoreThreshold + Sets scoreThreshold value. + + Shorthand Example: + + --action-score-thresholds=string={scoreThreshold=float} + + JSON Example: + + --action-score-thresholds='{"string": {"scoreThreshold": float}}' + + File Example: + + --action-score-thresholds=path_to_file.(yaml|json) + + --default-score-threshold=DEFAULT_SCORE_THRESHOLD + The global threshold to be used for POLICY_BASED_CHALLENGE if no + action specific one exists. + At most one of these can be specified: --allow-all-domains diff --git a/gcloud/redis/clusters/update b/gcloud/redis/clusters/update index 99171b520..49e8be7e5 100644 --- a/gcloud/redis/clusters/update +++ b/gcloud/redis/clusters/update @@ -8,12 +8,12 @@ SYNOPSIS [--automated-backup-mode=AUTOMATED_BACKUP_MODE] [--automated-backup-start-time=AUTOMATED_BACKUP_START_TIME] [--automated-backup-ttl=AUTOMATED_BACKUP_TTL] [--deletion-protection] - [--node-type=NODE_TYPE] [--ondemand-maintenance] - [--persistence-mode=PERSISTENCE_MODE] + [--node-type=NODE_TYPE] [--persistence-mode=PERSISTENCE_MODE] [--rdb-snapshot-period=RDB_SNAPSHOT_PERIOD] [--rdb-snapshot-start-time=RDB_SNAPSHOT_START_TIME] [--remove-redis-config=[KEY,...]] [--replica-count=REPLICA_COUNT] - [--shard-count=SHARD_COUNT] [--update-redis-config=KEY=VALUE] + [--shard-count=SHARD_COUNT] [--simulate-maintenance-event] + [--update-redis-config=KEY=VALUE] [--maintenance-window-any | --maintenance-window-day=MAINTENANCE_WINDOW_DAY --maintenance-window-hour=MAINTENANCE_WINDOW_HOUR] @@ -111,9 +111,6 @@ FLAGS redis-highmem-medium, redis-highmem-xlarge, redis-shared-core-nano, redis-standard-small. - --ondemand-maintenance - Trigger an on-demand maintenance. - --persistence-mode=PERSISTENCE_MODE Operation mode for persistence. PERSISTENCE_MODE must be one of: @@ -152,6 +149,9 @@ FLAGS --shard-count=SHARD_COUNT The shard count of the cluster. + --simulate-maintenance-event + Trigger a simulation for maintenance event. + --update-redis-config=KEY=VALUE A list of Redis Cluster config KEY=VALUE pairs to update. If a config parameter is already set, its value is modified; otherwise a new Redis diff --git a/gcloud/resource-manager/tags/keys/create b/gcloud/resource-manager/tags/keys/create index caa200d62..8619d8a88 100644 --- a/gcloud/resource-manager/tags/keys/create +++ b/gcloud/resource-manager/tags/keys/create @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud resource-manager tags keys create (SHORT_NAME --parent=PARENT) [--async] [--description=DESCRIPTION] [--purpose=PURPOSE] - [--purpose-data=[network=NETWORK]] [GCLOUD_WIDE_FLAG ...] + [--purpose-data=[network=NETWORK],[organization=ORGANIZATION]] + [GCLOUD_WIDE_FLAG ...] EXAMPLES To create a TagKey with the name env under 'organizations/123' with @@ -49,7 +50,7 @@ FLAGS that corresponds to the purpose. PURPOSE must be one of: GCE_FIREWALL, DATA_GOVERNANCE. - --purpose-data=[network=NETWORK] + --purpose-data=[network=NETWORK],[organization=ORGANIZATION] Purpose data of the TagKey that can only be set on creation. This data is validated by the policy system that corresponds to the purpose. diff --git a/gcloud/transfer/agents/help b/gcloud/transfer/agents/help index 6dd636685..fb18623de 100644 --- a/gcloud/transfer/agents/help +++ b/gcloud/transfer/agents/help @@ -5,7 +5,7 @@ SYNOPSIS gcloud transfer agents COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Manage agents. Agents arre lightweight applications that enable Transfer + Manage agents. Agents are 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. diff --git a/gcloud/workbench/instances/create b/gcloud/workbench/instances/create index d6eb59e55..ca5c1e6b4 100644 --- a/gcloud/workbench/instances/create +++ b/gcloud/workbench/instances/create @@ -23,7 +23,7 @@ SYNOPSIS | [(--vm-image-family=VM_IMAGE_FAMILY | --vm-image-name=VM_IMAGE_NAME) : --vm-image-project=VM_IMAGE_PROJECT; - default="deeplearning-platform-release"] + default="cloud-notebooks-managed"] --custom-gpu-driver-path=CUSTOM_GPU_DRIVER_PATH --install-gpu-driver --data-disk-encryption=DATA_DISK_ENCRYPTION --data-disk-size=DATA_DISK_SIZE --data-disk-type=DATA_DISK_TYPE @@ -258,7 +258,7 @@ FLAGS The tag of the container image. If not specified, this defaults to the latest tag. - --vm-image-project=VM_IMAGE_PROJECT; default="deeplearning-platform-release" + --vm-image-project=VM_IMAGE_PROJECT; default="cloud-notebooks-managed" The ID of the Google Cloud project that this VM image belongs to. Format: projects/{project_id}.