From a63704a3af4555feed1210d99ce0ec62eaec9394 Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 13 Nov 2024 10:04:10 +0000 Subject: [PATCH] gcloud: Wed Nov 13 10:04:10 UTC 2024 --- gcloud/_version | 8 +- .../cloud-bindings/create | 85 +++++++++- .../cloud-bindings/list | 17 ++ .../cloud-bindings/update | 83 +++++++++- .../cloud-bindings/create | 108 +++++++++++-- .../cloud-bindings/list | 13 ++ .../cloud-bindings/update | 90 ++++++++++- gcloud/alpha/compute/commitments/create | 11 +- gcloud/alpha/compute/disks/convert | 134 ++++++++++++++++ gcloud/alpha/compute/disks/help | 4 + .../alpha/compute/future-reservations/create | 9 +- .../alpha/compute/future-reservations/update | 7 - gcloud/alpha/compute/help | 3 + .../alpha/compute/instance-templates/create | 6 +- .../instance-templates/create-with-container | 2 +- gcloud/alpha/compute/instances/bulk/create | 6 +- gcloud/alpha/compute/instances/create | 6 +- .../compute/instances/create-with-container | 6 +- .../compute/instances/network-interfaces/add | 11 ++ gcloud/alpha/compute/instances/set-scheduling | 4 + .../alpha/compute/network-profiles/describe | 54 +++++++ gcloud/alpha/compute/network-profiles/help | 32 ++++ gcloud/alpha/compute/network-profiles/list | 68 ++++++++ .../os-config/policy-orchestrators/create | 12 +- .../os-config/policy-orchestrators/update | 30 +++- gcloud/alpha/compute/queued-resources/create | 2 +- gcloud/alpha/config/get | 6 + gcloud/alpha/config/help | 6 + gcloud/alpha/config/list | 6 + gcloud/alpha/config/set | 6 + gcloud/alpha/config/unset | 6 + gcloud/alpha/container/clusters/create | 17 +- gcloud/alpha/container/clusters/create-auto | 19 ++- gcloud/alpha/container/clusters/update | 36 ++++- gcloud/alpha/container/node-pools/create | 6 + .../container/vmware/admin-clusters/update | 5 +- .../dataplex/datascans/create/data-discovery | 149 ++++++++++++++++++ gcloud/alpha/dataplex/datascans/create/help | 3 + .../dataplex/datascans/update/data-discovery | 131 +++++++++++++++ gcloud/alpha/dataplex/datascans/update/help | 3 + gcloud/alpha/managed-kafka/clusters/create | 4 +- gcloud/alpha/managed-kafka/clusters/delete | 4 +- gcloud/alpha/managed-kafka/clusters/describe | 4 +- gcloud/alpha/managed-kafka/clusters/help | 4 +- gcloud/alpha/managed-kafka/clusters/list | 4 +- gcloud/alpha/managed-kafka/clusters/update | 4 +- .../managed-kafka/consumer-groups/delete | 4 +- .../managed-kafka/consumer-groups/describe | 4 +- .../alpha/managed-kafka/consumer-groups/help | 4 +- .../alpha/managed-kafka/consumer-groups/list | 4 +- .../managed-kafka/consumer-groups/update | 4 +- gcloud/alpha/managed-kafka/help | 4 +- gcloud/alpha/managed-kafka/topics/create | 4 +- gcloud/alpha/managed-kafka/topics/delete | 4 +- gcloud/alpha/managed-kafka/topics/describe | 4 +- gcloud/alpha/managed-kafka/topics/help | 4 +- gcloud/alpha/managed-kafka/topics/list | 4 +- gcloud/alpha/managed-kafka/topics/update | 4 +- .../threat-prevention/add-override | 2 +- .../threat-prevention/update-override | 2 +- gcloud/alpha/quotas/info/list | 11 +- gcloud/alpha/quotas/preferences/list | 11 +- gcloud/alpha/recaptcha/keys/help | 3 + gcloud/alpha/recaptcha/keys/list-ip-overrides | 80 ++++++++++ gcloud/alpha/spanner/instances/create | 22 ++- gcloud/alpha/spanner/instances/update | 17 ++ gcloud/alpha/sql/instances/create | 3 + gcloud/alpha/sql/instances/switchover | 6 +- gcloud/alpha/transfer/agents/delete | 22 ++- gcloud/alpha/transfer/agents/help | 2 +- gcloud/artifacts/repositories/create | 9 ++ gcloud/artifacts/repositories/update | 9 ++ gcloud/beta/colab-enterprise/executions/help | 34 ---- gcloud/beta/colab-enterprise/help | 32 ---- .../colab-enterprise/runtime-templates/help | 50 ------ gcloud/beta/colab-enterprise/runtimes/assign | 112 ------------- gcloud/beta/colab-enterprise/runtimes/help | 42 ----- gcloud/beta/colab-enterprise/schedules/help | 43 ----- gcloud/beta/colab/executions/create | 7 +- gcloud/beta/colab/executions/delete | 7 +- gcloud/beta/colab/executions/describe | 7 +- gcloud/beta/colab/executions/help | 5 +- gcloud/beta/colab/executions/list | 7 +- gcloud/beta/colab/help | 5 +- .../runtime-templates/add-iam-policy-binding | 7 +- gcloud/beta/colab/runtime-templates/create | 7 +- gcloud/beta/colab/runtime-templates/delete | 7 +- gcloud/beta/colab/runtime-templates/describe | 7 +- .../colab/runtime-templates/get-iam-policy | 7 +- gcloud/beta/colab/runtime-templates/help | 5 +- gcloud/beta/colab/runtime-templates/list | 9 +- .../remove-iam-policy-binding | 7 +- .../colab/runtime-templates/set-iam-policy | 7 +- gcloud/beta/colab/runtimes/create | 5 +- gcloud/beta/colab/runtimes/delete | 7 +- gcloud/beta/colab/runtimes/describe | 7 +- gcloud/beta/colab/runtimes/help | 5 +- gcloud/beta/colab/runtimes/list | 7 +- gcloud/beta/colab/runtimes/start | 7 +- gcloud/beta/colab/runtimes/upgrade | 7 +- gcloud/beta/colab/schedules/create | 5 +- gcloud/beta/colab/schedules/delete | 5 +- gcloud/beta/colab/schedules/describe | 5 +- gcloud/beta/colab/schedules/help | 5 +- gcloud/beta/colab/schedules/list | 5 +- gcloud/beta/colab/schedules/pause | 5 +- gcloud/beta/colab/schedules/resume | 5 +- gcloud/beta/colab/schedules/update | 5 +- gcloud/beta/compute/commitments/create | 8 +- gcloud/beta/compute/help | 3 + gcloud/beta/compute/instance-templates/create | 2 +- .../instance-templates/create-with-container | 2 +- gcloud/beta/compute/instances/bulk/create | 2 +- gcloud/beta/compute/instances/create | 2 +- .../compute/instances/create-with-container | 2 +- gcloud/beta/compute/network-profiles/describe | 52 ++++++ gcloud/beta/compute/network-profiles/help | 29 ++++ gcloud/beta/compute/network-profiles/list | 66 ++++++++ gcloud/beta/compute/networks/create | 6 +- .../os-config/policy-orchestrators/create | 12 +- .../os-config/policy-orchestrators/update | 30 +++- gcloud/beta/config/get | 6 + gcloud/beta/config/help | 6 + gcloud/beta/config/list | 6 + gcloud/beta/config/set | 6 + gcloud/beta/config/unset | 6 + gcloud/beta/container/clusters/create | 13 +- gcloud/beta/container/clusters/create-auto | 19 ++- gcloud/beta/container/clusters/update | 36 ++++- gcloud/beta/container/node-pools/create | 6 + .../container/vmware/admin-clusters/update | 5 +- gcloud/beta/eventarc/pipelines/create | 26 +-- gcloud/beta/eventarc/pipelines/update | 26 +-- gcloud/beta/managed-kafka/clusters/create | 6 +- gcloud/beta/managed-kafka/clusters/delete | 6 +- gcloud/beta/managed-kafka/clusters/describe | 6 +- gcloud/beta/managed-kafka/clusters/help | 6 +- gcloud/beta/managed-kafka/clusters/list | 6 +- gcloud/beta/managed-kafka/clusters/update | 6 +- .../beta/managed-kafka/consumer-groups/delete | 6 +- .../managed-kafka/consumer-groups/describe | 6 +- .../beta/managed-kafka/consumer-groups/help | 6 +- .../beta/managed-kafka/consumer-groups/list | 6 +- .../beta/managed-kafka/consumer-groups/update | 6 +- gcloud/beta/managed-kafka/help | 6 +- gcloud/beta/managed-kafka/topics/create | 6 +- gcloud/beta/managed-kafka/topics/delete | 6 +- gcloud/beta/managed-kafka/topics/describe | 6 +- gcloud/beta/managed-kafka/topics/help | 6 +- gcloud/beta/managed-kafka/topics/list | 6 +- gcloud/beta/managed-kafka/topics/update | 6 +- .../beta/netapp/volumes/replications/create | 7 +- .../volumes/replications/establish-peering | 118 ++++++++++++++ gcloud/beta/netapp/volumes/replications/help | 6 + gcloud/beta/netapp/volumes/replications/sync | 103 ++++++++++++ .../beta/netapp/volumes/replications/update | 5 +- .../spokes/linked-producer-vpc-network/update | 5 + .../spokes/linked-vpc-network/update | 5 + .../threat-prevention/add-override | 2 +- .../threat-prevention/update-override | 2 +- gcloud/beta/run/deploy | 55 ++++++- gcloud/beta/run/services/update | 57 ++++++- gcloud/beta/spanner/instances/create | 22 ++- gcloud/beta/spanner/instances/update | 17 ++ gcloud/beta/sql/instances/create | 3 + gcloud/beta/sql/instances/switchover | 6 +- .../executions/create | 14 +- .../executions/delete | 15 +- .../executions/describe | 15 +- gcloud/colab/executions/help | 35 ++++ .../executions/list | 19 +-- gcloud/colab/help | 34 ++++ .../runtime-templates/add-iam-policy-binding | 19 ++- .../runtime-templates/create | 27 ++-- .../runtime-templates/delete | 17 +- .../runtime-templates/describe | 15 +- .../runtime-templates/get-iam-policy | 14 +- gcloud/colab/runtime-templates/help | 48 ++++++ .../runtime-templates/list | 20 +-- .../remove-iam-policy-binding | 20 +-- .../runtime-templates/set-iam-policy | 17 +- .../runtimes/create | 23 +-- .../runtimes/delete | 15 +- .../runtimes/describe | 13 +- gcloud/colab/runtimes/help | 41 +++++ .../colab-enterprise => colab}/runtimes/list | 17 +- .../colab-enterprise => colab}/runtimes/start | 15 +- .../runtimes/upgrade | 15 +- .../schedules/create | 14 +- .../schedules/delete | 15 +- .../schedules/describe | 15 +- gcloud/colab/schedules/help | 45 ++++++ .../colab-enterprise => colab}/schedules/list | 20 +-- .../schedules/pause | 13 +- .../schedules/resume | 13 +- .../schedules/update | 13 +- gcloud/compute/instance-groups/managed/create | 12 ++ gcloud/compute/instance-groups/managed/update | 21 +++ gcloud/compute/instance-templates/create | 2 +- .../instance-templates/create-with-container | 2 +- gcloud/compute/instances/bulk/create | 2 +- gcloud/compute/instances/create | 2 +- .../compute/instances/create-with-container | 2 +- gcloud/config/get | 6 + gcloud/config/help | 6 + gcloud/config/list | 6 + gcloud/config/set | 6 + gcloud/config/unset | 6 + gcloud/container/clusters/update | 29 +++- gcloud/container/vmware/admin-clusters/update | 5 +- gcloud/managed-kafka/clusters/create | 117 ++++++++++++++ gcloud/managed-kafka/clusters/delete | 77 +++++++++ gcloud/managed-kafka/clusters/describe | 72 +++++++++ gcloud/managed-kafka/clusters/help | 40 +++++ gcloud/managed-kafka/clusters/list | 84 ++++++++++ gcloud/managed-kafka/clusters/update | 110 +++++++++++++ gcloud/managed-kafka/consumer-groups/delete | 82 ++++++++++ gcloud/managed-kafka/consumer-groups/describe | 82 ++++++++++ gcloud/managed-kafka/consumer-groups/help | 38 +++++ gcloud/managed-kafka/consumer-groups/list | 101 ++++++++++++ gcloud/managed-kafka/consumer-groups/update | 106 +++++++++++++ gcloud/managed-kafka/help | 35 ++++ gcloud/managed-kafka/topics/create | 101 ++++++++++++ gcloud/managed-kafka/topics/delete | 80 ++++++++++ gcloud/managed-kafka/topics/describe | 80 ++++++++++ gcloud/managed-kafka/topics/help | 40 +++++ gcloud/managed-kafka/topics/list | 99 ++++++++++++ gcloud/managed-kafka/topics/update | 104 ++++++++++++ gcloud/netapp/volumes/create | 33 +++- gcloud/netapp/volumes/replications/create | 7 +- .../volumes/replications/establish-peering | 117 ++++++++++++++ gcloud/netapp/volumes/replications/help | 6 + gcloud/netapp/volumes/replications/sync | 101 ++++++++++++ gcloud/netapp/volumes/replications/update | 5 +- gcloud/network-connectivity/hubs/help | 3 + gcloud/network-connectivity/hubs/query-status | 102 ++++++++++++ .../spokes/linked-producer-vpc-network/update | 5 + .../spokes/linked-vpc-network/update | 5 + .../threat-prevention/add-override | 2 +- .../threat-prevention/update-override | 2 +- gcloud/recaptcha/keys/help | 3 + gcloud/recaptcha/keys/list-ip-overrides | 77 +++++++++ gcloud/run/deploy | 10 ++ gcloud/run/jobs/create | 10 ++ gcloud/run/jobs/deploy | 10 ++ gcloud/run/jobs/update | 10 ++ gcloud/run/services/update | 10 ++ gcloud/spanner/instances/create | 22 ++- gcloud/spanner/instances/update | 17 ++ gcloud/sql/instances/switchover | 9 +- gcloud/transfer/agents/delete | 11 +- gcloud/transfer/agents/help | 2 +- 252 files changed, 4821 insertions(+), 807 deletions(-) create mode 100644 gcloud/alpha/compute/disks/convert create mode 100644 gcloud/alpha/compute/network-profiles/describe create mode 100644 gcloud/alpha/compute/network-profiles/help create mode 100644 gcloud/alpha/compute/network-profiles/list create mode 100644 gcloud/alpha/dataplex/datascans/create/data-discovery create mode 100644 gcloud/alpha/dataplex/datascans/update/data-discovery create mode 100644 gcloud/alpha/recaptcha/keys/list-ip-overrides delete mode 100644 gcloud/beta/colab-enterprise/executions/help delete mode 100644 gcloud/beta/colab-enterprise/help delete mode 100644 gcloud/beta/colab-enterprise/runtime-templates/help delete mode 100644 gcloud/beta/colab-enterprise/runtimes/assign delete mode 100644 gcloud/beta/colab-enterprise/runtimes/help delete mode 100644 gcloud/beta/colab-enterprise/schedules/help create mode 100644 gcloud/beta/compute/network-profiles/describe create mode 100644 gcloud/beta/compute/network-profiles/help create mode 100644 gcloud/beta/compute/network-profiles/list create mode 100644 gcloud/beta/netapp/volumes/replications/establish-peering create mode 100644 gcloud/beta/netapp/volumes/replications/sync rename gcloud/{beta/colab-enterprise => colab}/executions/create (95%) rename gcloud/{beta/colab-enterprise => colab}/executions/delete (81%) rename gcloud/{beta/colab-enterprise => colab}/executions/describe (80%) create mode 100644 gcloud/colab/executions/help rename gcloud/{beta/colab-enterprise => colab}/executions/list (83%) create mode 100644 gcloud/colab/help rename gcloud/{beta/colab-enterprise => colab}/runtime-templates/add-iam-policy-binding (83%) rename gcloud/{beta/colab-enterprise => colab}/runtime-templates/create (92%) rename gcloud/{beta/colab-enterprise => colab}/runtime-templates/delete (80%) rename gcloud/{beta/colab-enterprise => colab}/runtime-templates/describe (82%) rename gcloud/{beta/colab-enterprise => colab}/runtime-templates/get-iam-policy (89%) create mode 100644 gcloud/colab/runtime-templates/help rename gcloud/{beta/colab-enterprise => colab}/runtime-templates/list (83%) rename gcloud/{beta/colab-enterprise => colab}/runtime-templates/remove-iam-policy-binding (83%) rename gcloud/{beta/colab-enterprise => colab}/runtime-templates/set-iam-policy (83%) rename gcloud/{beta/colab-enterprise => colab}/runtimes/create (88%) rename gcloud/{beta/colab-enterprise => colab}/runtimes/delete (81%) rename gcloud/{beta/colab-enterprise => colab}/runtimes/describe (82%) create mode 100644 gcloud/colab/runtimes/help rename gcloud/{beta/colab-enterprise => colab}/runtimes/list (85%) rename gcloud/{beta/colab-enterprise => colab}/runtimes/start (81%) rename gcloud/{beta/colab-enterprise => colab}/runtimes/upgrade (81%) rename gcloud/{beta/colab-enterprise => colab}/schedules/create (96%) rename gcloud/{beta/colab-enterprise => colab}/schedules/delete (80%) rename gcloud/{beta/colab-enterprise => colab}/schedules/describe (79%) create mode 100644 gcloud/colab/schedules/help rename gcloud/{beta/colab-enterprise => colab}/schedules/list (83%) rename gcloud/{beta/colab-enterprise => colab}/schedules/pause (81%) rename gcloud/{beta/colab-enterprise => colab}/schedules/resume (83%) rename gcloud/{beta/colab-enterprise => colab}/schedules/update (91%) create mode 100644 gcloud/managed-kafka/clusters/create create mode 100644 gcloud/managed-kafka/clusters/delete create mode 100644 gcloud/managed-kafka/clusters/describe create mode 100644 gcloud/managed-kafka/clusters/help create mode 100644 gcloud/managed-kafka/clusters/list create mode 100644 gcloud/managed-kafka/clusters/update create mode 100644 gcloud/managed-kafka/consumer-groups/delete create mode 100644 gcloud/managed-kafka/consumer-groups/describe create mode 100644 gcloud/managed-kafka/consumer-groups/help create mode 100644 gcloud/managed-kafka/consumer-groups/list create mode 100644 gcloud/managed-kafka/consumer-groups/update create mode 100644 gcloud/managed-kafka/help create mode 100644 gcloud/managed-kafka/topics/create create mode 100644 gcloud/managed-kafka/topics/delete create mode 100644 gcloud/managed-kafka/topics/describe create mode 100644 gcloud/managed-kafka/topics/help create mode 100644 gcloud/managed-kafka/topics/list create mode 100644 gcloud/managed-kafka/topics/update create mode 100644 gcloud/netapp/volumes/replications/establish-peering create mode 100644 gcloud/netapp/volumes/replications/sync create mode 100644 gcloud/network-connectivity/hubs/query-status create mode 100644 gcloud/recaptcha/keys/list-ip-overrides diff --git a/gcloud/_version b/gcloud/_version index a4d912be3..0a31b12c9 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 500.0.0 -alpha 2024.11.01 -beta 2024.11.01 +Google Cloud SDK 501.0.0 +alpha 2024.11.08 +beta 2024.11.08 bq 2.1.9 bundled-python3-unix 3.11.9 -core 2024.11.01 +core 2024.11.08 gcloud-crc32c 1.0.0 gsutil 5.31 diff --git a/gcloud/access-context-manager/cloud-bindings/create b/gcloud/access-context-manager/cloud-bindings/create index 76267b483..ed40f081b 100644 --- a/gcloud/access-context-manager/cloud-bindings/create +++ b/gcloud/access-context-manager/cloud-bindings/create @@ -6,16 +6,18 @@ SYNOPSIS gcloud access-context-manager cloud-bindings create --group-key=GROUP_KEY [--binding-file=YAML_FILE] [--dry-run-level=[DRY_RUN_LEVEL,...]] [--level=[LEVEL,...]] [--organization=ORGANIZATION] + [--session-length=SESSION_LENGTH] + [--session-reauth-method=SESSION_REAUTH_METHOD; default="login"] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Create a new cloud access binding. The access level will be globally bound - with the group. + Create a new cloud access binding. The access level and/or session settings + will be globally bound with the group. - Allowlisted Applications can be specified to limit the scope of the cloud - access binding in the 'binding-file'. In such case, the access level - specified in the yaml file will be bound with the group and the allowlisted - applications. + To apply access level and/or session settings to a specific application, + specify the restricted application in the 'binding-file'. In such case, the + access level and/or session settings specified in the yaml file will be + bound with the group and the restricted applications. EXAMPLES To create a new cloud access binding, run: @@ -46,9 +48,40 @@ EXAMPLES --level=accessPolicies/123/accessLevels/abc \ --dry-run-level=accessPolicies/123/accessLevels/def + To create a new cloud access binding with global session settings, specify + your session length using an ISO duration string and the session-length + flag. For example: + + $ gcloud access-context-manager cloud-bindings create \ + --group-key=my-group-key --organization='1234567890' \ + --session-length=2h + + To set a particular session reauth method for these session settings, run: + + $ gcloud access-context-manager cloud-bindings create \ + --group-key=my-group-key --organization='1234567890' \ + --session-length=2h --session-reauth-method=LOGIN + + To create session settings for a particular application, supply a YAML file + and run: + + $ gcloud access-context-manager cloud-bindings create \ + --group-key=my-group-key --organization='1234567890' \ + --binding-file='binding.yaml' + + Global and per-app session settings can be set on the same group, along + with access levels. For example: + + $ gcloud access-context-manager cloud-bindings create \ + --group-key=my-group-key --organization='1234567890' \ + --session-length=2h --session-reauth-method=LOGIN \ + --level=accessPolicies/123/accessLevels/abc \ + --dry-run-level=accessPolicies/123/accessLevels/def \ + --binding-file='binding.yaml' + REQUIRED FLAGS --group-key=GROUP_KEY - Google Group id whose members are subject to the restrictions of this + Google Group ID whose members are subject to the restrictions of this binding. OPTIONAL FLAGS @@ -74,6 +107,44 @@ OPTIONAL FLAGS --organization=ORGANIZATION Parent organization for this binding. + --session-length=SESSION_LENGTH + The maximum lifetime of a user session provided as an ISO 8601 duration + string. Must be at least one hour or zero seconds, and no more than + twenty-four hours. Granularity is limited to seconds. + + When --session-length=0 then users in the group attached to this + binding will have infinite session length, effectively disabling the + session settings. + + A session begins when a user signs in successfully. If a user signs out + before the end of the session lifetime, a new login creates a new + session with a fresh lifetime. When a session expires, the user is + asked to re-authenticate in accordance with session-method. + + Setting --session-reauth-method when --session-length is empty raises + an error. + + --session-reauth-method=SESSION_REAUTH_METHOD; default="login" + Specifies the type of re-authentication challenge given to the user + when their session expires. Defaults to --session-reauth-method=login + if unspecified and --session-length is set. Cannot be used when + --session-length is empty or 0. + + SESSION_REAUTH_METHOD must be one of: + + login + The user must complete a regular login. + + password + The user will only be required to enter their password. + + security-key + The user must re-autheticate using their security key. Before + enabling this session reauth method, ensure a security key is + properly configured for the user. For help configuring your + security key, see + https://support.google.com/a/answer/2537800?hl=en#zippy=%2Cview-add-or-remove-security-keys + 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/access-context-manager/cloud-bindings/list b/gcloud/access-context-manager/cloud-bindings/list index 60085a501..76b10dba7 100644 --- a/gcloud/access-context-manager/cloud-bindings/list +++ b/gcloud/access-context-manager/cloud-bindings/list @@ -26,6 +26,10 @@ EXAMPLES - accessPolicies/9522/accessLevels/specific_location groupKey: a3dad name: organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N + sessionSettings: + sessionLength: 57600s + sessionLengthEnabled: true + sessionReauthMethod: LOGIN Or @@ -57,6 +61,19 @@ EXAMPLES clientScope: restrictedClientApplication: name: Cloud Console + - activeSettings: + sessionSettings: + sessionLength: 57600s + sessionLengthEnabled: true + sessionReauthMethod: LOGIN + scope: + clientScope: + restrictedClientApplication: + clientId: 123.apps.googleusercontent.com + sessionSettings: + sessionLength: 57600s + sessionLengthEnabled: true + sessionReauthMethod: LOGIN FLAGS Organization resource - The parent organization of the bindings you want diff --git a/gcloud/access-context-manager/cloud-bindings/update b/gcloud/access-context-manager/cloud-bindings/update index 11d8176a6..3cd78ae29 100644 --- a/gcloud/access-context-manager/cloud-bindings/update +++ b/gcloud/access-context-manager/cloud-bindings/update @@ -4,13 +4,16 @@ NAME SYNOPSIS gcloud access-context-manager cloud-bindings update - (--binding=BINDING : --organization=ORGANIZATION) + (--binding=BINDING : --organization=ORGANIZATION) [--append] [--binding-file=YAML_FILE] [--dry-run-level=[DRY_RUN_LEVEL,...]] - [--level=[LEVEL,...]] [GCLOUD_WIDE_FLAG ...] + [--level=[LEVEL,...]] [--session-length=SESSION_LENGTH] + [--session-reauth-method=SESSION_REAUTH_METHOD; default="login"] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update an existing cloud access binding. You can update the level, dry run - level and scoped access settings. They can't all be empty. + level, session settings, and scoped access settings. They cannot all be + empty. EXAMPLES To update an existing cloud access binding, run: @@ -25,11 +28,37 @@ EXAMPLES --binding=my-binding-id --level= \ --dry-run-level=accessPolicies/123/accessLevels/new-def - To update scoped access settings, run: + To replace scoped access settings with a new list, run: $ gcloud access-context-manager cloud-bindings update \ --binding=my-binding-id --binding-file='binding.yaml' + To append scoped access settings to the existing list, run: + + $ gcloud access-context-manager cloud-bindings update \ + --binding=my-binding-id --binding-file='binding.yaml' --append + + Note this is only possible for scoped access settings that exclusively hold + session settings (i.e. no access levels). + + To update session settings, run: + + $ gcloud access-context-manager cloud-bindings update \ + --binding=my-binding-id --session-length=2h + + To update the session reauth method you must also specify --session-length + (this can be the existing value if you only want to modify the reauth + method), run: + + $ gcloud access-context-manager cloud-bindings update \ + --binding=my-binding-id --session-length=2h \ + --session-reauth-method=login + + To disable session settings, set --session-length=0, for example: + + $ gcloud access-context-manager cloud-bindings update \ + --binding=my-binding-id --session-length=0 + REQUIRED FLAGS Cloud access binding resource - The cloud access binding you want to update. The arguments in this group can be used to specify the attributes @@ -57,6 +86,13 @@ REQUIRED FLAGS ▸ set the property access_context_manager/organization. OPTIONAL FLAGS + --append + When true, append the ScopedAccessSettings in --binding-file to the + existing ScopedAccessSettings on the binding. When false, the existing + binding's ScopedAccessSettings will be overwritten. Defaults to false. + You may only append ScopedAccessSettings that exclusively hold session + settings (i.e no access levels). + --binding-file=YAML_FILE Path to the file that contains a Google Cloud Platform user access binding. @@ -66,7 +102,8 @@ OPTIONAL FLAGS ScopedAccessSettings only. No other binding fields are allowed. The file content replaces the corresponding fields in the existing - binding. + binding. Unless --append is specified. See --append help text for more + details. --dry-run-level=[DRY_RUN_LEVEL,...] The dry run access level that replaces the existing dry run level for @@ -78,6 +115,42 @@ OPTIONAL FLAGS binding. The input must be the full identifier of an access level, such as accessPolicies/123/accessLevels/new-abc. + --session-length=SESSION_LENGTH + The maximum lifetime of a user session provided as an ISO 8601 duration + string. Must be at least one hour or zero, and no more than twenty-four + hours. Granularity is limited to seconds. + + When --session-length=0 users in the group attached to this binding + will have infinite session length, effectively disabling the session + settings. + + A session begins after a user signs in successfully. If a user signs + out before the end of the session lifetime, a new login creates a new + session with a fresh lifetime. When a session expires, the user is + asked to reauthenticate in accordance with session-reauth-method. + + Setting --session-reauth-method when --session-length is empty raises + an error. Cannot set --session-length on restricted client + applications; please use scoped access settings. + + --session-reauth-method=SESSION_REAUTH_METHOD; default="login" + Specifies the security check a user must undergo when their session + expires. Defaults to --session-reauth-method=LOGIN if unspecified and + --session-length is set. Cannot be used when --session-length is empty + or 0. SESSION_REAUTH_METHOD must be one of: + + login + The user will be prompted to perform regular login. Users who are + enrolled in two-step verification and haven't chosen to "Remember + this computer" will be prompted for their second factor. + + password + The user will only be required to enter their password. + + security-key + The user will be prompted to autheticate using their security key. + If no security key has been configured, the LOGIN method is used. + 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/access-context-manager/cloud-bindings/create b/gcloud/alpha/access-context-manager/cloud-bindings/create index 0da374cd0..4770792f3 100644 --- a/gcloud/alpha/access-context-manager/cloud-bindings/create +++ b/gcloud/alpha/access-context-manager/cloud-bindings/create @@ -10,24 +10,36 @@ SYNOPSIS [--restricted-client-application-client-ids=[RESTRICTED_CLIENT_APPLICATION_CLIENT_IDS, ...]] [--restricted-client-application-names=[RESTRICTED_CLIENT_APPLICATION_NAMES, - ...]] [GCLOUD_WIDE_FLAG ...] + ...]] [--session-length=SESSION_LENGTH] + [--session-reauth-method=SESSION_REAUTH_METHOD; default="login"] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a new access binding. The access level will be bound with + (ALPHA) Create a new access binding. The access level (if any) will be + bound with ▪ a group and the restricted client application ▪ a specific service account or all service accounts in a specified project. - If a group key is specified, the access level is globally enforced for all - context-aware access group members, as specified in the binding. If a - restricted client application is also specified, then the enforcement - applies only to the specified application, and not to the entire - organization. If the restricted client application is specified, then - --binding-file cannot be set. If a service account is specified, then the - enforcement applies only to the specified service account. If a service - account project is specified, then the enforcement applies to all the - service accounts belongs to the specified project. + The session settings (if any) will be bound with + + ▪ a group + + If you want to bind session settings to a particular application, use + scoped access settings. + + If a group key is specified, the access level and/or session settings are + globally enforced for all context-aware access group members, as specified + in the binding. If a restricted client application is also specified, then + the enforcement applies only to the specified application, and not to the + entire organization. Session settings are incompatible with the top level + --restricted-client-application flags; please use --binding-file to specify + scoped access settings. If the restricted client application is specified, + then --binding-file cannot be set. If a service account is specified, then + the enforcement applies only to the specified service account. If a service + account project is specified, the enforcement applies to all of the service + accounts belonging to the specified project. EXAMPLES To create a new global cloud access binding, run: @@ -98,6 +110,37 @@ EXAMPLES --level=accessPolicies/123/accessLevels/abc \ --organization='1234567890' \ + To create a new cloud access binding with global session settings, specify + your session length using an ISO duration string and the session-length + flag. For example: + + $ gcloud alpha access-context-manager cloud-bindings create \ + --group-key=my-group-key --organization='1234567890' \ + --session-length=2h + + To set a particular session reauth method for these session settings, run: + + $ gcloud alpha access-context-manager cloud-bindings create \ + --group-key=my-group-key --organization='1234567890' \ + --session-length=2h --session-reauth-method=LOGIN + + To create session settings for specific applications, supply a YAML file + and run: + + $ gcloud alpha access-context-manager cloud-bindings create \ + --group-key=my-group-key --organization='1234567890' \ + --binding-file='binding.yaml' + + Global and per-app session settings can be set on the same group, along + with access levels. For example: + + $ gcloud alpha access-context-manager cloud-bindings create \ + --group-key=my-group-key --organization='1234567890' \ + --session-length=2h --session-reauth-method=LOGIN \ + --level=accessPolicies/123/accessLevels/abc \ + --dry-run-level=accessPolicies/123/accessLevels/def \ + --binding-file='binding.yaml' + FLAGS --binding-file=YAML_FILE Path to the file that contains a Google Cloud Platform user access @@ -118,7 +161,7 @@ FLAGS is applied to the entire organization. --group-key=GROUP_KEY - Google Group id whose members are subject to the restrictions of this + Google Group ID whose members are subject to the restrictions of this binding. --level=[LEVEL,...] @@ -138,6 +181,47 @@ FLAGS --restricted-client-application-names=[RESTRICTED_CLIENT_APPLICATION_NAMES,...] Application names to which the access level is applied. + --session-length=SESSION_LENGTH + The maximum lifetime of a user session provided as an ISO 8601 duration + string. Must be at least one hour or zero seconds, and no more than + twenty-four hours. Granularity is limited to seconds. + + When --session-length=0 then users in the group attached to this + binding will have infinite session length, effectively disabling + session. + + A session begins when a user signs-in successfully. If a user signs out + before the end of the session lifetime, a new login creates a new + session with a fresh lifetime. When a session expires, the user is + asked to re-authenticate in accordance with session-method. + + Setting --session-reauth-method when --session-length is empty raises + an error. Cannot set --session-length with + --restricted-client-application-client-ids or + --restricted-client-application-names; please use scoped access + settings. + + --session-reauth-method=SESSION_REAUTH_METHOD; default="login" + Specifies the type of re-authentication challenge given to the user + when their session expires. Defaults to --session-reauth-method=login + if unspecified and --session-length is set. Cannot be used when + --session-length is empty or 0. + + SESSION_REAUTH_METHOD must be one of: + + login + The user must complete a regular login. + + password + The user will only be required to enter their password. + + security-key + The user must re-autheticate using their security key. Before + enabling this session reauth method, ensure a security key is + properly configured for the user. For help configuring your + security key, see + https://support.google.com/a/answer/2537800?hl=en#zippy=%2Cview-add-or-remove-security-keys + 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/access-context-manager/cloud-bindings/list b/gcloud/alpha/access-context-manager/cloud-bindings/list index 1ebe8465c..3b9e01fc3 100644 --- a/gcloud/alpha/access-context-manager/cloud-bindings/list +++ b/gcloud/alpha/access-context-manager/cloud-bindings/list @@ -57,6 +57,19 @@ EXAMPLES clientScope: restrictedClientApplication: name: Cloud Console + - activeSettings: + sessionSettings: + sessionLength: 57600s + sessionLengthEnabled: true + sessionReauthMethod: LOGIN + scope: + clientScope: + restrictedClientApplication: + clientId: 123.apps.googleusercontent.com + sessionSettings: + sessionLength: 57600s + sessionLengthEnabled: true + sessionReauthMethod: LOGIN If filter is specified as principal:serviceAccount OR principal:serviceAccountProjectNumber, the output is printed in the diff --git a/gcloud/alpha/access-context-manager/cloud-bindings/update b/gcloud/alpha/access-context-manager/cloud-bindings/update index 4d98a937b..12ac781d5 100644 --- a/gcloud/alpha/access-context-manager/cloud-bindings/update +++ b/gcloud/alpha/access-context-manager/cloud-bindings/update @@ -4,18 +4,23 @@ NAME SYNOPSIS gcloud alpha access-context-manager cloud-bindings update - (--binding=BINDING : --organization=ORGANIZATION) + (--binding=BINDING : --organization=ORGANIZATION) [--append] [--binding-file=YAML_FILE] [--dry-run-level=[DRY_RUN_LEVEL,...]] [--level=[LEVEL,...]] [--restricted-client-application-client-ids=[RESTRICTED_CLIENT_APPLICATION_CLIENT_IDS, ...]] [--restricted-client-application-names=[RESTRICTED_CLIENT_APPLICATION_NAMES, - ...]] [GCLOUD_WIDE_FLAG ...] + ...]] [--session-length=SESSION_LENGTH] + [--session-reauth-method=SESSION_REAUTH_METHOD; default="login"] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update an existing access binding. You can update the level, dry - run level, scoped access settings, restricted client application client IDs - and restricted client application names. They can't all be empty. + run level, scoped access settings, session settings, restricted client + application client IDs, and restricted client application names. They can't + all be empty. Session settings are incompatible with restricted client + application client IDs/names; please use scoped access settings to bind + session settings to an application. EXAMPLES To update an existing access binding, run: @@ -44,6 +49,37 @@ EXAMPLES $ gcloud alpha access-context-manager cloud-bindings update \ --binding=my-binding-id --binding-file='binding.yaml' + To replace scoped access settings with a new list, run: + + $ gcloud alpha access-context-manager cloud-bindings update \ + --binding=my-binding-id --binding-file='binding.yaml' + + To append scoped access settings to the existing list, run: + + $ gcloud alpha access-context-manager cloud-bindings update \ + --binding=my-binding-id --binding-file='binding.yaml' --append + + Note this is only possible for scoped access settings that exclusively hold + session settings. + + To update session settings, run: + + $ gcloud alpha access-context-manager cloud-bindings update \ + --binding=my-binding-id --session-length=2h + + To update the session reauth method you must also specify --session-length + (this can be the existing value if you only want to modify the reauth + method), run: + + $ gcloud alpha access-context-manager cloud-bindings update \ + --binding=my-binding-id --session-length=2h \ + --session-reauth-method=login + + To disable session settings, set --session-length=0, for example: + + $ gcloud alpha access-context-manager cloud-bindings update \ + --binding=my-binding-id --session-length=0 + REQUIRED FLAGS Cloud access binding resource - The cloud access binding you want to update. The arguments in this group can be used to specify the attributes @@ -71,6 +107,13 @@ REQUIRED FLAGS ▸ set the property access_context_manager/organization. OPTIONAL FLAGS + --append + When true, append the ScopedAccessSettings in --binding-file to the + existing ScopedAccessSettings on the binding. When false, the existing + binding's ScopedAccessSettings will be overwritten. Defaults to false. + You may only append ScopedAccessSettings that exclusively hold session + settings (i.e no access levels). + --binding-file=YAML_FILE Path to the file that contains a Google Cloud Platform user access binding. @@ -80,7 +123,8 @@ OPTIONAL FLAGS ScopedAccessSettings only. No other binding fields are allowed. The file content replaces the corresponding fields in the existing - binding. + binding. Unless --append is specified. See --append help text for more + details. --dry-run-level=[DRY_RUN_LEVEL,...] The dry run access level that replaces the existing dry run level for @@ -100,6 +144,42 @@ OPTIONAL FLAGS The application names that replace the existing application names for the restricted client applications in the given binding. + --session-length=SESSION_LENGTH + The maximum lifetime of a user session provided as an ISO 8601 duration + string. Must be at least one hour or zero, and no more than twenty-four + hours. Granularity is limited to seconds. + + When --session-length=0 users in the group attached to this binding + will have infinite session length, effectively disabling the session + settings. + + A session begins after a user signs in successfully. If a user signs + out before the end of the session lifetime, a new login creates a new + session with a fresh lifetime. When a session expires, the user is + asked to reauthenticate in accordance with session-reauth-method. + + Setting --session-reauth-method when --session-length is empty raises + an error. Cannot set --session-length on restricted client + applications; please use scoped access settings. + + --session-reauth-method=SESSION_REAUTH_METHOD; default="login" + Specifies the security check a user must undergo when their session + expires. Defaults to --session-reauth-method=LOGIN if unspecified and + --session-length is set. Cannot be used when --session-length is empty + or 0. SESSION_REAUTH_METHOD must be one of: + + login + The user will be prompted to perform regular login. Users who are + enrolled in two-step verification and haven't chosen to "Remember + this computer" will be prompted for their second factor. + + password + The user will only be required to enter their password. + + security-key + The user will be prompted to autheticate using their security key. + If no security key has been configured, the LOGIN method is used. + 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/commitments/create b/gcloud/alpha/compute/commitments/create index bd4999b01..3ce16632a 100644 --- a/gcloud/alpha/compute/commitments/create +++ b/gcloud/alpha/compute/commitments/create @@ -110,11 +110,12 @@ OPTIONAL FLAGS accelerator-optimized-a3-ultra, compute-optimized, compute-optimized-c2d, compute-optimized-c3, compute-optimized-c3d, compute-optimized-h3, general-purpose, general-purpose-c4, - general-purpose-e2, general-purpose-n2, general-purpose-n2d, - general-purpose-n4, general-purpose-t2d, graphics-optimized, - memory-optimized, memory-optimized-m3, memory-optimized-x4, - memory-optimized-x4-16tb, memory-optimized-x4-24tb, - memory-optimized-x4-32tb, storage-optimized-z3. + general-purpose-c4a, general-purpose-e2, general-purpose-n2, + general-purpose-n2d, general-purpose-n4, general-purpose-t2d, + graphics-optimized, memory-optimized, memory-optimized-m3, + memory-optimized-m4, memory-optimized-x4, memory-optimized-x4-16tb, + memory-optimized-x4-24tb, memory-optimized-x4-32tb, + storage-optimized-z3. Manage the reservations to be created with the commitment. diff --git a/gcloud/alpha/compute/disks/convert b/gcloud/alpha/compute/disks/convert new file mode 100644 index 000000000..66216b10f --- /dev/null +++ b/gcloud/alpha/compute/disks/convert @@ -0,0 +1,134 @@ +NAME + gcloud alpha compute disks convert - convert a Compute Engine disk into a + new disk type or new format + +SYNOPSIS + gcloud alpha compute disks convert DISK_NAME + --target-disk-type=TARGET_DISK_TYPE + [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING + --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] + [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Convert Compute Engine Persistent Disk volumes to Hyperdisk + volumes. + + gcloud alpha compute disks convert converts a Compute Engine Persistent + Disk volume to a Hyperdisk volume. For a comprehensive guide, refer to: + https://cloud.google.com/sdk/gcloud/reference/compute/disks/convert. + +EXAMPLES + The following command converts a PD Standard disk to a Hyperdisk + Throughput: + + $ gcloud alpha compute disks convert my-disk-1 --zone=ZONE \ + --target-disk-type=hyperdisk-throughput + +POSITIONAL ARGUMENTS + DISK_NAME + Name of the disk to operate on. + +REQUIRED FLAGS + --target-disk-type=TARGET_DISK_TYPE + Specifies the type of disk to convert to. To get a list of available + disk types, run gcloud compute disk-types list. + +OPTIONAL FLAGS + Key resource - The Cloud KMS (Key Management Service) cryptokey that will + be used to protect the disk. The 'Compute Engine Service Agent' service + account must hold permission 'Cloud KMS CryptoKey Encrypter/Decrypter'. + The arguments in this group can be used to specify the attributes of this + resource. + + --kms-key=KMS_KEY + ID of the key or fully qualified identifier for the key. + + To set the kms-key attribute: + ▸ provide the argument --kms-key on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --kms-keyring=KMS_KEYRING + The KMS keyring of the key. + + To set the kms-keyring attribute: + ▸ provide the argument --kms-key on the command line with a fully + specified name; + ▸ provide the argument --kms-keyring on the command line. + + --kms-location=KMS_LOCATION + The Google Cloud location for the key. + + To set the kms-location attribute: + ▸ provide the argument --kms-key on the command line with a fully + specified name; + ▸ provide the argument --kms-location on the command line; + ▸ provide the argument --region on the command line. + + --kms-project=KMS_PROJECT + The Google Cloud project for the key. + + To set the kms-project attribute: + ▸ provide the argument --kms-key on the command line with a fully + specified name; + ▸ provide the argument --kms-project on the command line; + ▸ set the property core/project. + + At most one of these can be specified: + + --region=REGION + Region of the disk to operate on. If not specified, you might be + prompted to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + + --zone=ZONE + Zone of the disk to operate on. 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 alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/compute/disks/help b/gcloud/alpha/compute/disks/help index 551848dfc..f3a699d3c 100644 --- a/gcloud/alpha/compute/disks/help +++ b/gcloud/alpha/compute/disks/help @@ -40,6 +40,10 @@ COMMANDS add-resource-policies (ALPHA) Add resource policies to a Compute Engine disk. + convert + (ALPHA) Convert a Compute Engine disk into a new disk type or new + format. + create (ALPHA) Create Compute Engine persistent disks. diff --git a/gcloud/alpha/compute/future-reservations/create b/gcloud/alpha/compute/future-reservations/create index 4180e740f..4c9a9a0c5 100644 --- a/gcloud/alpha/compute/future-reservations/create +++ b/gcloud/alpha/compute/future-reservations/create @@ -14,8 +14,7 @@ SYNOPSIS --min-cpu-platform=MIN_CPU_PLATFORM]) (--start-time=START_TIME (--duration=DURATION | --end-time=END_TIME)) [--deployment-type=DEPLOYMENT_TYPE] [--description=DESCRIPTION] - [--[no-]enable-opportunistic-maintenance] [--name-prefix=NAME_PREFIX] - [--planning-status=PLANNING_STATUS] + [--name-prefix=NAME_PREFIX] [--planning-status=PLANNING_STATUS] [--[no-]require-specific-reservation] [--reservation-name=RESERVATION_NAME] [--scheduling-type=SCHEDULING_TYPE] [--zone=ZONE] @@ -180,12 +179,6 @@ OPTIONAL FLAGS --description=DESCRIPTION An optional description of the future reservation to create. - --[no-]enable-opportunistic-maintenance - Enable or disable opportunistic maintenance. If enabled, maintenance is - performed on unused reservations whenever possible. Use - --enable-opportunistic-maintenance to enable and - --no-enable-opportunistic-maintenance to disable. - --name-prefix=NAME_PREFIX A name prefix for the auto-created reservations when capacity is delivered at the start time. Each auto-created reservation name starts diff --git a/gcloud/alpha/compute/future-reservations/update b/gcloud/alpha/compute/future-reservations/update index 7ce68f659..249ed2f0d 100644 --- a/gcloud/alpha/compute/future-reservations/update +++ b/gcloud/alpha/compute/future-reservations/update @@ -6,7 +6,6 @@ SYNOPSIS gcloud alpha compute future-reservations update FUTURE_RESERVATION [--[no-]auto-delete-auto-created-reservations] [--deployment-type=DEPLOYMENT_TYPE] [--description=DESCRIPTION] - [--[no-]enable-opportunistic-maintenance] [--planning-status=PLANNING_STATUS] [--[no-]require-specific-reservation] [--reservation-name=RESERVATION_NAME] @@ -62,12 +61,6 @@ FLAGS --description=DESCRIPTION An optional description of the future reservation to create. - --[no-]enable-opportunistic-maintenance - Enable or disable opportunistic maintenance. If enabled, maintenance is - performed on unused reservations whenever possible. Use - --enable-opportunistic-maintenance to enable and - --no-enable-opportunistic-maintenance to disable. - --planning-status=PLANNING_STATUS The planning status of the future reservation. The default value is DRAFT. While in DRAFT, any changes to the future reservation's diff --git a/gcloud/alpha/compute/help b/gcloud/alpha/compute/help index 395321fc3..499baaa33 100644 --- a/gcloud/alpha/compute/help +++ b/gcloud/alpha/compute/help @@ -114,6 +114,9 @@ GROUPS network-firewall-policies (ALPHA) Manage Compute Engine network firewall policies. + network-profiles + (ALPHA) Read Compute Engine network profiles. + networks (ALPHA) List, create, and delete Compute Engine networks. diff --git a/gcloud/alpha/compute/instance-templates/create b/gcloud/alpha/compute/instance-templates/create index cada99b49..9e9fa4c90 100644 --- a/gcloud/alpha/compute/instance-templates/create +++ b/gcloud/alpha/compute/instance-templates/create @@ -852,6 +852,10 @@ FLAGS Specifies provisioning model, which determines price, obtainability, and runtime for the VM instance. PROVISIONING_MODEL must be one of: + RESERVATION_BOUND + Reservation-bound provisioning model for VM instances which are + bound to the lifecycle of the reservation in which it is + provisioned. SPOT Spot VMs are spare capacity; Spot VMs are discounted to have much lower prices than standard VMs but have no guaranteed runtime. Spot @@ -1158,7 +1162,7 @@ FLAGS practice to use --image-family when the latest version of an image is needed. - By default, debian-11 is assumed for this flag. + By default, debian-12 is assumed for this flag. Maintenance Behavior. diff --git a/gcloud/alpha/compute/instance-templates/create-with-container b/gcloud/alpha/compute/instance-templates/create-with-container index 220c8d163..47d6a4352 100644 --- a/gcloud/alpha/compute/instance-templates/create-with-container +++ b/gcloud/alpha/compute/instance-templates/create-with-container @@ -883,7 +883,7 @@ FLAGS practice to use --image-family when the latest version of an image is needed. - By default, debian-11 is assumed for this flag. + By default, debian-12 is assumed for this flag. Maintenance Behavior. diff --git a/gcloud/alpha/compute/instances/bulk/create b/gcloud/alpha/compute/instances/bulk/create index 0db886919..5c2adb3e8 100644 --- a/gcloud/alpha/compute/instances/bulk/create +++ b/gcloud/alpha/compute/instances/bulk/create @@ -742,6 +742,10 @@ OPTIONAL FLAGS Specifies provisioning model, which determines price, obtainability, and runtime for the VM instance. PROVISIONING_MODEL must be one of: + RESERVATION_BOUND + Reservation-bound provisioning model for VM instances which are + bound to the lifecycle of the reservation in which it is + provisioned. SPOT Spot VMs are spare capacity; Spot VMs are discounted to have much lower prices than standard VMs but have no guaranteed runtime. Spot @@ -1027,7 +1031,7 @@ OPTIONAL FLAGS practice to use --image-family when the latest version of an image is needed. - By default, debian-11 is assumed for this flag. + By default, debian-12 is assumed for this flag. --source-snapshot=SOURCE_SNAPSHOT The name of the source disk snapshot that the instance boot disk will diff --git a/gcloud/alpha/compute/instances/create b/gcloud/alpha/compute/instances/create index c23de26b9..e9d8ef1d7 100644 --- a/gcloud/alpha/compute/instances/create +++ b/gcloud/alpha/compute/instances/create @@ -875,6 +875,10 @@ FLAGS Specifies provisioning model, which determines price, obtainability, and runtime for the VM instance. PROVISIONING_MODEL must be one of: + RESERVATION_BOUND + Reservation-bound provisioning model for VM instances which are + bound to the lifecycle of the reservation in which it is + provisioned. SPOT Spot VMs are spare capacity; Spot VMs are discounted to have much lower prices than standard VMs but have no guaranteed runtime. Spot @@ -1208,7 +1212,7 @@ FLAGS practice to use --image-family when the latest version of an image is needed. - By default, debian-11 is assumed for this flag. + By default, debian-12 is assumed for this flag. --source-instant-snapshot=SOURCE_INSTANT_SNAPSHOT The name of the source disk instant snapshot that the instance boot diff --git a/gcloud/alpha/compute/instances/create-with-container b/gcloud/alpha/compute/instances/create-with-container index ee6fc236c..3f4011648 100644 --- a/gcloud/alpha/compute/instances/create-with-container +++ b/gcloud/alpha/compute/instances/create-with-container @@ -817,6 +817,10 @@ FLAGS Specifies provisioning model, which determines price, obtainability, and runtime for the VM instance. PROVISIONING_MODEL must be one of: + RESERVATION_BOUND + Reservation-bound provisioning model for VM instances which are + bound to the lifecycle of the reservation in which it is + provisioned. SPOT Spot VMs are spare capacity; Spot VMs are discounted to have much lower prices than standard VMs but have no guaranteed runtime. Spot @@ -1067,7 +1071,7 @@ FLAGS practice to use --image-family when the latest version of an image is needed. - By default, debian-11 is assumed for this flag. + By default, debian-12 is assumed for this flag. Maintenance Behavior. diff --git a/gcloud/alpha/compute/instances/network-interfaces/add b/gcloud/alpha/compute/instances/network-interfaces/add index 52f92e226..a112f96a2 100644 --- a/gcloud/alpha/compute/instances/network-interfaces/add +++ b/gcloud/alpha/compute/instances/network-interfaces/add @@ -6,6 +6,7 @@ SYNOPSIS gcloud alpha compute instances network-interfaces add INSTANCE_NAME [--aliases=ALIASES] [--external-ipv6-address=EXTERNAL_IPV6_ADDRESS] [--external-ipv6-prefix-length=EXTERNAL_IPV6_PREFIX_LENGTH] + [--igmp-query=IGMP_QUERY] [--internal-ipv6-address=INTERNAL_IPV6_ADDRESS] [--internal-ipv6-prefix-length=INTERNAL_IPV6_PREFIX_LENGTH] [--ipv6-address=IPV6_ADDRESS] [--ipv6-network-tier=IPV6_NETWORK_TIER] @@ -57,6 +58,16 @@ FLAGS be used together with --external-ipv6-address. Currently only /96 is supported and the default value is 96. + --igmp-query=IGMP_QUERY + Determines if the Compute Engine instance can receive and respond to + IGMP query packets on the specified network interface. IGMP_QUERY must + be one of: + + IGMP_QUERY_DISABLED + IGMP Query on the network interface is disabled. + IGMP_QUERY_V2 + IGMP Query V2 on the network interface is enabled. + --internal-ipv6-address=INTERNAL_IPV6_ADDRESS Assigns the given internal IPv6 address or range to an instance. The address must be the first IP address in the range or a /96 IP address diff --git a/gcloud/alpha/compute/instances/set-scheduling b/gcloud/alpha/compute/instances/set-scheduling index 59efac6c9..ea2963111 100644 --- a/gcloud/alpha/compute/instances/set-scheduling +++ b/gcloud/alpha/compute/instances/set-scheduling @@ -81,6 +81,10 @@ FLAGS Specifies provisioning model, which determines price, obtainability, and runtime for the VM instance. PROVISIONING_MODEL must be one of: + RESERVATION_BOUND + Reservation-bound provisioning model for VM instances which are + bound to the lifecycle of the reservation in which it is + provisioned. SPOT Spot VMs are spare capacity; Spot VMs are discounted to have much lower prices than standard VMs but have no guaranteed runtime. Spot diff --git a/gcloud/alpha/compute/network-profiles/describe b/gcloud/alpha/compute/network-profiles/describe new file mode 100644 index 000000000..6e95cfd4e --- /dev/null +++ b/gcloud/alpha/compute/network-profiles/describe @@ -0,0 +1,54 @@ +NAME + gcloud alpha compute network-profiles describe - describe a network profile + +SYNOPSIS + gcloud alpha compute network-profiles describe NETWORK_PROFILE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a network profile. + +EXAMPLES + To retrieve a single network profile and print its properties, run the + following command: $ gcloud alpha compute network-profiles describe my-network-profile + +POSITIONAL ARGUMENTS + Network profile resource - Name of the network profile you want to + inspect. 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 network_profile on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + NETWORK_PROFILE + ID of the network_profile or fully qualified identifier for the + network_profile. + + To set the network_profile attribute: + ▸ provide the argument network_profile 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 compute/alpha API. The full documentation for this + API can be found at: https://cloud.google.com/compute/ + +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 network-profiles describe + diff --git a/gcloud/alpha/compute/network-profiles/help b/gcloud/alpha/compute/network-profiles/help new file mode 100644 index 000000000..cf3c79ab3 --- /dev/null +++ b/gcloud/alpha/compute/network-profiles/help @@ -0,0 +1,32 @@ +NAME + gcloud alpha compute network-profiles - read Compute Engine network + profiles + +SYNOPSIS + gcloud alpha compute network-profiles COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Read Compute Engine network profiles. + +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 a network profile. + + list + (ALPHA) List network profiles. + +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 network-profiles + diff --git a/gcloud/alpha/compute/network-profiles/list b/gcloud/alpha/compute/network-profiles/list new file mode 100644 index 000000000..29d85507b --- /dev/null +++ b/gcloud/alpha/compute/network-profiles/list @@ -0,0 +1,68 @@ +NAME + gcloud alpha compute network-profiles list - list network profiles + +SYNOPSIS + gcloud alpha compute network-profiles list [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List network profiles. + +EXAMPLES + The following command lists all network profiles: + + $ gcloud alpha compute network-profiles list + +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 compute/alpha API. The full documentation for this + API can be found at: https://cloud.google.com/compute/ + +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 network-profiles list + diff --git a/gcloud/alpha/compute/os-config/policy-orchestrators/create b/gcloud/alpha/compute/os-config/policy-orchestrators/create index fd854009e..afc557f82 100644 --- a/gcloud/alpha/compute/os-config/policy-orchestrators/create +++ b/gcloud/alpha/compute/os-config/policy-orchestrators/create @@ -6,6 +6,8 @@ SYNOPSIS gcloud alpha compute os-config policy-orchestrators create (POLICY_ORCHESTRATOR : --folder=FOLDER --organization=ORGANIZATION) --policy-type=POLICY_TYPE [--action=ACTION; default="upsert"] [--async] + [--include-folders=INCLUDE_FOLDERS] + [--include-locations=INCLUDE_LOCATIONS] [--include-projects=INCLUDE_PROJECTS] [--policy-file=POLICY_FILE] [--policy-id=POLICY_ID] [--state=STATE; default="ACTIVE"] [GCLOUD_WIDE_FLAG ...] @@ -94,8 +96,16 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --include-folders=INCLUDE_FOLDERS + Applies policy to selected folders. Comma-separated list of folder + numbers. Can beused together with --include-projects. + + --include-locations=INCLUDE_LOCATIONS + Applies policy to selected locations, e.g. us-central1-a. + --include-projects=INCLUDE_PROJECTS - Applies policy to selected projects only. + Applies policy to selected projects. Comma-separated list of project + numbers. Can be used together with --include-folders. --policy-file=POLICY_FILE Absolute path to the OS policy assignment file on your local client. diff --git a/gcloud/alpha/compute/os-config/policy-orchestrators/update b/gcloud/alpha/compute/os-config/policy-orchestrators/update index 012ab7a9f..d8f96224c 100644 --- a/gcloud/alpha/compute/os-config/policy-orchestrators/update +++ b/gcloud/alpha/compute/os-config/policy-orchestrators/update @@ -7,6 +7,8 @@ SYNOPSIS (POLICY_ORCHESTRATOR : --folder=FOLDER --organization=ORGANIZATION) [--action=ACTION] [--async] [--policy-file=POLICY_FILE] [--policy-id=POLICY_ID] [--state=STATE] + [--clear-folders | --include-folders=INCLUDE_FOLDERS] + [--clear-locations | --include-locations=INCLUDE_LOCATIONS] [--clear-projects | --include-projects=INCLUDE_PROJECTS] [GCLOUD_WIDE_FLAG ...] @@ -104,8 +106,32 @@ FLAGS stopped Updates the policy orchestrator to STOPPED state. - Projects to include in the policy orchestrator. If include-projects is - set, clear-projects must not be set. + Folders to include in the policy orchestrator. Comma-separated list of + folder numbers. If --include-folders is set, --clear-folders must not be + set. + + At most one of these can be specified: + + --clear-folders + Clears included folders from policy orchestrator selectors. + + --include-folders=INCLUDE_FOLDERS + Applies policy to selected folders only. + + Locations to include in the policy orchestrator, e.g. us-central1-a. If + include-locations is set, clear-locations must not be set. + + At most one of these can be specified: + + --clear-locations + Clears included locations from policy orchestrator selectors. + + --include-locations=INCLUDE_LOCATIONS + Applies policy to selected locations only. + + Projects to include in the policy orchestrator. Comma separated list of + project numbers. If include-projects is set, clear-projects must not be + set. At most one of these can be specified: diff --git a/gcloud/alpha/compute/queued-resources/create b/gcloud/alpha/compute/queued-resources/create index 267fb8f10..8612a21ab 100644 --- a/gcloud/alpha/compute/queued-resources/create +++ b/gcloud/alpha/compute/queued-resources/create @@ -1021,7 +1021,7 @@ OPTIONAL FLAGS practice to use --image-family when the latest version of an image is needed. - By default, debian-11 is assumed for this flag. + By default, debian-12 is assumed for this flag. --source-snapshot=SOURCE_SNAPSHOT The name of the source disk snapshot that the instance boot disk will diff --git a/gcloud/alpha/config/get b/gcloud/alpha/config/get index e664d0065..5b2521ff8 100644 --- a/gcloud/alpha/config/get +++ b/gcloud/alpha/config/get @@ -1028,6 +1028,12 @@ AVAILABLE PROPERTIES When a region is required but not provided by a flag, the command will fall back to this value, if set. + lustre + location + Default location to use when working with Cloud Lustre resources. + When a location value is required but not provided, the command + will fall back to this value, if set. + media_asset location Default location to use when working with Cloud Media Asset diff --git a/gcloud/alpha/config/help b/gcloud/alpha/config/help index 934634a59..9fe61265c 100644 --- a/gcloud/alpha/config/help +++ b/gcloud/alpha/config/help @@ -1060,6 +1060,12 @@ AVAILABLE PROPERTIES When a region is required but not provided by a flag, the command will fall back to this value, if set. + lustre + location + Default location to use when working with Cloud Lustre resources. + When a location value is required but not provided, the command + will fall back to this value, if set. + media_asset location Default location to use when working with Cloud Media Asset diff --git a/gcloud/alpha/config/list b/gcloud/alpha/config/list index 085cec526..71195a09a 100644 --- a/gcloud/alpha/config/list +++ b/gcloud/alpha/config/list @@ -1072,6 +1072,12 @@ AVAILABLE PROPERTIES When a region is required but not provided by a flag, the command will fall back to this value, if set. + lustre + location + Default location to use when working with Cloud Lustre resources. + When a location value is required but not provided, the command + will fall back to this value, if set. + media_asset location Default location to use when working with Cloud Media Asset diff --git a/gcloud/alpha/config/set b/gcloud/alpha/config/set index 93f522c3e..933647ce1 100644 --- a/gcloud/alpha/config/set +++ b/gcloud/alpha/config/set @@ -1075,6 +1075,12 @@ AVAILABLE PROPERTIES When a region is required but not provided by a flag, the command will fall back to this value, if set. + lustre + location + Default location to use when working with Cloud Lustre resources. + When a location value is required but not provided, the command + will fall back to this value, if set. + media_asset location Default location to use when working with Cloud Media Asset diff --git a/gcloud/alpha/config/unset b/gcloud/alpha/config/unset index b827be39a..0750bdf79 100644 --- a/gcloud/alpha/config/unset +++ b/gcloud/alpha/config/unset @@ -1036,6 +1036,12 @@ AVAILABLE PROPERTIES When a region is required but not provided by a flag, the command will fall back to this value, if set. + lustre + location + Default location to use when working with Cloud Lustre resources. + When a location value is required but not provided, the command + will fall back to this value, if set. + media_asset location Default location to use when working with Cloud Media Asset diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index f4d92ad47..34fa6d535 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -48,12 +48,14 @@ SYNOPSIS [--enable-service-externalips] [--enable-shielded-nodes] [--enable-stackdriver-kubernetes] [--enable-vertical-pod-autoscaling] [--fleet-project=PROJECT_ID_OR_NUMBER] [--gateway-api=GATEWAY_API] - [--identity-provider=IDENTITY_PROVIDER] [--image-type=IMAGE_TYPE] + [--hpa-profile=HPA_PROFILE] [--identity-provider=IDENTITY_PROVIDER] + [--image-type=IMAGE_TYPE] [--in-transit-encryption=IN_TRANSIT_ENCRYPTION] [--ipv6-access-type=IPV6_ACCESS_TYPE] [--issue-client-certificate] [--istio-config=[auth=MTLS_PERMISSIVE,...]] [--labels=[KEY=VALUE,...]] - [--linux-sysctls=KEY=VALUE,[KEY=VALUE,...]] [--logging=[COMPONENT,...]] - [--logging-variant=LOGGING_VARIANT] + [--linux-sysctls=KEY=VALUE,[KEY=VALUE,...]] + [--local-ssd-encryption-mode=LOCAL_SSD_ENCRYPTION_MODE] + [--logging=[COMPONENT,...]] [--logging-variant=LOGGING_VARIANT] [--machine-type=MACHINE_TYPE, -m MACHINE_TYPE] [--max-nodes-per-pool=MAX_NODES_PER_POOL] [--max-pods-per-node=MAX_PODS_PER_NODE] @@ -746,6 +748,10 @@ FLAGS definitions from the standard OSS Gateway API release channel will be installed. + --hpa-profile=HPA_PROFILE + Setting Horizontal Pod Autoscaler behavior, which is none by default. + HPA_PROFILE must be one of: none, performance. + --identity-provider=IDENTITY_PROVIDER Enable 3P identity provider on the cluster. @@ -818,6 +824,11 @@ FLAGS The --linux-sysctls flag is deprecated. Please use --system-config-from-file instead. + --local-ssd-encryption-mode=LOCAL_SSD_ENCRYPTION_MODE + Encryption mode for Local SSDs on the cluster. + LOCAL_SSD_ENCRYPTION_MODE must be one of: STANDARD_ENCRYPTION, + EPHEMERAL_KEY_ENCRYPTION. + --logging=[COMPONENT,...] Set the components that have logging enabled. Valid component values are: SYSTEM, WORKLOAD, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, NONE diff --git a/gcloud/alpha/container/clusters/create-auto b/gcloud/alpha/container/clusters/create-auto index 2e2a1f3d6..5f317080d 100644 --- a/gcloud/alpha/container/clusters/create-auto +++ b/gcloud/alpha/container/clusters/create-auto @@ -22,13 +22,14 @@ SYNOPSIS [--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] [--labels=[KEY=VALUE,...]] - [--logging=[COMPONENT,...]] [--monitoring=[COMPONENT,...]] - [--network=NETWORK] [--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] [--workload-policies=WORKLOAD_POLICIES] + [--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] [--security-posture=SECURITY_POSTURE] + [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] + [--subnetwork=SUBNETWORK] [--tier=TIER] + [--workload-policies=WORKLOAD_POLICIES] [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN | --disable-additive-vpc-scope] @@ -301,6 +302,10 @@ FLAGS Example: $ gcloud alpha container clusters create-auto \ --fleet-project=my-project + --hpa-profile=HPA_PROFILE + Setting Horizontal Pod Autoscaler behavior, which is none by default. + HPA_PROFILE must be one of: none, performance. + --labels=[KEY=VALUE,...] Labels to apply to the Google Cloud resources in use by the Kubernetes Engine cluster. These are unrelated to Kubernetes labels. diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index d5a5c1b5e..7cedd95f1 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha container clusters update NAME - (--autoprovisioning-enable-insecure-kubelet-readonly-port + (--autoprovisioning-cgroup-mode=AUTOPROVISIONING_CGROUP_MODE + | --autoprovisioning-enable-insecure-kubelet-readonly-port | --autoprovisioning-network-tags=[TAGS,...] | --autoprovisioning-resource-manager-tags=[KEY=VALUE,...] | --autoscaling-profile=AUTOSCALING_PROFILE | --clear-fleet-project @@ -28,7 +29,8 @@ SYNOPSIS | --enable-service-externalips | --enable-shielded-nodes | --enable-stackdriver-kubernetes | --enable-vertical-pod-autoscaling | --fleet-project=PROJECT_ID_OR_NUMBER | --gateway-api=GATEWAY_API - | --generate-password | --identity-provider=IDENTITY_PROVIDER + | --generate-password | --hpa-profile=HPA_PROFILE + | --identity-provider=IDENTITY_PROVIDER | --in-transit-encryption=IN_TRANSIT_ENCRYPTION | --logging-variant=LOGGING_VARIANT | --maintenance-window=START_TIME | --network-performance-configs=[PROPERTY1=VALUE1,...] @@ -131,6 +133,32 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS Exactly one of these must be specified: + --autoprovisioning-cgroup-mode=AUTOPROVISIONING_CGROUP_MODE + Sets the cgroup mode for auto-provisioned nodes. + + Updating this flag triggers an update using surge upgrades of all + existing auto-provisioned nodes to apply the new value of cgroup + mode. + + For an Autopilot cluster, the specified cgroup mode will be set on + all existing and new nodes in the cluster. For a Standard cluster, + the specified cgroup mode will be set on all existing and new + auto-provisioned node pools in the cluster. + + If not set, GKE uses cgroupv2 for new nodes when the cluster was + created running 1.26 or later, and cgroupv1 for clusters created + running 1.25 or earlier. To check your initial cluster version, run + gcloud container clusters describe [NAME] + --format="value(initialClusterVersion)" + + For clusters created running version 1.26 or later, you can't set the + cgroup mode to v1. + + To learn more, see: + https://cloud.google.com/kubernetes-engine/docs/how-to/migrate-cgroupv2. + + AUTOPROVISIONING_CGROUP_MODE must be one of: default, v1, v2. + --autoprovisioning-enable-insecure-kubelet-readonly-port Enables the Kubelet's insecure read only port for Autoprovisioned Node Pools. @@ -481,6 +509,10 @@ REQUIRED FLAGS Ask the server to generate a secure password and use that as the basic auth password, keeping the existing username. + --hpa-profile=HPA_PROFILE + Setting Horizontal Pod Autoscaler behavior, which is none by default. + HPA_PROFILE must be one of: none, performance. + --identity-provider=IDENTITY_PROVIDER Enable 3P identity provider on the cluster. diff --git a/gcloud/alpha/container/node-pools/create b/gcloud/alpha/container/node-pools/create index acca5257e..353e1559a 100644 --- a/gcloud/alpha/container/node-pools/create +++ b/gcloud/alpha/container/node-pools/create @@ -26,6 +26,7 @@ SYNOPSIS [--enable-queued-provisioning] [--enable-surge-upgrade] [--image-type=IMAGE_TYPE] [--labels=[KEY=VALUE,...]] [--linux-sysctls=KEY=VALUE,[KEY=VALUE,...]] + [--local-ssd-encryption-mode=LOCAL_SSD_ENCRYPTION_MODE] [--logging-variant=LOGGING_VARIANT] [--machine-type=MACHINE_TYPE, -m MACHINE_TYPE] [--max-pods-per-node=MAX_PODS_PER_NODE] @@ -332,6 +333,11 @@ FLAGS The --linux-sysctls flag is deprecated. Please use --system-config-from-file instead. + --local-ssd-encryption-mode=LOCAL_SSD_ENCRYPTION_MODE + Encryption mode for Local SSDs on the node pool. + LOCAL_SSD_ENCRYPTION_MODE must be one of: STANDARD_ENCRYPTION, + EPHEMERAL_KEY_ENCRYPTION. + --logging-variant=LOGGING_VARIANT Specifies the logging variant that will be deployed on all the nodes in the node pool. If the node pool doesn't specify a logging variant, then diff --git a/gcloud/alpha/container/vmware/admin-clusters/update b/gcloud/alpha/container/vmware/admin-clusters/update index 4c09a868b..62c418030 100644 --- a/gcloud/alpha/container/vmware/admin-clusters/update +++ b/gcloud/alpha/container/vmware/admin-clusters/update @@ -6,7 +6,7 @@ SYNOPSIS gcloud alpha container vmware admin-clusters update (ADMIN_CLUSTER : --location=LOCATION) [--async] [--required-platform-version=REQUIRED_PLATFORM_VERSION] - [GCLOUD_WIDE_FLAG ...] + [--version=VERSION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update an Anthos on VMware admin cluster. @@ -61,6 +61,9 @@ FLAGS version will be updated to the required version. If it is not installed in the platform, download the required version bundle. + --version=VERSION + Anthos Cluster on VMware version for the user cluster resource + 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/dataplex/datascans/create/data-discovery b/gcloud/alpha/dataplex/datascans/create/data-discovery new file mode 100644 index 000000000..d1532f60f --- /dev/null +++ b/gcloud/alpha/dataplex/datascans/create/data-discovery @@ -0,0 +1,149 @@ +NAME + gcloud alpha dataplex datascans create data-discovery - create a Dataplex + data discovery scan job + +SYNOPSIS + gcloud alpha dataplex datascans create data-discovery + (DATASCAN : --location=LOCATION) + --data-source-resource=DATA_SOURCE_RESOURCE [--description=DESCRIPTION] + [--display-name=DISPLAY_NAME] [--labels=[KEY=VALUE,...]] + [--async | --validate-only] + [--bigquery-publishing-connection=BIGQUERY_PUBLISHING_CONNECTION + --bigquery-publishing-table-type=BIGQUERY_PUBLISHING_TABLE_TYPE] + [--on-demand=ON_DEMAND | --schedule=SCHEDULE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Allows users to auto discover BigQuery External and BigLake tables + from underlying Cloud Storage buckets. + +EXAMPLES + To create a data discovery scan data-discovery-datascan in project + test-project located in us-central1 on Cloud Storage bucket test-bucket, + run: + + $ gcloud alpha dataplex datascans create data-discovery \ + data-discovery-datascan --project=test-project \ + --location=us-central1 \ + --data-source-resource="//storage.googleapis.com/projects/test-p\ + roject/buckets/test-bucket" + +POSITIONAL ARGUMENTS + Datascan resource - Arguments and flags that define the Dataplex datascan + you want to create a data discovery scan 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 datascan 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. + + DATASCAN + ID of the datascan or fully qualified identifier for the datascan. + + To set the dataScans attribute: + ▸ provide the argument datascan 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 Dataplex resource. + + To set the location attribute: + ▸ provide the argument datascan on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property dataplex/location. + +REQUIRED FLAGS + --data-source-resource=DATA_SOURCE_RESOURCE + Fully-qualified service resource name of the cloud resource bucket that + contains the data for the data discovery scan, of the form: + //storage.googleapis.com/projects/{project_id_or_number}/buckets/{bucket_id}. + +OPTIONAL FLAGS + --description=DESCRIPTION + Description of the data discovery scan. + + --display-name=DISPLAY_NAME + Display name of the data discovery scan. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of --async | --validate-only can be specified. + + At most one of these can be specified: + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --validate-only + Validate the create action, but don't actually perform it. + + Data spec for the data discovery scan. + + BigQuery publishing config arguments for the data discovery scan. + + --bigquery-publishing-connection=BIGQUERY_PUBLISHING_CONNECTION + BigQuery connection to use for auto discovering cloud resource + bucket to BigLake tables in format + projects/{project_id}/locations/{location_id}/connections/{connection_id}. + Connection is required for BIGLAKE BigQuery publishing table type. + + --bigquery-publishing-table-type=BIGQUERY_PUBLISHING_TABLE_TYPE + BigQuery table type to discover the cloud resource bucket. Can be + either EXTERNAL or BIGLAKE. If not specified, the table type will + be set to EXTERNAL. BIGQUERY_PUBLISHING_TABLE_TYPE must be one of: + + BIGLAKE + GCS Cloud Storage bucket is discoverd to BigQuery BigLake + tables. + EXTERNAL + default value. GCS Cloud Storage bucket is discoverd to + BigQuery External tables. + + Data discovery scan execution settings. + + Data discovery scan scheduling and trigger settings. + + At most one of these can be specified: + + --on-demand=ON_DEMAND + If set, the scan runs one-time shortly after data discovery scan + creation. + + --schedule=SCHEDULE + Cron schedule (https://en.wikipedia.org/wiki/Cron) for running + scans periodically. To explicitly set a timezone to the cron tab, + apply a prefix in the cron tab: "CRON_TZ=${IANA_TIME_ZONE}" or + "TZ=${IANA_TIME_ZONE}". The ${IANA_TIME_ZONE} may only be a valid + string from IANA time zone database. For example, + CRON_TZ=America/New_York 1 * * * * or TZ=America/New_York 1 * * * + *. This field is required for RECURRING scans. + +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/dataplex/datascans/create/help b/gcloud/alpha/dataplex/datascans/create/help index 700f4f3e3..7d4d0a4b8 100644 --- a/gcloud/alpha/dataplex/datascans/create/help +++ b/gcloud/alpha/dataplex/datascans/create/help @@ -15,6 +15,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + data-discovery + (ALPHA) Create a Dataplex data discovery scan job. + data-profile (ALPHA) Create a Dataplex data profile scan job. diff --git a/gcloud/alpha/dataplex/datascans/update/data-discovery b/gcloud/alpha/dataplex/datascans/update/data-discovery new file mode 100644 index 000000000..8506edbc2 --- /dev/null +++ b/gcloud/alpha/dataplex/datascans/update/data-discovery @@ -0,0 +1,131 @@ +NAME + gcloud alpha dataplex datascans update data-discovery - update a Dataplex + data discovery scan job + +SYNOPSIS + gcloud alpha dataplex datascans update data-discovery + (DATASCAN : --location=LOCATION) [--description=DESCRIPTION] + [--display-name=DISPLAY_NAME] [--labels=[KEY=VALUE,...]] + [--async | --validate-only] + [--bigquery-publishing-connection=BIGQUERY_PUBLISHING_CONNECTION + --bigquery-publishing-table-type=BIGQUERY_PUBLISHING_TABLE_TYPE] + [--on-demand=ON_DEMAND | --schedule=SCHEDULE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Allows users to auto discover BigQuery External and BigLake tables + from underlying Cloud Storage buckets. + +EXAMPLES + To update description of a data discovery scan data-discovery-datascan in + project test-project located in us-central1, run: + + $ gcloud alpha dataplex datascans update data-discovery \ + data-discovery-datascan --project=test-project \ + --location=us-central1 --description="Description is updated." + +POSITIONAL ARGUMENTS + Datascan resource - Arguments and flags that define the Dataplex datascan + you want to update a data discovery scan 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 datascan 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. + + DATASCAN + ID of the datascan or fully qualified identifier for the datascan. + + To set the dataScans attribute: + ▸ provide the argument datascan 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 Dataplex resource. + + To set the location attribute: + ▸ provide the argument datascan on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property dataplex/location. + +FLAGS + --description=DESCRIPTION + Description of the data discovery scan + + --display-name=DISPLAY_NAME + Display name of the data discovery scan + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of --async | --validate-only can be specified. + + At most one of these can be specified: + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --validate-only + Validate the update action, but don't actually perform it. + + Data spec for the data discovery scan. + + BigQuery publishing config arguments for the data discovery scan. + + --bigquery-publishing-connection=BIGQUERY_PUBLISHING_CONNECTION + BigQuery connection to use for auto discovering cloud resource + bucket to BigLake tables. Connection is required for + BIGLAKE`BigQuery publishing table type. + + --bigquery-publishing-table-type=BIGQUERY_PUBLISHING_TABLE_TYPE + BigQuery table type to discover the cloud resource bucket. Can be + either EXTERNAL or BIGLAKE. If not specified, the table type will + be set to EXTERNAL. + + Data discovery scan execution settings. + + Data discovery scan scheduling and trigger settings + + At most one of these can be specified: + + --on-demand=ON_DEMAND + If set, the scan runs one-time shortly after data discovery scan + updation. + + --schedule=SCHEDULE + Cron schedule (https://en.wikipedia.org/wiki/Cron) for running + scans periodically. To explicitly set a timezone to the cron tab, + apply a prefix in the cron tab: "CRON_TZ=${IANA_TIME_ZONE}" or + "TZ=${IANA_TIME_ZONE}". The ${IANA_TIME_ZONE} may only be a valid + string from IANA time zone database. For example, + CRON_TZ=America/New_York 1 * * * * or TZ=America/New_York 1 * * * + *. This field is required for RECURRING scans. + +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/dataplex/datascans/update/help b/gcloud/alpha/dataplex/datascans/update/help index 83f6e1e15..305c5fcc4 100644 --- a/gcloud/alpha/dataplex/datascans/update/help +++ b/gcloud/alpha/dataplex/datascans/update/help @@ -15,6 +15,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + data-discovery + (ALPHA) Update a Dataplex data discovery scan job. + data-profile (ALPHA) Update a Dataplex data profile scan job. diff --git a/gcloud/alpha/managed-kafka/clusters/create b/gcloud/alpha/managed-kafka/clusters/create index 0be679842..bf9628e98 100644 --- a/gcloud/alpha/managed-kafka/clusters/create +++ b/gcloud/alpha/managed-kafka/clusters/create @@ -112,7 +112,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 managed-kafka clusters create $ gcloud beta managed-kafka clusters create diff --git a/gcloud/alpha/managed-kafka/clusters/delete b/gcloud/alpha/managed-kafka/clusters/delete index 36987c639..5893feee6 100644 --- a/gcloud/alpha/managed-kafka/clusters/delete +++ b/gcloud/alpha/managed-kafka/clusters/delete @@ -72,7 +72,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 managed-kafka clusters delete $ gcloud beta managed-kafka clusters delete diff --git a/gcloud/alpha/managed-kafka/clusters/describe b/gcloud/alpha/managed-kafka/clusters/describe index a94ec46e6..94abd0977 100644 --- a/gcloud/alpha/managed-kafka/clusters/describe +++ b/gcloud/alpha/managed-kafka/clusters/describe @@ -67,7 +67,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud managed-kafka clusters describe $ gcloud beta managed-kafka clusters describe diff --git a/gcloud/alpha/managed-kafka/clusters/help b/gcloud/alpha/managed-kafka/clusters/help index ebbc2a75f..5eff56e45 100644 --- a/gcloud/alpha/managed-kafka/clusters/help +++ b/gcloud/alpha/managed-kafka/clusters/help @@ -36,7 +36,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 managed-kafka clusters $ gcloud beta managed-kafka clusters diff --git a/gcloud/alpha/managed-kafka/clusters/list b/gcloud/alpha/managed-kafka/clusters/list index db73b8a71..3f194108e 100644 --- a/gcloud/alpha/managed-kafka/clusters/list +++ b/gcloud/alpha/managed-kafka/clusters/list @@ -79,7 +79,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 managed-kafka clusters list $ gcloud beta managed-kafka clusters list diff --git a/gcloud/alpha/managed-kafka/clusters/update b/gcloud/alpha/managed-kafka/clusters/update index d2bb20c55..feeec0634 100644 --- a/gcloud/alpha/managed-kafka/clusters/update +++ b/gcloud/alpha/managed-kafka/clusters/update @@ -105,7 +105,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 managed-kafka clusters update $ gcloud beta managed-kafka clusters update diff --git a/gcloud/alpha/managed-kafka/consumer-groups/delete b/gcloud/alpha/managed-kafka/consumer-groups/delete index ba0c3f705..4f4867ef2 100644 --- a/gcloud/alpha/managed-kafka/consumer-groups/delete +++ b/gcloud/alpha/managed-kafka/consumer-groups/delete @@ -77,7 +77,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 managed-kafka consumer-groups delete $ gcloud beta managed-kafka consumer-groups delete diff --git a/gcloud/alpha/managed-kafka/consumer-groups/describe b/gcloud/alpha/managed-kafka/consumer-groups/describe index e8e0162d5..16c74f180 100644 --- a/gcloud/alpha/managed-kafka/consumer-groups/describe +++ b/gcloud/alpha/managed-kafka/consumer-groups/describe @@ -77,7 +77,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 managed-kafka consumer-groups describe $ gcloud beta managed-kafka consumer-groups describe diff --git a/gcloud/alpha/managed-kafka/consumer-groups/help b/gcloud/alpha/managed-kafka/consumer-groups/help index 539f55738..0ef91292d 100644 --- a/gcloud/alpha/managed-kafka/consumer-groups/help +++ b/gcloud/alpha/managed-kafka/consumer-groups/help @@ -33,7 +33,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 managed-kafka consumer-groups $ gcloud beta managed-kafka consumer-groups diff --git a/gcloud/alpha/managed-kafka/consumer-groups/list b/gcloud/alpha/managed-kafka/consumer-groups/list index 9d7156d17..660cdbd74 100644 --- a/gcloud/alpha/managed-kafka/consumer-groups/list +++ b/gcloud/alpha/managed-kafka/consumer-groups/list @@ -96,7 +96,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 managed-kafka consumer-groups list $ gcloud beta managed-kafka consumer-groups list diff --git a/gcloud/alpha/managed-kafka/consumer-groups/update b/gcloud/alpha/managed-kafka/consumer-groups/update index 7c43ee05a..0f37e2c40 100644 --- a/gcloud/alpha/managed-kafka/consumer-groups/update +++ b/gcloud/alpha/managed-kafka/consumer-groups/update @@ -101,7 +101,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 managed-kafka consumer-groups update $ gcloud beta managed-kafka consumer-groups update diff --git a/gcloud/alpha/managed-kafka/help b/gcloud/alpha/managed-kafka/help index 5f8ab1e97..7aa5a79e9 100644 --- a/gcloud/alpha/managed-kafka/help +++ b/gcloud/alpha/managed-kafka/help @@ -30,7 +30,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 managed-kafka $ gcloud beta managed-kafka diff --git a/gcloud/alpha/managed-kafka/topics/create b/gcloud/alpha/managed-kafka/topics/create index e23685224..e740d1a77 100644 --- a/gcloud/alpha/managed-kafka/topics/create +++ b/gcloud/alpha/managed-kafka/topics/create @@ -97,7 +97,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 managed-kafka topics create $ gcloud beta managed-kafka topics create diff --git a/gcloud/alpha/managed-kafka/topics/delete b/gcloud/alpha/managed-kafka/topics/delete index 4349682a1..0bf92ff79 100644 --- a/gcloud/alpha/managed-kafka/topics/delete +++ b/gcloud/alpha/managed-kafka/topics/delete @@ -75,7 +75,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 managed-kafka topics delete $ gcloud beta managed-kafka topics delete diff --git a/gcloud/alpha/managed-kafka/topics/describe b/gcloud/alpha/managed-kafka/topics/describe index 9f5c3fe4e..0621dc875 100644 --- a/gcloud/alpha/managed-kafka/topics/describe +++ b/gcloud/alpha/managed-kafka/topics/describe @@ -75,7 +75,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 managed-kafka topics describe $ gcloud beta managed-kafka topics describe diff --git a/gcloud/alpha/managed-kafka/topics/help b/gcloud/alpha/managed-kafka/topics/help index fa12cd07a..f35231150 100644 --- a/gcloud/alpha/managed-kafka/topics/help +++ b/gcloud/alpha/managed-kafka/topics/help @@ -36,7 +36,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 managed-kafka topics $ gcloud beta managed-kafka topics diff --git a/gcloud/alpha/managed-kafka/topics/list b/gcloud/alpha/managed-kafka/topics/list index fb21b5621..a8f789b63 100644 --- a/gcloud/alpha/managed-kafka/topics/list +++ b/gcloud/alpha/managed-kafka/topics/list @@ -96,7 +96,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 managed-kafka topics list $ gcloud beta managed-kafka topics list diff --git a/gcloud/alpha/managed-kafka/topics/update b/gcloud/alpha/managed-kafka/topics/update index c69774c84..4f724c81f 100644 --- a/gcloud/alpha/managed-kafka/topics/update +++ b/gcloud/alpha/managed-kafka/topics/update @@ -99,7 +99,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 managed-kafka topics update $ gcloud beta managed-kafka topics update diff --git a/gcloud/alpha/network-security/security-profiles/threat-prevention/add-override b/gcloud/alpha/network-security/security-profiles/threat-prevention/add-override index a17853417..95e57bfae 100644 --- a/gcloud/alpha/network-security/security-profiles/threat-prevention/add-override +++ b/gcloud/alpha/network-security/security-profiles/threat-prevention/add-override @@ -67,7 +67,7 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --action=ACTION Action associated with severity or threat-id. ACTION must be one of: - DEFAULT, ALLOW, ALERT, DENY. + DEFAULT_ACTION, ALLOW, ALERT, DENY. Exactly one of these must be specified: diff --git a/gcloud/alpha/network-security/security-profiles/threat-prevention/update-override b/gcloud/alpha/network-security/security-profiles/threat-prevention/update-override index 2b87713af..b9933ff3d 100644 --- a/gcloud/alpha/network-security/security-profiles/threat-prevention/update-override +++ b/gcloud/alpha/network-security/security-profiles/threat-prevention/update-override @@ -67,7 +67,7 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --action=ACTION Action associated with severity or threat-id. ACTION must be one of: - DEFAULT, ALLOW, ALERT, DENY. + DEFAULT_ACTION, ALLOW, ALERT, DENY. Exactly one of these must be specified: diff --git a/gcloud/alpha/quotas/info/list b/gcloud/alpha/quotas/info/list index eafcd0284..6a8bd4231 100644 --- a/gcloud/alpha/quotas/info/list +++ b/gcloud/alpha/quotas/info/list @@ -5,9 +5,9 @@ NAME SYNOPSIS gcloud alpha quotas info list --service=SERVICE (--folder=FOLDER_ID | --organization=ORGANIZATION_ID - | --project=PROJECT_ID_OR_NUMBER) [--page-token=PAGE_TOKEN] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + | --project=PROJECT_ID_OR_NUMBER) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] EXAMPLES To list all quota info for service example.googleapis.com and @@ -40,11 +40,6 @@ REQUIRED FLAGS --project=PROJECT_ID_OR_NUMBER Project of the quota info to list. -FLAGS - --page-token=PAGE_TOKEN - A token identifying a page of results the server should return. Default - is none. - LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/alpha/quotas/preferences/list b/gcloud/alpha/quotas/preferences/list index 0d7ca59d2..80780d107 100644 --- a/gcloud/alpha/quotas/preferences/list +++ b/gcloud/alpha/quotas/preferences/list @@ -5,10 +5,9 @@ NAME SYNOPSIS gcloud alpha quotas preferences list (--folder=FOLDER_ID | --organization=ORGANIZATION_ID - | --project=PROJECT_ID_OR_NUMBER) [--page-token=PAGE_TOKEN] - [--reconciling-only] [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] + | --project=PROJECT_ID_OR_NUMBER) [--reconciling-only] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] EXAMPLES To list the quota preferences for projects/12321, run: @@ -41,10 +40,6 @@ REQUIRED FLAGS Project of the quota preferences to list. FLAGS - --page-token=PAGE_TOKEN - A token identifying a page of results the server should return. Default - is none. - --reconciling-only If specified, only displays quota preferences in unresolved states. Default is false. diff --git a/gcloud/alpha/recaptcha/keys/help b/gcloud/alpha/recaptcha/keys/help index 8de57abe3..9c1c2c674 100644 --- a/gcloud/alpha/recaptcha/keys/help +++ b/gcloud/alpha/recaptcha/keys/help @@ -30,6 +30,9 @@ COMMANDS list (ALPHA) List reCAPTCHA Keys. + list-ip-overrides + (ALPHA) List IP overrides for a key. + migrate (ALPHA) Migrate a key to reCAPTCHA Enterprise. diff --git a/gcloud/alpha/recaptcha/keys/list-ip-overrides b/gcloud/alpha/recaptcha/keys/list-ip-overrides new file mode 100644 index 000000000..e166cf4af --- /dev/null +++ b/gcloud/alpha/recaptcha/keys/list-ip-overrides @@ -0,0 +1,80 @@ +NAME + gcloud alpha recaptcha keys list-ip-overrides - list IP overrides for a key + +SYNOPSIS + gcloud alpha recaptcha keys list-ip-overrides KEY [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List IP overrides for a key. + +EXAMPLES + $ gcloud alpha recaptcha keys list-ip-overrides test-key + +POSITIONAL ARGUMENTS + Key resource - The reCAPTCHA key for which to list the IP overrides. 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 key 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. + + KEY + ID of the key or fully qualified identifier for the key. + + To set the key attribute: + ▸ provide the argument key on the command line. + +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 recaptchaenterprise/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/recaptcha-enterprise/ + +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 recaptcha keys list-ip-overrides + diff --git a/gcloud/alpha/spanner/instances/create b/gcloud/alpha/spanner/instances/create index 1b4c1250f..9cc283a95 100644 --- a/gcloud/alpha/spanner/instances/create +++ b/gcloud/alpha/spanner/instances/create @@ -3,8 +3,10 @@ NAME SYNOPSIS gcloud alpha spanner instances create INSTANCE --config=CONFIG - --description=DESCRIPTION [--async] [--edition=EDITION] - [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] + --description=DESCRIPTION [--async] + [--default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE] + [--edition=EDITION] [--expire-behavior=EXPIRE_BEHAVIOR] + [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS | --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET (--autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES | --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS)] [GCLOUD_WIDE_FLAG ...] @@ -37,6 +39,22 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE + The default backup schedule type that is used in the instance. + DEFAULT_BACKUP_SCHEDULE_TYPE must be one of: + + AUTOMATIC + A default backup schedule is created automatically when a new + database is created in an instance. You can edit or delete the + default backup schedule once it's created. The default backup + schedule creates a full backup every 24 hours. These full backups + are retained for 7 days. + DEFAULT_BACKUP_SCHEDULE_TYPE_UNSPECIFIED + Not specified. + NONE + No default backup schedule is created automatically when a new + database is created in an instance. + --edition=EDITION Cloud Spanner edition. EDITION must be one of: diff --git a/gcloud/alpha/spanner/instances/update b/gcloud/alpha/spanner/instances/update index aebfcf4d7..eedf82398 100644 --- a/gcloud/alpha/spanner/instances/update +++ b/gcloud/alpha/spanner/instances/update @@ -3,6 +3,7 @@ NAME SYNOPSIS gcloud alpha spanner instances update INSTANCE [--async] + [--default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE] [--description=DESCRIPTION] [--edition=EDITION] [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS @@ -31,6 +32,22 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE + The default backup schedule type that is used in the instance. + DEFAULT_BACKUP_SCHEDULE_TYPE must be one of: + + AUTOMATIC + A default backup schedule is created automatically when a new + database is created in an instance. You can edit or delete the + default backup schedule once it's created. The default backup + schedule creates a full backup every 24 hours. These full backups + are retained for 7 days. + DEFAULT_BACKUP_SCHEDULE_TYPE_UNSPECIFIED + Not specified. + NONE + No default backup schedule is created automatically when a new + database is created in an instance. + --description=DESCRIPTION Description of the instance. diff --git a/gcloud/alpha/sql/instances/create b/gcloud/alpha/sql/instances/create index a93b6c3c9..ead6833a6 100644 --- a/gcloud/alpha/sql/instances/create +++ b/gcloud/alpha/sql/instances/create @@ -456,6 +456,9 @@ FLAGS --server-ca-mode=SERVER_CA_MODE Set the server CA mode of the instance. SERVER_CA_MODE must be one of: + CUSTOMER_MANAGED_CAS_CA + Customer-managed CA hosted on Google Cloud's Certificate Authority + Service (CAS). GOOGLE_MANAGED_CAS_CA Google-managed regional CA part of root CA hierarchy hosted on Google Cloud's Certificate Authority Service (CAS). diff --git a/gcloud/alpha/sql/instances/switchover b/gcloud/alpha/sql/instances/switchover index c8d579eae..a1a3a68bb 100644 --- a/gcloud/alpha/sql/instances/switchover +++ b/gcloud/alpha/sql/instances/switchover @@ -24,9 +24,9 @@ FLAGS complete. --db-timeout=DB_TIMEOUT - (MySQL only) Cloud SQL instance operations timeout, which is the sum of - all database operations. Default value is 10 minutes and can be - modified to a maximum value of 24h. + (MySQL and PostgreSQL only) Cloud SQL instance operations timeout, + which is the sum of all database operations. Default value is 10 + minutes and can be modified to a maximum value of 24h. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/transfer/agents/delete b/gcloud/alpha/transfer/agents/delete index 0c5cfa8b5..22c088db8 100644 --- a/gcloud/alpha/transfer/agents/delete +++ b/gcloud/alpha/transfer/agents/delete @@ -1,19 +1,20 @@ NAME - gcloud alpha transfer agents delete - delete a Transfer Service transfer + gcloud alpha transfer agents delete - delete Transfer Service transfer agents SYNOPSIS - gcloud alpha transfer agents delete [--ids=[IDS,...] | --all | --uninstall] - [GCLOUD_WIDE_FLAG ...] + gcloud alpha transfer agents delete + [--container-manager=CONTAINER_MANAGER; default="docker"] + [--ids=[IDS,...] | --all | --uninstall] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete agents and remove agent resources from your machine. + (ALPHA) Delete Transfer Service agents from your machine. EXAMPLES If you plan to delete specific agents, you can list which agents are running on your machine by running: - $ docker container list --all \ + $ docker (or podman) container list --all \ --filter ancestor=gcr.io/cloud-ingest/tsop-agent Then run: @@ -21,6 +22,10 @@ EXAMPLES $ gcloud alpha transfer agents delete --ids=id1,id2,... FLAGS + --container-manager=CONTAINER_MANAGER; default="docker" + The container manager to use for running agents. CONTAINER_MANAGER must + be one of: docker, podman. + At most one of these can be specified: --ids=[IDS,...] @@ -31,9 +36,10 @@ FLAGS Delete all agents running on your machine. --uninstall - Fully uninstall the agent Docker image in addition to deleting the - agents. Uninstalling the Docker image will free up space, but you'll - need to reinstall it to run agents on this machine in the future. + Fully uninstall the agent container image in addition to deleting the + agents. Uninstalling the container image will free up space, but + you'll need to reinstall it to run agents on this machine in the + future. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/transfer/agents/help b/gcloud/alpha/transfer/agents/help index ca19f77bc..be7d69e05 100644 --- a/gcloud/alpha/transfer/agents/help +++ b/gcloud/alpha/transfer/agents/help @@ -19,7 +19,7 @@ COMMANDS COMMAND is one of the following: delete - (ALPHA) Delete a Transfer Service transfer agents. + (ALPHA) Delete Transfer Service transfer agents. install (ALPHA) Install Transfer Service agents. diff --git a/gcloud/artifacts/repositories/create b/gcloud/artifacts/repositories/create index d6f9718be..636634413 100644 --- a/gcloud/artifacts/repositories/create +++ b/gcloud/artifacts/repositories/create @@ -17,6 +17,7 @@ SYNOPSIS [--remote-username=REMOTE_USERNAME] [--remote-yum-repo=REMOTE_YUM_REPO] [--remote-yum-repo-path=REMOTE_YUM_REPO_PATH] [--upstream-policy-file=FILE] [--version-policy=VERSION_POLICY] + [--allow-vulnerability-scanning | --disable-vulnerability-scanning] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -214,6 +215,14 @@ OPTIONAL FLAGS snapshot (Maven only) The repository accepts snapshot versions only. + At most one of these can be specified: + + --allow-vulnerability-scanning + Allow vulnerability scanning on the repository. + + --disable-vulnerability-scanning + Disable vulnerability scanning on the repository. + 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/artifacts/repositories/update b/gcloud/artifacts/repositories/update index 9bb351e0b..285989bb8 100644 --- a/gcloud/artifacts/repositories/update +++ b/gcloud/artifacts/repositories/update @@ -9,6 +9,7 @@ SYNOPSIS [--remote-password-secret-version=REMOTE_PASSWORD_SECRET_VERSION] [--remote-username=REMOTE_USERNAME] [--update-labels=[KEY=VALUE,...]] [--upstream-policy-file=FILE] + [--allow-vulnerability-scanning | --disable-vulnerability-scanning] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -97,6 +98,14 @@ FLAGS "priority": 1 }, { "id": "test2", "repository": "projects/p2/locations/us-west2/repositories/repo2", "priority": 2 } ] + At most one of these can be specified: + + --allow-vulnerability-scanning + Allow vulnerability scanning on the repository. + + --disable-vulnerability-scanning + Disable vulnerability scanning on the repository. + At most one of these can be specified: --clear-labels diff --git a/gcloud/beta/colab-enterprise/executions/help b/gcloud/beta/colab-enterprise/executions/help deleted file mode 100644 index f9fe04b42..000000000 --- a/gcloud/beta/colab-enterprise/executions/help +++ /dev/null @@ -1,34 +0,0 @@ -NAME - gcloud beta colab-enterprise executions - manage Colab Enterprise notebook - execution jobs - -SYNOPSIS - gcloud beta colab-enterprise executions COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) For more information about executions, see - https://cloud.google.com/colab/docs/schedule-notebook-run. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - create - (BETA) Create an execution. - - delete - (BETA) Delete an execution. - - describe - (BETA) Describe an execution. - - list - (BETA) List your Colab Enterprise notebook execution jobs. - -NOTES - This command is currently in beta and might change without notice. - diff --git a/gcloud/beta/colab-enterprise/help b/gcloud/beta/colab-enterprise/help deleted file mode 100644 index 320e1ecba..000000000 --- a/gcloud/beta/colab-enterprise/help +++ /dev/null @@ -1,32 +0,0 @@ -NAME - gcloud beta colab-enterprise - manage Colab Enterprise resources - -SYNOPSIS - gcloud beta colab-enterprise GROUP [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) Manage Colab Enterprise resources. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -GROUPS - GROUP is one of the following: - - executions - (BETA) Manage Colab Enterprise notebook execution jobs. - - runtime-templates - (BETA) Manage Colab Enterprise runtime templates. - - runtimes - (BETA) Manage Colab Enterprise runtimes. - - schedules - (BETA) Manage Colab Enterprise notebook execution schedules. - -NOTES - This command is currently in beta and might change without notice. - diff --git a/gcloud/beta/colab-enterprise/runtime-templates/help b/gcloud/beta/colab-enterprise/runtime-templates/help deleted file mode 100644 index dc7399e33..000000000 --- a/gcloud/beta/colab-enterprise/runtime-templates/help +++ /dev/null @@ -1,50 +0,0 @@ -NAME - gcloud beta colab-enterprise runtime-templates - manage Colab Enterprise - runtime templates - -SYNOPSIS - gcloud beta colab-enterprise runtime-templates COMMAND - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) For more information about runtime templates, see - https://cloud.google.com/colab/docs/runtimes#runtime-templates - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - add-iam-policy-binding - (BETA) Add an IAM policy binding to a Colab Enterprise runtime - template. - - create - (BETA) Create a runtime template. - - delete - (BETA) Delete a runtime template. - - describe - (BETA) Describe a runtime template. - - get-iam-policy - (BETA) Get IAM policy for a Colab Enterprise runtime template. - - list - (BETA) List your runtime templates. - - remove-iam-policy-binding - (BETA) Remove an IAM policy binding from a Colab Enterprise runtime - template. - - set-iam-policy - (BETA) Set IAM policy for a Colab Enterprise runtime template as - defined in a JSON or YAML file. - -NOTES - This command is currently in beta and might change without notice. - diff --git a/gcloud/beta/colab-enterprise/runtimes/assign b/gcloud/beta/colab-enterprise/runtimes/assign deleted file mode 100644 index eefcbdb2d..000000000 --- a/gcloud/beta/colab-enterprise/runtimes/assign +++ /dev/null @@ -1,112 +0,0 @@ -NAME - gcloud beta colab-enterprise runtimes assign - assign a notebook runtime - -SYNOPSIS - gcloud beta colab-enterprise runtimes assign --display-name=DISPLAY_NAME - --runtime-template=RUNTIME_TEMPLATE [--async] - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--region=REGION] [--runtime-id=RUNTIME_ID] - [--runtime-user=RUNTIME_USER] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) (DEPRECATED) This command is deprecated. Please use gcloud beta - colab runtimes create instead. - - Assign a notebook runtime to run code from your notebook (IPYNB file). - -EXAMPLES - To create a runtime in region 'us-central1' with the display name - 'my-runtime' and template with id 'my-template', run: - - $ gcloud beta colab-enterprise runtimes assign \ - --region=us-central1 --display-name=my-runtime \ - --runtime-template=my-template - - To create a runtime for user 'USER@DOMAIN.COM', run: - - $ gcloud beta colab-enterprise runtimes assign \ - --runtime-user=USER@DOMAIN.COM --region=us-central1 \ - --display-name=my-runtime --runtime-template=my-template - -REQUIRED FLAGS - --display-name=DISPLAY_NAME - The display name of the runtime to create. - - Runtime template resource - Unique name of the runtime template to - configure the runtime with. This was optionally provided by setting - --runtime-template-id in the create runtime-template command, or was - system-generated if unspecified. 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 --runtime-template 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 region attribute: - ◆ provide the argument --runtime-template on the command line with a - fully specified name; - ◆ provide the argument --region on the command line; - ◆ set the property colab/region. - - This must be specified. - - --runtime-template=RUNTIME_TEMPLATE - ID of the runtime template or fully qualified identifier for the - runtime template. - - To set the name attribute: - ▸ provide the argument --runtime-template on the command line. - -OPTIONAL FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --description=DESCRIPTION - The description - - --labels=[KEY=VALUE,...] - Add labels to identify and group the runtime template. - - Region resource - Cloud region to create runtime. Please see - https://cloud.google.com/colab/docs/locations for a list of supported - regions. This represents a Cloud resource. (NOTE) Some attributes are not - given arguments in this group but can be set in other ways. - - To set the project attribute: - ◆ provide the argument --region on the command line with a fully - specified name; - ◆ set the property colab/region with a fully specified name; - ◆ provide the argument --project on the command line; - ◆ set the property core/project. - - --region=REGION - ID of the region or fully qualified identifier for the region. - - To set the region attribute: - ▸ provide the argument --region on the command line; - ▸ set the property colab/region. - - --runtime-id=RUNTIME_ID - The id of the runtime to create. If not specified, a random id will be - generated. - - --runtime-user=RUNTIME_USER - User email for the runtime owner. Runtimes can only be used by the - owner. If a user is not provided, the gcloud user will be assumed to be - the owner. The user cannot be a service account. - -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. - diff --git a/gcloud/beta/colab-enterprise/runtimes/help b/gcloud/beta/colab-enterprise/runtimes/help deleted file mode 100644 index 89700a13f..000000000 --- a/gcloud/beta/colab-enterprise/runtimes/help +++ /dev/null @@ -1,42 +0,0 @@ -NAME - gcloud beta colab-enterprise runtimes - manage Colab Enterprise runtimes - -SYNOPSIS - gcloud beta colab-enterprise runtimes COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) For more information about runtimes, see - https://cloud.google.com/colab/docs/runtimes#runtimes - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - assign - (BETA) (DEPRECATED) Assign a notebook runtime. - - create - (BETA) Create a notebook runtime. - - delete - (BETA) Delete a runtime. - - describe - (BETA) Describe a runtime. - - list - (BETA) List your project's runtimes. - - start - (BETA) Start a stopped runtime. - - upgrade - (BETA) Upgrade a runtime. - -NOTES - This command is currently in beta and might change without notice. - diff --git a/gcloud/beta/colab-enterprise/schedules/help b/gcloud/beta/colab-enterprise/schedules/help deleted file mode 100644 index 19995e1fb..000000000 --- a/gcloud/beta/colab-enterprise/schedules/help +++ /dev/null @@ -1,43 +0,0 @@ -NAME - gcloud beta colab-enterprise schedules - manage Colab Enterprise notebook - execution schedules - -SYNOPSIS - gcloud beta colab-enterprise schedules COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) For more information about schedules, see - https://cloud.google.com/colab/docs/schedule-notebook-run. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - create - (BETA) Create a schedule. - - delete - (BETA) Delete a schedule. - - describe - (BETA) Describe a schedule. - - list - (BETA) List your Colab Enterprise notebook execution schedules. - - pause - (BETA) Pause a schedule. - - resume - (BETA) Resume a schedule. - - update - (BETA) Update a schedule. - -NOTES - This command is currently in beta and might change without notice. - diff --git a/gcloud/beta/colab/executions/create b/gcloud/beta/colab/executions/create index f726a87a2..5ae5538a9 100644 --- a/gcloud/beta/colab/executions/create +++ b/gcloud/beta/colab/executions/create @@ -14,7 +14,7 @@ SYNOPSIS [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Creates a notebook execution to be used on a Colab Enterprise + (BETA) Create a notebook execution to be used on a Colab Enterprise runtime. EXAMPLES @@ -182,5 +182,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab executions create diff --git a/gcloud/beta/colab/executions/delete b/gcloud/beta/colab/executions/delete index 5d56dc6a9..e57ec1b3e 100644 --- a/gcloud/beta/colab/executions/delete +++ b/gcloud/beta/colab/executions/delete @@ -6,7 +6,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Deletes a Colab Enterprise notebook execution. + (BETA) Delete a Colab Enterprise notebook execution. EXAMPLES To delete an execution with id my-execution, in region us-central1, run: @@ -61,5 +61,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab executions delete diff --git a/gcloud/beta/colab/executions/describe b/gcloud/beta/colab/executions/describe index 9a076532a..00ce4dfd5 100644 --- a/gcloud/beta/colab/executions/describe +++ b/gcloud/beta/colab/executions/describe @@ -6,7 +6,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Describes a Colab Enterprise notebook execution. + (BETA) Describe a Colab Enterprise notebook execution. EXAMPLES To describe a notebook execution with id my-execution in region @@ -57,5 +57,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab executions describe diff --git a/gcloud/beta/colab/executions/help b/gcloud/beta/colab/executions/help index 6e033237b..c0ab4bb18 100644 --- a/gcloud/beta/colab/executions/help +++ b/gcloud/beta/colab/executions/help @@ -30,5 +30,8 @@ COMMANDS (BETA) List your Colab Enterprise notebook execution jobs. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab executions diff --git a/gcloud/beta/colab/executions/list b/gcloud/beta/colab/executions/list index b2f1fcc23..253573163 100644 --- a/gcloud/beta/colab/executions/list +++ b/gcloud/beta/colab/executions/list @@ -8,7 +8,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Lists your project's Colab Enterprise notebook executions in a given + (BETA) List your project's Colab Enterprise notebook executions in a given region. EXAMPLES @@ -76,5 +76,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab executions list diff --git a/gcloud/beta/colab/help b/gcloud/beta/colab/help index b688403e0..8df2c260b 100644 --- a/gcloud/beta/colab/help +++ b/gcloud/beta/colab/help @@ -28,5 +28,8 @@ GROUPS (BETA) Manage Colab Enterprise notebook execution schedules. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab diff --git a/gcloud/beta/colab/runtime-templates/add-iam-policy-binding b/gcloud/beta/colab/runtime-templates/add-iam-policy-binding index 9f9b4d992..0dd4eb546 100644 --- a/gcloud/beta/colab/runtime-templates/add-iam-policy-binding +++ b/gcloud/beta/colab/runtime-templates/add-iam-policy-binding @@ -8,7 +8,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Adds an IAM policy binding to a Colab Enterprise runtime template. + (BETA) Add an IAM policy binding to a Colab Enterprise runtime template. EXAMPLES To set someone@example.com to have the roles/aiplatform.notebookRuntimeUser @@ -85,5 +85,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab runtime-templates add-iam-policy-binding diff --git a/gcloud/beta/colab/runtime-templates/create b/gcloud/beta/colab/runtime-templates/create index a15792ce3..eea03276a 100644 --- a/gcloud/beta/colab/runtime-templates/create +++ b/gcloud/beta/colab/runtime-templates/create @@ -17,7 +17,7 @@ SYNOPSIS : --subnetwork-region=SUBNETWORK_REGION]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Creates a Colab Enterprise runtime template, a VM configuration for + (BETA) Create a Colab Enterprise runtime template, a VM configuration for your notebook runtimes. EXAMPLES @@ -222,5 +222,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab runtime-templates create diff --git a/gcloud/beta/colab/runtime-templates/delete b/gcloud/beta/colab/runtime-templates/delete index 89baf4e8f..bdeadb138 100644 --- a/gcloud/beta/colab/runtime-templates/delete +++ b/gcloud/beta/colab/runtime-templates/delete @@ -6,7 +6,7 @@ SYNOPSIS (RUNTIME_TEMPLATE : --region=REGION) [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Deletes a Colab Enterprise notebook runtime template. + (BETA) Delete a Colab Enterprise notebook runtime template. EXAMPLES To delete a runtime template with id 'my-runtime-template' in region @@ -64,5 +64,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab runtime-templates delete diff --git a/gcloud/beta/colab/runtime-templates/describe b/gcloud/beta/colab/runtime-templates/describe index 8601eec51..e045dc2b7 100644 --- a/gcloud/beta/colab/runtime-templates/describe +++ b/gcloud/beta/colab/runtime-templates/describe @@ -6,7 +6,7 @@ SYNOPSIS (RUNTIME_TEMPLATE : --region=REGION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Describes a Colab Enterprise notebook runtime template. + (BETA) Describe a Colab Enterprise notebook runtime template. EXAMPLES To describe a runtime template with id 'my-runtime-template' in region @@ -59,5 +59,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab runtime-templates describe diff --git a/gcloud/beta/colab/runtime-templates/get-iam-policy b/gcloud/beta/colab/runtime-templates/get-iam-policy index 6b38b0878..7a5704174 100644 --- a/gcloud/beta/colab/runtime-templates/get-iam-policy +++ b/gcloud/beta/colab/runtime-templates/get-iam-policy @@ -9,7 +9,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Gets the IAM policy for a Colab Enterprise runtime template. + (BETA) Get the IAM policy for a Colab Enterprise runtime template. EXAMPLES To get the IAM policy for a runtime template with id my-runtime-template in @@ -90,5 +90,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab runtime-templates get-iam-policy diff --git a/gcloud/beta/colab/runtime-templates/help b/gcloud/beta/colab/runtime-templates/help index 437eb0f52..e9055dd83 100644 --- a/gcloud/beta/colab/runtime-templates/help +++ b/gcloud/beta/colab/runtime-templates/help @@ -45,5 +45,8 @@ COMMANDS defined in a JSON or YAML file. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab runtime-templates diff --git a/gcloud/beta/colab/runtime-templates/list b/gcloud/beta/colab/runtime-templates/list index 59ea6080d..1950a55d5 100644 --- a/gcloud/beta/colab/runtime-templates/list +++ b/gcloud/beta/colab/runtime-templates/list @@ -7,8 +7,8 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Lists your project's Colab Enterprise notebook runtime templates in - a given region. + (BETA) List your project's Colab Enterprise notebook runtime templates in a + given region. EXAMPLES To list your runtime templates in region 'us-central1', run: @@ -77,5 +77,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab runtime-templates list diff --git a/gcloud/beta/colab/runtime-templates/remove-iam-policy-binding b/gcloud/beta/colab/runtime-templates/remove-iam-policy-binding index bdfb88567..d0cbfe13f 100644 --- a/gcloud/beta/colab/runtime-templates/remove-iam-policy-binding +++ b/gcloud/beta/colab/runtime-templates/remove-iam-policy-binding @@ -8,7 +8,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Removes an IAM policy binding from a Colab Enterprise runtime + (BETA) Remove an IAM policy binding from a Colab Enterprise runtime template. EXAMPLES @@ -87,5 +87,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab runtime-templates remove-iam-policy-binding diff --git a/gcloud/beta/colab/runtime-templates/set-iam-policy b/gcloud/beta/colab/runtime-templates/set-iam-policy index eebcc6f01..76f508122 100644 --- a/gcloud/beta/colab/runtime-templates/set-iam-policy +++ b/gcloud/beta/colab/runtime-templates/set-iam-policy @@ -7,7 +7,7 @@ SYNOPSIS (RUNTIME_TEMPLATE : --region=REGION) POLICY_FILE [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Sets the IAM policy for a Colab Enterprise runtime template as + (BETA) Set the IAM policy for a Colab Enterprise runtime template as defined in a JSON or YAML file. See https://cloud.google.com/iam/docs/managing-policies for details of the @@ -71,5 +71,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab runtime-templates set-iam-policy diff --git a/gcloud/beta/colab/runtimes/create b/gcloud/beta/colab/runtimes/create index 6856d24a9..04a205ce9 100644 --- a/gcloud/beta/colab/runtimes/create +++ b/gcloud/beta/colab/runtimes/create @@ -105,5 +105,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab runtimes create diff --git a/gcloud/beta/colab/runtimes/delete b/gcloud/beta/colab/runtimes/delete index 0e348a27e..c953ce7ff 100644 --- a/gcloud/beta/colab/runtimes/delete +++ b/gcloud/beta/colab/runtimes/delete @@ -6,7 +6,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Deletes a Colab Enterprise notebook runtime. + (BETA) Delete a Colab Enterprise notebook runtime. EXAMPLES To delete a runtime with id 'my-runtime' in region 'us-central1', run: @@ -60,5 +60,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab runtimes delete diff --git a/gcloud/beta/colab/runtimes/describe b/gcloud/beta/colab/runtimes/describe index df6646735..764815ad8 100644 --- a/gcloud/beta/colab/runtimes/describe +++ b/gcloud/beta/colab/runtimes/describe @@ -6,7 +6,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Describes a Colab Enterprise notebook runtime. + (BETA) Describe a Colab Enterprise notebook runtime. EXAMPLES To describe a runtime with id 'my-runtime' in region 'us-central1', run: @@ -55,5 +55,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab runtimes describe diff --git a/gcloud/beta/colab/runtimes/help b/gcloud/beta/colab/runtimes/help index 1b5771f62..9c690032a 100644 --- a/gcloud/beta/colab/runtimes/help +++ b/gcloud/beta/colab/runtimes/help @@ -38,5 +38,8 @@ COMMANDS (BETA) Upgrade a runtime. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab runtimes diff --git a/gcloud/beta/colab/runtimes/list b/gcloud/beta/colab/runtimes/list index 95db3f786..9c5c82a57 100644 --- a/gcloud/beta/colab/runtimes/list +++ b/gcloud/beta/colab/runtimes/list @@ -7,7 +7,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Lists your project's Colab Enterprise notebook runtimes in a given + (BETA) List your project's Colab Enterprise notebook runtimes in a given region. EXAMPLES @@ -76,5 +76,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab runtimes list diff --git a/gcloud/beta/colab/runtimes/start b/gcloud/beta/colab/runtimes/start index 48b0a7187..969696a85 100644 --- a/gcloud/beta/colab/runtimes/start +++ b/gcloud/beta/colab/runtimes/start @@ -6,7 +6,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Starts a stopped Colab Enterprise notebook runtime. + (BETA) Start a stopped Colab Enterprise notebook runtime. EXAMPLES To start a runtime with id 'my-runtime' in region 'us-central1', run: @@ -60,5 +60,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab runtimes start diff --git a/gcloud/beta/colab/runtimes/upgrade b/gcloud/beta/colab/runtimes/upgrade index 5de96dce2..79f888696 100644 --- a/gcloud/beta/colab/runtimes/upgrade +++ b/gcloud/beta/colab/runtimes/upgrade @@ -6,7 +6,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Upgrades a Colab Enterprise notebook runtime. + (BETA) Upgrade a Colab Enterprise notebook runtime. EXAMPLES To upgrade a runtime with id 'my-runtime' in region 'us-central1', run: @@ -60,5 +60,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab runtimes upgrade diff --git a/gcloud/beta/colab/schedules/create b/gcloud/beta/colab/schedules/create index aff4c3e07..78ffe690a 100644 --- a/gcloud/beta/colab/schedules/create +++ b/gcloud/beta/colab/schedules/create @@ -241,5 +241,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab schedules create diff --git a/gcloud/beta/colab/schedules/delete b/gcloud/beta/colab/schedules/delete index 8d2f4ae4f..5960e6fa4 100644 --- a/gcloud/beta/colab/schedules/delete +++ b/gcloud/beta/colab/schedules/delete @@ -59,5 +59,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab schedules delete diff --git a/gcloud/beta/colab/schedules/describe b/gcloud/beta/colab/schedules/describe index c53994a85..c87c658ab 100644 --- a/gcloud/beta/colab/schedules/describe +++ b/gcloud/beta/colab/schedules/describe @@ -55,5 +55,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab schedules describe diff --git a/gcloud/beta/colab/schedules/help b/gcloud/beta/colab/schedules/help index 25e3484cf..c3cd2bd54 100644 --- a/gcloud/beta/colab/schedules/help +++ b/gcloud/beta/colab/schedules/help @@ -39,5 +39,8 @@ COMMANDS (BETA) Update a schedule. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab schedules diff --git a/gcloud/beta/colab/schedules/list b/gcloud/beta/colab/schedules/list index 9ab954b3f..e51a2d665 100644 --- a/gcloud/beta/colab/schedules/list +++ b/gcloud/beta/colab/schedules/list @@ -76,5 +76,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab schedules list diff --git a/gcloud/beta/colab/schedules/pause b/gcloud/beta/colab/schedules/pause index 74d04cde9..280c8103c 100644 --- a/gcloud/beta/colab/schedules/pause +++ b/gcloud/beta/colab/schedules/pause @@ -54,5 +54,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab schedules pause diff --git a/gcloud/beta/colab/schedules/resume b/gcloud/beta/colab/schedules/resume index 8133f2a53..f61a071d9 100644 --- a/gcloud/beta/colab/schedules/resume +++ b/gcloud/beta/colab/schedules/resume @@ -61,5 +61,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab schedules resume diff --git a/gcloud/beta/colab/schedules/update b/gcloud/beta/colab/schedules/update index 00096e54f..411f1c27e 100644 --- a/gcloud/beta/colab/schedules/update +++ b/gcloud/beta/colab/schedules/update @@ -106,5 +106,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud colab schedules update diff --git a/gcloud/beta/compute/commitments/create b/gcloud/beta/compute/commitments/create index 904ee5ebe..25ed9ae39 100644 --- a/gcloud/beta/compute/commitments/create +++ b/gcloud/beta/compute/commitments/create @@ -109,10 +109,10 @@ OPTIONAL FLAGS accelerator-optimized-a3, accelerator-optimized-a3-mega, compute-optimized, compute-optimized-c2d, compute-optimized-c3, compute-optimized-c3d, compute-optimized-h3, general-purpose, - general-purpose-c4, general-purpose-e2, general-purpose-n2, - general-purpose-n2d, general-purpose-n4, general-purpose-t2d, - graphics-optimized, memory-optimized, memory-optimized-m3, - storage-optimized-z3. + general-purpose-c4, general-purpose-c4a, general-purpose-e2, + general-purpose-n2, general-purpose-n2d, general-purpose-n4, + general-purpose-t2d, graphics-optimized, memory-optimized, + memory-optimized-m3, storage-optimized-z3. Manage the reservations to be created with the commitment. diff --git a/gcloud/beta/compute/help b/gcloud/beta/compute/help index c13bf15f0..43fcab9ce 100644 --- a/gcloud/beta/compute/help +++ b/gcloud/beta/compute/help @@ -111,6 +111,9 @@ GROUPS network-firewall-policies (BETA) Manage Compute Engine network firewall policies. + network-profiles + (BETA) Read Compute Engine network profiles. + networks (BETA) List, create, and delete Compute Engine networks. diff --git a/gcloud/beta/compute/instance-templates/create b/gcloud/beta/compute/instance-templates/create index f253c05d5..bf9e7d32c 100644 --- a/gcloud/beta/compute/instance-templates/create +++ b/gcloud/beta/compute/instance-templates/create @@ -1125,7 +1125,7 @@ FLAGS practice to use --image-family when the latest version of an image is needed. - By default, debian-11 is assumed for this flag. + By default, debian-12 is assumed for this flag. Sole Tenancy. diff --git a/gcloud/beta/compute/instance-templates/create-with-container b/gcloud/beta/compute/instance-templates/create-with-container index 612139a30..860af1043 100644 --- a/gcloud/beta/compute/instance-templates/create-with-container +++ b/gcloud/beta/compute/instance-templates/create-with-container @@ -859,7 +859,7 @@ FLAGS practice to use --image-family when the latest version of an image is needed. - By default, debian-11 is assumed for this flag. + By default, debian-12 is assumed for this flag. Specifies the reservation for instances created from this template. diff --git a/gcloud/beta/compute/instances/bulk/create b/gcloud/beta/compute/instances/bulk/create index c0d23a87b..93e9fb111 100644 --- a/gcloud/beta/compute/instances/bulk/create +++ b/gcloud/beta/compute/instances/bulk/create @@ -993,7 +993,7 @@ OPTIONAL FLAGS practice to use --image-family when the latest version of an image is needed. - By default, debian-11 is assumed for this flag. + By default, debian-12 is assumed for this flag. --source-snapshot=SOURCE_SNAPSHOT The name of the source disk snapshot that the instance boot disk will diff --git a/gcloud/beta/compute/instances/create b/gcloud/beta/compute/instances/create index cd3c524f8..3719b30fc 100644 --- a/gcloud/beta/compute/instances/create +++ b/gcloud/beta/compute/instances/create @@ -1220,7 +1220,7 @@ FLAGS practice to use --image-family when the latest version of an image is needed. - By default, debian-11 is assumed for this flag. + By default, debian-12 is assumed for this flag. --source-snapshot=SOURCE_SNAPSHOT The name of the source disk snapshot that the instance boot disk will diff --git a/gcloud/beta/compute/instances/create-with-container b/gcloud/beta/compute/instances/create-with-container index a249ef6c0..d1fc9bd5e 100644 --- a/gcloud/beta/compute/instances/create-with-container +++ b/gcloud/beta/compute/instances/create-with-container @@ -1040,7 +1040,7 @@ FLAGS practice to use --image-family when the latest version of an image is needed. - By default, debian-11 is assumed for this flag. + By default, debian-12 is assumed for this flag. At most one of these can be specified: diff --git a/gcloud/beta/compute/network-profiles/describe b/gcloud/beta/compute/network-profiles/describe new file mode 100644 index 000000000..b4c7110be --- /dev/null +++ b/gcloud/beta/compute/network-profiles/describe @@ -0,0 +1,52 @@ +NAME + gcloud beta compute network-profiles describe - describe a network profile + +SYNOPSIS + gcloud beta compute network-profiles describe NETWORK_PROFILE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a network profile. + +EXAMPLES + To retrieve a single network profile and print its properties, run the + following command: $ gcloud beta compute network-profiles describe my-network-profile + +POSITIONAL ARGUMENTS + Network profile resource - Name of the network profile you want to + inspect. 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 network_profile on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + NETWORK_PROFILE + ID of the network_profile or fully qualified identifier for the + network_profile. + + To set the network_profile attribute: + ▸ provide the argument network_profile 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 compute/beta API. The full documentation for this API + can be found at: https://cloud.google.com/compute/ + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute network-profiles describe + diff --git a/gcloud/beta/compute/network-profiles/help b/gcloud/beta/compute/network-profiles/help new file mode 100644 index 000000000..131433cb0 --- /dev/null +++ b/gcloud/beta/compute/network-profiles/help @@ -0,0 +1,29 @@ +NAME + gcloud beta compute network-profiles - read Compute Engine network profiles + +SYNOPSIS + gcloud beta compute network-profiles COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Read Compute Engine network profiles. + +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 a network profile. + + list + (BETA) List network profiles. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute network-profiles + diff --git a/gcloud/beta/compute/network-profiles/list b/gcloud/beta/compute/network-profiles/list new file mode 100644 index 000000000..319e75ad3 --- /dev/null +++ b/gcloud/beta/compute/network-profiles/list @@ -0,0 +1,66 @@ +NAME + gcloud beta compute network-profiles list - list network profiles + +SYNOPSIS + gcloud beta compute network-profiles list [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List network profiles. + +EXAMPLES + The following command lists all network profiles: + + $ gcloud beta compute network-profiles list + +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 compute/beta API. The full documentation for this API + can be found at: https://cloud.google.com/compute/ + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute network-profiles list + diff --git a/gcloud/beta/compute/networks/create b/gcloud/beta/compute/networks/create index 8b7bd149e..45c8b8f73 100644 --- a/gcloud/beta/compute/networks/create +++ b/gcloud/beta/compute/networks/create @@ -7,7 +7,8 @@ SYNOPSIS [--description=DESCRIPTION] [--[no-]enable-ula-internal-ipv6] [--internal-ipv6-range=INTERNAL_IPV6_RANGE] [--mtu=MTU] [--network-firewall-policy-enforcement-order=NETWORK_FIREWALL_POLICY_ENFORCEMENT_ORDER] - [--range=RANGE] [--subnet-mode=MODE] + [--network-profile=NETWORK_PROFILE] [--range=RANGE] + [--subnet-mode=MODE] [--bgp-best-path-selection-mode=BGP_BEST_PATH_SELECTION_MODE --[no-]bgp-bps-always-compare-med --bgp-bps-inter-region-cost=BGP_BPS_INTER_REGION_COST] @@ -87,6 +88,9 @@ FLAGS BEFORE_CLASSIC_FIREWALL Network Firewall Policy is enforced before classic firewall. + --network-profile=NETWORK_PROFILE + The network profile to apply to this network. + --range=RANGE Specifies the IPv4 address range of legacy mode networks. The range must be specified in CIDR format: diff --git a/gcloud/beta/compute/os-config/policy-orchestrators/create b/gcloud/beta/compute/os-config/policy-orchestrators/create index b3c3fbb4f..b6b9f9069 100644 --- a/gcloud/beta/compute/os-config/policy-orchestrators/create +++ b/gcloud/beta/compute/os-config/policy-orchestrators/create @@ -6,6 +6,8 @@ SYNOPSIS gcloud beta compute os-config policy-orchestrators create (POLICY_ORCHESTRATOR : --folder=FOLDER --organization=ORGANIZATION) --policy-type=POLICY_TYPE [--action=ACTION; default="upsert"] [--async] + [--include-folders=INCLUDE_FOLDERS] + [--include-locations=INCLUDE_LOCATIONS] [--include-projects=INCLUDE_PROJECTS] [--policy-file=POLICY_FILE] [--policy-id=POLICY_ID] [--state=STATE; default="ACTIVE"] [GCLOUD_WIDE_FLAG ...] @@ -94,8 +96,16 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --include-folders=INCLUDE_FOLDERS + Applies policy to selected folders. Comma-separated list of folder + numbers. Can beused together with --include-projects. + + --include-locations=INCLUDE_LOCATIONS + Applies policy to selected locations, e.g. us-central1-a. + --include-projects=INCLUDE_PROJECTS - Applies policy to selected projects only. + Applies policy to selected projects. Comma-separated list of project + numbers. Can be used together with --include-folders. --policy-file=POLICY_FILE Absolute path to the OS policy assignment file on your local client. diff --git a/gcloud/beta/compute/os-config/policy-orchestrators/update b/gcloud/beta/compute/os-config/policy-orchestrators/update index 86ff444d1..fb6f438b1 100644 --- a/gcloud/beta/compute/os-config/policy-orchestrators/update +++ b/gcloud/beta/compute/os-config/policy-orchestrators/update @@ -7,6 +7,8 @@ SYNOPSIS (POLICY_ORCHESTRATOR : --folder=FOLDER --organization=ORGANIZATION) [--action=ACTION] [--async] [--policy-file=POLICY_FILE] [--policy-id=POLICY_ID] [--state=STATE] + [--clear-folders | --include-folders=INCLUDE_FOLDERS] + [--clear-locations | --include-locations=INCLUDE_LOCATIONS] [--clear-projects | --include-projects=INCLUDE_PROJECTS] [GCLOUD_WIDE_FLAG ...] @@ -104,8 +106,32 @@ FLAGS stopped Updates the policy orchestrator to STOPPED state. - Projects to include in the policy orchestrator. If include-projects is - set, clear-projects must not be set. + Folders to include in the policy orchestrator. Comma-separated list of + folder numbers. If --include-folders is set, --clear-folders must not be + set. + + At most one of these can be specified: + + --clear-folders + Clears included folders from policy orchestrator selectors. + + --include-folders=INCLUDE_FOLDERS + Applies policy to selected folders only. + + Locations to include in the policy orchestrator, e.g. us-central1-a. If + include-locations is set, clear-locations must not be set. + + At most one of these can be specified: + + --clear-locations + Clears included locations from policy orchestrator selectors. + + --include-locations=INCLUDE_LOCATIONS + Applies policy to selected locations only. + + Projects to include in the policy orchestrator. Comma separated list of + project numbers. If include-projects is set, clear-projects must not be + set. At most one of these can be specified: diff --git a/gcloud/beta/config/get b/gcloud/beta/config/get index 750d7584a..de581aa87 100644 --- a/gcloud/beta/config/get +++ b/gcloud/beta/config/get @@ -1028,6 +1028,12 @@ AVAILABLE PROPERTIES When a region is required but not provided by a flag, the command will fall back to this value, if set. + lustre + location + Default location to use when working with Cloud Lustre resources. + When a location value is required but not provided, the command + will fall back to this value, if set. + media_asset location Default location to use when working with Cloud Media Asset diff --git a/gcloud/beta/config/help b/gcloud/beta/config/help index 5214ef9cf..c31c6fb22 100644 --- a/gcloud/beta/config/help +++ b/gcloud/beta/config/help @@ -1060,6 +1060,12 @@ AVAILABLE PROPERTIES When a region is required but not provided by a flag, the command will fall back to this value, if set. + lustre + location + Default location to use when working with Cloud Lustre resources. + When a location value is required but not provided, the command + will fall back to this value, if set. + media_asset location Default location to use when working with Cloud Media Asset diff --git a/gcloud/beta/config/list b/gcloud/beta/config/list index 52eeba4b5..3fa08b1d5 100644 --- a/gcloud/beta/config/list +++ b/gcloud/beta/config/list @@ -1072,6 +1072,12 @@ AVAILABLE PROPERTIES When a region is required but not provided by a flag, the command will fall back to this value, if set. + lustre + location + Default location to use when working with Cloud Lustre resources. + When a location value is required but not provided, the command + will fall back to this value, if set. + media_asset location Default location to use when working with Cloud Media Asset diff --git a/gcloud/beta/config/set b/gcloud/beta/config/set index d00c3d6a8..3d7bb605a 100644 --- a/gcloud/beta/config/set +++ b/gcloud/beta/config/set @@ -1075,6 +1075,12 @@ AVAILABLE PROPERTIES When a region is required but not provided by a flag, the command will fall back to this value, if set. + lustre + location + Default location to use when working with Cloud Lustre resources. + When a location value is required but not provided, the command + will fall back to this value, if set. + media_asset location Default location to use when working with Cloud Media Asset diff --git a/gcloud/beta/config/unset b/gcloud/beta/config/unset index 3578e6076..ea3c142a4 100644 --- a/gcloud/beta/config/unset +++ b/gcloud/beta/config/unset @@ -1036,6 +1036,12 @@ AVAILABLE PROPERTIES When a region is required but not provided by a flag, the command will fall back to this value, if set. + lustre + location + Default location to use when working with Cloud Lustre resources. + When a location value is required but not provided, the command + will fall back to this value, if set. + media_asset location Default location to use when working with Cloud Media Asset diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index 018bb91dd..a70476184 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -48,10 +48,12 @@ SYNOPSIS [--enable-service-externalips] [--enable-shielded-nodes] [--enable-stackdriver-kubernetes] [--enable-vertical-pod-autoscaling] [--fleet-project=PROJECT_ID_OR_NUMBER] [--gateway-api=GATEWAY_API] - [--identity-provider=IDENTITY_PROVIDER] [--image-type=IMAGE_TYPE] + [--hpa-profile=HPA_PROFILE] [--identity-provider=IDENTITY_PROVIDER] + [--image-type=IMAGE_TYPE] [--in-transit-encryption=IN_TRANSIT_ENCRYPTION] [--ipv6-access-type=IPV6_ACCESS_TYPE] [--issue-client-certificate] [--istio-config=[auth=MTLS_PERMISSIVE,...]] [--labels=[KEY=VALUE,...]] + [--local-ssd-encryption-mode=LOCAL_SSD_ENCRYPTION_MODE] [--logging=[COMPONENT,...]] [--logging-variant=LOGGING_VARIANT] [--machine-type=MACHINE_TYPE, -m MACHINE_TYPE] [--max-nodes-per-pool=MAX_NODES_PER_POOL] @@ -740,6 +742,10 @@ FLAGS definitions from the standard OSS Gateway API release channel will be installed. + --hpa-profile=HPA_PROFILE + Setting Horizontal Pod Autoscaler behavior, which is none by default. + HPA_PROFILE must be one of: none, performance. + --identity-provider=IDENTITY_PROVIDER Enable 3P identity provider on the cluster. @@ -798,6 +804,11 @@ FLAGS $ gcloud beta container clusters create example-cluster \ --labels=label_a=value1,label_b=,label_c=value3 + --local-ssd-encryption-mode=LOCAL_SSD_ENCRYPTION_MODE + Encryption mode for Local SSDs on the cluster. + LOCAL_SSD_ENCRYPTION_MODE must be one of: STANDARD_ENCRYPTION, + EPHEMERAL_KEY_ENCRYPTION. + --logging=[COMPONENT,...] Set the components that have logging enabled. Valid component values are: SYSTEM, WORKLOAD, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, NONE diff --git a/gcloud/beta/container/clusters/create-auto b/gcloud/beta/container/clusters/create-auto index 67d76e2f6..2ac6c2162 100644 --- a/gcloud/beta/container/clusters/create-auto +++ b/gcloud/beta/container/clusters/create-auto @@ -22,13 +22,14 @@ SYNOPSIS [--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] [--labels=[KEY=VALUE,...]] - [--logging=[COMPONENT,...]] [--monitoring=[COMPONENT,...]] - [--network=NETWORK] [--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] [--workload-policies=WORKLOAD_POLICIES] + [--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] [--security-posture=SECURITY_POSTURE] + [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] + [--subnetwork=SUBNETWORK] [--tier=TIER] + [--workload-policies=WORKLOAD_POLICIES] [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN | --disable-additive-vpc-scope] @@ -300,6 +301,10 @@ FLAGS Example: $ gcloud beta container clusters create-auto \ --fleet-project=my-project + --hpa-profile=HPA_PROFILE + Setting Horizontal Pod Autoscaler behavior, which is none by default. + HPA_PROFILE must be one of: none, performance. + --labels=[KEY=VALUE,...] Labels to apply to the Google Cloud resources in use by the Kubernetes Engine cluster. These are unrelated to Kubernetes labels. diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index d23c1bdca..ef2da6f4a 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud beta container clusters update NAME - (--autoprovisioning-enable-insecure-kubelet-readonly-port + (--autoprovisioning-cgroup-mode=AUTOPROVISIONING_CGROUP_MODE + | --autoprovisioning-enable-insecure-kubelet-readonly-port | --autoprovisioning-network-tags=[TAGS,...] | --autoprovisioning-resource-manager-tags=[KEY=VALUE,...] | --autoscaling-profile=AUTOSCALING_PROFILE | --clear-fleet-project @@ -28,7 +29,8 @@ SYNOPSIS | --enable-service-externalips | --enable-shielded-nodes | --enable-stackdriver-kubernetes | --enable-vertical-pod-autoscaling | --fleet-project=PROJECT_ID_OR_NUMBER | --gateway-api=GATEWAY_API - | --generate-password | --identity-provider=IDENTITY_PROVIDER + | --generate-password | --hpa-profile=HPA_PROFILE + | --identity-provider=IDENTITY_PROVIDER | --in-transit-encryption=IN_TRANSIT_ENCRYPTION | --logging-variant=LOGGING_VARIANT | --maintenance-window=START_TIME | --network-performance-configs=[PROPERTY1=VALUE1,...] @@ -129,6 +131,32 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS Exactly one of these must be specified: + --autoprovisioning-cgroup-mode=AUTOPROVISIONING_CGROUP_MODE + Sets the cgroup mode for auto-provisioned nodes. + + Updating this flag triggers an update using surge upgrades of all + existing auto-provisioned nodes to apply the new value of cgroup + mode. + + For an Autopilot cluster, the specified cgroup mode will be set on + all existing and new nodes in the cluster. For a Standard cluster, + the specified cgroup mode will be set on all existing and new + auto-provisioned node pools in the cluster. + + If not set, GKE uses cgroupv2 for new nodes when the cluster was + created running 1.26 or later, and cgroupv1 for clusters created + running 1.25 or earlier. To check your initial cluster version, run + gcloud container clusters describe [NAME] + --format="value(initialClusterVersion)" + + For clusters created running version 1.26 or later, you can't set the + cgroup mode to v1. + + To learn more, see: + https://cloud.google.com/kubernetes-engine/docs/how-to/migrate-cgroupv2. + + AUTOPROVISIONING_CGROUP_MODE must be one of: default, v1, v2. + --autoprovisioning-enable-insecure-kubelet-readonly-port Enables the Kubelet's insecure read only port for Autoprovisioned Node Pools. @@ -479,6 +507,10 @@ REQUIRED FLAGS Ask the server to generate a secure password and use that as the basic auth password, keeping the existing username. + --hpa-profile=HPA_PROFILE + Setting Horizontal Pod Autoscaler behavior, which is none by default. + HPA_PROFILE must be one of: none, performance. + --identity-provider=IDENTITY_PROVIDER Enable 3P identity provider on the cluster. diff --git a/gcloud/beta/container/node-pools/create b/gcloud/beta/container/node-pools/create index 718eb4b17..9e3e4351c 100644 --- a/gcloud/beta/container/node-pools/create +++ b/gcloud/beta/container/node-pools/create @@ -25,6 +25,7 @@ SYNOPSIS [--enable-nested-virtualization] [--enable-private-nodes] [--enable-queued-provisioning] [--enable-surge-upgrade] [--image-type=IMAGE_TYPE] [--labels=[KEY=VALUE,...]] + [--local-ssd-encryption-mode=LOCAL_SSD_ENCRYPTION_MODE] [--logging-variant=LOGGING_VARIANT] [--machine-type=MACHINE_TYPE, -m MACHINE_TYPE] [--max-pods-per-node=MAX_PODS_PER_NODE] @@ -316,6 +317,11 @@ FLAGS $ gcloud beta container node-pools create node-pool-1 \ --cluster=example-cluster --labels=label1=value1,label2=value2 + --local-ssd-encryption-mode=LOCAL_SSD_ENCRYPTION_MODE + Encryption mode for Local SSDs on the node pool. + LOCAL_SSD_ENCRYPTION_MODE must be one of: STANDARD_ENCRYPTION, + EPHEMERAL_KEY_ENCRYPTION. + --logging-variant=LOGGING_VARIANT Specifies the logging variant that will be deployed on all the nodes in the node pool. If the node pool doesn't specify a logging variant, then diff --git a/gcloud/beta/container/vmware/admin-clusters/update b/gcloud/beta/container/vmware/admin-clusters/update index 7a68c6e52..f528420a3 100644 --- a/gcloud/beta/container/vmware/admin-clusters/update +++ b/gcloud/beta/container/vmware/admin-clusters/update @@ -6,7 +6,7 @@ SYNOPSIS gcloud beta container vmware admin-clusters update (ADMIN_CLUSTER : --location=LOCATION) [--async] [--required-platform-version=REQUIRED_PLATFORM_VERSION] - [GCLOUD_WIDE_FLAG ...] + [--version=VERSION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Update an Anthos on VMware admin cluster. @@ -61,6 +61,9 @@ FLAGS version will be updated to the required version. If it is not installed in the platform, download the required version bundle. + --version=VERSION + Anthos Cluster on VMware version for the user cluster resource + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/eventarc/pipelines/create b/gcloud/beta/eventarc/pipelines/create index 8d6bafeb0..5fa3c9029 100644 --- a/gcloud/beta/eventarc/pipelines/create +++ b/gcloud/beta/eventarc/pipelines/create @@ -3,18 +3,18 @@ NAME SYNOPSIS gcloud beta eventarc pipelines create (PIPELINE : --location=LOCATION) - --destinations=http_endpoint_uri=URI, - http_endpoint_message_binding_template=HTTP_ENDPOINT_MESSAGE_BINDING_TEMPLATE, - workflow=WORKFLOW,message_bus=MESSAGE_BUS,pubsub_topic=PUBSUB_TOPIC, - project=PROJECT,location=LOCATION, - network_attachment=NETWORK_ATTACHMENT, - google_oidc_authentication_service_account=GOOGLE_OIDC_AUTHENTICATION_SERVICE_ACCOUNT, - google_oidc_authentication_audience=GOOGLE_OIDC_AUTHENTICATION_AUDIENCE, - oauth_token_authentication_service_account=OAUTH_TOKEN_AUTHENTICATION_SERVICE_ACCOUNT, - oauth_token_authentication_scope=OAUTH_TOKEN_AUTHENTICATION_SCOPE, - output_payload_format_json=OUTPUT_PAYLOAD_FORMAT_JSON, - output_payload_format_avro_schema_definition=OUTPUT_PAYLOAD_FORMAT_AVRO_SCHEMA_DEFINITION, - output_payload_format_protobuf_schema_definition=OUTPUT_PAYLOAD_FORMAT_PROTOBUF_SCHEMA_DEFINITION|[...] + --destinations=[http_endpoint_uri=URI], + [http_endpoint_message_binding_template=HTTP_ENDPOINT_MESSAGE_BINDING_TEMPLATE], + [workflow=WORKFLOW],[message_bus=MESSAGE_BUS], + [pubsub_topic=PUBSUB_TOPIC],[project=PROJECT],[location=LOCATION], + [network_attachment=NETWORK_ATTACHMENT], + [google_oidc_authentication_service_account=GOOGLE_OIDC_AUTHENTICATION_SERVICE_ACCOUNT], + [google_oidc_authentication_audience=GOOGLE_OIDC_AUTHENTICATION_AUDIENCE], + [oauth_token_authentication_service_account=OAUTH_TOKEN_AUTHENTICATION_SERVICE_ACCOUNT], + [oauth_token_authentication_scope=OAUTH_TOKEN_AUTHENTICATION_SCOPE], + [output_payload_format_json=OUTPUT_PAYLOAD_FORMAT_JSON], + [output_payload_format_avro_schema_definition=OUTPUT_PAYLOAD_FORMAT_AVRO_SCHEMA_DEFINITION], + [output_payload_format_protobuf_schema_definition=OUTPUT_PAYLOAD_FORMAT_PROTOBUF_SCHEMA_DEFINITION]|[...] [--async] [--crypto-key=CRYPTO_KEY] [--logging-config=LOGGING_CONFIG] [--mediations=[transformation_template=TRANSFORMATION_TEMPLATE|...]] [--input-payload-format-avro-schema-definition=INPUT_PAYLOAD_FORMAT_AVRO_SCHEMA_DEFINITION | --input-payload-format-json=INPUT_PAYLOAD_FORMAT_JSON | --input-payload-format-protobuf-schema-definition=INPUT_PAYLOAD_FORMAT_PROTOBUF_SCHEMA_DEFINITION] @@ -246,7 +246,7 @@ POSITIONAL ARGUMENTS ▸ set the property eventarc/location. REQUIRED FLAGS - --destinations=http_endpoint_uri=URI,http_endpoint_message_binding_template=HTTP_ENDPOINT_MESSAGE_BINDING_TEMPLATE,workflow=WORKFLOW,message_bus=MESSAGE_BUS,pubsub_topic=PUBSUB_TOPIC,project=PROJECT,location=LOCATION,network_attachment=NETWORK_ATTACHMENT,google_oidc_authentication_service_account=GOOGLE_OIDC_AUTHENTICATION_SERVICE_ACCOUNT,google_oidc_authentication_audience=GOOGLE_OIDC_AUTHENTICATION_AUDIENCE,oauth_token_authentication_service_account=OAUTH_TOKEN_AUTHENTICATION_SERVICE_ACCOUNT,oauth_token_authentication_scope=OAUTH_TOKEN_AUTHENTICATION_SCOPE,output_payload_format_json=OUTPUT_PAYLOAD_FORMAT_JSON,output_payload_format_avro_schema_definition=OUTPUT_PAYLOAD_FORMAT_AVRO_SCHEMA_DEFINITION,output_payload_format_protobuf_schema_definition=OUTPUT_PAYLOAD_FORMAT_PROTOBUF_SCHEMA_DEFINITION|[...] + --destinations=[http_endpoint_uri=URI],[http_endpoint_message_binding_template=HTTP_ENDPOINT_MESSAGE_BINDING_TEMPLATE],[workflow=WORKFLOW],[message_bus=MESSAGE_BUS],[pubsub_topic=PUBSUB_TOPIC],[project=PROJECT],[location=LOCATION],[network_attachment=NETWORK_ATTACHMENT],[google_oidc_authentication_service_account=GOOGLE_OIDC_AUTHENTICATION_SERVICE_ACCOUNT],[google_oidc_authentication_audience=GOOGLE_OIDC_AUTHENTICATION_AUDIENCE],[oauth_token_authentication_service_account=OAUTH_TOKEN_AUTHENTICATION_SERVICE_ACCOUNT],[oauth_token_authentication_scope=OAUTH_TOKEN_AUTHENTICATION_SCOPE],[output_payload_format_json=OUTPUT_PAYLOAD_FORMAT_JSON],[output_payload_format_avro_schema_definition=OUTPUT_PAYLOAD_FORMAT_AVRO_SCHEMA_DEFINITION],[output_payload_format_protobuf_schema_definition=OUTPUT_PAYLOAD_FORMAT_PROTOBUF_SCHEMA_DEFINITION]|[...] The pipeline's destinations. This flag can be repeated to add more destinations to the list. Currently, only one destination is supported per pipeline. diff --git a/gcloud/beta/eventarc/pipelines/update b/gcloud/beta/eventarc/pipelines/update index fe6683b03..b74d9b676 100644 --- a/gcloud/beta/eventarc/pipelines/update +++ b/gcloud/beta/eventarc/pipelines/update @@ -4,18 +4,18 @@ NAME SYNOPSIS gcloud beta eventarc pipelines update (PIPELINE : --location=LOCATION) [--async] - [--destinations=http_endpoint_uri=URI, - http_endpoint_message_binding_template=HTTP_ENDPOINT_MESSAGE_BINDING_TEMPLATE, - workflow=WORKFLOW,message_bus=MESSAGE_BUS,pubsub_topic=PUBSUB_TOPIC, - project=PROJECT,location=LOCATION, - network_attachment=NETWORK_ATTACHMENT, - google_oidc_authentication_service_account=GOOGLE_OIDC_AUTHENTICATION_SERVICE_ACCOUNT, - google_oidc_authentication_audience=GOOGLE_OIDC_AUTHENTICATION_AUDIENCE, - oauth_token_authentication_service_account=OAUTH_TOKEN_AUTHENTICATION_SERVICE_ACCOUNT, - oauth_token_authentication_scope=OAUTH_TOKEN_AUTHENTICATION_SCOPE, - output_payload_format_json=OUTPUT_PAYLOAD_FORMAT_JSON, - output_payload_format_avro_schema_definition=OUTPUT_PAYLOAD_FORMAT_AVRO_SCHEMA_DEFINITION, - output_payload_format_protobuf_schema_definition=OUTPUT_PAYLOAD_FORMAT_PROTOBUF_SCHEMA_DEFINITION|[...]] + [--destinations=[http_endpoint_uri=URI], + [http_endpoint_message_binding_template=HTTP_ENDPOINT_MESSAGE_BINDING_TEMPLATE], + [workflow=WORKFLOW],[message_bus=MESSAGE_BUS], + [pubsub_topic=PUBSUB_TOPIC],[project=PROJECT],[location=LOCATION], + [network_attachment=NETWORK_ATTACHMENT], + [google_oidc_authentication_service_account=GOOGLE_OIDC_AUTHENTICATION_SERVICE_ACCOUNT], + [google_oidc_authentication_audience=GOOGLE_OIDC_AUTHENTICATION_AUDIENCE], + [oauth_token_authentication_service_account=OAUTH_TOKEN_AUTHENTICATION_SERVICE_ACCOUNT], + [oauth_token_authentication_scope=OAUTH_TOKEN_AUTHENTICATION_SCOPE], + [output_payload_format_json=OUTPUT_PAYLOAD_FORMAT_JSON], + [output_payload_format_avro_schema_definition=OUTPUT_PAYLOAD_FORMAT_AVRO_SCHEMA_DEFINITION], + [output_payload_format_protobuf_schema_definition=OUTPUT_PAYLOAD_FORMAT_PROTOBUF_SCHEMA_DEFINITION]|[...]] [--logging-config=LOGGING_CONFIG] [--mediations=[transformation_template=TRANSFORMATION_TEMPLATE|...]] [--clear-crypto-key | --crypto-key=CRYPTO_KEY] @@ -76,7 +76,7 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. - --destinations=http_endpoint_uri=URI,http_endpoint_message_binding_template=HTTP_ENDPOINT_MESSAGE_BINDING_TEMPLATE,workflow=WORKFLOW,message_bus=MESSAGE_BUS,pubsub_topic=PUBSUB_TOPIC,project=PROJECT,location=LOCATION,network_attachment=NETWORK_ATTACHMENT,google_oidc_authentication_service_account=GOOGLE_OIDC_AUTHENTICATION_SERVICE_ACCOUNT,google_oidc_authentication_audience=GOOGLE_OIDC_AUTHENTICATION_AUDIENCE,oauth_token_authentication_service_account=OAUTH_TOKEN_AUTHENTICATION_SERVICE_ACCOUNT,oauth_token_authentication_scope=OAUTH_TOKEN_AUTHENTICATION_SCOPE,output_payload_format_json=OUTPUT_PAYLOAD_FORMAT_JSON,output_payload_format_avro_schema_definition=OUTPUT_PAYLOAD_FORMAT_AVRO_SCHEMA_DEFINITION,output_payload_format_protobuf_schema_definition=OUTPUT_PAYLOAD_FORMAT_PROTOBUF_SCHEMA_DEFINITION|[...] + --destinations=[http_endpoint_uri=URI],[http_endpoint_message_binding_template=HTTP_ENDPOINT_MESSAGE_BINDING_TEMPLATE],[workflow=WORKFLOW],[message_bus=MESSAGE_BUS],[pubsub_topic=PUBSUB_TOPIC],[project=PROJECT],[location=LOCATION],[network_attachment=NETWORK_ATTACHMENT],[google_oidc_authentication_service_account=GOOGLE_OIDC_AUTHENTICATION_SERVICE_ACCOUNT],[google_oidc_authentication_audience=GOOGLE_OIDC_AUTHENTICATION_AUDIENCE],[oauth_token_authentication_service_account=OAUTH_TOKEN_AUTHENTICATION_SERVICE_ACCOUNT],[oauth_token_authentication_scope=OAUTH_TOKEN_AUTHENTICATION_SCOPE],[output_payload_format_json=OUTPUT_PAYLOAD_FORMAT_JSON],[output_payload_format_avro_schema_definition=OUTPUT_PAYLOAD_FORMAT_AVRO_SCHEMA_DEFINITION],[output_payload_format_protobuf_schema_definition=OUTPUT_PAYLOAD_FORMAT_PROTOBUF_SCHEMA_DEFINITION]|[...] The pipeline's destinations. This flag can be repeated to add more destinations to the list. Currently, only one destination is supported per pipeline. diff --git a/gcloud/beta/managed-kafka/clusters/create b/gcloud/beta/managed-kafka/clusters/create index 2c261b821..74b772f64 100644 --- a/gcloud/beta/managed-kafka/clusters/create +++ b/gcloud/beta/managed-kafka/clusters/create @@ -109,8 +109,10 @@ API REFERENCE https://cloud.google.com/managed-service-for-apache-kafka/docs 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 managed-kafka clusters create $ gcloud alpha managed-kafka clusters create diff --git a/gcloud/beta/managed-kafka/clusters/delete b/gcloud/beta/managed-kafka/clusters/delete index bdca06d5c..768503eee 100644 --- a/gcloud/beta/managed-kafka/clusters/delete +++ b/gcloud/beta/managed-kafka/clusters/delete @@ -69,8 +69,10 @@ API REFERENCE https://cloud.google.com/managed-service-for-apache-kafka/docs 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 managed-kafka clusters delete $ gcloud alpha managed-kafka clusters delete diff --git a/gcloud/beta/managed-kafka/clusters/describe b/gcloud/beta/managed-kafka/clusters/describe index 8e94fd071..a536805ed 100644 --- a/gcloud/beta/managed-kafka/clusters/describe +++ b/gcloud/beta/managed-kafka/clusters/describe @@ -64,8 +64,10 @@ API REFERENCE https://cloud.google.com/managed-service-for-apache-kafka/docs 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 managed-kafka clusters describe $ gcloud alpha managed-kafka clusters describe diff --git a/gcloud/beta/managed-kafka/clusters/help b/gcloud/beta/managed-kafka/clusters/help index 6800d36e0..6e14839c4 100644 --- a/gcloud/beta/managed-kafka/clusters/help +++ b/gcloud/beta/managed-kafka/clusters/help @@ -33,8 +33,10 @@ COMMANDS (BETA) Update a Managed Service for Apache Kafka cluster. 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 managed-kafka clusters $ gcloud alpha managed-kafka clusters diff --git a/gcloud/beta/managed-kafka/clusters/list b/gcloud/beta/managed-kafka/clusters/list index ba2735e5c..8032d1539 100644 --- a/gcloud/beta/managed-kafka/clusters/list +++ b/gcloud/beta/managed-kafka/clusters/list @@ -76,8 +76,10 @@ API REFERENCE https://cloud.google.com/managed-service-for-apache-kafka/docs 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 managed-kafka clusters list $ gcloud alpha managed-kafka clusters list diff --git a/gcloud/beta/managed-kafka/clusters/update b/gcloud/beta/managed-kafka/clusters/update index 53f54a350..e931f3d63 100644 --- a/gcloud/beta/managed-kafka/clusters/update +++ b/gcloud/beta/managed-kafka/clusters/update @@ -102,8 +102,10 @@ API REFERENCE https://cloud.google.com/managed-service-for-apache-kafka/docs 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 managed-kafka clusters update $ gcloud alpha managed-kafka clusters update diff --git a/gcloud/beta/managed-kafka/consumer-groups/delete b/gcloud/beta/managed-kafka/consumer-groups/delete index cd20c16dc..1cbe8df18 100644 --- a/gcloud/beta/managed-kafka/consumer-groups/delete +++ b/gcloud/beta/managed-kafka/consumer-groups/delete @@ -74,8 +74,10 @@ API REFERENCE https://cloud.google.com/managed-service-for-apache-kafka/docs 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 managed-kafka consumer-groups delete $ gcloud alpha managed-kafka consumer-groups delete diff --git a/gcloud/beta/managed-kafka/consumer-groups/describe b/gcloud/beta/managed-kafka/consumer-groups/describe index 98f3fd38d..171fcbfef 100644 --- a/gcloud/beta/managed-kafka/consumer-groups/describe +++ b/gcloud/beta/managed-kafka/consumer-groups/describe @@ -74,8 +74,10 @@ API REFERENCE https://cloud.google.com/managed-service-for-apache-kafka/docs 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 managed-kafka consumer-groups describe $ gcloud alpha managed-kafka consumer-groups describe diff --git a/gcloud/beta/managed-kafka/consumer-groups/help b/gcloud/beta/managed-kafka/consumer-groups/help index 9e364b920..c323103f9 100644 --- a/gcloud/beta/managed-kafka/consumer-groups/help +++ b/gcloud/beta/managed-kafka/consumer-groups/help @@ -30,8 +30,10 @@ COMMANDS (BETA) Update a Managed Service for Apache Kafka consumer group. 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 managed-kafka consumer-groups $ gcloud alpha managed-kafka consumer-groups diff --git a/gcloud/beta/managed-kafka/consumer-groups/list b/gcloud/beta/managed-kafka/consumer-groups/list index a7b96abd5..efae0f375 100644 --- a/gcloud/beta/managed-kafka/consumer-groups/list +++ b/gcloud/beta/managed-kafka/consumer-groups/list @@ -93,8 +93,10 @@ API REFERENCE https://cloud.google.com/managed-service-for-apache-kafka/docs 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 managed-kafka consumer-groups list $ gcloud alpha managed-kafka consumer-groups list diff --git a/gcloud/beta/managed-kafka/consumer-groups/update b/gcloud/beta/managed-kafka/consumer-groups/update index 5e6a1ec7f..fb7eaac29 100644 --- a/gcloud/beta/managed-kafka/consumer-groups/update +++ b/gcloud/beta/managed-kafka/consumer-groups/update @@ -98,8 +98,10 @@ API REFERENCE https://cloud.google.com/managed-service-for-apache-kafka/docs 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 managed-kafka consumer-groups update $ gcloud alpha managed-kafka consumer-groups update diff --git a/gcloud/beta/managed-kafka/help b/gcloud/beta/managed-kafka/help index e24f78175..40f07f265 100644 --- a/gcloud/beta/managed-kafka/help +++ b/gcloud/beta/managed-kafka/help @@ -27,8 +27,10 @@ GROUPS (BETA) Administer Managed Service for Apache Kafka topics. 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 managed-kafka $ gcloud alpha managed-kafka diff --git a/gcloud/beta/managed-kafka/topics/create b/gcloud/beta/managed-kafka/topics/create index 7b43e6bd1..46b390c19 100644 --- a/gcloud/beta/managed-kafka/topics/create +++ b/gcloud/beta/managed-kafka/topics/create @@ -94,8 +94,10 @@ API REFERENCE https://cloud.google.com/managed-service-for-apache-kafka/docs 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 managed-kafka topics create $ gcloud alpha managed-kafka topics create diff --git a/gcloud/beta/managed-kafka/topics/delete b/gcloud/beta/managed-kafka/topics/delete index 07aadfe5e..09c720e1b 100644 --- a/gcloud/beta/managed-kafka/topics/delete +++ b/gcloud/beta/managed-kafka/topics/delete @@ -72,8 +72,10 @@ API REFERENCE https://cloud.google.com/managed-service-for-apache-kafka/docs 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 managed-kafka topics delete $ gcloud alpha managed-kafka topics delete diff --git a/gcloud/beta/managed-kafka/topics/describe b/gcloud/beta/managed-kafka/topics/describe index b69aee128..5643eab43 100644 --- a/gcloud/beta/managed-kafka/topics/describe +++ b/gcloud/beta/managed-kafka/topics/describe @@ -72,8 +72,10 @@ API REFERENCE https://cloud.google.com/managed-service-for-apache-kafka/docs 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 managed-kafka topics describe $ gcloud alpha managed-kafka topics describe diff --git a/gcloud/beta/managed-kafka/topics/help b/gcloud/beta/managed-kafka/topics/help index 171019311..3c3649326 100644 --- a/gcloud/beta/managed-kafka/topics/help +++ b/gcloud/beta/managed-kafka/topics/help @@ -33,8 +33,10 @@ COMMANDS (BETA) Update a Managed Service for Apache Kafka topic. 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 managed-kafka topics $ gcloud alpha managed-kafka topics diff --git a/gcloud/beta/managed-kafka/topics/list b/gcloud/beta/managed-kafka/topics/list index 0ca47f641..0171af2c6 100644 --- a/gcloud/beta/managed-kafka/topics/list +++ b/gcloud/beta/managed-kafka/topics/list @@ -92,8 +92,10 @@ API REFERENCE https://cloud.google.com/managed-service-for-apache-kafka/docs 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 managed-kafka topics list $ gcloud alpha managed-kafka topics list diff --git a/gcloud/beta/managed-kafka/topics/update b/gcloud/beta/managed-kafka/topics/update index bb92b524d..9f3832eea 100644 --- a/gcloud/beta/managed-kafka/topics/update +++ b/gcloud/beta/managed-kafka/topics/update @@ -96,8 +96,10 @@ API REFERENCE https://cloud.google.com/managed-service-for-apache-kafka/docs 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 managed-kafka topics update $ gcloud alpha managed-kafka topics update diff --git a/gcloud/beta/netapp/volumes/replications/create b/gcloud/beta/netapp/volumes/replications/create index 0e2e8c3d2..a92862ef5 100644 --- a/gcloud/beta/netapp/volumes/replications/create +++ b/gcloud/beta/netapp/volumes/replications/create @@ -9,8 +9,8 @@ SYNOPSIS [share_name=SHARE_NAME], [storage_pool=STORAGE_POOL],[volume_id=VOLUME_ID] --replication-schedule=REPLICATION_SCHEDULE [--async] - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--volume=VOLUME] [GCLOUD_WIDE_FLAG ...] + [--cluster-location=CLUSTER_LOCATION] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] [--volume=VOLUME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a Cloud NetApp Volume Replication. @@ -73,6 +73,9 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --cluster-location=CLUSTER_LOCATION + Location of the user cluster. + --description=DESCRIPTION A description of the Cloud NetApp Replication diff --git a/gcloud/beta/netapp/volumes/replications/establish-peering b/gcloud/beta/netapp/volumes/replications/establish-peering new file mode 100644 index 000000000..1d884ab50 --- /dev/null +++ b/gcloud/beta/netapp/volumes/replications/establish-peering @@ -0,0 +1,118 @@ +NAME + gcloud beta netapp volumes replications establish-peering - establish + peering for Hybrid replication + +SYNOPSIS + gcloud beta netapp volumes replications establish-peering + (REPLICATION : --location=LOCATION) + --peer-cluster-name=PEER_CLUSTER_NAME --peer-svm-name=PEER_SVM_NAME + --peer-volume-name=PEER_VOLUME_NAME [--async] + [--peer-ip-addresses=PEER_IP_ADDRESS,[...]] [--volume=VOLUME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Establish peering for Hybrid replication. + +EXAMPLES + The following command establishes peering for Hybrid replication named NAME + using the arguments specified: + + $ gcloud beta netapp volumes replications establish-peering NAME \ + --volume=volume1 --peer-cluster-name=peer-cluster-name1 \ + --peer-svm-name=peer-svm-name1 \ + --peer-volume-name=peer-volume-name1 \ + --peer-ip-addresses=1.1.1.1,2.2.2.2 + +POSITIONAL ARGUMENTS + Replication resource - The Hybrid replication to establish peering 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 replication 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 volume attribute: + ◆ provide the argument replication on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + REPLICATION + ID of the replication or fully qualified identifier for the + replication. + + To set the replication attribute: + ▸ provide the argument replication 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 replication. + + To set the location attribute: + ▸ provide the argument replication on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +REQUIRED FLAGS + --peer-cluster-name=PEER_CLUSTER_NAME + Name of the destination cluster to be peered with the source cluster. + + --peer-svm-name=PEER_SVM_NAME + Name of the local source vserver svm to be peered with the destination + cluster. + + --peer-volume-name=PEER_VOLUME_NAME + Name of the source volume to be peered with the destination volume. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --peer-ip-addresses=PEER_IP_ADDRESS,[...] + List of ip addresses to be used for peering. + + Volume resource - The Volume that the Replication is based on 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 --volume 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --volume=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. + +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 netapp volumes replications establish-peering + diff --git a/gcloud/beta/netapp/volumes/replications/help b/gcloud/beta/netapp/volumes/replications/help index 20d1d4233..5a65ca176 100644 --- a/gcloud/beta/netapp/volumes/replications/help +++ b/gcloud/beta/netapp/volumes/replications/help @@ -25,6 +25,9 @@ COMMANDS describe (BETA) Describe a Cloud NetApp Volume Replication. + establish-peering + (BETA) Establish peering for Hybrid replication. + list (BETA) List Cloud NetApp Volume Replications. @@ -37,6 +40,9 @@ COMMANDS stop (BETA) Stop a Cloud NetApp Volume Replication. + sync + (BETA) Sync a Cloud NetApp Volume Replication. + update (BETA) Update a Cloud NetApp Volume Replication. diff --git a/gcloud/beta/netapp/volumes/replications/sync b/gcloud/beta/netapp/volumes/replications/sync new file mode 100644 index 000000000..4a5d2d891 --- /dev/null +++ b/gcloud/beta/netapp/volumes/replications/sync @@ -0,0 +1,103 @@ +NAME + gcloud beta netapp volumes replications sync - sync a Cloud NetApp Volume + Replication + +SYNOPSIS + gcloud beta netapp volumes replications sync + (REPLICATION : --location=LOCATION) [--async] [--volume=VOLUME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Sync a Cloud NetApp Volume Replication. + +EXAMPLES + The following command syncs a Replication named NAME using the required + arguments: + + $ gcloud beta netapp volumes replications sync NAME \ + --location=us-central1 --volume=vol1 + + To sync a Replication named NAME asynchronously, run the following command: + + $ gcloud beta netapp volumes replications sync NAME \ + --location=us-central1 --volume=vol1 --async + +POSITIONAL ARGUMENTS + Replication resource - The Replication to sync. 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 replication 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 volume attribute: + ◆ provide the argument replication on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + REPLICATION + ID of the replication or fully qualified identifier for the + replication. + + To set the replication attribute: + ▸ provide the argument replication 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 replication. + + To set the location attribute: + ▸ provide the argument replication on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + Volume resource - The Volume that the Replication is based on 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 --volume 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --volume=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. + +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 netapp volumes replications sync + diff --git a/gcloud/beta/netapp/volumes/replications/update b/gcloud/beta/netapp/volumes/replications/update index bc7ee1628..ffa746b9b 100644 --- a/gcloud/beta/netapp/volumes/replications/update +++ b/gcloud/beta/netapp/volumes/replications/update @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud beta netapp volumes replications update (REPLICATION : --location=LOCATION) [--async] - [--description=DESCRIPTION] + [--cluster-location=CLUSTER_LOCATION] [--description=DESCRIPTION] [--replication-schedule=REPLICATION_SCHEDULE] [--update-labels=[KEY=VALUE,...]] [--volume=VOLUME] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -66,6 +66,9 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --cluster-location=CLUSTER_LOCATION + Location of the user cluster. + --description=DESCRIPTION A description of the Cloud NetApp Replication diff --git a/gcloud/beta/network-connectivity/spokes/linked-producer-vpc-network/update b/gcloud/beta/network-connectivity/spokes/linked-producer-vpc-network/update index 5d805fc65..726e0e321 100644 --- a/gcloud/beta/network-connectivity/spokes/linked-producer-vpc-network/update +++ b/gcloud/beta/network-connectivity/spokes/linked-producer-vpc-network/update @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud beta network-connectivity spokes linked-producer-vpc-network update SPOKE [--async] [--description=DESCRIPTION] [--global] + [--include-export-ranges=[CIDR_RANGE,...]] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -53,6 +54,10 @@ FLAGS --global Indicates that the spoke is global. + --include-export-ranges=[CIDR_RANGE,...] + Only allows adding ALL_IPV6_RANGES to include export ranges or removing + ALL_IPV6_RANGES from include export ranges. + --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. diff --git a/gcloud/beta/network-connectivity/spokes/linked-vpc-network/update b/gcloud/beta/network-connectivity/spokes/linked-vpc-network/update index f36952ce7..6b071d09e 100644 --- a/gcloud/beta/network-connectivity/spokes/linked-vpc-network/update +++ b/gcloud/beta/network-connectivity/spokes/linked-vpc-network/update @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud beta network-connectivity spokes linked-vpc-network update SPOKE [--async] [--description=DESCRIPTION] [--global] + [--include-export-ranges=[CIDR_RANGE,...]] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -52,6 +53,10 @@ FLAGS --global Indicates that the spoke is global. + --include-export-ranges=[CIDR_RANGE,...] + Only allows adding ALL_IPV6_RANGES to include export ranges or removing + ALL_IPV6_RANGES from include export ranges. + --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. diff --git a/gcloud/beta/network-security/security-profiles/threat-prevention/add-override b/gcloud/beta/network-security/security-profiles/threat-prevention/add-override index 20e219204..ba351d4d0 100644 --- a/gcloud/beta/network-security/security-profiles/threat-prevention/add-override +++ b/gcloud/beta/network-security/security-profiles/threat-prevention/add-override @@ -67,7 +67,7 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --action=ACTION Action associated with severity or threat-id. ACTION must be one of: - DEFAULT, ALLOW, ALERT, DENY. + DEFAULT_ACTION, ALLOW, ALERT, DENY. Exactly one of these must be specified: diff --git a/gcloud/beta/network-security/security-profiles/threat-prevention/update-override b/gcloud/beta/network-security/security-profiles/threat-prevention/update-override index 291a75f3b..fd2a39ca4 100644 --- a/gcloud/beta/network-security/security-profiles/threat-prevention/update-override +++ b/gcloud/beta/network-security/security-profiles/threat-prevention/update-override @@ -67,7 +67,7 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --action=ACTION Action associated with severity or threat-id. ACTION must be one of: - DEFAULT, ALLOW, ALERT, DENY. + DEFAULT_ACTION, ALLOW, ALERT, DENY. Exactly one of these must be specified: diff --git a/gcloud/beta/run/deploy b/gcloud/beta/run/deploy index f5a60b0f1..e7df8c2e8 100644 --- a/gcloud/beta/run/deploy +++ b/gcloud/beta/run/deploy @@ -30,8 +30,10 @@ SYNOPSIS --clear-volumes --remove-volume=[VOLUME,...]] [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] --args=[ARG,...] --[no-]automatic-updates --clear-volume-mounts - --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --memory=MEMORY - --port=PORT --remove-volume-mount=[MOUNT_PATH,...] + --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU + --liveness-probe=[KEY=VALUE,...] --memory=MEMORY --port=PORT + --remove-volume-mount=[MOUNT_PATH,...] + --startup-probe=[KEY=VALUE,...] --[no-]use-http2 --base-image=BASE_IMAGE | --clear-base-image --build-env-vars-file=FILE_PATH | --clear-build-env-vars | --set-build-env-vars=[KEY=VALUE,...] @@ -409,6 +411,30 @@ FLAGS Cloud Run supports values 0 or 1. 1 gpu also requires a minimum 4 --cpu value 1 gpu also requires a minimum 8Gi --memory value. + --liveness-probe=[KEY=VALUE,...] + Comma separated settings for liveness probe in the form KEY=VALUE. + Each key stands for a field of the probe described in + https://cloud.google.com/run/docs/reference/rest/v1/Container#Probe. + Currently supported keys are: + + + initialDelaySeconds: integer + + timeoutSeconds: integer + + periodSeconds: integer + + failureThreshold: integer + + httpGet.port: integer + + httpGet.path: string + + grpc.port: integer + + grpc.service: string + + For example, to set a probe with 10s timeout and HTTP probe + requests sent to 8080 port of the container: + + $ --liveness-probe=timeoutSeconds=10,httpGet.port=8080 + + To remove existing probe: + + $ --liveness-probe="" + --memory=MEMORY Set a memory limit. Ex: 1024Mi, 4Gi. @@ -424,6 +450,31 @@ FLAGS Removes the volume mounted at the specified path from the current container. + --startup-probe=[KEY=VALUE,...] + Comma separated settings for startup probe in the form KEY=VALUE. + Each key stands for a field of the probe described in + https://cloud.google.com/run/docs/reference/rest/v1/Container#Probe. + Currently supported keys are: + + + initialDelaySeconds: integer + + timeoutSeconds: integer + + periodSeconds: integer + + failureThreshold: integer + + httpGet.port: integer + + httpGet.path: string + + grpc.port: integer + + grpc.service: string + + tcpSocket.port: integer + + For example, to set a probe with 10s timeout and HTTP probe + requests sent to 8080 port of the container: + + $ --startup-probe=timeoutSeconds=10,httpGet.port=8080 + + To remove existing probe: + + $ --startup-probe="" + --[no-]use-http2 Whether to use HTTP/2 for connections to the service. Use --use-http2 to enable and --no-use-http2 to disable. diff --git a/gcloud/beta/run/services/update b/gcloud/beta/run/services/update index 84d1f24e7..b4e0e9dd5 100644 --- a/gcloud/beta/run/services/update +++ b/gcloud/beta/run/services/update @@ -31,9 +31,11 @@ SYNOPSIS [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --image=IMAGE - --memory=MEMORY --port=PORT --remove-volume-mount=[MOUNT_PATH,...] - --[no-]use-http2 --clear-env-vars | --env-vars-file=FILE_PATH - | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] + --liveness-probe=[KEY=VALUE,...] --memory=MEMORY --port=PORT + --remove-volume-mount=[MOUNT_PATH,...] + --startup-probe=[KEY=VALUE,...] --[no-]use-http2 --clear-env-vars + | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] + | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...] --clear-secrets | --set-secrets=[KEY=VALUE,...] | --remove-secrets=[KEY,...] --update-secrets=[KEY=VALUE,...]] @@ -387,6 +389,30 @@ FLAGS Name of the container image to deploy (e.g. us-docker.pkg.dev/cloudrun/container/hello:latest). + --liveness-probe=[KEY=VALUE,...] + Comma separated settings for liveness probe in the form KEY=VALUE. + Each key stands for a field of the probe described in + https://cloud.google.com/run/docs/reference/rest/v1/Container#Probe. + Currently supported keys are: + + + initialDelaySeconds: integer + + timeoutSeconds: integer + + periodSeconds: integer + + failureThreshold: integer + + httpGet.port: integer + + httpGet.path: string + + grpc.port: integer + + grpc.service: string + + For example, to set a probe with 10s timeout and HTTP probe + requests sent to 8080 port of the container: + + $ --liveness-probe=timeoutSeconds=10,httpGet.port=8080 + + To remove existing probe: + + $ --liveness-probe="" + --memory=MEMORY Set a memory limit. Ex: 1024Mi, 4Gi. @@ -402,6 +428,31 @@ FLAGS Removes the volume mounted at the specified path from the current container. + --startup-probe=[KEY=VALUE,...] + Comma separated settings for startup probe in the form KEY=VALUE. + Each key stands for a field of the probe described in + https://cloud.google.com/run/docs/reference/rest/v1/Container#Probe. + Currently supported keys are: + + + initialDelaySeconds: integer + + timeoutSeconds: integer + + periodSeconds: integer + + failureThreshold: integer + + httpGet.port: integer + + httpGet.path: string + + grpc.port: integer + + grpc.service: string + + tcpSocket.port: integer + + For example, to set a probe with 10s timeout and HTTP probe + requests sent to 8080 port of the container: + + $ --startup-probe=timeoutSeconds=10,httpGet.port=8080 + + To remove existing probe: + + $ --startup-probe="" + --[no-]use-http2 Whether to use HTTP/2 for connections to the service. Use --use-http2 to enable and --no-use-http2 to disable. diff --git a/gcloud/beta/spanner/instances/create b/gcloud/beta/spanner/instances/create index 78a7b4646..010378c8a 100644 --- a/gcloud/beta/spanner/instances/create +++ b/gcloud/beta/spanner/instances/create @@ -3,8 +3,10 @@ NAME SYNOPSIS gcloud beta spanner instances create INSTANCE --config=CONFIG - --description=DESCRIPTION [--async] [--edition=EDITION] - [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] + --description=DESCRIPTION [--async] + [--default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE] + [--edition=EDITION] [--expire-behavior=EXPIRE_BEHAVIOR] + [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS | --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET (--autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES | --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS)] [GCLOUD_WIDE_FLAG ...] @@ -37,6 +39,22 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE + The default backup schedule type that is used in the instance. + DEFAULT_BACKUP_SCHEDULE_TYPE must be one of: + + AUTOMATIC + A default backup schedule is created automatically when a new + database is created in an instance. You can edit or delete the + default backup schedule once it's created. The default backup + schedule creates a full backup every 24 hours. These full backups + are retained for 7 days. + DEFAULT_BACKUP_SCHEDULE_TYPE_UNSPECIFIED + Not specified. + NONE + No default backup schedule is created automatically when a new + database is created in an instance. + --edition=EDITION Cloud Spanner edition. EDITION must be one of: diff --git a/gcloud/beta/spanner/instances/update b/gcloud/beta/spanner/instances/update index 9ba6f16bb..cb23dd109 100644 --- a/gcloud/beta/spanner/instances/update +++ b/gcloud/beta/spanner/instances/update @@ -3,6 +3,7 @@ NAME SYNOPSIS gcloud beta spanner instances update INSTANCE [--async] + [--default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE] [--description=DESCRIPTION] [--edition=EDITION] [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS @@ -31,6 +32,22 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE + The default backup schedule type that is used in the instance. + DEFAULT_BACKUP_SCHEDULE_TYPE must be one of: + + AUTOMATIC + A default backup schedule is created automatically when a new + database is created in an instance. You can edit or delete the + default backup schedule once it's created. The default backup + schedule creates a full backup every 24 hours. These full backups + are retained for 7 days. + DEFAULT_BACKUP_SCHEDULE_TYPE_UNSPECIFIED + Not specified. + NONE + No default backup schedule is created automatically when a new + database is created in an instance. + --description=DESCRIPTION Description of the instance. diff --git a/gcloud/beta/sql/instances/create b/gcloud/beta/sql/instances/create index 7437b56d1..7826fbda6 100644 --- a/gcloud/beta/sql/instances/create +++ b/gcloud/beta/sql/instances/create @@ -456,6 +456,9 @@ FLAGS --server-ca-mode=SERVER_CA_MODE Set the server CA mode of the instance. SERVER_CA_MODE must be one of: + CUSTOMER_MANAGED_CAS_CA + Customer-managed CA hosted on Google Cloud's Certificate Authority + Service (CAS). GOOGLE_MANAGED_CAS_CA Google-managed regional CA part of root CA hierarchy hosted on Google Cloud's Certificate Authority Service (CAS). diff --git a/gcloud/beta/sql/instances/switchover b/gcloud/beta/sql/instances/switchover index b3cf8325f..e0e750012 100644 --- a/gcloud/beta/sql/instances/switchover +++ b/gcloud/beta/sql/instances/switchover @@ -24,9 +24,9 @@ FLAGS complete. --db-timeout=DB_TIMEOUT - (MySQL only) Cloud SQL instance operations timeout, which is the sum of - all database operations. Default value is 10 minutes and can be - modified to a maximum value of 24h. + (MySQL and PostgreSQL only) Cloud SQL instance operations timeout, + which is the sum of all database operations. Default value is 10 + minutes and can be modified to a maximum value of 24h. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/colab-enterprise/executions/create b/gcloud/colab/executions/create similarity index 95% rename from gcloud/beta/colab-enterprise/executions/create rename to gcloud/colab/executions/create index 662f2da7a..3d6c48127 100644 --- a/gcloud/beta/colab-enterprise/executions/create +++ b/gcloud/colab/executions/create @@ -1,8 +1,8 @@ NAME - gcloud beta colab-enterprise executions create - create an execution + gcloud colab executions create - create an execution SYNOPSIS - gcloud beta colab-enterprise executions create + gcloud colab executions create (--display-name=DISPLAY_NAME --gcs-output-uri=GCS_OUTPUT_URI --notebook-runtime-template=NOTEBOOK_RUNTIME_TEMPLATE (--direct-content=DIRECT_CONTENT @@ -14,8 +14,7 @@ SYNOPSIS [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Creates a notebook execution to be used on a Colab Enterprise - runtime. + Create a notebook execution to be used on a Colab Enterprise runtime. EXAMPLES To create an execution of a notebook file with Cloud Storage URI @@ -26,8 +25,7 @@ EXAMPLES uploaded to Cloud Storage bucket gs://my-bucket/results, and in region us-central1 run: - $ gcloud beta colab-enterprise executions create \ - --display-name=my-execution \ + $ gcloud colab executions create --display-name=my-execution \ --runtime-template=my-runtime-template-id \ --gcs-notebook-uri=gs://my-bucket/my-notebook.ipynb \ --service-account=my-service-account@my-project.iam.gserviceacco\ @@ -183,5 +181,7 @@ 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: + + $ gcloud beta colab executions create diff --git a/gcloud/beta/colab-enterprise/executions/delete b/gcloud/colab/executions/delete similarity index 81% rename from gcloud/beta/colab-enterprise/executions/delete rename to gcloud/colab/executions/delete index fba4d912d..b2760faa7 100644 --- a/gcloud/beta/colab-enterprise/executions/delete +++ b/gcloud/colab/executions/delete @@ -1,18 +1,17 @@ NAME - gcloud beta colab-enterprise executions delete - delete an execution + gcloud colab executions delete - delete an execution SYNOPSIS - gcloud beta colab-enterprise executions delete - (EXECUTION : --region=REGION) [--async] [GCLOUD_WIDE_FLAG ...] + gcloud colab executions delete (EXECUTION : --region=REGION) [--async] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Deletes a Colab Enterprise notebook execution. + Delete a Colab Enterprise notebook execution. EXAMPLES To delete an execution with id my-execution, in region us-central1, run: - $ gcloud beta colab-enterprise executions delete my-execution \ - --region=us-central1 + $ gcloud colab executions delete my-execution --region=us-central1 POSITIONAL ARGUMENTS Notebook execution job resource - Unique resource name of the execution to @@ -61,5 +60,7 @@ 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: + + $ gcloud beta colab executions delete diff --git a/gcloud/beta/colab-enterprise/executions/describe b/gcloud/colab/executions/describe similarity index 80% rename from gcloud/beta/colab-enterprise/executions/describe rename to gcloud/colab/executions/describe index 5a0c903ed..5469eaa52 100644 --- a/gcloud/beta/colab-enterprise/executions/describe +++ b/gcloud/colab/executions/describe @@ -1,19 +1,18 @@ NAME - gcloud beta colab-enterprise executions describe - describe an execution + gcloud colab executions describe - describe an execution SYNOPSIS - gcloud beta colab-enterprise executions describe - (EXECUTION : --region=REGION) [GCLOUD_WIDE_FLAG ...] + gcloud colab executions describe (EXECUTION : --region=REGION) + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Describes a Colab Enterprise notebook execution. + Describe a Colab Enterprise notebook execution. EXAMPLES To describe a notebook execution with id my-execution in region us-central1, run: - $ gcloud beta colab-enterprise executions describe my-execution \ - --region=us-central1 + $ gcloud colab executions describe my-execution --region=us-central1 POSITIONAL ARGUMENTS Notebook execution job resource - Unique resource name of the execution to @@ -57,5 +56,7 @@ 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: + + $ gcloud beta colab executions describe diff --git a/gcloud/colab/executions/help b/gcloud/colab/executions/help new file mode 100644 index 000000000..207dfd3f6 --- /dev/null +++ b/gcloud/colab/executions/help @@ -0,0 +1,35 @@ +NAME + gcloud colab executions - manage Colab Enterprise notebook execution jobs + +SYNOPSIS + gcloud colab executions COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + For more information about executions, see + https://cloud.google.com/colab/docs/schedule-notebook-run. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create an execution. + + delete + Delete an execution. + + describe + Describe an execution. + + list + List your Colab Enterprise notebook execution jobs. + +NOTES + This variant is also available: + + $ gcloud beta colab executions + diff --git a/gcloud/beta/colab-enterprise/executions/list b/gcloud/colab/executions/list similarity index 83% rename from gcloud/beta/colab-enterprise/executions/list rename to gcloud/colab/executions/list index 1ec7f7110..2f5143986 100644 --- a/gcloud/beta/colab-enterprise/executions/list +++ b/gcloud/colab/executions/list @@ -1,20 +1,19 @@ NAME - gcloud beta colab-enterprise executions list - list your Colab Enterprise - notebook execution jobs + gcloud colab executions list - list your Colab Enterprise notebook + execution jobs SYNOPSIS - gcloud beta colab-enterprise executions list [--region=REGION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + gcloud colab executions list [--region=REGION] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Lists your project's Colab Enterprise notebook executions in a given - region. + List your project's Colab Enterprise notebook executions in a given region. EXAMPLES To list your executions in region us-central1, run: - $ gcloud beta colab-enterprise executions list --region=us-central1 + $ gcloud colab executions list --region=us-central1 FLAGS Region resource - Cloud region for which to list all executions. This @@ -76,5 +75,7 @@ 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: + + $ gcloud beta colab executions list diff --git a/gcloud/colab/help b/gcloud/colab/help new file mode 100644 index 000000000..560e23980 --- /dev/null +++ b/gcloud/colab/help @@ -0,0 +1,34 @@ +NAME + gcloud colab - manage Colab Enterprise resources + +SYNOPSIS + gcloud colab GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Colab Enterprise resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + executions + Manage Colab Enterprise notebook execution jobs. + + runtime-templates + Manage Colab Enterprise runtime templates. + + runtimes + Manage Colab Enterprise runtimes. + + schedules + Manage Colab Enterprise notebook execution schedules. + +NOTES + This variant is also available: + + $ gcloud beta colab + diff --git a/gcloud/beta/colab-enterprise/runtime-templates/add-iam-policy-binding b/gcloud/colab/runtime-templates/add-iam-policy-binding similarity index 83% rename from gcloud/beta/colab-enterprise/runtime-templates/add-iam-policy-binding rename to gcloud/colab/runtime-templates/add-iam-policy-binding index a35fdcd0c..e91434f76 100644 --- a/gcloud/beta/colab-enterprise/runtime-templates/add-iam-policy-binding +++ b/gcloud/colab/runtime-templates/add-iam-policy-binding @@ -1,23 +1,24 @@ NAME - gcloud beta colab-enterprise runtime-templates add-iam-policy-binding - add - an IAM policy binding to a Colab Enterprise runtime template + gcloud colab runtime-templates add-iam-policy-binding - add an IAM policy + binding to a Colab Enterprise runtime template SYNOPSIS - gcloud beta colab-enterprise runtime-templates add-iam-policy-binding + gcloud colab runtime-templates add-iam-policy-binding (RUNTIME_TEMPLATE : --region=REGION) --member=PRINCIPAL --role=ROLE [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Adds an IAM policy binding to a Colab Enterprise runtime template. + Add an IAM policy binding to a Colab Enterprise runtime template. EXAMPLES To set someone@example.com to have the roles/aiplatform.notebookRuntimeUser role for a runtime template with id my-runtime-template in region us-central1, run: - $ gcloud beta colab-enterprise runtime-templates \ add-iam-policy-binding my-runtime-template \ - --region=us-central1 --member=user:someone@example.com \ - --role=roles/aiplatform.notebookRuntimeUser + $ gcloud colab runtime-templates add-iam-policy-binding \ + my-runtime-template --region=us-central1 \ + --member=user:someone@example.com \ + --role=roles/aiplatform.notebookRuntimeUser POSITIONAL ARGUMENTS Runtime template resource - Unique name of the runtime template to add IAM @@ -84,5 +85,7 @@ 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: + + $ gcloud beta colab runtime-templates add-iam-policy-binding diff --git a/gcloud/beta/colab-enterprise/runtime-templates/create b/gcloud/colab/runtime-templates/create similarity index 92% rename from gcloud/beta/colab-enterprise/runtime-templates/create rename to gcloud/colab/runtime-templates/create index d15e28472..abb1967a0 100644 --- a/gcloud/beta/colab-enterprise/runtime-templates/create +++ b/gcloud/colab/runtime-templates/create @@ -1,11 +1,9 @@ NAME - gcloud beta colab-enterprise runtime-templates create - create a runtime - template + gcloud colab runtime-templates create - create a runtime template SYNOPSIS - gcloud beta colab-enterprise runtime-templates create - --display-name=DISPLAY_NAME [--async] [--region=REGION] - [--runtime-template-id=RUNTIME_TEMPLATE_ID] + gcloud colab runtime-templates create --display-name=DISPLAY_NAME [--async] + [--region=REGION] [--runtime-template-id=RUNTIME_TEMPLATE_ID] [--description=DESCRIPTION --no-enable-euc --enable-secure-boot --idle-shutdown-timeout=IDLE_SHUTDOWN_TIMEOUT; default="3h" --labels=[KEY=VALUE,...] --network-tags=[TAGS,...] @@ -19,29 +17,28 @@ SYNOPSIS : --subnetwork-region=SUBNETWORK_REGION]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Creates a Colab Enterprise runtime template, a VM configuration for - your notebook runtimes. + Create a Colab Enterprise runtime template, a VM configuration for your + notebook runtimes. EXAMPLES To create a runtime template in region 'us-central1' with the display name 'my-runtime-template', run: - $ gcloud beta colab-enterprise runtime-templates create \ - --region=us-central1 --display-name=my-runtime-template + $ gcloud colab runtime-templates create --region=us-central1 \ + --display-name=my-runtime-template To create a runtime template for a VM with machine type n1-standard-2 and one NVIDIA_TESLA_V100 accelerator, run: - $ gcloud beta colab-enterprise runtime-templates create \ + $ gcloud colab runtime-templates create \ --machine-type=n1-standard-2 \ --accelerator-type=NVIDIA_TESLA_V100 --accelerator-count=1 \ --region=us-central1 --display-name=my-runtime-template To create a runtime template that disables end user credential access, run: - $ gcloud beta colab-enterprise runtime-templates create \ - --no-enable-euc --region=us-central1 \ - --display-name=my-runtime-template + $ gcloud colab runtime-templates create --no-enable-euc \ + --region=us-central1 --display-name=my-runtime-template REQUIRED FLAGS --display-name=DISPLAY_NAME @@ -225,5 +222,7 @@ 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: + + $ gcloud beta colab runtime-templates create diff --git a/gcloud/beta/colab-enterprise/runtime-templates/delete b/gcloud/colab/runtime-templates/delete similarity index 80% rename from gcloud/beta/colab-enterprise/runtime-templates/delete rename to gcloud/colab/runtime-templates/delete index a50da67fa..f206cee15 100644 --- a/gcloud/beta/colab-enterprise/runtime-templates/delete +++ b/gcloud/colab/runtime-templates/delete @@ -1,20 +1,19 @@ NAME - gcloud beta colab-enterprise runtime-templates delete - delete a runtime - template + gcloud colab runtime-templates delete - delete a runtime template SYNOPSIS - gcloud beta colab-enterprise runtime-templates delete - (RUNTIME_TEMPLATE : --region=REGION) [--async] [GCLOUD_WIDE_FLAG ...] + gcloud colab runtime-templates delete (RUNTIME_TEMPLATE : --region=REGION) + [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Deletes a Colab Enterprise notebook runtime template. + Delete a Colab Enterprise notebook runtime template. EXAMPLES To delete a runtime template with id 'my-runtime-template' in region 'us-central1', run: - $ gcloud beta colab-enterprise runtime-templates delete \ - my-runtime-template --region=us-central1 + $ gcloud colab runtime-templates delete my-runtime-template \ + --region=us-central1 POSITIONAL ARGUMENTS Runtime template resource - Unique name of the runtime template to delete. @@ -65,5 +64,7 @@ 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: + + $ gcloud beta colab runtime-templates delete diff --git a/gcloud/beta/colab-enterprise/runtime-templates/describe b/gcloud/colab/runtime-templates/describe similarity index 82% rename from gcloud/beta/colab-enterprise/runtime-templates/describe rename to gcloud/colab/runtime-templates/describe index a175665a0..9fd960ab4 100644 --- a/gcloud/beta/colab-enterprise/runtime-templates/describe +++ b/gcloud/colab/runtime-templates/describe @@ -1,20 +1,19 @@ NAME - gcloud beta colab-enterprise runtime-templates describe - describe a - runtime template + gcloud colab runtime-templates describe - describe a runtime template SYNOPSIS - gcloud beta colab-enterprise runtime-templates describe + gcloud colab runtime-templates describe (RUNTIME_TEMPLATE : --region=REGION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Describes a Colab Enterprise notebook runtime template. + Describe a Colab Enterprise notebook runtime template. EXAMPLES To describe a runtime template with id 'my-runtime-template' in region 'us-central1', run: - $ gcloud beta colab-enterprise runtime-templates describe \ - my-runtime-template --region=us-central1 + $ gcloud colab runtime-templates describe my-runtime-template \ + --region=us-central1 POSITIONAL ARGUMENTS Runtime template resource - Unique name of the runtime template to @@ -60,5 +59,7 @@ 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: + + $ gcloud beta colab runtime-templates describe diff --git a/gcloud/beta/colab-enterprise/runtime-templates/get-iam-policy b/gcloud/colab/runtime-templates/get-iam-policy similarity index 89% rename from gcloud/beta/colab-enterprise/runtime-templates/get-iam-policy rename to gcloud/colab/runtime-templates/get-iam-policy index 484e7e0a2..10091a155 100644 --- a/gcloud/beta/colab-enterprise/runtime-templates/get-iam-policy +++ b/gcloud/colab/runtime-templates/get-iam-policy @@ -1,21 +1,21 @@ NAME - gcloud beta colab-enterprise runtime-templates get-iam-policy - get IAM - policy for a Colab Enterprise runtime template + gcloud colab runtime-templates get-iam-policy - get IAM policy for a Colab + Enterprise runtime template SYNOPSIS - gcloud beta colab-enterprise runtime-templates get-iam-policy + gcloud colab runtime-templates get-iam-policy (RUNTIME_TEMPLATE : --region=REGION) [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Gets the IAM policy for a Colab Enterprise runtime template. + Get the IAM policy for a Colab Enterprise runtime template. EXAMPLES To get the IAM policy for a runtime template with id my-runtime-template in region us-central1, run: - $ gcloud beta colab-enterprise runtime-templates get-iam-policy \ + $ gcloud colab runtime-templates get-iam-policy \ my-runtime-template --location=us-central1 \ --member=user:someone@example.com \ --role=roles/aiplatform.notebookRuntimeUser @@ -90,5 +90,7 @@ 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: + + $ gcloud beta colab runtime-templates get-iam-policy diff --git a/gcloud/colab/runtime-templates/help b/gcloud/colab/runtime-templates/help new file mode 100644 index 000000000..7aaaf46e8 --- /dev/null +++ b/gcloud/colab/runtime-templates/help @@ -0,0 +1,48 @@ +NAME + gcloud colab runtime-templates - manage Colab Enterprise runtime templates + +SYNOPSIS + gcloud colab runtime-templates COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + For more information about runtime templates, see + https://cloud.google.com/colab/docs/runtimes#runtime-templates + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + add-iam-policy-binding + Add an IAM policy binding to a Colab Enterprise runtime template. + + create + Create a runtime template. + + delete + Delete a runtime template. + + describe + Describe a runtime template. + + get-iam-policy + Get IAM policy for a Colab Enterprise runtime template. + + list + List your runtime templates. + + remove-iam-policy-binding + Remove an IAM policy binding from a Colab Enterprise runtime template. + + set-iam-policy + Set IAM policy for a Colab Enterprise runtime template as defined in a + JSON or YAML file. + +NOTES + This variant is also available: + + $ gcloud beta colab runtime-templates + diff --git a/gcloud/beta/colab-enterprise/runtime-templates/list b/gcloud/colab/runtime-templates/list similarity index 83% rename from gcloud/beta/colab-enterprise/runtime-templates/list rename to gcloud/colab/runtime-templates/list index dda766996..0d41d812f 100644 --- a/gcloud/beta/colab-enterprise/runtime-templates/list +++ b/gcloud/colab/runtime-templates/list @@ -1,21 +1,19 @@ NAME - gcloud beta colab-enterprise runtime-templates list - list your runtime - templates + gcloud colab runtime-templates list - list your runtime templates SYNOPSIS - gcloud beta colab-enterprise runtime-templates list [--region=REGION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + gcloud colab runtime-templates list [--region=REGION] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Lists your project's Colab Enterprise notebook runtime templates in - a given region. + List your project's Colab Enterprise notebook runtime templates in a given + region. EXAMPLES To list your runtime templates in region 'us-central1', run: - $ gcloud beta colab-enterprise runtime-templates list \ - --region=us-central1 + $ gcloud colab runtime-templates list --region=us-central1 FLAGS Region resource - Cloud region for which to list all runtime templates. @@ -79,5 +77,7 @@ 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: + + $ gcloud beta colab runtime-templates list diff --git a/gcloud/beta/colab-enterprise/runtime-templates/remove-iam-policy-binding b/gcloud/colab/runtime-templates/remove-iam-policy-binding similarity index 83% rename from gcloud/beta/colab-enterprise/runtime-templates/remove-iam-policy-binding rename to gcloud/colab/runtime-templates/remove-iam-policy-binding index 25bfcb7a6..26b5e18b7 100644 --- a/gcloud/beta/colab-enterprise/runtime-templates/remove-iam-policy-binding +++ b/gcloud/colab/runtime-templates/remove-iam-policy-binding @@ -1,24 +1,24 @@ NAME - gcloud beta colab-enterprise runtime-templates remove-iam-policy-binding - - remove an IAM policy binding from a Colab Enterprise runtime template + gcloud colab runtime-templates remove-iam-policy-binding - remove an IAM + policy binding from a Colab Enterprise runtime template SYNOPSIS - gcloud beta colab-enterprise runtime-templates remove-iam-policy-binding + gcloud colab runtime-templates remove-iam-policy-binding (RUNTIME_TEMPLATE : --region=REGION) --member=PRINCIPAL --role=ROLE [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Removes an IAM policy binding from a Colab Enterprise runtime - template. + Remove an IAM policy binding from a Colab Enterprise runtime template. EXAMPLES To remove an IAM policy binding of roles/aiplatform.notebookRuntimeUser for someone@example.com, from the runtime template with id my-runtime-template in region us-central1, run: - $ gcloud beta colab-enterprise runtime-templates \ remove-iam-policy-binding my-runtime-template \ - --region=us-central1 --member=user:someone@example.com \ - --role=roles/aiplatform.notebookRuntimeUser + $ gcloud colab runtime-templates remove-iam-policy-binding \ + my-runtime-template --region=us-central1 \ + --member=user:someone@example.com \ + --role=roles/aiplatform.notebookRuntimeUser POSITIONAL ARGUMENTS Runtime template resource - Unique name of the runtime template to remove @@ -86,5 +86,7 @@ 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: + + $ gcloud beta colab runtime-templates remove-iam-policy-binding diff --git a/gcloud/beta/colab-enterprise/runtime-templates/set-iam-policy b/gcloud/colab/runtime-templates/set-iam-policy similarity index 83% rename from gcloud/beta/colab-enterprise/runtime-templates/set-iam-policy rename to gcloud/colab/runtime-templates/set-iam-policy index d2e712b0d..ba52c7d13 100644 --- a/gcloud/beta/colab-enterprise/runtime-templates/set-iam-policy +++ b/gcloud/colab/runtime-templates/set-iam-policy @@ -1,15 +1,14 @@ NAME - gcloud beta colab-enterprise runtime-templates set-iam-policy - set IAM - policy for a Colab Enterprise runtime template as defined in a JSON or - YAML file + gcloud colab runtime-templates set-iam-policy - set IAM policy for a Colab + Enterprise runtime template as defined in a JSON or YAML file SYNOPSIS - gcloud beta colab-enterprise runtime-templates set-iam-policy + gcloud colab runtime-templates set-iam-policy (RUNTIME_TEMPLATE : --region=REGION) POLICY_FILE [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Sets the IAM policy for a Colab Enterprise runtime template as - defined in a JSON or YAML file. + Set the IAM policy for a Colab Enterprise runtime template as defined in a + JSON or YAML file. See https://cloud.google.com/iam/docs/managing-policies for details of the policy file format and contents. @@ -18,7 +17,7 @@ EXAMPLES To set the IAM policy for a runtime template with id my-runtime-template in region us-central1 to the policy defined in policy.json, run: - $ gcloud beta colab-enterprise runtime-templates set-iam-policy \ + $ gcloud colab runtime-templates set-iam-policy \ my-runtime-template policy.json --region=us-central1 POSITIONAL ARGUMENTS @@ -72,5 +71,7 @@ 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: + + $ gcloud beta colab runtime-templates set-iam-policy diff --git a/gcloud/beta/colab-enterprise/runtimes/create b/gcloud/colab/runtimes/create similarity index 88% rename from gcloud/beta/colab-enterprise/runtimes/create rename to gcloud/colab/runtimes/create index bd7e0c2ae..44354e7bb 100644 --- a/gcloud/beta/colab-enterprise/runtimes/create +++ b/gcloud/colab/runtimes/create @@ -1,30 +1,29 @@ NAME - gcloud beta colab-enterprise runtimes create - create a notebook runtime + gcloud colab runtimes create - create a notebook runtime SYNOPSIS - gcloud beta colab-enterprise runtimes create --display-name=DISPLAY_NAME + gcloud colab runtimes create --display-name=DISPLAY_NAME --runtime-template=RUNTIME_TEMPLATE [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--region=REGION] [--runtime-id=RUNTIME_ID] [--runtime-user=RUNTIME_USER] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Create a notebook runtime that can be used to run code from your - notebook (IPYNB file). + Create a notebook runtime that can be used to run code from your notebook + (IPYNB file). EXAMPLES To create a runtime in region 'us-central1' with the display name 'my-runtime' and template with id 'my-template', run: - $ gcloud beta colab-enterprise runtimes create \ - --region=us-central1 --display-name=my-runtime \ - --runtime-template=my-template + $ gcloud colab runtimes create --region=us-central1 \ + --display-name=my-runtime --runtime-template=my-template To create a runtime for user 'USER@DOMAIN.COM', run: - $ gcloud beta colab-enterprise runtimes create \ - --runtime-user=USER@DOMAIN.COM --region=us-central1 \ - --display-name=my-runtime --runtime-template=my-template + $ gcloud colab runtimes create --runtime-user=USER@DOMAIN.COM \ + --region=us-central1 --display-name=my-runtime \ + --runtime-template=my-template REQUIRED FLAGS --display-name=DISPLAY_NAME @@ -106,5 +105,7 @@ 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: + + $ gcloud beta colab runtimes create diff --git a/gcloud/beta/colab-enterprise/runtimes/delete b/gcloud/colab/runtimes/delete similarity index 81% rename from gcloud/beta/colab-enterprise/runtimes/delete rename to gcloud/colab/runtimes/delete index 13703dd13..dee91edb9 100644 --- a/gcloud/beta/colab-enterprise/runtimes/delete +++ b/gcloud/colab/runtimes/delete @@ -1,18 +1,17 @@ NAME - gcloud beta colab-enterprise runtimes delete - delete a runtime + gcloud colab runtimes delete - delete a runtime SYNOPSIS - gcloud beta colab-enterprise runtimes delete (RUNTIME : --region=REGION) - [--async] [GCLOUD_WIDE_FLAG ...] + gcloud colab runtimes delete (RUNTIME : --region=REGION) [--async] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Deletes a Colab Enterprise notebook runtime. + Delete a Colab Enterprise notebook runtime. EXAMPLES To delete a runtime with id 'my-runtime' in region 'us-central1', run: - $ gcloud beta colab-enterprise runtimes delete my-runtime \ - --region=us-central1 + $ gcloud colab runtimes delete my-runtime --region=us-central1 POSITIONAL ARGUMENTS Runtime resource - Unique name of the runtime to delete. This was @@ -61,5 +60,7 @@ 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: + + $ gcloud beta colab runtimes delete diff --git a/gcloud/beta/colab-enterprise/runtimes/describe b/gcloud/colab/runtimes/describe similarity index 82% rename from gcloud/beta/colab-enterprise/runtimes/describe rename to gcloud/colab/runtimes/describe index c082cbcb8..c537d4961 100644 --- a/gcloud/beta/colab-enterprise/runtimes/describe +++ b/gcloud/colab/runtimes/describe @@ -1,18 +1,17 @@ NAME - gcloud beta colab-enterprise runtimes describe - describe a runtime + gcloud colab runtimes describe - describe a runtime SYNOPSIS - gcloud beta colab-enterprise runtimes describe (RUNTIME : --region=REGION) + gcloud colab runtimes describe (RUNTIME : --region=REGION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Describes a Colab Enterprise notebook runtime. + Describe a Colab Enterprise notebook runtime. EXAMPLES To describe a runtime with id 'my-runtime' in region 'us-central1', run: - $ gcloud beta colab-enterprise runtimes describe my-runtime \ - --region=us-central1 + $ gcloud colab runtimes describe my-runtime --region=us-central1 POSITIONAL ARGUMENTS Runtime resource - Unique name of the runtime to describe. This was @@ -56,5 +55,7 @@ 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: + + $ gcloud beta colab runtimes describe diff --git a/gcloud/colab/runtimes/help b/gcloud/colab/runtimes/help new file mode 100644 index 000000000..947a22175 --- /dev/null +++ b/gcloud/colab/runtimes/help @@ -0,0 +1,41 @@ +NAME + gcloud colab runtimes - manage Colab Enterprise runtimes + +SYNOPSIS + gcloud colab runtimes COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + For more information about runtimes, see + https://cloud.google.com/colab/docs/runtimes#runtimes + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a notebook runtime. + + delete + Delete a runtime. + + describe + Describe a runtime. + + list + List your project's runtimes. + + start + Start a stopped runtime. + + upgrade + Upgrade a runtime. + +NOTES + This variant is also available: + + $ gcloud beta colab runtimes + diff --git a/gcloud/beta/colab-enterprise/runtimes/list b/gcloud/colab/runtimes/list similarity index 85% rename from gcloud/beta/colab-enterprise/runtimes/list rename to gcloud/colab/runtimes/list index fb13ca450..6f8e84a1e 100644 --- a/gcloud/beta/colab-enterprise/runtimes/list +++ b/gcloud/colab/runtimes/list @@ -1,19 +1,18 @@ NAME - gcloud beta colab-enterprise runtimes list - list your project's runtimes + gcloud colab runtimes list - list your project's runtimes SYNOPSIS - gcloud beta colab-enterprise runtimes list [--region=REGION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + gcloud colab runtimes list [--region=REGION] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Lists your project's Colab Enterprise notebook runtimes in a given - region. + List your project's Colab Enterprise notebook runtimes in a given region. EXAMPLES To list your runtimes in region 'us-central1', run: - $ gcloud beta colab-enterprise runtimes list --region=us-central1 + $ gcloud colab runtimes list --region=us-central1 FLAGS Region resource - Cloud region for which to list all runtimes. Please see @@ -76,5 +75,7 @@ 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: + + $ gcloud beta colab runtimes list diff --git a/gcloud/beta/colab-enterprise/runtimes/start b/gcloud/colab/runtimes/start similarity index 81% rename from gcloud/beta/colab-enterprise/runtimes/start rename to gcloud/colab/runtimes/start index ec14fe3f8..6a61b205e 100644 --- a/gcloud/beta/colab-enterprise/runtimes/start +++ b/gcloud/colab/runtimes/start @@ -1,18 +1,17 @@ NAME - gcloud beta colab-enterprise runtimes start - start a stopped runtime + gcloud colab runtimes start - start a stopped runtime SYNOPSIS - gcloud beta colab-enterprise runtimes start (RUNTIME : --region=REGION) - [--async] [GCLOUD_WIDE_FLAG ...] + gcloud colab runtimes start (RUNTIME : --region=REGION) [--async] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Starts a stopped Colab Enterprise notebook runtime. + Start a stopped Colab Enterprise notebook runtime. EXAMPLES To start a runtime with id 'my-runtime' in region 'us-central1', run: - $ gcloud beta colab-enterprise runtimes start my-runtime \ - --region=us-central1 + $ gcloud colab runtimes start my-runtime --region=us-central1 POSITIONAL ARGUMENTS Runtime resource - Unique name of the runtime to start. This was @@ -61,5 +60,7 @@ 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: + + $ gcloud beta colab runtimes start diff --git a/gcloud/beta/colab-enterprise/runtimes/upgrade b/gcloud/colab/runtimes/upgrade similarity index 81% rename from gcloud/beta/colab-enterprise/runtimes/upgrade rename to gcloud/colab/runtimes/upgrade index 3e8e23634..b771ce939 100644 --- a/gcloud/beta/colab-enterprise/runtimes/upgrade +++ b/gcloud/colab/runtimes/upgrade @@ -1,18 +1,17 @@ NAME - gcloud beta colab-enterprise runtimes upgrade - upgrade a runtime + gcloud colab runtimes upgrade - upgrade a runtime SYNOPSIS - gcloud beta colab-enterprise runtimes upgrade (RUNTIME : --region=REGION) - [--async] [GCLOUD_WIDE_FLAG ...] + gcloud colab runtimes upgrade (RUNTIME : --region=REGION) [--async] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Upgrades a Colab Enterprise notebook runtime. + Upgrade a Colab Enterprise notebook runtime. EXAMPLES To upgrade a runtime with id 'my-runtime' in region 'us-central1', run: - $ gcloud beta colab-enterprise runtimes upgrade my-runtime \ - --region=us-central1 + $ gcloud colab runtimes upgrade my-runtime --region=us-central1 POSITIONAL ARGUMENTS Runtime resource - Unique name of the runtime to upgrade. This was @@ -61,5 +60,7 @@ 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: + + $ gcloud beta colab runtimes upgrade diff --git a/gcloud/beta/colab-enterprise/schedules/create b/gcloud/colab/schedules/create similarity index 96% rename from gcloud/beta/colab-enterprise/schedules/create rename to gcloud/colab/schedules/create index 15fb923b9..d1bf8ec0d 100644 --- a/gcloud/beta/colab-enterprise/schedules/create +++ b/gcloud/colab/schedules/create @@ -1,8 +1,8 @@ NAME - gcloud beta colab-enterprise schedules create - create a schedule + gcloud colab schedules create - create a schedule SYNOPSIS - gcloud beta colab-enterprise schedules create + gcloud colab schedules create (--cron-schedule=CRON_SCHEDULE --display-name=DISPLAY_NAME (--execution-display-name=EXECUTION_DISPLAY_NAME --gcs-output-uri=GCS_OUTPUT_URI @@ -18,7 +18,7 @@ SYNOPSIS [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Create a schedule to run a Colab Enterprise notebook execution job. + Create a schedule to run a Colab Enterprise notebook execution job. EXAMPLES To create a schedule in region us-central1 with the following schedule @@ -37,8 +37,8 @@ EXAMPLES my-service-account@my-project.iam.gserviceaccount.com, ▪ with results uploaded to Cloud Storage bucket gs://my-bucket/results - Run the following command: $ gcloud beta colab-enterprise schedules create \ - --region=us-central1 --display-name=my-schedule \ + Run the following command: $ gcloud colab schedules create --region=us-central1 \ + --display-name=my-schedule \ --cron-schedule='TZ=America/Los_Angeles * * * * *' \ --max-concurrent-runs=1 --start-time=2025-01-01T00:00:00-06:00 \ --execution-display-name=my-execution \ @@ -241,5 +241,7 @@ 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: + + $ gcloud beta colab schedules create diff --git a/gcloud/beta/colab-enterprise/schedules/delete b/gcloud/colab/schedules/delete similarity index 80% rename from gcloud/beta/colab-enterprise/schedules/delete rename to gcloud/colab/schedules/delete index 6013188fb..43338763b 100644 --- a/gcloud/beta/colab-enterprise/schedules/delete +++ b/gcloud/colab/schedules/delete @@ -1,18 +1,17 @@ NAME - gcloud beta colab-enterprise schedules delete - delete a schedule + gcloud colab schedules delete - delete a schedule SYNOPSIS - gcloud beta colab-enterprise schedules delete (SCHEDULE : --region=REGION) - [--async] [GCLOUD_WIDE_FLAG ...] + gcloud colab schedules delete (SCHEDULE : --region=REGION) [--async] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Delete a Colab Enterprise notebook execution schedule. + Delete a Colab Enterprise notebook execution schedule. EXAMPLES To delete a schedule with id my-schedule, in region us-central1, run: - $ gcloud beta colab-enterprise schedules delete my-schedule \ - --region=us-central1 + $ gcloud colab schedules delete my-schedule --region=us-central1 POSITIONAL ARGUMENTS Schedule resource - Unique, system-generated resource name of the schedule @@ -60,5 +59,7 @@ 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: + + $ gcloud beta colab schedules delete diff --git a/gcloud/beta/colab-enterprise/schedules/describe b/gcloud/colab/schedules/describe similarity index 79% rename from gcloud/beta/colab-enterprise/schedules/describe rename to gcloud/colab/schedules/describe index 3361ea970..6d1643dc1 100644 --- a/gcloud/beta/colab-enterprise/schedules/describe +++ b/gcloud/colab/schedules/describe @@ -1,18 +1,17 @@ NAME - gcloud beta colab-enterprise schedules describe - describe a schedule + gcloud colab schedules describe - describe a schedule SYNOPSIS - gcloud beta colab-enterprise schedules describe - (SCHEDULE : --region=REGION) [GCLOUD_WIDE_FLAG ...] + gcloud colab schedules describe (SCHEDULE : --region=REGION) + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Describe a Colab Enterprise notebook execution schedule. + Describe a Colab Enterprise notebook execution schedule. EXAMPLES To describe a schedule with id my-schedule in region us-central1, run: - $ gcloud beta colab-enterprise schedules describe my-schedule \ - --region=us-central1 + $ gcloud colab schedules describe my-schedule --region=us-central1 POSITIONAL ARGUMENTS Schedule resource - Unique, system-generated resource name of the schedule @@ -55,5 +54,7 @@ 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: + + $ gcloud beta colab schedules describe diff --git a/gcloud/colab/schedules/help b/gcloud/colab/schedules/help new file mode 100644 index 000000000..8de82eccc --- /dev/null +++ b/gcloud/colab/schedules/help @@ -0,0 +1,45 @@ +NAME + gcloud colab schedules - manage Colab Enterprise notebook execution + schedules + +SYNOPSIS + gcloud colab schedules COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + For more information about schedules, see + https://cloud.google.com/colab/docs/schedule-notebook-run. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a schedule. + + delete + Delete a schedule. + + describe + Describe a schedule. + + list + List your Colab Enterprise notebook execution schedules. + + pause + Pause a schedule. + + resume + Resume a schedule. + + update + Update a schedule. + +NOTES + This variant is also available: + + $ gcloud beta colab schedules + diff --git a/gcloud/beta/colab-enterprise/schedules/list b/gcloud/colab/schedules/list similarity index 83% rename from gcloud/beta/colab-enterprise/schedules/list rename to gcloud/colab/schedules/list index fce52e6ea..ef014542f 100644 --- a/gcloud/beta/colab-enterprise/schedules/list +++ b/gcloud/colab/schedules/list @@ -1,20 +1,20 @@ NAME - gcloud beta colab-enterprise schedules list - list your Colab Enterprise - notebook execution schedules + gcloud colab schedules list - list your Colab Enterprise notebook execution + schedules SYNOPSIS - gcloud beta colab-enterprise schedules list [--region=REGION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + gcloud colab schedules list [--region=REGION] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) List your project's Colab Enterprise notebook execution schedules in - a given region. + List your project's Colab Enterprise notebook execution schedules in a + given region. EXAMPLES To list your schedules in region us-central1, run: - $ gcloud beta colab-enterprise schedules list --region=us-central1 + $ gcloud colab schedules list --region=us-central1 FLAGS Region resource - Cloud region for which to list all schedules. This @@ -76,5 +76,7 @@ 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: + + $ gcloud beta colab schedules list diff --git a/gcloud/beta/colab-enterprise/schedules/pause b/gcloud/colab/schedules/pause similarity index 81% rename from gcloud/beta/colab-enterprise/schedules/pause rename to gcloud/colab/schedules/pause index a1d5227f0..479e89413 100644 --- a/gcloud/beta/colab-enterprise/schedules/pause +++ b/gcloud/colab/schedules/pause @@ -1,18 +1,17 @@ NAME - gcloud beta colab-enterprise schedules pause - pause a schedule + gcloud colab schedules pause - pause a schedule SYNOPSIS - gcloud beta colab-enterprise schedules pause (SCHEDULE : --region=REGION) + gcloud colab schedules pause (SCHEDULE : --region=REGION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Pause a Colab Enterprise notebook execution schedule. + Pause a Colab Enterprise notebook execution schedule. EXAMPLES To pause a schedule with id my-schedule, in region us-central1, run: - $ gcloud beta colab-enterprise schedules pause my-schedule \ - --region=us-central1 + $ gcloud colab schedules pause my-schedule --region=us-central1 POSITIONAL ARGUMENTS Schedule resource - Unique, system-generated resource name of the schedule @@ -55,5 +54,7 @@ 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: + + $ gcloud beta colab schedules pause diff --git a/gcloud/beta/colab-enterprise/schedules/resume b/gcloud/colab/schedules/resume similarity index 83% rename from gcloud/beta/colab-enterprise/schedules/resume rename to gcloud/colab/schedules/resume index bfb883191..d00b73a94 100644 --- a/gcloud/beta/colab-enterprise/schedules/resume +++ b/gcloud/colab/schedules/resume @@ -1,19 +1,18 @@ NAME - gcloud beta colab-enterprise schedules resume - resume a schedule + gcloud colab schedules resume - resume a schedule SYNOPSIS - gcloud beta colab-enterprise schedules resume (SCHEDULE : --region=REGION) + gcloud colab schedules resume (SCHEDULE : --region=REGION) [--enable-catch-up] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Resume a Colab Enterprise notebook execution schedule. + Resume a Colab Enterprise notebook execution schedule. EXAMPLES To resume a paused schedule with id my-schedule, in region us-central1, run: - $ gcloud beta colab-enterprise schedules resume my-schedule \ - --region=us-central1 + $ gcloud colab schedules resume my-schedule --region=us-central1 POSITIONAL ARGUMENTS Schedule resource - Unique, system-generated resource name of the schedule @@ -62,5 +61,7 @@ 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: + + $ gcloud beta colab schedules resume diff --git a/gcloud/beta/colab-enterprise/schedules/update b/gcloud/colab/schedules/update similarity index 91% rename from gcloud/beta/colab-enterprise/schedules/update rename to gcloud/colab/schedules/update index 09a5f0b01..450eea6ae 100644 --- a/gcloud/beta/colab-enterprise/schedules/update +++ b/gcloud/colab/schedules/update @@ -1,22 +1,21 @@ NAME - gcloud beta colab-enterprise schedules update - update a schedule + gcloud colab schedules update - update a schedule SYNOPSIS - gcloud beta colab-enterprise schedules update (SCHEDULE : --region=REGION) + gcloud colab schedules update (SCHEDULE : --region=REGION) (--cron-schedule=CRON_SCHEDULE --display-name=DISPLAY_NAME --enable-queueing --end-time=END_TIME --max-concurrent-runs=MAX_CONCURRENT_RUNS --max-runs=MAX_RUNS --start-time=START_TIME) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Update a Colab Enterprise notebook execution schedule. + Update a Colab Enterprise notebook execution schedule. EXAMPLES To update the cron schedule and max runs of a schedule with id my-schedule, in region us-central1, run: - $ gcloud beta colab-enterprise schedules update my-schedule \ - --region=us-central1 \ + $ gcloud colab schedules update my-schedule --region=us-central1 \ --cron-schedule='TZ=America/Los_Angeles 0 0 * * 0' --max-runs=2 POSITIONAL ARGUMENTS @@ -106,5 +105,7 @@ 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: + + $ gcloud beta colab schedules update diff --git a/gcloud/compute/instance-groups/managed/create b/gcloud/compute/instance-groups/managed/create index 224366f1f..70ff927a1 100644 --- a/gcloud/compute/instance-groups/managed/create +++ b/gcloud/compute/instance-groups/managed/create @@ -8,6 +8,9 @@ SYNOPSIS [--default-action-on-vm-failure=ACTION_ON_VM_FAILURE] [--description=DESCRIPTION] [--[no-]force-update-on-repair] [--initial-delay=INITIAL_DELAY] [--instance-redistribution-type=TYPE] + [--instance-selection=name=NAME, + machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK]] + [--instance-selection-machine-types=[MACHINE_TYPE,...]] [--list-managed-instances-results=MODE] [--stateful-disk=[auto-delete=AUTO-DELETE],[device-name=DEVICE-NAME]] [--stateful-external-ip=[enabled], @@ -126,6 +129,15 @@ OPTIONAL FLAGS The managed instance group proactively redistributes instances to meet its target distribution. + --instance-selection=name=NAME,machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK] + Named selection of machine types with an optional rank. For example, + --instance-selection="name=instance-selection-1,machine-type=e2-standard-8,machine-type=t2d-standard-8,rank=0" + + --instance-selection-machine-types=[MACHINE_TYPE,...] + Machine types that are used to create VMs in the managed instance + group. If not provided, the machine type specified in the instance + template is used. + --list-managed-instances-results=MODE Pagination behavior for the group's listManagedInstances API method. This flag does not affect the group's gcloud or console list-instances diff --git a/gcloud/compute/instance-groups/managed/update b/gcloud/compute/instance-groups/managed/update index f64c4351b..c72603350 100644 --- a/gcloud/compute/instance-groups/managed/update +++ b/gcloud/compute/instance-groups/managed/update @@ -7,7 +7,12 @@ SYNOPSIS [--default-action-on-vm-failure=ACTION_ON_VM_FAILURE] [--description=DESCRIPTION] [--[no-]force-update-on-repair] [--instance-redistribution-type=TYPE] + [--instance-selection=name=NAME, + machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK]] + [--instance-selection-machine-types=[MACHINE_TYPE,...]] [--list-managed-instances-results=MODE] + [--remove-instance-selections=[INSTANCE_SELECTION_NAME,...]] + [--remove-instance-selections-all] [--remove-stateful-disks=DEVICE_NAME,[DEVICE_NAME,...]] [--remove-stateful-external-ips=INTERFACE_NAME,[...]] [--remove-stateful-internal-ips=INTERFACE_NAME,[...]] [--size=SIZE] @@ -105,6 +110,15 @@ FLAGS The managed instance group proactively redistributes instances to meet its target distribution. + --instance-selection=name=NAME,machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK] + Named selection of machine types with an optional rank. For example, + --instance-selection="name=instance-selection-1,machine-type=e2-standard-8,machine-type=t2d-standard-8,rank=0" + + --instance-selection-machine-types=[MACHINE_TYPE,...] + Machine types that are used to create VMs in the managed instance + group. If not provided, the machine type specified in the instance + template is used. + --list-managed-instances-results=MODE Pagination behavior for the group's listManagedInstances API method. This flag does not affect the group's gcloud or console list-instances @@ -118,6 +132,13 @@ FLAGS Pagination is enabled for the group's listManagedInstances API method. maxResults and pageToken query parameters are respected. + --remove-instance-selections=[INSTANCE_SELECTION_NAME,...] + Remove specific instance selections from the instance flexibility + policy. + + --remove-instance-selections-all + Remove all instance selections from the instance flexibility policy. + --remove-stateful-disks=DEVICE_NAME,[DEVICE_NAME,...] Remove stateful configuration for the specified disks. diff --git a/gcloud/compute/instance-templates/create b/gcloud/compute/instance-templates/create index c5f32e383..83e7d47dd 100644 --- a/gcloud/compute/instance-templates/create +++ b/gcloud/compute/instance-templates/create @@ -1051,7 +1051,7 @@ FLAGS practice to use --image-family when the latest version of an image is needed. - By default, debian-11 is assumed for this flag. + By default, debian-12 is assumed for this flag. Sole Tenancy. diff --git a/gcloud/compute/instance-templates/create-with-container b/gcloud/compute/instance-templates/create-with-container index ed36e4ecf..a25b34740 100644 --- a/gcloud/compute/instance-templates/create-with-container +++ b/gcloud/compute/instance-templates/create-with-container @@ -812,7 +812,7 @@ FLAGS practice to use --image-family when the latest version of an image is needed. - By default, debian-11 is assumed for this flag. + By default, debian-12 is assumed for this flag. Specifies the reservation for instances created from this template. diff --git a/gcloud/compute/instances/bulk/create b/gcloud/compute/instances/bulk/create index f6d1590ad..db2e28d2c 100644 --- a/gcloud/compute/instances/bulk/create +++ b/gcloud/compute/instances/bulk/create @@ -975,7 +975,7 @@ OPTIONAL FLAGS practice to use --image-family when the latest version of an image is needed. - By default, debian-11 is assumed for this flag. + By default, debian-12 is assumed for this flag. --source-snapshot=SOURCE_SNAPSHOT The name of the source disk snapshot that the instance boot disk will diff --git a/gcloud/compute/instances/create b/gcloud/compute/instances/create index fe9f2b542..65586f08f 100644 --- a/gcloud/compute/instances/create +++ b/gcloud/compute/instances/create @@ -1176,7 +1176,7 @@ FLAGS practice to use --image-family when the latest version of an image is needed. - By default, debian-11 is assumed for this flag. + By default, debian-12 is assumed for this flag. --source-snapshot=SOURCE_SNAPSHOT The name of the source disk snapshot that the instance boot disk will diff --git a/gcloud/compute/instances/create-with-container b/gcloud/compute/instances/create-with-container index d6e0116c2..09d72d093 100644 --- a/gcloud/compute/instances/create-with-container +++ b/gcloud/compute/instances/create-with-container @@ -1001,7 +1001,7 @@ FLAGS practice to use --image-family when the latest version of an image is needed. - By default, debian-11 is assumed for this flag. + By default, debian-12 is assumed for this flag. At most one of these can be specified: diff --git a/gcloud/config/get b/gcloud/config/get index b5dec87c1..956e8448e 100644 --- a/gcloud/config/get +++ b/gcloud/config/get @@ -1028,6 +1028,12 @@ AVAILABLE PROPERTIES When a region is required but not provided by a flag, the command will fall back to this value, if set. + lustre + location + Default location to use when working with Cloud Lustre resources. + When a location value is required but not provided, the command + will fall back to this value, if set. + media_asset location Default location to use when working with Cloud Media Asset diff --git a/gcloud/config/help b/gcloud/config/help index 487e8e61a..33d917f03 100644 --- a/gcloud/config/help +++ b/gcloud/config/help @@ -1060,6 +1060,12 @@ AVAILABLE PROPERTIES When a region is required but not provided by a flag, the command will fall back to this value, if set. + lustre + location + Default location to use when working with Cloud Lustre resources. + When a location value is required but not provided, the command + will fall back to this value, if set. + media_asset location Default location to use when working with Cloud Media Asset diff --git a/gcloud/config/list b/gcloud/config/list index 94ba4985b..3d6f5a703 100644 --- a/gcloud/config/list +++ b/gcloud/config/list @@ -1072,6 +1072,12 @@ AVAILABLE PROPERTIES When a region is required but not provided by a flag, the command will fall back to this value, if set. + lustre + location + Default location to use when working with Cloud Lustre resources. + When a location value is required but not provided, the command + will fall back to this value, if set. + media_asset location Default location to use when working with Cloud Media Asset diff --git a/gcloud/config/set b/gcloud/config/set index 5fd27037b..f30e1215e 100644 --- a/gcloud/config/set +++ b/gcloud/config/set @@ -1075,6 +1075,12 @@ AVAILABLE PROPERTIES When a region is required but not provided by a flag, the command will fall back to this value, if set. + lustre + location + Default location to use when working with Cloud Lustre resources. + When a location value is required but not provided, the command + will fall back to this value, if set. + media_asset location Default location to use when working with Cloud Media Asset diff --git a/gcloud/config/unset b/gcloud/config/unset index 78a885a74..b2c7fb6ad 100644 --- a/gcloud/config/unset +++ b/gcloud/config/unset @@ -1036,6 +1036,12 @@ AVAILABLE PROPERTIES When a region is required but not provided by a flag, the command will fall back to this value, if set. + lustre + location + Default location to use when working with Cloud Lustre resources. + When a location value is required but not provided, the command + will fall back to this value, if set. + media_asset location Default location to use when working with Cloud Media Asset diff --git a/gcloud/container/clusters/update b/gcloud/container/clusters/update index 4d95a8745..1e1882ddb 100644 --- a/gcloud/container/clusters/update +++ b/gcloud/container/clusters/update @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud container clusters update NAME - (--autoprovisioning-enable-insecure-kubelet-readonly-port + (--autoprovisioning-cgroup-mode=AUTOPROVISIONING_CGROUP_MODE + | --autoprovisioning-enable-insecure-kubelet-readonly-port | --autoprovisioning-network-tags=[TAGS,...] | --autoprovisioning-resource-manager-tags=[KEY=VALUE,...] | --autoscaling-profile=AUTOSCALING_PROFILE | --clear-fleet-project @@ -121,6 +122,32 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS Exactly one of these must be specified: + --autoprovisioning-cgroup-mode=AUTOPROVISIONING_CGROUP_MODE + Sets the cgroup mode for auto-provisioned nodes. + + Updating this flag triggers an update using surge upgrades of all + existing auto-provisioned nodes to apply the new value of cgroup + mode. + + For an Autopilot cluster, the specified cgroup mode will be set on + all existing and new nodes in the cluster. For a Standard cluster, + the specified cgroup mode will be set on all existing and new + auto-provisioned node pools in the cluster. + + If not set, GKE uses cgroupv2 for new nodes when the cluster was + created running 1.26 or later, and cgroupv1 for clusters created + running 1.25 or earlier. To check your initial cluster version, run + gcloud container clusters describe [NAME] + --format="value(initialClusterVersion)" + + For clusters created running version 1.26 or later, you can't set the + cgroup mode to v1. + + To learn more, see: + https://cloud.google.com/kubernetes-engine/docs/how-to/migrate-cgroupv2. + + AUTOPROVISIONING_CGROUP_MODE must be one of: default, v1, v2. + --autoprovisioning-enable-insecure-kubelet-readonly-port Enables the Kubelet's insecure read only port for Autoprovisioned Node Pools. diff --git a/gcloud/container/vmware/admin-clusters/update b/gcloud/container/vmware/admin-clusters/update index 1118044c9..6e8889ac6 100644 --- a/gcloud/container/vmware/admin-clusters/update +++ b/gcloud/container/vmware/admin-clusters/update @@ -6,7 +6,7 @@ SYNOPSIS gcloud container vmware admin-clusters update (ADMIN_CLUSTER : --location=LOCATION) [--async] [--required-platform-version=REQUIRED_PLATFORM_VERSION] - [GCLOUD_WIDE_FLAG ...] + [--version=VERSION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update an Anthos on VMware admin cluster. @@ -61,6 +61,9 @@ FLAGS version will be updated to the required version. If it is not installed in the platform, download the required version bundle. + --version=VERSION + Anthos Cluster on VMware version for the user cluster resource + 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/managed-kafka/clusters/create b/gcloud/managed-kafka/clusters/create new file mode 100644 index 000000000..c700320bc --- /dev/null +++ b/gcloud/managed-kafka/clusters/create @@ -0,0 +1,117 @@ +NAME + gcloud managed-kafka clusters create - create a Managed Service for Apache + Kafka cluster + +SYNOPSIS + gcloud managed-kafka clusters create (CLUSTER : --location=LOCATION) + --cpu=CPU --memory=MEMORY --subnets=[SUBNETS,...] [--async] + [--no-auto-rebalance] [--encryption-key=ENCRYPTION_KEY] + [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a Managed Service for Apache Kafka cluster. + +EXAMPLES + To create a cluster, run the following: + + $ gcloud managed-kafka clusters create mycluster \ + --location=us-central1 --cpu=3 --memory=3GiB \ + --subnets=projects/PROJECT_ID/regions/us-central1/subnetworks/\ + default + +POSITIONAL ARGUMENTS + Cluster resource - Identifies the cluster for which the command runs. 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 cluster 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. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + + To set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + ID of the location of the Managed Service for Apache Kafka resource. + See + https://cloud.google.com/managed-service-for-apache-kafka/docs/locations + for a list of supported locations. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --cpu=CPU + The number of vCPUs to provision for the cluster. The minimum is 3. + + --memory=MEMORY + The memory to provision for the cluster in bytes. The value must be + between 1 GiB and 8 GiB per vCPU. Ex. 1024Mi, 4Gi. + + --subnets=[SUBNETS,...] + VPC subnets from which the cluster is accessible. Both broker and + bootstrap server IP addresses and DNS entries are automatically created + in each subnet. The subnet must be located in the same region as the + cluster. The project may differ. A minimum of 1 subnet is required. A + maximum of 10 subnets can be specified. Use commas to separate multiple + subnets. The name of the subnet must be in the format + projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --auto-rebalance + Whether the automatic rebalancing is enabled. If automatic rebalancing + is enabled, topic partitions are rebalanced among brokers when the + number of CPUs in the cluster changes. Automatic rebalancing is enabled + by default. Use --no-auto-rebalance to disable this flag. Enabled by + default, use --no-auto-rebalance to disable. + + --encryption-key=ENCRYPTION_KEY + The relative resource path of the Cloud KMS key to use for encryption + in the form: + projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY. + The key must be located in the same region as the cluster. The key + cannot be changed once set. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. Keys must start with a lowercase + character and contain only hyphens (-), underscores (_), lowercase + characters, and numbers. Values must contain only hyphens (-), + underscores (_), lowercase characters, and numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the managedkafka/v1 API. The full documentation for this + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs + +NOTES + These variants are also available: + + $ gcloud alpha managed-kafka clusters create + + $ gcloud beta managed-kafka clusters create + diff --git a/gcloud/managed-kafka/clusters/delete b/gcloud/managed-kafka/clusters/delete new file mode 100644 index 000000000..a9b520d63 --- /dev/null +++ b/gcloud/managed-kafka/clusters/delete @@ -0,0 +1,77 @@ +NAME + gcloud managed-kafka clusters delete - delete a Managed Service for Apache + Kafka cluster + +SYNOPSIS + gcloud managed-kafka clusters delete (CLUSTER : --location=LOCATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a Managed Service for Apache Kafka cluster. + +EXAMPLES + To delete a cluster named mycluster located in us-central1, run the + following: + + $ gcloud managed-kafka clusters delete mycluster \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Cluster resource - Identifies the cluster for deletion. 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 cluster 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. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + + To set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + ID of the location of the Managed Service for Apache Kafka resource. + See + https://cloud.google.com/managed-service-for-apache-kafka/docs/locations + for a list of supported locations. + + To set the location attribute: + ▸ provide the argument cluster 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 managedkafka/v1 API. The full documentation for this + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs + +NOTES + These variants are also available: + + $ gcloud alpha managed-kafka clusters delete + + $ gcloud beta managed-kafka clusters delete + diff --git a/gcloud/managed-kafka/clusters/describe b/gcloud/managed-kafka/clusters/describe new file mode 100644 index 000000000..57a7015ab --- /dev/null +++ b/gcloud/managed-kafka/clusters/describe @@ -0,0 +1,72 @@ +NAME + gcloud managed-kafka clusters describe - describe a Managed Service for + Apache Kafka cluster + +SYNOPSIS + gcloud managed-kafka clusters describe (CLUSTER : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a Managed Service for Apache Kafka cluster. + +EXAMPLES + To describe a cluster named mycluster located in us-central1, run the + following: + + $ gcloud managed-kafka clusters describe mycluster \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Cluster resource - Identifies the cluster for details to be displayed. 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 cluster 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. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + + To set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + ID of the location of the Managed Service for Apache Kafka resource. + See + https://cloud.google.com/managed-service-for-apache-kafka/docs/locations + for a list of supported locations. + + To set the location attribute: + ▸ provide the argument cluster 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 managedkafka/v1 API. The full documentation for this + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs + +NOTES + These variants are also available: + + $ gcloud alpha managed-kafka clusters describe + + $ gcloud beta managed-kafka clusters describe + diff --git a/gcloud/managed-kafka/clusters/help b/gcloud/managed-kafka/clusters/help new file mode 100644 index 000000000..4a263bc20 --- /dev/null +++ b/gcloud/managed-kafka/clusters/help @@ -0,0 +1,40 @@ +NAME + gcloud managed-kafka clusters - administer Managed Service for Apache Kafka + clusters + +SYNOPSIS + gcloud managed-kafka clusters COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Administer Managed Service for Apache Kafka clusters. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a Managed Service for Apache Kafka cluster. + + delete + Delete a Managed Service for Apache Kafka cluster. + + describe + Describe a Managed Service for Apache Kafka cluster. + + list + List all Managed Service for Apache Kafka clusters in a given location. + + update + Update a Managed Service for Apache Kafka cluster. + +NOTES + These variants are also available: + + $ gcloud alpha managed-kafka clusters + + $ gcloud beta managed-kafka clusters + diff --git a/gcloud/managed-kafka/clusters/list b/gcloud/managed-kafka/clusters/list new file mode 100644 index 000000000..e19eee1ab --- /dev/null +++ b/gcloud/managed-kafka/clusters/list @@ -0,0 +1,84 @@ +NAME + gcloud managed-kafka clusters list - list all Managed Service for Apache + Kafka clusters in a given location + +SYNOPSIS + gcloud managed-kafka clusters list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all Apache Kafka for BigQuery clusters in a given location. To specify + the maximum number of clusters to list, use the --limit flag. + +EXAMPLES + To list all clusters in a given location, such as us-central1, run the + following: + + $ gcloud managed-kafka clusters list --location=us-central1 + +REQUIRED FLAGS + Location resource - Identifies the region which contains all the clusters + to be listed. 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 + 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 managedkafka/v1 API. The full documentation for this + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs + +NOTES + These variants are also available: + + $ gcloud alpha managed-kafka clusters list + + $ gcloud beta managed-kafka clusters list + diff --git a/gcloud/managed-kafka/clusters/update b/gcloud/managed-kafka/clusters/update new file mode 100644 index 000000000..46dcdc4c7 --- /dev/null +++ b/gcloud/managed-kafka/clusters/update @@ -0,0 +1,110 @@ +NAME + gcloud managed-kafka clusters update - update a Managed Service for Apache + Kafka cluster + +SYNOPSIS + gcloud managed-kafka clusters update (CLUSTER : --location=LOCATION) + (--auto-rebalance --cpu=CPU + --labels=[KEY=VALUE,...] --memory=MEMORY --subnets=[SUBNETS,...]) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a Managed Service for Apache Kafka cluster. + +EXAMPLES + To update an attribute in a cluster named mycluster located in us-central1, + such as the CPU, run the following: + + $ gcloud managed-kafka clusters update mycluster \ + --location=us-central1 --cpu=3 + +POSITIONAL ARGUMENTS + Cluster resource - Identifies the cluster to be updated. 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 cluster 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. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + + To set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + ID of the location of the Managed Service for Apache Kafka resource. + See + https://cloud.google.com/managed-service-for-apache-kafka/docs/locations + for a list of supported locations. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + At least one of these must be specified: + + --auto-rebalance + Whether the automatic rebalancing is enabled. If automatic + rebalancing is enabled, topic partitions are rebalanced among brokers + when the number of CPUs in the cluster changes. Automatic rebalancing + is enabled by default. Use --no-auto-rebalance to disable this flag. + + --cpu=CPU + The number of vCPUs to provision for the cluster. The minimum is 3. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. Keys must start with a + lowercase character and contain only hyphens (-), underscores (_), + lowercase characters, and numbers. Values must contain only hyphens + (-), underscores (_), lowercase characters, and numbers. + + --memory=MEMORY + The memory to provision for the cluster in bytes. The value must be + between 1 GiB and 8 GiB per vCPU. Ex. 1024Mi, 4Gi. + + --subnets=[SUBNETS,...] + VPC subnets from which the cluster is accessible. Both broker and + bootstrap server IP addresses and DNS entries are automatically + created in each subnet. The subnet must be located in the same region + as the cluster. The project may differ. A minimum of 1 subnet is + required. A maximum of 10 subnets can be specified. Use commas to + separate multiple subnets. The name of the subnet must be in the + format projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET. + +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 managedkafka/v1 API. The full documentation for this + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs + +NOTES + These variants are also available: + + $ gcloud alpha managed-kafka clusters update + + $ gcloud beta managed-kafka clusters update + diff --git a/gcloud/managed-kafka/consumer-groups/delete b/gcloud/managed-kafka/consumer-groups/delete new file mode 100644 index 000000000..79f22a4fa --- /dev/null +++ b/gcloud/managed-kafka/consumer-groups/delete @@ -0,0 +1,82 @@ +NAME + gcloud managed-kafka consumer-groups delete - delete a Managed Service for + Apache Kafka consumer group + +SYNOPSIS + gcloud managed-kafka consumer-groups delete + (CONSUMER_GROUP : --cluster=CLUSTER --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a Managed Service for Apache Kafka consumer group. + +EXAMPLES + To delete a consumer group in a cluster named mycluster located in + us-central1, run the following: + + $ gcloud managed-kafka consumer-groups delete myconsumergroup \ + --cluster=mycluster --location=us-central1 + +POSITIONAL ARGUMENTS + Consumer group resource - Identifies the consumer group for deletion. 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 consumer_group 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. + + CONSUMER_GROUP + ID of the consumer_group or fully qualified identifier for the + consumer_group. + + To set the consumer_group attribute: + ▸ provide the argument consumer_group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The cluster name. + + To set the cluster attribute: + ▸ provide the argument consumer_group on the command line with a + fully specified name; + ▸ provide the argument --cluster on the command line. + + --location=LOCATION + ID of the location of the Managed Service for Apache Kafka resource. + See + https://cloud.google.com/managed-service-for-apache-kafka/docs/locations + for a list of supported locations. + + To set the location attribute: + ▸ provide the argument consumer_group 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 managedkafka/v1 API. The full documentation for this + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs + +NOTES + These variants are also available: + + $ gcloud alpha managed-kafka consumer-groups delete + + $ gcloud beta managed-kafka consumer-groups delete + diff --git a/gcloud/managed-kafka/consumer-groups/describe b/gcloud/managed-kafka/consumer-groups/describe new file mode 100644 index 000000000..d898a0cb6 --- /dev/null +++ b/gcloud/managed-kafka/consumer-groups/describe @@ -0,0 +1,82 @@ +NAME + gcloud managed-kafka consumer-groups describe - describe a Managed Service + for Apache Kafka consumer group + +SYNOPSIS + gcloud managed-kafka consumer-groups describe + (CONSUMER_GROUP : --cluster=CLUSTER --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a Managed Service for Apache Kafka consumer group. + +EXAMPLES + To describe a consumer group in a cluster named mycluster located in + us-central1, run the following: + + $ gcloud managed-kafka consumer-groups describe myconsumergroup \ + --cluster=mycluster --location=us-central1 + +POSITIONAL ARGUMENTS + Consumer group resource - Identifies the consumer group for details to be + displayed. 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 consumer_group 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. + + CONSUMER_GROUP + ID of the consumer_group or fully qualified identifier for the + consumer_group. + + To set the consumer_group attribute: + ▸ provide the argument consumer_group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The cluster name. + + To set the cluster attribute: + ▸ provide the argument consumer_group on the command line with a + fully specified name; + ▸ provide the argument --cluster on the command line. + + --location=LOCATION + ID of the location of the Managed Service for Apache Kafka resource. + See + https://cloud.google.com/managed-service-for-apache-kafka/docs/locations + for a list of supported locations. + + To set the location attribute: + ▸ provide the argument consumer_group 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 managedkafka/v1 API. The full documentation for this + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs + +NOTES + These variants are also available: + + $ gcloud alpha managed-kafka consumer-groups describe + + $ gcloud beta managed-kafka consumer-groups describe + diff --git a/gcloud/managed-kafka/consumer-groups/help b/gcloud/managed-kafka/consumer-groups/help new file mode 100644 index 000000000..c96f6f6dc --- /dev/null +++ b/gcloud/managed-kafka/consumer-groups/help @@ -0,0 +1,38 @@ +NAME + gcloud managed-kafka consumer-groups - administer Managed Service for + Apache Kafka consumer groups + +SYNOPSIS + gcloud managed-kafka consumer-groups COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Administer Managed Service for Apache Kafka consumer groups. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + Delete a Managed Service for Apache Kafka consumer group. + + describe + Describe a Managed Service for Apache Kafka consumer group. + + list + List all Managed Service for Apache Kafka consumer groups in a given + cluster and location. + + update + Update a Managed Service for Apache Kafka consumer group. + +NOTES + These variants are also available: + + $ gcloud alpha managed-kafka consumer-groups + + $ gcloud beta managed-kafka consumer-groups + diff --git a/gcloud/managed-kafka/consumer-groups/list b/gcloud/managed-kafka/consumer-groups/list new file mode 100644 index 000000000..de4b0593e --- /dev/null +++ b/gcloud/managed-kafka/consumer-groups/list @@ -0,0 +1,101 @@ +NAME + gcloud managed-kafka consumer-groups list - list all Managed Service for + Apache Kafka consumer groups in a given cluster and location + +SYNOPSIS + gcloud managed-kafka consumer-groups list (CLUSTER : --location=LOCATION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all Managed Service for Apache Kafka consumer groups in a given + cluster and location. To specify the maximum number of consumer groups to + list, use the --limit flag. + +EXAMPLES + To list all consumer groups in a cluster named mycluster located in + us-central1, run the following: + + $ gcloud managed-kafka consumer-groups list mycluster \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Cluster resource - Identifies the cluster which contains all the consumer + groups to be listed. 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 cluster 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. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + + To set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + ID of the location of the Managed Service for Apache Kafka resource. + See + https://cloud.google.com/managed-service-for-apache-kafka/docs/locations + for a list of supported locations. + + To set the location attribute: + ▸ provide the argument cluster 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 managedkafka/v1 API. The full documentation for this + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs + +NOTES + These variants are also available: + + $ gcloud alpha managed-kafka consumer-groups list + + $ gcloud beta managed-kafka consumer-groups list + diff --git a/gcloud/managed-kafka/consumer-groups/update b/gcloud/managed-kafka/consumer-groups/update new file mode 100644 index 000000000..da49f0823 --- /dev/null +++ b/gcloud/managed-kafka/consumer-groups/update @@ -0,0 +1,106 @@ +NAME + gcloud managed-kafka consumer-groups update - update a Managed Service for + Apache Kafka consumer group + +SYNOPSIS + gcloud managed-kafka consumer-groups update + (CONSUMER_GROUP : --cluster=CLUSTER --location=LOCATION) + --topics-file=JSON|YAML|FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a Managed Service for Apache Kafka consumer group. + +EXAMPLES + To specify a file for updating the topics of a consumer group, run the + following: + + $gcloud managed-kafka consumer-groups update myconsumergroup | + --cluster=mycluster \ + --location=us-central1 \ + --topics-file=topics.json + + To update the topics of a consumer group with inline JSON, run the + following: + + $gcloud managed-kafka consumer-groups update myconsumergroup | + --cluster=mycluster \ + --location=us-central1 \ + --topics-file='{"topic":{"partitions":{"0":{"offset":1,"metadata":"metadata"}}}}' + +POSITIONAL ARGUMENTS + Consumer group resource - Identifies the consumer group to be updated. 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 consumer_group 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. + + CONSUMER_GROUP + ID of the consumer_group or fully qualified identifier for the + consumer_group. + + To set the consumer_group attribute: + ▸ provide the argument consumer_group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The cluster name. + + To set the cluster attribute: + ▸ provide the argument consumer_group on the command line with a + fully specified name; + ▸ provide the argument --cluster on the command line. + + --location=LOCATION + ID of the location of the Managed Service for Apache Kafka resource. + See + https://cloud.google.com/managed-service-for-apache-kafka/docs/locations + for a list of supported locations. + + To set the location attribute: + ▸ provide the argument consumer_group on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --topics-file=JSON|YAML|FILE + The path to the JSON or YAML file containing the configuration of the + topics to be updated for the consumer group. This also supports inline + JSON or YAML. Required, Sets topics_file value. + + Input Example: + + --topics-file=string + + File Example: + + --topics-file=path_to_file.(yaml|json) + +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 managedkafka/v1 API. The full documentation for this + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs + +NOTES + These variants are also available: + + $ gcloud alpha managed-kafka consumer-groups update + + $ gcloud beta managed-kafka consumer-groups update + diff --git a/gcloud/managed-kafka/help b/gcloud/managed-kafka/help new file mode 100644 index 000000000..132417d33 --- /dev/null +++ b/gcloud/managed-kafka/help @@ -0,0 +1,35 @@ +NAME + gcloud managed-kafka - administer Managed Service for Apache Kafka + clusters, topics, and consumer groups + +SYNOPSIS + gcloud managed-kafka GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Administer Managed Service for Apache Kafka clusters, topics, and consumer + groups. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + clusters + Administer Managed Service for Apache Kafka clusters. + + consumer-groups + Administer Managed Service for Apache Kafka consumer groups. + + topics + Administer Managed Service for Apache Kafka topics. + +NOTES + These variants are also available: + + $ gcloud alpha managed-kafka + + $ gcloud beta managed-kafka + diff --git a/gcloud/managed-kafka/topics/create b/gcloud/managed-kafka/topics/create new file mode 100644 index 000000000..6e299e876 --- /dev/null +++ b/gcloud/managed-kafka/topics/create @@ -0,0 +1,101 @@ +NAME + gcloud managed-kafka topics create - create a Managed Service for Apache + Kafka topic + +SYNOPSIS + gcloud managed-kafka topics create + (TOPIC : --cluster=CLUSTER --location=LOCATION) --partitions=PARTITIONS + --replication-factor=REPLICATION_FACTOR [--configs=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a Managed Service for Apache Kafka topic. + +EXAMPLES + To create a topic in a cluster named mycluster located in us-central1, run + the following: + + $ gcloud managed-kafka topics create mytopic --cluster=mycluster \ + --location=us-central1 --partitions=1 --replication-factor=3 + +POSITIONAL ARGUMENTS + Topic resource - Identifies the name of the topic that this command + creates. 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 topic 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. + + TOPIC + ID of the topic or fully qualified identifier for the topic. + + To set the topic attribute: + ▸ provide the argument topic on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The cluster name. + + To set the cluster attribute: + ▸ provide the argument topic on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --location=LOCATION + ID of the location of the Managed Service for Apache Kafka resource. + See + https://cloud.google.com/managed-service-for-apache-kafka/docs/locations + for a list of supported locations. + + To set the location attribute: + ▸ provide the argument topic on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --partitions=PARTITIONS + The number of partitions in a topic. You can increase the partition + count for a topic, but you cannot decrease it. Increasing partitions + for a topic that uses a key might change how messages are distributed. + + --replication-factor=REPLICATION_FACTOR + The number of replicas of each partition. A replication factor of 3 is + recommended for high availability. + +OPTIONAL FLAGS + --configs=[KEY=VALUE,...] + Configuration for the topic that are overridden from the cluster + defaults. The key of the map is a Kafka topic property name, for + example: cleanup.policy=compact,compression.type=producer. If you + provide a map with a key that already exists, only that configuration + is updated. If the map contains a key that does not exist, the entry is + appended to the topic configuration. + +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 managedkafka/v1 API. The full documentation for this + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs + +NOTES + These variants are also available: + + $ gcloud alpha managed-kafka topics create + + $ gcloud beta managed-kafka topics create + diff --git a/gcloud/managed-kafka/topics/delete b/gcloud/managed-kafka/topics/delete new file mode 100644 index 000000000..dcf9b4343 --- /dev/null +++ b/gcloud/managed-kafka/topics/delete @@ -0,0 +1,80 @@ +NAME + gcloud managed-kafka topics delete - delete a Managed Service for Apache + Kafka topic + +SYNOPSIS + gcloud managed-kafka topics delete + (TOPIC : --cluster=CLUSTER --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a Managed Service for Apache Kafka topic. + +EXAMPLES + To delete a topic in a cluster named mycluster located in us-central1, run + the following: + + $ gcloud managed-kafka topics delete mytopic --cluster=mycluster \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Topic resource - Identifies the topic for deletion. 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 topic 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. + + TOPIC + ID of the topic or fully qualified identifier for the topic. + + To set the topic attribute: + ▸ provide the argument topic on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The cluster name. + + To set the cluster attribute: + ▸ provide the argument topic on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --location=LOCATION + ID of the location of the Managed Service for Apache Kafka resource. + See + https://cloud.google.com/managed-service-for-apache-kafka/docs/locations + for a list of supported locations. + + To set the location attribute: + ▸ provide the argument topic 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 managedkafka/v1 API. The full documentation for this + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs + +NOTES + These variants are also available: + + $ gcloud alpha managed-kafka topics delete + + $ gcloud beta managed-kafka topics delete + diff --git a/gcloud/managed-kafka/topics/describe b/gcloud/managed-kafka/topics/describe new file mode 100644 index 000000000..b44f0e3a2 --- /dev/null +++ b/gcloud/managed-kafka/topics/describe @@ -0,0 +1,80 @@ +NAME + gcloud managed-kafka topics describe - describe a Managed Service for + Apache Kafka topic + +SYNOPSIS + gcloud managed-kafka topics describe + (TOPIC : --cluster=CLUSTER --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a Managed Service for Apache Kafka topic. + +EXAMPLES + To describe a topic in a cluster named mycluster located in us-central1, + run the following: + + $ gcloud managed-kafka topics describe mytopic --cluster=mycluster \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Topic resource - The describe command displays properties of the topic + specified by this parameter. 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 topic 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. + + TOPIC + ID of the topic or fully qualified identifier for the topic. + + To set the topic attribute: + ▸ provide the argument topic on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The cluster name. + + To set the cluster attribute: + ▸ provide the argument topic on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --location=LOCATION + ID of the location of the Managed Service for Apache Kafka resource. + See + https://cloud.google.com/managed-service-for-apache-kafka/docs/locations + for a list of supported locations. + + To set the location attribute: + ▸ provide the argument topic 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 managedkafka/v1 API. The full documentation for this + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs + +NOTES + These variants are also available: + + $ gcloud alpha managed-kafka topics describe + + $ gcloud beta managed-kafka topics describe + diff --git a/gcloud/managed-kafka/topics/help b/gcloud/managed-kafka/topics/help new file mode 100644 index 000000000..2aa6be8e2 --- /dev/null +++ b/gcloud/managed-kafka/topics/help @@ -0,0 +1,40 @@ +NAME + gcloud managed-kafka topics - administer Managed Service for Apache Kafka + topics + +SYNOPSIS + gcloud managed-kafka topics COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Administer Managed Service for Apache Kafka topics. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a Managed Service for Apache Kafka topic. + + delete + Delete a Managed Service for Apache Kafka topic. + + describe + Describe a Managed Service for Apache Kafka topic. + + list + List all Managed Service for Apache Kafka topics in a given cluster. + + update + Update a Managed Service for Apache Kafka topic. + +NOTES + These variants are also available: + + $ gcloud alpha managed-kafka topics + + $ gcloud beta managed-kafka topics + diff --git a/gcloud/managed-kafka/topics/list b/gcloud/managed-kafka/topics/list new file mode 100644 index 000000000..a7ee43825 --- /dev/null +++ b/gcloud/managed-kafka/topics/list @@ -0,0 +1,99 @@ +NAME + gcloud managed-kafka topics list - list all Managed Service for Apache + Kafka topics in a given cluster + +SYNOPSIS + gcloud managed-kafka topics list (CLUSTER : --location=LOCATION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all Managed Service for Apache Kafka topics in a given cluster. To + specify the maximum number of topics to list, use the --limit flag. + +EXAMPLES + To list all topics in a cluster named mycluster located in us-central1, run + the following: + + $ gcloud managed-kafka topics list mycluster --location=us-central1 + +POSITIONAL ARGUMENTS + Cluster resource - Identifies the cluster which contains all the topics to + be listed. 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 cluster 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. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + + To set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + ID of the location of the Managed Service for Apache Kafka resource. + See + https://cloud.google.com/managed-service-for-apache-kafka/docs/locations + for a list of supported locations. + + To set the location attribute: + ▸ provide the argument cluster 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 managedkafka/v1 API. The full documentation for this + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs + +NOTES + These variants are also available: + + $ gcloud alpha managed-kafka topics list + + $ gcloud beta managed-kafka topics list + diff --git a/gcloud/managed-kafka/topics/update b/gcloud/managed-kafka/topics/update new file mode 100644 index 000000000..ff466ef70 --- /dev/null +++ b/gcloud/managed-kafka/topics/update @@ -0,0 +1,104 @@ +NAME + gcloud managed-kafka topics update - update a Managed Service for Apache + Kafka topic + +SYNOPSIS + gcloud managed-kafka topics update + (TOPIC : --cluster=CLUSTER --location=LOCATION) + (--partitions=PARTITIONS --clear-configs | --configs=[KEY=VALUE,...]) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a Managed Service for Apache Kafka topic. + +EXAMPLES + To update an attribute in a topic, such as the partitions, for a cluster + named mycluster located in us-central1, run the following: + + $ gcloud managed-kafka topics update mytopic --cluster=mycluster \ + --location=us-central1 --partitions=3 + +POSITIONAL ARGUMENTS + Topic resource - Identifies the topic to be updated. 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 topic 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. + + TOPIC + ID of the topic or fully qualified identifier for the topic. + + To set the topic attribute: + ▸ provide the argument topic on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The cluster name. + + To set the cluster attribute: + ▸ provide the argument topic on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --location=LOCATION + ID of the location of the Managed Service for Apache Kafka resource. + See + https://cloud.google.com/managed-service-for-apache-kafka/docs/locations + for a list of supported locations. + + To set the location attribute: + ▸ provide the argument topic on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + At least one of these must be specified: + + --partitions=PARTITIONS + The number of partitions in a topic. You can increase the partition + count for a topic, but you cannot decrease it. Increasing partitions + for a topic that uses a key might change how messages are + distributed. + + At most one of these can be specified: + + --clear-configs + Remove all the configurations for the topic. + + --configs=[KEY=VALUE,...] + Configuration for the topic that are overridden from the cluster + defaults. The key of the map is a Kafka topic property name, for + example: cleanup.policy=compact,compression.type=producer. If you + provide a map with a key that already exists, only that + configuration is updated. If the map contains a key that does not + exist, the entry is appended to the topic configuration. + +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 managedkafka/v1 API. The full documentation for this + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs + +NOTES + These variants are also available: + + $ gcloud alpha managed-kafka topics update + + $ gcloud beta managed-kafka topics update + diff --git a/gcloud/netapp/volumes/create b/gcloud/netapp/volumes/create index c06dd03e7..a9714cad6 100644 --- a/gcloud/netapp/volumes/create +++ b/gcloud/netapp/volumes/create @@ -17,8 +17,13 @@ SYNOPSIS [kerberos-5i-read-write=KERBEROS-5I-READ-WRITE], [kerberos-5p-read-only=KERBEROS-5P-READ-ONLY], [kerberos-5p-read-write=KERBEROS-5P-READ-WRITE], - [nfsv3=NFSV3],[nfsv4=NFSV4]] [--labels=[KEY=VALUE,...]] - [--large-capacity=LARGE_CAPACITY] + [nfsv3=NFSV3],[nfsv4=NFSV4]] + [--hybrid-replication-parameters=[cluster-location=CLUSTER-LOCATION], + [description=DESCRIPTION],[labels=LABELS], + [peer-cluster-name=PEER-CLUSTER-NAME], + [peer-ip-addresses=PEER-IP-ADDRESSES],[peer-svm-name=PEER-SVM-NAME], + [peer-volume-name=PEER-VOLUME-NAME],[replication=REPLICATION]] + [--labels=[KEY=VALUE,...]] [--large-capacity=LARGE_CAPACITY] [--multiple-endpoints=MULTIPLE_ENDPOINTS] [--restricted-actions=RESTRICTED_ACTION,[...]] [--security-style=SECURITY_STYLE; default="SECURITY_STYLE_UNSPECIFIED"] @@ -164,6 +169,30 @@ OPTIONAL FLAGS kerberos-5p-read-only=KERBEROS_5P_READ_ONLY, kerberos-5p-read-write=KERBEROS_5P_READ_WRITE + --hybrid-replication-parameters=[cluster-location=CLUSTER-LOCATION],[description=DESCRIPTION],[labels=LABELS],[peer-cluster-name=PEER-CLUSTER-NAME],[peer-ip-addresses=PEER-IP-ADDRESSES],[peer-svm-name=PEER-SVM-NAME],[peer-volume-name=PEER-VOLUME-NAME],[replication=REPLICATION] + Hybrid Replication Parameters contains hybrid replication parameters on + a volume. + + Hybrid Replication Parameters will have the following format + --hybrid-replication-parameters=replication=REPLICATION, + peer-volume-name=PEER_VOLUME_NAME, + peer-cluster-name=PEER_CLUSTER_NAME, + peer-svm-name=PEER_SVM_NAME, + peer-ip-addresses=[PEER-IP-ADDRESS1#PEER-IP-ADDRESS2#...], + cluster-location=CLUSTER_LOCATION, + description=DESCRIPTION, + labels=[KEY1:VALUE1#KEY2:VALUE2#...] + + replication is the desired name for the replication of the volume, + peer-volume-name is the name of the user's local source volume, + peer-cluster-name is the name of the user's local source cluster, + peer-svm-name is the name of the user's local source vserver svm, + peer-ip-addresses is a ampersand-separated(#) list of ip addresses, + cluster-location is the name of the source cluster location, + description is the description of the replication and labels is an + hashtag-separated(#) key value pair of labels with key and value + separated by colon(:) for the replication. + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/netapp/volumes/replications/create b/gcloud/netapp/volumes/replications/create index 8dcdde684..7bebb4729 100644 --- a/gcloud/netapp/volumes/replications/create +++ b/gcloud/netapp/volumes/replications/create @@ -9,8 +9,8 @@ SYNOPSIS [share_name=SHARE_NAME], [storage_pool=STORAGE_POOL],[volume_id=VOLUME_ID] --replication-schedule=REPLICATION_SCHEDULE [--async] - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--volume=VOLUME] [GCLOUD_WIDE_FLAG ...] + [--cluster-location=CLUSTER_LOCATION] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] [--volume=VOLUME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a Cloud NetApp Volume Replication. @@ -73,6 +73,9 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --cluster-location=CLUSTER_LOCATION + Location of the user cluster. + --description=DESCRIPTION A description of the Cloud NetApp Replication diff --git a/gcloud/netapp/volumes/replications/establish-peering b/gcloud/netapp/volumes/replications/establish-peering new file mode 100644 index 000000000..a9eb20bfe --- /dev/null +++ b/gcloud/netapp/volumes/replications/establish-peering @@ -0,0 +1,117 @@ +NAME + gcloud netapp volumes replications establish-peering - establish peering + for Hybrid replication + +SYNOPSIS + gcloud netapp volumes replications establish-peering + (REPLICATION : --location=LOCATION) + --peer-cluster-name=PEER_CLUSTER_NAME --peer-svm-name=PEER_SVM_NAME + --peer-volume-name=PEER_VOLUME_NAME [--async] + [--peer-ip-addresses=PEER_IP_ADDRESS,[...]] [--volume=VOLUME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Establish peering for Hybrid replication. + +EXAMPLES + The following command establishes peering for Hybrid replication named NAME + using the arguments specified: + + $ gcloud netapp volumes replications establish-peering NAME \ + --volume=volume1 --peer-cluster-name=peer-cluster-name1 \ + --peer-svm-name=peer-svm-name1 \ + --peer-volume-name=peer-volume-name1 \ + --peer-ip-addresses=1.1.1.1,2.2.2.2 + +POSITIONAL ARGUMENTS + Replication resource - The Hybrid replication to establish peering 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 replication 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 volume attribute: + ◆ provide the argument replication on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + REPLICATION + ID of the replication or fully qualified identifier for the + replication. + + To set the replication attribute: + ▸ provide the argument replication 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 replication. + + To set the location attribute: + ▸ provide the argument replication on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +REQUIRED FLAGS + --peer-cluster-name=PEER_CLUSTER_NAME + Name of the destination cluster to be peered with the source cluster. + + --peer-svm-name=PEER_SVM_NAME + Name of the local source vserver svm to be peered with the destination + cluster. + + --peer-volume-name=PEER_VOLUME_NAME + Name of the source volume to be peered with the destination volume. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --peer-ip-addresses=PEER_IP_ADDRESS,[...] + List of ip addresses to be used for peering. + + Volume resource - The Volume that the Replication is based on 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 --volume 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --volume=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. + +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 netapp volumes replications establish-peering + diff --git a/gcloud/netapp/volumes/replications/help b/gcloud/netapp/volumes/replications/help index db728ffdf..ab45f2237 100644 --- a/gcloud/netapp/volumes/replications/help +++ b/gcloud/netapp/volumes/replications/help @@ -25,6 +25,9 @@ COMMANDS describe Describe a Cloud NetApp Volume Replication. + establish-peering + Establish peering for Hybrid replication. + list List Cloud NetApp Volume Replications. @@ -37,6 +40,9 @@ COMMANDS stop Stop a Cloud NetApp Volume Replication. + sync + Sync a Cloud NetApp Volume Replication. + update Update a Cloud NetApp Volume Replication. diff --git a/gcloud/netapp/volumes/replications/sync b/gcloud/netapp/volumes/replications/sync new file mode 100644 index 000000000..19d475291 --- /dev/null +++ b/gcloud/netapp/volumes/replications/sync @@ -0,0 +1,101 @@ +NAME + gcloud netapp volumes replications sync - sync a Cloud NetApp Volume + Replication + +SYNOPSIS + gcloud netapp volumes replications sync (REPLICATION : --location=LOCATION) + [--async] [--volume=VOLUME] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Sync a Cloud NetApp Volume Replication. + +EXAMPLES + The following command syncs a Replication named NAME using the required + arguments: + + $ gcloud netapp volumes replications sync NAME \ + --location=us-central1 --volume=vol1 + + To sync a Replication named NAME asynchronously, run the following command: + + $ gcloud netapp volumes replications sync NAME \ + --location=us-central1 --volume=vol1 --async + +POSITIONAL ARGUMENTS + Replication resource - The Replication to sync. 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 replication 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 volume attribute: + ◆ provide the argument replication on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + REPLICATION + ID of the replication or fully qualified identifier for the + replication. + + To set the replication attribute: + ▸ provide the argument replication 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 replication. + + To set the location attribute: + ▸ provide the argument replication on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + Volume resource - The Volume that the Replication is based on 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 --volume 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --volume=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. + +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 netapp volumes replications sync + diff --git a/gcloud/netapp/volumes/replications/update b/gcloud/netapp/volumes/replications/update index 490bb27b3..dc3f37153 100644 --- a/gcloud/netapp/volumes/replications/update +++ b/gcloud/netapp/volumes/replications/update @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud netapp volumes replications update (REPLICATION : --location=LOCATION) [--async] - [--description=DESCRIPTION] + [--cluster-location=CLUSTER_LOCATION] [--description=DESCRIPTION] [--replication-schedule=REPLICATION_SCHEDULE] [--update-labels=[KEY=VALUE,...]] [--volume=VOLUME] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -65,6 +65,9 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --cluster-location=CLUSTER_LOCATION + Location of the user cluster. + --description=DESCRIPTION A description of the Cloud NetApp Replication diff --git a/gcloud/network-connectivity/hubs/help b/gcloud/network-connectivity/hubs/help index 6eac0a353..79820a786 100644 --- a/gcloud/network-connectivity/hubs/help +++ b/gcloud/network-connectivity/hubs/help @@ -48,6 +48,9 @@ COMMANDS list-spokes List hub spokes. + query-status + Query the status of Private Service Connect propagation for a hub. + reject-spoke Reject a spoke from a hub. diff --git a/gcloud/network-connectivity/hubs/query-status b/gcloud/network-connectivity/hubs/query-status new file mode 100644 index 000000000..ba5e06b36 --- /dev/null +++ b/gcloud/network-connectivity/hubs/query-status @@ -0,0 +1,102 @@ +NAME + gcloud network-connectivity hubs query-status - query the status of Private + Service Connect propagation for a hub + +SYNOPSIS + gcloud network-connectivity hubs query-status HUB [--group-by=GROUP_BY] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Query the status of Private Service Connect propagation for a hub. + +EXAMPLES + To query the Private Service Connect propagation status of a hub, run: + + $ gcloud network-connectivity hubs query-status HUB + + To query the Private Service Connect propagation status of a hub grouped by + source spoke and code, run: + + $ gcloud network-connectivity hubs query-status HUB \ + --group-by="psc_propagation_status.source_spoke,psc_propagation_\ + status.code" + + To query the Private Service Connect propagation status of a hub sorted by + the source forwarding rule, run: + + $ gcloud network-connectivity hubs query-status HUB \ + --sort-by="psc_propagation_status.source_forwarding_rule" + +POSITIONAL ARGUMENTS + Hub resource - Name of the hub to query Private Service Connect + propagation for. 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 hub 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. + + HUB + ID of the hub or fully qualified identifier for the hub. + + To set the hub attribute: + ▸ provide the argument hub on the command line. + +FLAGS + --group-by=GROUP_BY + Comma-separated list of resource field key names to group by. + Aggregated values will be displayed for each group. If --group-by is + set, the value of the --sort-by flag must be the same as or a subset of + the --group-by flag. + + Accepted values are: + ◆ 'psc_propagation_status.source_spoke' + ◆ 'psc_propagation_status.source_group' + ◆ 'psc_propagation_status.source_forwarding_rule' + ◆ 'psc_propagation_status.target_spoke' + ◆ 'psc_propagation_status.target_group' + ◆ 'psc_propagation_status.code' + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest diff --git a/gcloud/network-connectivity/spokes/linked-producer-vpc-network/update b/gcloud/network-connectivity/spokes/linked-producer-vpc-network/update index 1abb92c72..f38f2ef93 100644 --- a/gcloud/network-connectivity/spokes/linked-producer-vpc-network/update +++ b/gcloud/network-connectivity/spokes/linked-producer-vpc-network/update @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud network-connectivity spokes linked-producer-vpc-network update SPOKE [--async] [--description=DESCRIPTION] [--global] + [--include-export-ranges=[CIDR_RANGE,...]] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -52,6 +53,10 @@ FLAGS --global Indicates that the spoke is global. + --include-export-ranges=[CIDR_RANGE,...] + Only allows adding ALL_IPV6_RANGES to include export ranges or removing + ALL_IPV6_RANGES from include export ranges. + --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. diff --git a/gcloud/network-connectivity/spokes/linked-vpc-network/update b/gcloud/network-connectivity/spokes/linked-vpc-network/update index fb9df16ba..352882306 100644 --- a/gcloud/network-connectivity/spokes/linked-vpc-network/update +++ b/gcloud/network-connectivity/spokes/linked-vpc-network/update @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud network-connectivity spokes linked-vpc-network update SPOKE [--async] [--description=DESCRIPTION] [--global] + [--include-export-ranges=[CIDR_RANGE,...]] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -52,6 +53,10 @@ FLAGS --global Indicates that the spoke is global. + --include-export-ranges=[CIDR_RANGE,...] + Only allows adding ALL_IPV6_RANGES to include export ranges or removing + ALL_IPV6_RANGES from include export ranges. + --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. diff --git a/gcloud/network-security/security-profiles/threat-prevention/add-override b/gcloud/network-security/security-profiles/threat-prevention/add-override index be37bfda7..e05f993a0 100644 --- a/gcloud/network-security/security-profiles/threat-prevention/add-override +++ b/gcloud/network-security/security-profiles/threat-prevention/add-override @@ -66,7 +66,7 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --action=ACTION Action associated with severity or threat-id. ACTION must be one of: - DEFAULT, ALLOW, ALERT, DENY. + DEFAULT_ACTION, ALLOW, ALERT, DENY. Exactly one of these must be specified: diff --git a/gcloud/network-security/security-profiles/threat-prevention/update-override b/gcloud/network-security/security-profiles/threat-prevention/update-override index 1882cd2e0..aa96e46ff 100644 --- a/gcloud/network-security/security-profiles/threat-prevention/update-override +++ b/gcloud/network-security/security-profiles/threat-prevention/update-override @@ -66,7 +66,7 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --action=ACTION Action associated with severity or threat-id. ACTION must be one of: - DEFAULT, ALLOW, ALERT, DENY. + DEFAULT_ACTION, ALLOW, ALERT, DENY. Exactly one of these must be specified: diff --git a/gcloud/recaptcha/keys/help b/gcloud/recaptcha/keys/help index fb60f9ede..7a4ce212c 100644 --- a/gcloud/recaptcha/keys/help +++ b/gcloud/recaptcha/keys/help @@ -30,6 +30,9 @@ COMMANDS list List reCAPTCHA Keys. + list-ip-overrides + List IP overrides for a key. + migrate Migrate a key to reCAPTCHA Enterprise. diff --git a/gcloud/recaptcha/keys/list-ip-overrides b/gcloud/recaptcha/keys/list-ip-overrides new file mode 100644 index 000000000..5b5996a5f --- /dev/null +++ b/gcloud/recaptcha/keys/list-ip-overrides @@ -0,0 +1,77 @@ +NAME + gcloud recaptcha keys list-ip-overrides - list IP overrides for a key + +SYNOPSIS + gcloud recaptcha keys list-ip-overrides KEY [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List IP overrides for a key. + +EXAMPLES + $ gcloud recaptcha keys list-ip-overrides test-key + +POSITIONAL ARGUMENTS + Key resource - The reCAPTCHA key for which to list the IP overrides. 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 key 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. + + KEY + ID of the key or fully qualified identifier for the key. + + To set the key attribute: + ▸ provide the argument key on the command line. + +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 recaptchaenterprise/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/recaptcha-enterprise/ + +NOTES + This variant is also available: + + $ gcloud alpha recaptcha keys list-ip-overrides + diff --git a/gcloud/run/deploy b/gcloud/run/deploy index d9c3872f2..90ef80582 100644 --- a/gcloud/run/deploy +++ b/gcloud/run/deploy @@ -312,6 +312,16 @@ FLAGS ◆ readonly: (optional) A boolean. If true, this volume will be read-only from all mounts. + in-memory: An ephemeral volume that stores data in the instance's + memory. With this type of volume, data is not shared between instances + and all data will be lost when the instance it is on is terminated. + Additional keys: + ◆ size-limit: (optional) A quantity representing the maximum amount + of memory allocated to this volume, such as "512Mi" or "3G". Data + stored in an in-memory volume consumes the memory allocation of the + container that wrote the data. If size-limit is not specified, the + maximum size will be half the total memory limit of all containers. + nfs: Represents a volume backed by an NFS server. Additional keys: ◆ location: (required) The location of the NFS Server, in the form SERVER:/PATH diff --git a/gcloud/run/jobs/create b/gcloud/run/jobs/create index 8d0857706..4a8a4cc95 100644 --- a/gcloud/run/jobs/create +++ b/gcloud/run/jobs/create @@ -182,6 +182,16 @@ OPTIONAL FLAGS ◆ readonly: (optional) A boolean. If true, this volume will be read-only from all mounts. + in-memory: An ephemeral volume that stores data in the instance's + memory. With this type of volume, data is not shared between instances + and all data will be lost when the instance it is on is terminated. + Additional keys: + ◆ size-limit: (optional) A quantity representing the maximum amount + of memory allocated to this volume, such as "512Mi" or "3G". Data + stored in an in-memory volume consumes the memory allocation of the + container that wrote the data. If size-limit is not specified, the + maximum size will be half the total memory limit of all containers. + nfs: Represents a volume backed by an NFS server. Additional keys: ◆ location: (required) The location of the NFS Server, in the form SERVER:/PATH diff --git a/gcloud/run/jobs/deploy b/gcloud/run/jobs/deploy index 77a92eaf9..48044df4a 100644 --- a/gcloud/run/jobs/deploy +++ b/gcloud/run/jobs/deploy @@ -181,6 +181,16 @@ FLAGS ◆ readonly: (optional) A boolean. If true, this volume will be read-only from all mounts. + in-memory: An ephemeral volume that stores data in the instance's + memory. With this type of volume, data is not shared between instances + and all data will be lost when the instance it is on is terminated. + Additional keys: + ◆ size-limit: (optional) A quantity representing the maximum amount + of memory allocated to this volume, such as "512Mi" or "3G". Data + stored in an in-memory volume consumes the memory allocation of the + container that wrote the data. If size-limit is not specified, the + maximum size will be half the total memory limit of all containers. + nfs: Represents a volume backed by an NFS server. Additional keys: ◆ location: (required) The location of the NFS Server, in the form SERVER:/PATH diff --git a/gcloud/run/jobs/update b/gcloud/run/jobs/update index 1fa8cfed4..27b21bc24 100644 --- a/gcloud/run/jobs/update +++ b/gcloud/run/jobs/update @@ -191,6 +191,16 @@ FLAGS ◆ readonly: (optional) A boolean. If true, this volume will be read-only from all mounts. + in-memory: An ephemeral volume that stores data in the instance's + memory. With this type of volume, data is not shared between instances + and all data will be lost when the instance it is on is terminated. + Additional keys: + ◆ size-limit: (optional) A quantity representing the maximum amount + of memory allocated to this volume, such as "512Mi" or "3G". Data + stored in an in-memory volume consumes the memory allocation of the + container that wrote the data. If size-limit is not specified, the + maximum size will be half the total memory limit of all containers. + nfs: Represents a volume backed by an NFS server. Additional keys: ◆ location: (required) The location of the NFS Server, in the form SERVER:/PATH diff --git a/gcloud/run/services/update b/gcloud/run/services/update index f306d1fae..6a75dde54 100644 --- a/gcloud/run/services/update +++ b/gcloud/run/services/update @@ -293,6 +293,16 @@ FLAGS ◆ readonly: (optional) A boolean. If true, this volume will be read-only from all mounts. + in-memory: An ephemeral volume that stores data in the instance's + memory. With this type of volume, data is not shared between instances + and all data will be lost when the instance it is on is terminated. + Additional keys: + ◆ size-limit: (optional) A quantity representing the maximum amount + of memory allocated to this volume, such as "512Mi" or "3G". Data + stored in an in-memory volume consumes the memory allocation of the + container that wrote the data. If size-limit is not specified, the + maximum size will be half the total memory limit of all containers. + nfs: Represents a volume backed by an NFS server. Additional keys: ◆ location: (required) The location of the NFS Server, in the form SERVER:/PATH diff --git a/gcloud/spanner/instances/create b/gcloud/spanner/instances/create index 096ab4556..60e6d839e 100644 --- a/gcloud/spanner/instances/create +++ b/gcloud/spanner/instances/create @@ -3,8 +3,10 @@ NAME SYNOPSIS gcloud spanner instances create INSTANCE --config=CONFIG - --description=DESCRIPTION [--async] [--edition=EDITION] - [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] + --description=DESCRIPTION [--async] + [--default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE] + [--edition=EDITION] [--expire-behavior=EXPIRE_BEHAVIOR] + [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS] [GCLOUD_WIDE_FLAG ...] @@ -36,6 +38,22 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE + The default backup schedule type that is used in the instance. + DEFAULT_BACKUP_SCHEDULE_TYPE must be one of: + + AUTOMATIC + A default backup schedule is created automatically when a new + database is created in an instance. You can edit or delete the + default backup schedule once it's created. The default backup + schedule creates a full backup every 24 hours. These full backups + are retained for 7 days. + DEFAULT_BACKUP_SCHEDULE_TYPE_UNSPECIFIED + Not specified. + NONE + No default backup schedule is created automatically when a new + database is created in an instance. + --edition=EDITION Cloud Spanner edition. EDITION must be one of: diff --git a/gcloud/spanner/instances/update b/gcloud/spanner/instances/update index 684321b08..4c20f4682 100644 --- a/gcloud/spanner/instances/update +++ b/gcloud/spanner/instances/update @@ -3,6 +3,7 @@ NAME SYNOPSIS gcloud spanner instances update INSTANCE [--async] + [--default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE] [--description=DESCRIPTION] [--edition=EDITION] [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS] @@ -30,6 +31,22 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE + The default backup schedule type that is used in the instance. + DEFAULT_BACKUP_SCHEDULE_TYPE must be one of: + + AUTOMATIC + A default backup schedule is created automatically when a new + database is created in an instance. You can edit or delete the + default backup schedule once it's created. The default backup + schedule creates a full backup every 24 hours. These full backups + are retained for 7 days. + DEFAULT_BACKUP_SCHEDULE_TYPE_UNSPECIFIED + Not specified. + NONE + No default backup schedule is created automatically when a new + database is created in an instance. + --description=DESCRIPTION Description of the instance. diff --git a/gcloud/sql/instances/switchover b/gcloud/sql/instances/switchover index 0edd9b540..0b039e8fc 100644 --- a/gcloud/sql/instances/switchover +++ b/gcloud/sql/instances/switchover @@ -7,8 +7,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Switches over a Cloud SQL instance to one of its replicas. Only supported - on Cloud SQL for SQL Server and MySQL instances. + Switches over a Cloud SQL instance to one of its replicas. EXAMPLES To switch over an instance to its replica called replica-instance: @@ -25,9 +24,9 @@ FLAGS complete. --db-timeout=DB_TIMEOUT - (MySQL only) Cloud SQL instance operations timeout, which is the sum of - all database operations. Default value is 10 minutes and can be - modified to a maximum value of 24h. + (MySQL and PostgreSQL only) Cloud SQL instance operations timeout, + which is the sum of all database operations. Default value is 10 + minutes and can be modified to a maximum value of 24h. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/transfer/agents/delete b/gcloud/transfer/agents/delete index b71f3b0be..193513b5d 100644 --- a/gcloud/transfer/agents/delete +++ b/gcloud/transfer/agents/delete @@ -1,12 +1,12 @@ NAME - gcloud transfer agents delete - delete a Transfer Service transfer agents + gcloud transfer agents delete - delete Transfer Service transfer agents SYNOPSIS gcloud transfer agents delete [--ids=[IDS,...] | --all | --uninstall] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Delete agents and remove agent resources from your machine. + Delete Transfer Service agents from your machine. EXAMPLES If you plan to delete specific agents, you can list which agents are @@ -30,9 +30,10 @@ FLAGS Delete all agents running on your machine. --uninstall - Fully uninstall the agent Docker image in addition to deleting the - agents. Uninstalling the Docker image will free up space, but you'll - need to reinstall it to run agents on this machine in the future. + Fully uninstall the agent container image in addition to deleting the + agents. Uninstalling the container image will free up space, but + you'll need to reinstall it to run agents on this machine in the + future. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/transfer/agents/help b/gcloud/transfer/agents/help index c087999ae..6dd636685 100644 --- a/gcloud/transfer/agents/help +++ b/gcloud/transfer/agents/help @@ -19,7 +19,7 @@ COMMANDS COMMAND is one of the following: delete - Delete a Transfer Service transfer agents. + Delete Transfer Service transfer agents. install Install Transfer Service agents.