From 4d8dd33b3e255472a049fa51306e756c2a3f5c8a Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 23 Apr 2025 10:54:24 +0000 Subject: [PATCH] gcloud: Wed Apr 23 10:54:24 UTC 2025 --- gcloud/_version | 10 +- gcloud/alpha/alloydb/instances/update | 8 +- gcloud/alpha/backup-dr/backups/help | 3 + gcloud/alpha/backup-dr/backups/update | 115 +++++++++++++ gcloud/alpha/compute/backend-services/create | 46 ++--- gcloud/alpha/compute/backend-services/update | 46 ++--- .../compute/reservations/blocks/describe | 12 +- gcloud/alpha/compute/reservations/blocks/help | 7 +- gcloud/alpha/compute/reservations/blocks/list | 22 +-- .../reservations/blocks/perform-maintenance | 11 +- gcloud/alpha/compute/reservations/help | 3 + .../compute/reservations/perform-maintenance | 11 +- .../compute/reservations/sub-blocks/describe | 67 ++++++++ .../compute/reservations/sub-blocks/help | 29 ++++ .../compute/reservations/sub-blocks/list | 104 ++++++++++++ gcloud/alpha/config/get | 4 + gcloud/alpha/config/help | 4 + gcloud/alpha/config/list | 4 + gcloud/alpha/config/set | 4 + gcloud/alpha/config/unset | 4 + gcloud/alpha/container/clusters/create | 37 +--- gcloud/alpha/container/clusters/update | 31 ---- gcloud/alpha/container/fleet/help | 3 + .../fleet/rbacrolebindingactuation/update | 23 ++- .../fleet/workload-identity/describe | 26 +++ .../container/fleet/workload-identity/disable | 30 ++++ .../container/fleet/workload-identity/enable | 25 +++ .../container/fleet/workload-identity/help | 40 +++++ .../workload-identity/scope-tenancy-pool/help | 31 ++++ .../workload-identity/scope-tenancy-pool/set | 51 ++++++ .../scope-tenancy-pool/unset | 25 +++ gcloud/alpha/container/hub/help | 3 + .../hub/rbacrolebindingactuation/update | 23 ++- .../container/hub/workload-identity/describe | 26 +++ .../container/hub/workload-identity/disable | 30 ++++ .../container/hub/workload-identity/enable | 24 +++ .../container/hub/workload-identity/help | 40 +++++ .../workload-identity/scope-tenancy-pool/help | 31 ++++ .../workload-identity/scope-tenancy-pool/set | 51 ++++++ .../scope-tenancy-pool/unset | 25 +++ gcloud/alpha/dns/managed-zones/create | 15 +- gcloud/alpha/dns/managed-zones/update | 15 +- gcloud/alpha/edge-cache/origins/create | 25 ++- gcloud/alpha/edge-cache/origins/update | 25 ++- gcloud/alpha/firestore/backups/schedules/help | 2 +- gcloud/alpha/firestore/backups/schedules/list | 2 +- gcloud/alpha/firestore/user-creds/help | 2 +- gcloud/alpha/firestore/user-creds/list | 2 +- gcloud/alpha/lustre/help | 31 ++++ gcloud/alpha/lustre/instances/create | 149 ++++++++++++++++ gcloud/alpha/lustre/instances/delete | 87 ++++++++++ gcloud/alpha/lustre/instances/describe | 67 ++++++++ gcloud/alpha/lustre/instances/export-data | 101 +++++++++++ gcloud/alpha/lustre/instances/help | 46 +++++ gcloud/alpha/lustre/instances/import-data | 101 +++++++++++ gcloud/alpha/lustre/instances/list | 90 ++++++++++ gcloud/alpha/lustre/instances/update | 160 ++++++++++++++++++ gcloud/alpha/lustre/operations/cancel | 66 ++++++++ gcloud/alpha/lustre/operations/delete | 66 ++++++++ gcloud/alpha/lustre/operations/describe | 66 ++++++++ gcloud/alpha/lustre/operations/help | 40 +++++ gcloud/alpha/lustre/operations/list | 87 ++++++++++ gcloud/alpha/lustre/operations/wait | 66 ++++++++ gcloud/alpha/netapp/volumes/create | 24 ++- gcloud/alpha/scc/findings/list | 17 +- .../scc/manage/billing-metadata/describe | 61 +++++++ gcloud/alpha/scc/manage/billing-metadata/help | 26 +++ gcloud/alpha/scc/manage/help | 3 + gcloud/backup-dr/backups/help | 3 + gcloud/backup-dr/backups/update | 112 ++++++++++++ gcloud/beta/compute/backend-services/create | 46 ++--- gcloud/beta/compute/backend-services/update | 46 ++--- .../beta/compute/reservations/blocks/describe | 14 +- gcloud/beta/compute/reservations/blocks/help | 9 +- gcloud/beta/compute/reservations/blocks/list | 24 +-- .../reservations/blocks/perform-maintenance | 15 +- gcloud/beta/compute/reservations/help | 2 +- .../compute/reservations/perform-maintenance | 13 +- gcloud/beta/config/get | 4 + gcloud/beta/config/help | 4 + gcloud/beta/config/list | 4 + gcloud/beta/config/set | 4 + gcloud/beta/config/unset | 4 + gcloud/beta/container/clusters/create | 37 +--- gcloud/beta/container/clusters/update | 31 ---- .../datastream/private-connections/create | 45 ++--- gcloud/beta/dns/managed-zones/create | 15 +- gcloud/beta/dns/managed-zones/update | 15 +- gcloud/beta/filestore/instances/create | 62 ++----- gcloud/beta/firestore/backups/schedules/help | 2 +- gcloud/beta/firestore/backups/schedules/list | 2 +- gcloud/beta/firestore/user-creds/help | 2 +- gcloud/beta/firestore/user-creds/list | 2 +- gcloud/beta/netapp/volumes/create | 24 ++- gcloud/beta/scc/findings/list | 17 +- gcloud/compute/backend-services/create | 46 ++--- gcloud/compute/backend-services/update | 46 ++--- gcloud/compute/commitments/create | 11 +- gcloud/compute/reservations/blocks/describe | 63 +++++++ gcloud/compute/reservations/blocks/help | 34 ++++ gcloud/compute/reservations/blocks/list | 99 +++++++++++ .../reservations/blocks/perform-maintenance | 78 +++++++++ gcloud/compute/reservations/help | 12 +- .../compute/reservations/perform-maintenance | 72 ++++++++ gcloud/compute/url-maps/invalidate-cdn-cache | 32 ++-- gcloud/config/get | 4 + gcloud/config/help | 4 + gcloud/config/list | 4 + gcloud/config/set | 4 + gcloud/config/unset | 4 + gcloud/container/clusters/create | 25 +-- gcloud/database-migration/objects/lookup | 2 +- gcloud/datastream/private-connections/create | 64 ++++--- gcloud/dns/managed-zones/create | 13 +- gcloud/dns/managed-zones/update | 13 +- gcloud/edge-cache/origins/create | 25 ++- gcloud/edge-cache/origins/update | 24 ++- gcloud/firestore/backups/schedules/help | 2 +- gcloud/firestore/backups/schedules/list | 2 +- gcloud/lustre/help | 28 +++ gcloud/lustre/instances/create | 146 ++++++++++++++++ gcloud/lustre/instances/delete | 84 +++++++++ gcloud/lustre/instances/describe | 64 +++++++ gcloud/lustre/instances/export-data | 98 +++++++++++ gcloud/lustre/instances/help | 43 +++++ gcloud/lustre/instances/import-data | 98 +++++++++++ gcloud/lustre/instances/list | 87 ++++++++++ gcloud/lustre/instances/update | 157 +++++++++++++++++ gcloud/lustre/operations/cancel | 63 +++++++ gcloud/lustre/operations/delete | 63 +++++++ gcloud/lustre/operations/describe | 63 +++++++ gcloud/lustre/operations/help | 37 ++++ gcloud/lustre/operations/list | 84 +++++++++ gcloud/lustre/operations/wait | 63 +++++++ gcloud/netapp/volumes/create | 24 ++- .../service-connection-policies/update | 102 ++++++----- gcloud/scc/findings/list | 17 +- gcloud/services/api-keys/create | 10 ++ 138 files changed, 4506 insertions(+), 597 deletions(-) create mode 100644 gcloud/alpha/backup-dr/backups/update create mode 100644 gcloud/alpha/compute/reservations/sub-blocks/describe create mode 100644 gcloud/alpha/compute/reservations/sub-blocks/help create mode 100644 gcloud/alpha/compute/reservations/sub-blocks/list create mode 100644 gcloud/alpha/container/fleet/workload-identity/describe create mode 100644 gcloud/alpha/container/fleet/workload-identity/disable create mode 100644 gcloud/alpha/container/fleet/workload-identity/enable create mode 100644 gcloud/alpha/container/fleet/workload-identity/help create mode 100644 gcloud/alpha/container/fleet/workload-identity/scope-tenancy-pool/help create mode 100644 gcloud/alpha/container/fleet/workload-identity/scope-tenancy-pool/set create mode 100644 gcloud/alpha/container/fleet/workload-identity/scope-tenancy-pool/unset create mode 100644 gcloud/alpha/container/hub/workload-identity/describe create mode 100644 gcloud/alpha/container/hub/workload-identity/disable create mode 100644 gcloud/alpha/container/hub/workload-identity/enable create mode 100644 gcloud/alpha/container/hub/workload-identity/help create mode 100644 gcloud/alpha/container/hub/workload-identity/scope-tenancy-pool/help create mode 100644 gcloud/alpha/container/hub/workload-identity/scope-tenancy-pool/set create mode 100644 gcloud/alpha/container/hub/workload-identity/scope-tenancy-pool/unset create mode 100644 gcloud/alpha/lustre/help create mode 100644 gcloud/alpha/lustre/instances/create create mode 100644 gcloud/alpha/lustre/instances/delete create mode 100644 gcloud/alpha/lustre/instances/describe create mode 100644 gcloud/alpha/lustre/instances/export-data create mode 100644 gcloud/alpha/lustre/instances/help create mode 100644 gcloud/alpha/lustre/instances/import-data create mode 100644 gcloud/alpha/lustre/instances/list create mode 100644 gcloud/alpha/lustre/instances/update create mode 100644 gcloud/alpha/lustre/operations/cancel create mode 100644 gcloud/alpha/lustre/operations/delete create mode 100644 gcloud/alpha/lustre/operations/describe create mode 100644 gcloud/alpha/lustre/operations/help create mode 100644 gcloud/alpha/lustre/operations/list create mode 100644 gcloud/alpha/lustre/operations/wait create mode 100644 gcloud/alpha/scc/manage/billing-metadata/describe create mode 100644 gcloud/alpha/scc/manage/billing-metadata/help create mode 100644 gcloud/backup-dr/backups/update create mode 100644 gcloud/compute/reservations/blocks/describe create mode 100644 gcloud/compute/reservations/blocks/help create mode 100644 gcloud/compute/reservations/blocks/list create mode 100644 gcloud/compute/reservations/blocks/perform-maintenance create mode 100644 gcloud/compute/reservations/perform-maintenance create mode 100644 gcloud/lustre/help create mode 100644 gcloud/lustre/instances/create create mode 100644 gcloud/lustre/instances/delete create mode 100644 gcloud/lustre/instances/describe create mode 100644 gcloud/lustre/instances/export-data create mode 100644 gcloud/lustre/instances/help create mode 100644 gcloud/lustre/instances/import-data create mode 100644 gcloud/lustre/instances/list create mode 100644 gcloud/lustre/instances/update create mode 100644 gcloud/lustre/operations/cancel create mode 100644 gcloud/lustre/operations/delete create mode 100644 gcloud/lustre/operations/describe create mode 100644 gcloud/lustre/operations/help create mode 100644 gcloud/lustre/operations/list create mode 100644 gcloud/lustre/operations/wait diff --git a/gcloud/_version b/gcloud/_version index 96c5b5b04..c43b1e716 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 518.0.0 -alpha 2025.04.11 -beta 2025.04.11 +Google Cloud SDK 519.0.0 +alpha 2025.04.18 +beta 2025.04.18 bq 2.1.15 bundled-python3-unix 3.12.8 -core 2025.04.11 +core 2025.04.18 gcloud-crc32c 1.0.0 -gsutil 5.33 +gsutil 5.34 diff --git a/gcloud/alpha/alloydb/instances/update b/gcloud/alpha/alloydb/instances/update index 3a49f2b7c..bfbe3cfb9 100644 --- a/gcloud/alpha/alloydb/instances/update +++ b/gcloud/alpha/alloydb/instances/update @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha alloydb instances update INSTANCE --cluster=CLUSTER - --region=REGION [--allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...]] + --region=REGION [--activation-policy=ACTIVATION_POLICY] + [--allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...]] [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] [--async] [--authorized-external-networks=[AUTHORIZED_NETWORK,...]] [--availability-type=AVAILABILITY_TYPE] @@ -59,6 +60,11 @@ REQUIRED FLAGS regions at https://cloud.google.com/sql/docs/instance-locations. OPTIONAL FLAGS + --activation-policy=ACTIVATION_POLICY + Activation Policy for the instance.Required to START or STOP an + instance.ALWAYS - The instance is up and running.NEVER - The instance + is stopped. ACTIVATION_POLICY must be one of: ALWAYS, NEVER. + --allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...] Comma-separated list of allowed consumer projects to create endpoints for Private Service Connect (PSC) connectivity for the instance. Only diff --git a/gcloud/alpha/backup-dr/backups/help b/gcloud/alpha/backup-dr/backups/help index 585e425a0..8bdaed742 100644 --- a/gcloud/alpha/backup-dr/backups/help +++ b/gcloud/alpha/backup-dr/backups/help @@ -30,6 +30,9 @@ COMMANDS list (ALPHA) List Backups. + update + (ALPHA) Update the specified Backup. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/backup-dr/backups/update b/gcloud/alpha/backup-dr/backups/update new file mode 100644 index 000000000..505579bba --- /dev/null +++ b/gcloud/alpha/backup-dr/backups/update @@ -0,0 +1,115 @@ +NAME + gcloud alpha backup-dr backups update - update the specified Backup + +SYNOPSIS + gcloud alpha backup-dr backups update + (BACKUP : --backup-vault=BACKUP_VAULT + --data-source=DATA_SOURCE --location=LOCATION) + --enforced-retention-end-time=ENFORCED_RETENTION_END_TIME [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update the specified Backup. + +EXAMPLES + To update the enforced retention of a backup sample-backup in backup vault + sample-vault, data source sample-ds, project sample-project and location + us-central1, run: + + $ gcloud alpha backup-dr backups update sample-backup \ + --backup-vault=sample-vault --data-source=sample-ds \ + --project=sample-project --location=us-central1 \ + --enforced-retention-end-time="2025-02-14T01:10:20Z" + + To update the expire time of a backup sample-backup in backup vault + sample-vault, data source sample-ds, project sample-project and location + us-central1, run: + + $ gcloud alpha backup-dr backups update sample-backup \ + --backup-vault=sample-vault --data-source=sample-ds \ + --project=sample-project --location=us-central1 \ + --expire-time="2025-02-14T01:10:20Z" + +POSITIONAL ARGUMENTS + Backup resource - Name of the backup to update. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. + + To set the project attribute: + ◆ provide the argument backup on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKUP + ID of the Backup or fully qualified identifier for the Backup. + + To set the name attribute: + ▸ provide the argument backup on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --backup-vault=BACKUP_VAULT + The ID of the Backup Vault. + + To set the backup-vault attribute: + ▸ provide the argument backup on the command line with a fully + specified name; + ▸ provide the argument --backup-vault on the command line. + + --data-source=DATA_SOURCE + The ID of the Data Source. + + To set the data-source attribute: + ▸ provide the argument backup on the command line with a fully + specified name; + ▸ provide the argument --data-source on the command line. + + --location=LOCATION + The location of the Backup. + + To set the location attribute: + ▸ provide the argument backup on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --enforced-retention-end-time=ENFORCED_RETENTION_END_TIME + Backups cannot be deleted until this time or later. This period can be + extended, but not shortened. It should be specified in the format of + "YYYY-MM-DD". + + ◆ For backup configured with a backup appliance, there are additional + restrictions: 1. Enforced retention cannot be extended past the + expiry time. 2. Enforced retention can only be updated for finalized + backups. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +BRIEF + Updates a specific backup + +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 backup-dr backups update + diff --git a/gcloud/alpha/compute/backend-services/create b/gcloud/alpha/compute/backend-services/create index 291a35607..85ee07b75 100644 --- a/gcloud/alpha/compute/backend-services/create +++ b/gcloud/alpha/compute/backend-services/create @@ -287,9 +287,9 @@ FLAGS --[no-]enable-cdn Enable or disable Cloud CDN for the backend service. Only available for backend services with --load-balancing-scheme=EXTERNAL that use a - --protocol of HTTP, HTTPS, or HTTP2. Cloud CDN caches HTTP responses at - the edge of Google's network. Cloud CDN is disabled by default. Use - --enable-cdn to enable and --no-enable-cdn to disable. + --protocol of HTTP, HTTPS, HTTP2 or H2C. Cloud CDN caches HTTP + responses at the edge of Google's network. Cloud CDN is disabled by + default. Use --enable-cdn to enable and --no-enable-cdn to disable. --[no-]enable-logging The logging options for the load balancer traffic served by this @@ -543,10 +543,12 @@ FLAGS Load Balancer), the protocol must be one of: TCP, UDP, UNSPECIFIED. If the load-balancing-scheme is INTERNAL_SELF_MANAGED (Traffic - Director), the protocol must be one of: HTTP, HTTPS, HTTP2, GRPC. + Director), the protocol must be one of: HTTP, HTTPS, HTTP2, GRPC, H2C + (beta only). If the load-balancing-scheme is INTERNAL_MANAGED (Internal Application - Load Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + Load Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2, H2C + (beta only). If the load-balancing-scheme is INTERNAL_MANAGED (Internal proxy Network Load Balancer), the protocol must be only TCP. @@ -561,7 +563,8 @@ FLAGS If the load-balancing-scheme is EXTERNAL_MANAGED (Global external Application Load Balancer and regional external Application Load - Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2, H2C (beta + only). If the load-balancing-scheme is EXTERNAL_MANAGED (Global external proxy Network Load Balancer), the protocol must be one of: TCP, SSL. @@ -639,7 +642,7 @@ FLAGS --load-balancing-scheme is EXTERNAL or EXTERNAL_MANAGED, routes requests to backend VMs or endpoints in a NEG, based on the contents of the GCLB cookie set by the load balancer. Only - applicable when --protocol is HTTP, HTTPS, or HTTP2. If the + applicable when --protocol is HTTP, HTTPS,HTTP2 or H2C. If the --load-balancing-scheme is INTERNAL_MANAGED or INTERNAL_SELF_MANAGED, routes requests to backend VMs or endpoints in a NEG, based on the contents of the GCILB cookie set by the @@ -715,21 +718,22 @@ FLAGS Network Load Balancers (global not set and load-balancing-scheme set to EXTERNAL), timeout is ignored. - If the protocol is HTTP, HTTPS, or HTTP2, timeout is a request/response - timeout for HTTP(S) traffic, meaning the amount of time that the load - balancer waits for a backend to return a full response to a request. If - WebSockets traffic is supported, the timeout parameter sets the maximum - amount of time that a WebSocket can be open (idle or not). + If the protocol is HTTP, HTTPS, HTTP2 or H2C, timeout is a + request/response timeout for HTTP(S) traffic, meaning the amount of + time that the load balancer waits for a backend to return a full + response to a request. If WebSockets traffic is supported, the timeout + parameter sets the maximum amount of time that a WebSocket can be open + (idle or not). - For example, for HTTP, HTTPS, or HTTP2 traffic, specifying a timeout of - 10s means that backends have 10 seconds to respond to the load - balancer's requests. The load balancer retries the HTTP GET request one - time if the backend closes the connection or times out before sending - response headers to the load balancer. If the backend sends response - headers or if the request sent to the backend is not an HTTP GET - request, the load balancer does not retry. If the backend does not - reply at all, the load balancer returns a 502 Bad Gateway error to the - client. + For example, for HTTP, HTTPS, HTTP2 or H2C traffic, specifying a + timeout of 10s means that backends have 10 seconds to respond to the + load balancer's requests. The load balancer retries the HTTP GET + request one time if the backend closes the connection or times out + before sending response headers to the load balancer. If the backend + sends response headers or if the request sent to the backend is not an + HTTP GET request, the load balancer does not retry. If the backend does + not reply at all, the load balancer returns a 502 Bad Gateway error to + the client. If the protocol is SSL or TCP, timeout is an idle timeout. diff --git a/gcloud/alpha/compute/backend-services/update b/gcloud/alpha/compute/backend-services/update index be10fdcaf..68f3d489e 100644 --- a/gcloud/alpha/compute/backend-services/update +++ b/gcloud/alpha/compute/backend-services/update @@ -204,9 +204,9 @@ FLAGS --[no-]enable-cdn Enable or disable Cloud CDN for the backend service. Only available for backend services with --load-balancing-scheme=EXTERNAL that use a - --protocol of HTTP, HTTPS, or HTTP2. Cloud CDN caches HTTP responses at - the edge of Google's network. Cloud CDN is disabled by default. Use - --enable-cdn to enable and --no-enable-cdn to disable. + --protocol of HTTP, HTTPS, HTTP2 or H2C. Cloud CDN caches HTTP + responses at the edge of Google's network. Cloud CDN is disabled by + default. Use --enable-cdn to enable and --no-enable-cdn to disable. --[no-]enable-logging The logging options for the load balancer traffic served by this @@ -382,10 +382,12 @@ FLAGS Load Balancer), the protocol must be one of: TCP, UDP, UNSPECIFIED. If the load-balancing-scheme is INTERNAL_SELF_MANAGED (Traffic - Director), the protocol must be one of: HTTP, HTTPS, HTTP2, GRPC. + Director), the protocol must be one of: HTTP, HTTPS, HTTP2, GRPC, H2C + (beta only). If the load-balancing-scheme is INTERNAL_MANAGED (Internal Application - Load Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + Load Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2, H2C + (beta only). If the load-balancing-scheme is INTERNAL_MANAGED (Internal proxy Network Load Balancer), the protocol must be only TCP. @@ -400,7 +402,8 @@ FLAGS If the load-balancing-scheme is EXTERNAL_MANAGED (Global external Application Load Balancer and regional external Application Load - Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2, H2C (beta + only). If the load-balancing-scheme is EXTERNAL_MANAGED (Global external proxy Network Load Balancer), the protocol must be one of: TCP, SSL. @@ -453,7 +456,7 @@ FLAGS --load-balancing-scheme is EXTERNAL or EXTERNAL_MANAGED, routes requests to backend VMs or endpoints in a NEG, based on the contents of the GCLB cookie set by the load balancer. Only - applicable when --protocol is HTTP, HTTPS, or HTTP2. If the + applicable when --protocol is HTTP, HTTPS,HTTP2 or H2C. If the --load-balancing-scheme is INTERNAL_MANAGED or INTERNAL_SELF_MANAGED, routes requests to backend VMs or endpoints in a NEG, based on the contents of the GCILB cookie set by the @@ -528,21 +531,22 @@ FLAGS Network Load Balancers (global not set and load-balancing-scheme set to EXTERNAL), timeout is ignored. - If the protocol is HTTP, HTTPS, or HTTP2, timeout is a request/response - timeout for HTTP(S) traffic, meaning the amount of time that the load - balancer waits for a backend to return a full response to a request. If - WebSockets traffic is supported, the timeout parameter sets the maximum - amount of time that a WebSocket can be open (idle or not). + If the protocol is HTTP, HTTPS, HTTP2 or H2C, timeout is a + request/response timeout for HTTP(S) traffic, meaning the amount of + time that the load balancer waits for a backend to return a full + response to a request. If WebSockets traffic is supported, the timeout + parameter sets the maximum amount of time that a WebSocket can be open + (idle or not). - For example, for HTTP, HTTPS, or HTTP2 traffic, specifying a timeout of - 10s means that backends have 10 seconds to respond to the load - balancer's requests. The load balancer retries the HTTP GET request one - time if the backend closes the connection or times out before sending - response headers to the load balancer. If the backend sends response - headers or if the request sent to the backend is not an HTTP GET - request, the load balancer does not retry. If the backend does not - reply at all, the load balancer returns a 502 Bad Gateway error to the - client. + For example, for HTTP, HTTPS, HTTP2 or H2C traffic, specifying a + timeout of 10s means that backends have 10 seconds to respond to the + load balancer's requests. The load balancer retries the HTTP GET + request one time if the backend closes the connection or times out + before sending response headers to the load balancer. If the backend + sends response headers or if the request sent to the backend is not an + HTTP GET request, the load balancer does not retry. If the backend does + not reply at all, the load balancer returns a 502 Bad Gateway error to + the client. If the protocol is SSL or TCP, timeout is an idle timeout. diff --git a/gcloud/alpha/compute/reservations/blocks/describe b/gcloud/alpha/compute/reservations/blocks/describe index 3e9b5877d..8cb690c99 100644 --- a/gcloud/alpha/compute/reservations/blocks/describe +++ b/gcloud/alpha/compute/reservations/blocks/describe @@ -10,11 +10,11 @@ DESCRIPTION (ALPHA) Describe a Compute Engine reservation block. EXAMPLES - To describe a reservation block in reservation exr1 in my-zone with block - name block1, run: + To describe a reservation block in reservation my-reservation in my-zone + with block name my-reservation-block-0001, run: - $ gcloud alpha compute reservations blocks describe exr1 \ - --zone=my-zone --block-name=block1 + $ gcloud alpha compute reservations blocks describe my-reservation \ + --zone=my-zone --block-name=my-reservation-block-0001 POSITIONAL ARGUMENTS RESERVATION @@ -58,7 +58,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute reservations blocks describe $ gcloud beta compute reservations blocks describe diff --git a/gcloud/alpha/compute/reservations/blocks/help b/gcloud/alpha/compute/reservations/blocks/help index 25d529075..a2db11ccd 100644 --- a/gcloud/alpha/compute/reservations/blocks/help +++ b/gcloud/alpha/compute/reservations/blocks/help @@ -1,5 +1,6 @@ NAME - gcloud alpha compute reservations blocks - + gcloud alpha compute reservations blocks - manage Compute Engine + reservation blocks SYNOPSIS gcloud alpha compute reservations blocks COMMAND [GCLOUD_WIDE_FLAG ...] @@ -29,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 compute reservations blocks $ gcloud beta compute reservations blocks diff --git a/gcloud/alpha/compute/reservations/blocks/list b/gcloud/alpha/compute/reservations/blocks/list index fa5881c6f..3794416e9 100644 --- a/gcloud/alpha/compute/reservations/blocks/list +++ b/gcloud/alpha/compute/reservations/blocks/list @@ -9,20 +9,20 @@ SYNOPSIS DESCRIPTION (ALPHA) gcloud alpha compute reservations blocks list displays all Compute - Engine reservation blocks in an extended reservation. + Engine reservation blocks in a densely deployed reservation. EXAMPLES - To list all reservation blocks in an extended reservation in table form, - run: + To list all reservation blocks in a densely deployed reservation in table + form, run: - $ gcloud alpha compute reservations blocks list \ - extended-reservation --zone=us-central1-a --project=my-project + $ gcloud alpha compute reservations blocks list my-reservation \ + --zone=us-central1-a --project=my-project - To list the URIs of all reservation blocks in an extended reservation, run: + To list the URIs of all reservation blocks in a densely deployed + reservation, run: - $ gcloud alpha compute reservations blocks list \ - extended-reservation --zone=us-central1-a --project=my-project \ - --uri + $ gcloud alpha compute reservations blocks list my-reservation \ + --zone=us-central1-a --project=my-project --uri POSITIONAL ARGUMENTS RESERVATION @@ -94,7 +94,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute reservations blocks list $ gcloud beta compute reservations blocks list diff --git a/gcloud/alpha/compute/reservations/blocks/perform-maintenance b/gcloud/alpha/compute/reservations/blocks/perform-maintenance index 0f5bf4aba..a2becbf21 100644 --- a/gcloud/alpha/compute/reservations/blocks/perform-maintenance +++ b/gcloud/alpha/compute/reservations/blocks/perform-maintenance @@ -11,11 +11,12 @@ DESCRIPTION (ALPHA) Perform maintenance on a reservation block within a reservation. EXAMPLES - To perform maintenance on a reservation block in reservation exr1 in - my-zone with block name block1 with scope all, run: + To perform maintenance on a reservation block in reservation my-reservation + in my-zone with block name my-reservation-block-0001 with scope all, run: $ gcloud alpha compute reservations blocks perform-maintenance \ - exr1 --zone=my-zone --block-name=block1 --scope=all + my-reservation --zone=my-zone \ + --block-name=my-reservation-block-0001 --scope=all POSITIONAL ARGUMENTS RESERVATION @@ -72,7 +73,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute reservations blocks perform-maintenance $ gcloud beta compute reservations blocks perform-maintenance diff --git a/gcloud/alpha/compute/reservations/help b/gcloud/alpha/compute/reservations/help index 195a41a15..9dcfc96a7 100644 --- a/gcloud/alpha/compute/reservations/help +++ b/gcloud/alpha/compute/reservations/help @@ -22,6 +22,9 @@ GROUPS GROUP is one of the following: blocks + (ALPHA) Manage Compute Engine reservation blocks. + + sub-blocks (ALPHA) COMMANDS diff --git a/gcloud/alpha/compute/reservations/perform-maintenance b/gcloud/alpha/compute/reservations/perform-maintenance index b23d68a28..91a4db1c0 100644 --- a/gcloud/alpha/compute/reservations/perform-maintenance +++ b/gcloud/alpha/compute/reservations/perform-maintenance @@ -12,10 +12,11 @@ DESCRIPTION reservations with reservation blocks. EXAMPLES - To perform maintenance on reservation exr1 in my-zone with scope all, run: + To perform maintenance on reservation my-reservation in my-zone with scope + all, run: - $ gcloud alpha compute reservations perform-maintenance exr1 \ - --zone=my-zone --scope=all + $ gcloud alpha compute reservations perform-maintenance \ + my-reservation --zone=my-zone --scope=all POSITIONAL ARGUMENTS RESERVATION @@ -67,7 +68,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute reservations perform-maintenance $ gcloud beta compute reservations perform-maintenance diff --git a/gcloud/alpha/compute/reservations/sub-blocks/describe b/gcloud/alpha/compute/reservations/sub-blocks/describe new file mode 100644 index 000000000..16e62ab6c --- /dev/null +++ b/gcloud/alpha/compute/reservations/sub-blocks/describe @@ -0,0 +1,67 @@ +NAME + gcloud alpha compute reservations sub-blocks describe - describe a Compute + Engine reservation sub block + +SYNOPSIS + gcloud alpha compute reservations sub-blocks describe RESERVATION + --block-name=BLOCK_NAME --sub-block-name=SUB_BLOCK_NAME [--zone=ZONE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a Compute Engine reservation sub block. + +EXAMPLES + To describe a reservation sub block in reservation exr1 in my-zone with + block name my-block and sub block name my-sub-block, run: + + $ gcloud alpha compute reservations sub-blocks describe exr1 \ + --zone=my-zone --block-name=my-block \ + --sub-block-name=my-sub-block + +POSITIONAL ARGUMENTS + RESERVATION + Name of the reservation to describe. + +REQUIRED FLAGS + --block-name=BLOCK_NAME + The name of the reservation block. + + --sub-block-name=SUB_BLOCK_NAME + The name of the reservation sub block. + +OPTIONAL FLAGS + --zone=ZONE + Zone of the reservation to describe. 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/reservations/sub-blocks/help b/gcloud/alpha/compute/reservations/sub-blocks/help new file mode 100644 index 000000000..44bc39455 --- /dev/null +++ b/gcloud/alpha/compute/reservations/sub-blocks/help @@ -0,0 +1,29 @@ +NAME + gcloud alpha compute reservations sub-blocks - + +SYNOPSIS + gcloud alpha compute reservations sub-blocks COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Compute Engine reservation sub blocks. + +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 Compute Engine reservation sub block. + + list + (ALPHA) List Compute Engine reservation sub blocks. + +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/reservations/sub-blocks/list b/gcloud/alpha/compute/reservations/sub-blocks/list new file mode 100644 index 000000000..9c35654be --- /dev/null +++ b/gcloud/alpha/compute/reservations/sub-blocks/list @@ -0,0 +1,104 @@ +NAME + gcloud alpha compute reservations sub-blocks list - list Compute Engine + reservation sub blocks + +SYNOPSIS + gcloud alpha compute reservations sub-blocks list RESERVATION + --block-name=BLOCK_NAME [--zone=ZONE] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute reservations sub-blocks list displays all + Compute Engine reservation sub blocks in an extended reservation's block. + +EXAMPLES + To list all reservation sub blocks in an extended reservation's block + my-block in table form, run: + + $ gcloud alpha compute reservations sub-blocks list \ + extended-reservation --block-name=my-block \ + --zone=us-central1-a --project=my-project + + To list the URIs of all reservation blocks in an extended reservation, run: + + $ gcloud alpha compute reservations sub-blocks list \ + extended-reservation --block-name=my-block \ + --zone=us-central1-a --project=my-project --uri + +POSITIONAL ARGUMENTS + RESERVATION + Name of the reservation to list. + +REQUIRED FLAGS + --block-name=BLOCK_NAME + The name of the reservation block. + +FLAGS + --zone=ZONE + Zone of the reservation to list. 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. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/config/get b/gcloud/alpha/config/get index 9bb3625eb..70eff43df 100644 --- a/gcloud/alpha/config/get +++ b/gcloud/alpha/config/get @@ -273,6 +273,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud kms command group. Defaults to https://cloudkms.googleapis.com/ + cloudlocationfinder + Overrides API endpoint for gcloud cloudlocationfinder command + group. Defaults to https://cloudlocationfinder.googleapis.com/ + cloudresourcemanager Overrides API endpoint for gcloud projects command group. Defaults to https://cloudresourcemanager.googleapis.com/ diff --git a/gcloud/alpha/config/help b/gcloud/alpha/config/help index 2b65f72b8..b19b38387 100644 --- a/gcloud/alpha/config/help +++ b/gcloud/alpha/config/help @@ -305,6 +305,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud kms command group. Defaults to https://cloudkms.googleapis.com/ + cloudlocationfinder + Overrides API endpoint for gcloud cloudlocationfinder command + group. Defaults to https://cloudlocationfinder.googleapis.com/ + cloudresourcemanager Overrides API endpoint for gcloud projects command group. Defaults to https://cloudresourcemanager.googleapis.com/ diff --git a/gcloud/alpha/config/list b/gcloud/alpha/config/list index cba1cecac..2a7e9c966 100644 --- a/gcloud/alpha/config/list +++ b/gcloud/alpha/config/list @@ -317,6 +317,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud kms command group. Defaults to https://cloudkms.googleapis.com/ + cloudlocationfinder + Overrides API endpoint for gcloud cloudlocationfinder command + group. Defaults to https://cloudlocationfinder.googleapis.com/ + cloudresourcemanager Overrides API endpoint for gcloud projects command group. Defaults to https://cloudresourcemanager.googleapis.com/ diff --git a/gcloud/alpha/config/set b/gcloud/alpha/config/set index 01cbec4be..fb4e5e8ab 100644 --- a/gcloud/alpha/config/set +++ b/gcloud/alpha/config/set @@ -320,6 +320,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud kms command group. Defaults to https://cloudkms.googleapis.com/ + cloudlocationfinder + Overrides API endpoint for gcloud cloudlocationfinder command + group. Defaults to https://cloudlocationfinder.googleapis.com/ + cloudresourcemanager Overrides API endpoint for gcloud projects command group. Defaults to https://cloudresourcemanager.googleapis.com/ diff --git a/gcloud/alpha/config/unset b/gcloud/alpha/config/unset index 23dc3db9f..ec45af521 100644 --- a/gcloud/alpha/config/unset +++ b/gcloud/alpha/config/unset @@ -281,6 +281,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud kms command group. Defaults to https://cloudkms.googleapis.com/ + cloudlocationfinder + Overrides API endpoint for gcloud cloudlocationfinder command + group. Defaults to https://cloudlocationfinder.googleapis.com/ + cloudresourcemanager Overrides API endpoint for gcloud projects command group. Defaults to https://cloudresourcemanager.googleapis.com/ diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index 50664f975..07f910e43 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -9,8 +9,8 @@ SYNOPSIS gpu-partition-size=GPU_PARTITION_SIZE, gpu-sharing-strategy=GPU_SHARING_STRATEGY, max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...]] - [--addons=[ADDON,...]] [--allow-route-overlap] [--async] - [--auto-monitoring-scope=AUTO_MONITORING_SCOPE] + [--addons=[ADDON[=ENABLED|DISABLED],...]] [--allow-route-overlap] + [--async] [--auto-monitoring-scope=AUTO_MONITORING_SCOPE] [--autoprovisioning-enable-insecure-kubelet-readonly-port] [--autoprovisioning-network-tags=TAGS,[TAGS,...]] [--autoprovisioning-resource-manager-tags=[KEY=VALUE,...]] @@ -135,7 +135,6 @@ SYNOPSIS --master-ipv4-cidr=MASTER_IPV4_CIDR --private-cluster] [--enable-secret-manager --enable-secret-manager-rotation --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL] - [--enable-tpu --enable-tpu-service-networking | --tpu-ipv4-cidr=CIDR] [--ephemeral-storage[=[local-ssd-count=LOCAL-SSD-COUNT]] | --ephemeral-storage-local-ssd[=[count=COUNT]] | --local-nvme-ssd-block[=[count=COUNT]] @@ -212,7 +211,7 @@ FLAGS (Optional) The max number of containers allowed to share each GPU on the node. This field is used together with gpu-sharing-strategy. - --addons=[ADDON,...] + --addons=[ADDON[=ENABLED|DISABLED],...] Addons (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters#Cluster.AddonsConfig) are additional Kubernetes cluster components. Addons specified by this @@ -2157,36 +2156,6 @@ FLAGS Set the rotation period for secrets in the Secret Manager CSI driver provider component. - Flags relating to Cloud TPUs: - - --enable-tpu - Enable Cloud TPUs for this cluster. - - Can not be specified unless --enable-ip-alias is also specified. - - At most one of these can be specified: - - --enable-tpu-service-networking - Enable Cloud TPU's Service Networking mode. In this mode, the CIDR - blocks used by the Cloud TPUs will be allocated and managed by - Service Networking, instead of Kubernetes Engine. - - This cannot be specified if tpu-ipv4-cidr is specified. - - --tpu-ipv4-cidr=CIDR - Set the IP range for the Cloud TPUs. - - Can be specified as a netmask size (e.g. '/20') or as in CIDR - notion (e.g. '10.100.0.0/20'). If given as a netmask size, the IP - range will be chosen automatically from the available space in the - network. - - If unspecified, the TPU CIDR range will use automatic default - '/20'. - - Can not be specified unless '--enable-tpu' and '--enable-ip-alias' - are also specified. - At most one of these can be specified: --ephemeral-storage[=[local-ssd-count=LOCAL-SSD-COUNT]] diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index 1b55c6a0a..c57ff0950 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -110,7 +110,6 @@ SYNOPSIS --enable-insecure-binding-system-unauthenticated | --enable-secret-manager --enable-secret-manager-rotation --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL - | --enable-tpu --enable-tpu-service-networking | --tpu-ipv4-cidr=CIDR | --logging-service=LOGGING_SERVICE --monitoring-service=MONITORING_SERVICE | --password=PASSWORD --enable-basic-auth @@ -1534,36 +1533,6 @@ REQUIRED FLAGS Set the rotation period for secrets in the Secret Manager CSI driver provider component. - Flags relating to Cloud TPUs: - - --enable-tpu - Enable Cloud TPUs for this cluster. - - Can not be specified unless --enable-ip-alias is also specified. - - At most one of these can be specified: - - --enable-tpu-service-networking - Enable Cloud TPU's Service Networking mode. In this mode, the - CIDR blocks used by the Cloud TPUs will be allocated and managed - by Service Networking, instead of Kubernetes Engine. - - This cannot be specified if tpu-ipv4-cidr is specified. - - --tpu-ipv4-cidr=CIDR - Set the IP range for the Cloud TPUs. - - Can be specified as a netmask size (e.g. '/20') or as in CIDR - notion (e.g. '10.100.0.0/20'). If given as a netmask size, the IP - range will be chosen automatically from the available space in - the network. - - If unspecified, the TPU CIDR range will use automatic default - '/20'. - - Can not be specified unless '--enable-tpu' and - '--enable-ip-alias' are also specified. - --logging-service=LOGGING_SERVICE (DEPRECATED) Logging service to use for the cluster. Options are: "logging.googleapis.com/kubernetes" (the Google Cloud Logging service diff --git a/gcloud/alpha/container/fleet/help b/gcloud/alpha/container/fleet/help index 4f3f4f3ad..5c13145ce 100644 --- a/gcloud/alpha/container/fleet/help +++ b/gcloud/alpha/container/fleet/help @@ -100,6 +100,9 @@ GROUPS service-directory (ALPHA) Manage the Service Directory Feature. + workload-identity + (ALPHA) Manage Workload Identity Feature. + COMMANDS COMMAND is one of the following: diff --git a/gcloud/alpha/container/fleet/rbacrolebindingactuation/update b/gcloud/alpha/container/fleet/rbacrolebindingactuation/update index c5e914490..51190c866 100644 --- a/gcloud/alpha/container/fleet/rbacrolebindingactuation/update +++ b/gcloud/alpha/container/fleet/rbacrolebindingactuation/update @@ -4,7 +4,10 @@ NAME SYNOPSIS gcloud alpha container fleet rbacrolebindingactuation update - --allowed-custom-roles=ROLES,[ROLES,...] [GCLOUD_WIDE_FLAG ...] + (--add-allowed-custom-role=ADD_ALLOWED_CUSTOM_ROLE + | --allowed-custom-roles=[ROLES,...] + | --remove-allowed-custom-role=REMOVE_ALLOWED_CUSTOM_ROLE) + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) This command updates RbacRoleBinding Actuation Feature in a fleet. @@ -14,11 +17,23 @@ EXAMPLES $ gcloud container fleet rbacrolebinding-actuation update \ --allowed-custom-roles=role1,role2 + $ gcloud container fleet rbacrolebinding-actuation update \ + --add-allowed-custom-role=role1 + $ gcloud container fleet rbacrolebinding-actuation update \ + --remove-allowed-custom-role=role2 REQUIRED FLAGS - --allowed-custom-roles=ROLES,[ROLES,...] - The list of allowed custom roles that can be used in scope - RBACRoleBindings. + Exactly one of these must be specified: + + --add-allowed-custom-role=ADD_ALLOWED_CUSTOM_ROLE + Add a single custom role to the allowed custom roles list. + + --allowed-custom-roles=[ROLES,...] + The list of allowed custom roles that can be used in scope + RBACRoleBindings. + + --remove-allowed-custom-role=REMOVE_ALLOWED_CUSTOM_ROLE + Remove a single custom role from the allowed custom roles list. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/fleet/workload-identity/describe b/gcloud/alpha/container/fleet/workload-identity/describe new file mode 100644 index 000000000..82bf70ad5 --- /dev/null +++ b/gcloud/alpha/container/fleet/workload-identity/describe @@ -0,0 +1,26 @@ +NAME + gcloud alpha container fleet workload-identity describe - describe the + status of Workload Identity Feature resource + +SYNOPSIS + gcloud alpha container fleet workload-identity describe + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe the status of the Workload Identity Feature resource in a + fleet. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/fleet/workload-identity/disable b/gcloud/alpha/container/fleet/workload-identity/disable new file mode 100644 index 000000000..969922840 --- /dev/null +++ b/gcloud/alpha/container/fleet/workload-identity/disable @@ -0,0 +1,30 @@ +NAME + gcloud alpha container fleet workload-identity disable - disable Workload + Identity Feature + +SYNOPSIS + gcloud alpha container fleet workload-identity disable [--force] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Disable the Workload Identity Feature in a fleet. + +FLAGS + --force + Disable this feature, even if it is currently in use. Force disablement + may result in unexpected behavior. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/fleet/workload-identity/enable b/gcloud/alpha/container/fleet/workload-identity/enable new file mode 100644 index 000000000..c219ef317 --- /dev/null +++ b/gcloud/alpha/container/fleet/workload-identity/enable @@ -0,0 +1,25 @@ +NAME + gcloud alpha container fleet workload-identity enable - enable Workload + Identity Feature + +SYNOPSIS + gcloud alpha container fleet workload-identity enable + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Enable the Workload Identity Feature in a fleet. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/fleet/workload-identity/help b/gcloud/alpha/container/fleet/workload-identity/help new file mode 100644 index 000000000..9f0c811ce --- /dev/null +++ b/gcloud/alpha/container/fleet/workload-identity/help @@ -0,0 +1,40 @@ +NAME + gcloud alpha container fleet workload-identity - manage Workload Identity + Feature + +SYNOPSIS + gcloud alpha container fleet workload-identity GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Workload Identity Feature. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + scope-tenancy-pool + (ALPHA) Manage Workload Identity Feature scope tenancy pool. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Describe the status of Workload Identity Feature resource. + + disable + (ALPHA) Disable Workload Identity Feature. + + enable + (ALPHA) Enable Workload Identity Feature. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/fleet/workload-identity/scope-tenancy-pool/help b/gcloud/alpha/container/fleet/workload-identity/scope-tenancy-pool/help new file mode 100644 index 000000000..5f9ac7aed --- /dev/null +++ b/gcloud/alpha/container/fleet/workload-identity/scope-tenancy-pool/help @@ -0,0 +1,31 @@ +NAME + gcloud alpha container fleet workload-identity scope-tenancy-pool - manage + Workload Identity Feature scope tenancy pool + +SYNOPSIS + gcloud alpha container fleet workload-identity scope-tenancy-pool COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Workload Identity Feature scope tenancy pool. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + set + (ALPHA) Set Scope Tenancy Pool. + + unset + (ALPHA) Unset Scope Tenancy Pool. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/fleet/workload-identity/scope-tenancy-pool/set b/gcloud/alpha/container/fleet/workload-identity/scope-tenancy-pool/set new file mode 100644 index 000000000..eba21d31a --- /dev/null +++ b/gcloud/alpha/container/fleet/workload-identity/scope-tenancy-pool/set @@ -0,0 +1,51 @@ +NAME + gcloud alpha container fleet workload-identity scope-tenancy-pool set - set + Scope Tenancy Pool + +SYNOPSIS + gcloud alpha container fleet workload-identity scope-tenancy-pool set + WORKLOAD_IDENTITY_POOL [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Set the scope tenancy pool for a fleet. + +POSITIONAL ARGUMENTS + Workloadidentitypool resource - The group of arguments defining a Workload + Identity Pool. 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 WORKLOAD_IDENTITY_POOL on the command line with + a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument WORKLOAD_IDENTITY_POOL on the command line with + a fully specified name; + ◆ provide the argument --location on the command line; + ◆ set the property gkehub/location. + + This must be specified. + + WORKLOAD_IDENTITY_POOL + ID of the workloadidentitypool or fully qualified identifier for the + workloadidentitypool. + + To set the workloadidentitypool attribute: + ▸ provide the argument WORKLOAD_IDENTITY_POOL on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/fleet/workload-identity/scope-tenancy-pool/unset b/gcloud/alpha/container/fleet/workload-identity/scope-tenancy-pool/unset new file mode 100644 index 000000000..0886cadb0 --- /dev/null +++ b/gcloud/alpha/container/fleet/workload-identity/scope-tenancy-pool/unset @@ -0,0 +1,25 @@ +NAME + gcloud alpha container fleet workload-identity scope-tenancy-pool unset - + unset Scope Tenancy Pool + +SYNOPSIS + gcloud alpha container fleet workload-identity scope-tenancy-pool unset + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Unset the scope tenancy pool for a fleet. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/hub/help b/gcloud/alpha/container/hub/help index bc76de3b3..a17163c52 100644 --- a/gcloud/alpha/container/hub/help +++ b/gcloud/alpha/container/hub/help @@ -100,6 +100,9 @@ GROUPS service-directory (ALPHA) Manage the Service Directory Feature. + workload-identity + (ALPHA) Manage Workload Identity Feature. + COMMANDS COMMAND is one of the following: diff --git a/gcloud/alpha/container/hub/rbacrolebindingactuation/update b/gcloud/alpha/container/hub/rbacrolebindingactuation/update index bf3e28d76..fe762ef21 100644 --- a/gcloud/alpha/container/hub/rbacrolebindingactuation/update +++ b/gcloud/alpha/container/hub/rbacrolebindingactuation/update @@ -4,7 +4,10 @@ NAME SYNOPSIS gcloud alpha container hub rbacrolebindingactuation update - --allowed-custom-roles=ROLES,[ROLES,...] [GCLOUD_WIDE_FLAG ...] + (--add-allowed-custom-role=ADD_ALLOWED_CUSTOM_ROLE + | --allowed-custom-roles=[ROLES,...] + | --remove-allowed-custom-role=REMOVE_ALLOWED_CUSTOM_ROLE) + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) This command updates RbacRoleBinding Actuation Feature in a fleet. @@ -14,11 +17,23 @@ EXAMPLES $ gcloud container fleet rbacrolebinding-actuation update \ --allowed-custom-roles=role1,role2 + $ gcloud container fleet rbacrolebinding-actuation update \ + --add-allowed-custom-role=role1 + $ gcloud container fleet rbacrolebinding-actuation update \ + --remove-allowed-custom-role=role2 REQUIRED FLAGS - --allowed-custom-roles=ROLES,[ROLES,...] - The list of allowed custom roles that can be used in scope - RBACRoleBindings. + Exactly one of these must be specified: + + --add-allowed-custom-role=ADD_ALLOWED_CUSTOM_ROLE + Add a single custom role to the allowed custom roles list. + + --allowed-custom-roles=[ROLES,...] + The list of allowed custom roles that can be used in scope + RBACRoleBindings. + + --remove-allowed-custom-role=REMOVE_ALLOWED_CUSTOM_ROLE + Remove a single custom role from the allowed custom roles list. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/hub/workload-identity/describe b/gcloud/alpha/container/hub/workload-identity/describe new file mode 100644 index 000000000..e0f4be23c --- /dev/null +++ b/gcloud/alpha/container/hub/workload-identity/describe @@ -0,0 +1,26 @@ +NAME + gcloud alpha container hub workload-identity describe - describe the status + of Workload Identity Feature resource + +SYNOPSIS + gcloud alpha container hub workload-identity describe + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe the status of the Workload Identity Feature resource in a + fleet. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/hub/workload-identity/disable b/gcloud/alpha/container/hub/workload-identity/disable new file mode 100644 index 000000000..139be4f80 --- /dev/null +++ b/gcloud/alpha/container/hub/workload-identity/disable @@ -0,0 +1,30 @@ +NAME + gcloud alpha container hub workload-identity disable - disable Workload + Identity Feature + +SYNOPSIS + gcloud alpha container hub workload-identity disable [--force] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Disable the Workload Identity Feature in a fleet. + +FLAGS + --force + Disable this feature, even if it is currently in use. Force disablement + may result in unexpected behavior. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/hub/workload-identity/enable b/gcloud/alpha/container/hub/workload-identity/enable new file mode 100644 index 000000000..d5c90cf11 --- /dev/null +++ b/gcloud/alpha/container/hub/workload-identity/enable @@ -0,0 +1,24 @@ +NAME + gcloud alpha container hub workload-identity enable - enable Workload + Identity Feature + +SYNOPSIS + gcloud alpha container hub workload-identity enable [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Enable the Workload Identity Feature in a fleet. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/hub/workload-identity/help b/gcloud/alpha/container/hub/workload-identity/help new file mode 100644 index 000000000..623d7ba03 --- /dev/null +++ b/gcloud/alpha/container/hub/workload-identity/help @@ -0,0 +1,40 @@ +NAME + gcloud alpha container hub workload-identity - manage Workload Identity + Feature + +SYNOPSIS + gcloud alpha container hub workload-identity GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Workload Identity Feature. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + scope-tenancy-pool + (ALPHA) Manage Workload Identity Feature scope tenancy pool. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Describe the status of Workload Identity Feature resource. + + disable + (ALPHA) Disable Workload Identity Feature. + + enable + (ALPHA) Enable Workload Identity Feature. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/hub/workload-identity/scope-tenancy-pool/help b/gcloud/alpha/container/hub/workload-identity/scope-tenancy-pool/help new file mode 100644 index 000000000..2a74bfcd1 --- /dev/null +++ b/gcloud/alpha/container/hub/workload-identity/scope-tenancy-pool/help @@ -0,0 +1,31 @@ +NAME + gcloud alpha container hub workload-identity scope-tenancy-pool - manage + Workload Identity Feature scope tenancy pool + +SYNOPSIS + gcloud alpha container hub workload-identity scope-tenancy-pool COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Workload Identity Feature scope tenancy pool. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + set + (ALPHA) Set Scope Tenancy Pool. + + unset + (ALPHA) Unset Scope Tenancy Pool. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/hub/workload-identity/scope-tenancy-pool/set b/gcloud/alpha/container/hub/workload-identity/scope-tenancy-pool/set new file mode 100644 index 000000000..63385fab8 --- /dev/null +++ b/gcloud/alpha/container/hub/workload-identity/scope-tenancy-pool/set @@ -0,0 +1,51 @@ +NAME + gcloud alpha container hub workload-identity scope-tenancy-pool set - set + Scope Tenancy Pool + +SYNOPSIS + gcloud alpha container hub workload-identity scope-tenancy-pool set + WORKLOAD_IDENTITY_POOL [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Set the scope tenancy pool for a fleet. + +POSITIONAL ARGUMENTS + Workloadidentitypool resource - The group of arguments defining a Workload + Identity Pool. 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 WORKLOAD_IDENTITY_POOL on the command line with + a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument WORKLOAD_IDENTITY_POOL on the command line with + a fully specified name; + ◆ provide the argument --location on the command line; + ◆ set the property gkehub/location. + + This must be specified. + + WORKLOAD_IDENTITY_POOL + ID of the workloadidentitypool or fully qualified identifier for the + workloadidentitypool. + + To set the workloadidentitypool attribute: + ▸ provide the argument WORKLOAD_IDENTITY_POOL on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/hub/workload-identity/scope-tenancy-pool/unset b/gcloud/alpha/container/hub/workload-identity/scope-tenancy-pool/unset new file mode 100644 index 000000000..ddb36eb1d --- /dev/null +++ b/gcloud/alpha/container/hub/workload-identity/scope-tenancy-pool/unset @@ -0,0 +1,25 @@ +NAME + gcloud alpha container hub workload-identity scope-tenancy-pool unset - + unset Scope Tenancy Pool + +SYNOPSIS + gcloud alpha container hub workload-identity scope-tenancy-pool unset + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Unset the scope tenancy pool for a fleet. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/dns/managed-zones/create b/gcloud/alpha/dns/managed-zones/create index 0ace78cb8..a6c23727a 100644 --- a/gcloud/alpha/dns/managed-zones/create +++ b/gcloud/alpha/dns/managed-zones/create @@ -65,10 +65,10 @@ OPTIONAL FLAGS Enable DNSSEC and allow transferring a signed zone in or out. --forwarding-targets=[IP_ADDRESSES,...] - List of IPv4 addresses of target name servers that the zone will - forward queries to. Ignored for public visibility. Non-RFC1918 - addresses will forward to the target through the Internet. RFC1918 - addresses will forward through the VPC. + List of IPv4/IPv6 addresses or one domain name of the target name + server that the zone will forward queries to. Ignored for public + visibility. Non-RFC1918 addresses will forward to the target through + the Internet. RFC1918 addresses will forward through the VPC. --gkeclusters=[GKECLUSTERS,...] List of GKE clusters that the zone should be visible in if the zone @@ -108,9 +108,10 @@ OPTIONAL FLAGS visibility is [private]. --private-forwarding-targets=[IP_ADDRESSES,...] - List of IPv4 addresses of target name servers that the zone will - forward queries to. Ignored for public visibility. All addresses - specified for this parameter will be reached through the VPC. + List of IPv4/IPv6 addresses or one domain name of the target name + server that the zone will forward queries to. Ignored for public + visibility. All addresses specified for this parameter will be reached + through the VPC. --service-directory-namespace=SERVICE_DIRECTORY_NAMESPACE The fully qualified URL of the service directory namespace that should diff --git a/gcloud/alpha/dns/managed-zones/update b/gcloud/alpha/dns/managed-zones/update index 41ead8317..f6d5d1a18 100644 --- a/gcloud/alpha/dns/managed-zones/update +++ b/gcloud/alpha/dns/managed-zones/update @@ -73,10 +73,10 @@ FLAGS Enable DNSSEC and allow transferring a signed zone in or out. --forwarding-targets=[IP_ADDRESSES,...] - List of IPv4 addresses of target name servers that the zone will - forward queries to. Ignored for public visibility. Non-RFC1918 - addresses will forward to the target through the Internet. RFC1918 - addresses will forward through the VPC. + List of IPv4/IPv6 addresses or one domain name of the target name + server that the zone will forward queries to. Ignored for public + visibility. Non-RFC1918 addresses will forward to the target through + the Internet. RFC1918 addresses will forward through the VPC. --gkeclusters=[GKECLUSTERS,...] List of GKE clusters that the zone should be visible in if the zone @@ -108,9 +108,10 @@ FLAGS visibility is [private]. --private-forwarding-targets=[IP_ADDRESSES,...] - List of IPv4 addresses of target name servers that the zone will - forward queries to. Ignored for public visibility. All addresses - specified for this parameter will be reached through the VPC. + List of IPv4/IPv6 addresses or one domain name of the target name + server that the zone will forward queries to. Ignored for public + visibility. All addresses specified for this parameter will be reached + through the VPC. --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value diff --git a/gcloud/alpha/edge-cache/origins/create b/gcloud/alpha/edge-cache/origins/create index f01162dad..84bb6f1d2 100644 --- a/gcloud/alpha/edge-cache/origins/create +++ b/gcloud/alpha/edge-cache/origins/create @@ -4,9 +4,9 @@ NAME SYNOPSIS gcloud alpha edge-cache origins create (ORIGIN : --location=LOCATION) --origin-address=ORIGIN_ADDRESS [--async] [--description=DESCRIPTION] - [--failover-origin=FAILOVER_ORIGIN] [--labels=[KEY=VALUE,...]] - [--max-attempts=MAX_ATTEMPTS] [--port=PORT] [--protocol=PROTOCOL] - [--response-timeout=RESPONSE_TIMEOUT] + [--failover-origin=FAILOVER_ORIGIN] [--flex-shielding=FLEX_SHIELDING] + [--labels=[KEY=VALUE,...]] [--max-attempts=MAX_ATTEMPTS] [--port=PORT] + [--protocol=PROTOCOL] [--response-timeout=RESPONSE_TIMEOUT] [--retry-conditions=[RETRY_CONDITIONS,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -89,6 +89,25 @@ OPTIONAL FLAGS The value of timeout.maxAttemptsTimeout dictates the timeout across all origins. + --flex-shielding=FLEX_SHIELDING + Whenever possible, content will be fetched from origin and cached in or + near the specified region. Best effort. + + Defaults to default global origin shielding. You may specify at most + one region. An empty flag turns off flex shielding. + + FLEX_SHIELDING must be one of: + + ** + Turn off flexible shielding and use the default global origin + shielding. + + africa_south1 + Origin fetch from near africa-south1. + + me_central1 + Origin fetch from near me-central1. + --labels=[KEY=VALUE,...] List of KEY=VALUE labels to attach to this resource. diff --git a/gcloud/alpha/edge-cache/origins/update b/gcloud/alpha/edge-cache/origins/update index 941837a0f..5fd071e70 100644 --- a/gcloud/alpha/edge-cache/origins/update +++ b/gcloud/alpha/edge-cache/origins/update @@ -4,9 +4,9 @@ NAME SYNOPSIS gcloud alpha edge-cache origins update (ORIGIN : --location=LOCATION) [--async] [--description=DESCRIPTION] - [--failover-origin=FAILOVER_ORIGIN] [--labels=[KEY=VALUE,...]] - [--max-attempts=MAX_ATTEMPTS] [--origin-address=ORIGIN_ADDRESS] - [--port=PORT] [--protocol=PROTOCOL] + [--failover-origin=FAILOVER_ORIGIN] [--flex-shielding=FLEX_SHIELDING] + [--labels=[KEY=VALUE,...]] [--max-attempts=MAX_ATTEMPTS] + [--origin-address=ORIGIN_ADDRESS] [--port=PORT] [--protocol=PROTOCOL] [--response-timeout=RESPONSE_TIMEOUT] [--retry-conditions=[RETRY_CONDITIONS,...]] [GCLOUD_WIDE_FLAG ...] @@ -73,6 +73,25 @@ FLAGS The value of timeout.maxAttemptsTimeout dictates the timeout across all origins. + --flex-shielding=FLEX_SHIELDING + Whenever possible, content will be fetched from origin and cached in or + near the specified region. Best effort. + + Defaults to default global origin shielding. You may specify at most + one region. An empty flag turns off flex shielding. + + FLEX_SHIELDING must be one of: + + ** + Turn off flexible shielding and use the default global origin + shielding. + + africa_south1 + Origin fetch from near africa-south1. + + me_central1 + Origin fetch from near me-central1. + --labels=[KEY=VALUE,...] List of KEY=VALUE labels to attach to this resource. diff --git a/gcloud/alpha/firestore/backups/schedules/help b/gcloud/alpha/firestore/backups/schedules/help index 8ebb8b3c9..1a4483e81 100644 --- a/gcloud/alpha/firestore/backups/schedules/help +++ b/gcloud/alpha/firestore/backups/schedules/help @@ -26,7 +26,7 @@ COMMANDS (ALPHA) Describes a Cloud Firestore backup schedule. list - (ALPHA) Lists backup schedules under a Cloud Firesore database. + (ALPHA) Lists backup schedules under a Cloud Firestore database. update (ALPHA) Updates a Cloud Firestore backup schedule. diff --git a/gcloud/alpha/firestore/backups/schedules/list b/gcloud/alpha/firestore/backups/schedules/list index 861b3cc24..4efdac99f 100644 --- a/gcloud/alpha/firestore/backups/schedules/list +++ b/gcloud/alpha/firestore/backups/schedules/list @@ -1,6 +1,6 @@ NAME gcloud alpha firestore backups schedules list - lists backup schedules - under a Cloud Firesore database + under a Cloud Firestore database SYNOPSIS gcloud alpha firestore backups schedules list --database=DATABASE diff --git a/gcloud/alpha/firestore/user-creds/help b/gcloud/alpha/firestore/user-creds/help index fc86879e0..1026f06a8 100644 --- a/gcloud/alpha/firestore/user-creds/help +++ b/gcloud/alpha/firestore/user-creds/help @@ -32,7 +32,7 @@ COMMANDS (ALPHA) Enables a Cloud Firestore user creds. list - (ALPHA) Lists user creds under a Cloud Firesore database. + (ALPHA) Lists user creds under a Cloud Firestore database. reset-password (ALPHA) Resets a Cloud Firestore user creds. diff --git a/gcloud/alpha/firestore/user-creds/list b/gcloud/alpha/firestore/user-creds/list index b660742c1..4baade779 100644 --- a/gcloud/alpha/firestore/user-creds/list +++ b/gcloud/alpha/firestore/user-creds/list @@ -1,6 +1,6 @@ NAME gcloud alpha firestore user-creds list - lists user creds under a Cloud - Firesore database + Firestore database SYNOPSIS gcloud alpha firestore user-creds list --database=DATABASE diff --git a/gcloud/alpha/lustre/help b/gcloud/alpha/lustre/help new file mode 100644 index 000000000..7fb98a81c --- /dev/null +++ b/gcloud/alpha/lustre/help @@ -0,0 +1,31 @@ +NAME + gcloud alpha lustre - manage Lustre resources + +SYNOPSIS + gcloud alpha lustre GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Lustre resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + instances + (ALPHA) Manage Instance resources. + + operations + (ALPHA) Manage Operation resources. + +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 lustre + diff --git a/gcloud/alpha/lustre/instances/create b/gcloud/alpha/lustre/instances/create new file mode 100644 index 000000000..a5e97456d --- /dev/null +++ b/gcloud/alpha/lustre/instances/create @@ -0,0 +1,149 @@ +NAME + gcloud alpha lustre instances create - create instances + +SYNOPSIS + gcloud alpha lustre instances create (INSTANCE : --location=LOCATION) + --capacity-gib=CAPACITY_GIB --filesystem=FILESYSTEM --network=NETWORK + [--async] [--description=DESCRIPTION] [--gke-support-enabled] + [--labels=[LABELS,...]] [--request-id=REQUEST_ID] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create an instance + +EXAMPLES + To create the instance, run: + + $ gcloud alpha lustre instances create + +POSITIONAL ARGUMENTS + Instance resource - Identifier. The name of the instance. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument instance on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the instance resource. + + To set the location attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --capacity-gib=CAPACITY_GIB + The storage capacity of the instance in gibibytes (GiB). Allowed values + are from 18000 to 936000, in increments of 9000. + + --filesystem=FILESYSTEM + The filesystem name for this instance. This name is used by client-side + tools, including when mounting the instance. Must be eight characters + or less and can only contain letters and numbers. + + Network resource - The full name of the VPC network to which the instance + is connected. Must be in the format + projects/{project_id}/global/networks/{network_name}. 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 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=NETWORK + ID of the network or fully qualified identifier for the network. + + To set the network attribute: + ▸ provide the argument --network on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A user-readable description of the instance. + + --gke-support-enabled + Indicates whether you want to enable support for GKE clients. By + default, GKE clients are not supported. + + --labels=[LABELS,...] + Labels as key value pairs. + + KEY + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + +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 lustre/v1alpha API. The full documentation for this + API can be found at: https://cloud.google.com/managed-lustre/ + +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 lustre instances create + diff --git a/gcloud/alpha/lustre/instances/delete b/gcloud/alpha/lustre/instances/delete new file mode 100644 index 000000000..77b007b2d --- /dev/null +++ b/gcloud/alpha/lustre/instances/delete @@ -0,0 +1,87 @@ +NAME + gcloud alpha lustre instances delete - delete instances + +SYNOPSIS + gcloud alpha lustre instances delete (INSTANCE : --location=LOCATION) + [--async] [--request-id=REQUEST_ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete an instance + +EXAMPLES + To delete the instance, run: + + $ gcloud alpha lustre instances delete + +POSITIONAL ARGUMENTS + Instance resource - The resource name of the instance to delete, in the + format projects/{projectId}/locations/{location}/instances/{instanceId}. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument instance on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the instance resource. + + To set the location attribute: + ▸ provide the argument instance 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. + + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes after the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + +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 lustre/v1alpha API. The full documentation for this + API can be found at: https://cloud.google.com/managed-lustre/ + +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 lustre instances delete + diff --git a/gcloud/alpha/lustre/instances/describe b/gcloud/alpha/lustre/instances/describe new file mode 100644 index 000000000..927b6e388 --- /dev/null +++ b/gcloud/alpha/lustre/instances/describe @@ -0,0 +1,67 @@ +NAME + gcloud alpha lustre instances describe - describe instances + +SYNOPSIS + gcloud alpha lustre instances describe (INSTANCE : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe an instance + +EXAMPLES + To describe the instance, run: + + $ gcloud alpha lustre instances describe + +POSITIONAL ARGUMENTS + Instance resource - The instance resource name, in the format + projects/{projectId}/locations/{location}/instances/{instanceId}. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument instance on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the instance resource. + + To set the location attribute: + ▸ provide the argument instance 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 lustre/v1alpha API. The full documentation for this + API can be found at: https://cloud.google.com/managed-lustre/ + +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 lustre instances describe + diff --git a/gcloud/alpha/lustre/instances/export-data b/gcloud/alpha/lustre/instances/export-data new file mode 100644 index 000000000..eea3d0cc5 --- /dev/null +++ b/gcloud/alpha/lustre/instances/export-data @@ -0,0 +1,101 @@ +NAME + gcloud alpha lustre instances export-data - export instances + +SYNOPSIS + gcloud alpha lustre instances export-data (INSTANCE : --location=LOCATION) + --gcs-path-uri=GCS_PATH_URI [--async] [--lustre-path=LUSTRE_PATH] + [--request-id=REQUEST_ID] [--service-account=SERVICE_ACCOUNT] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) export instances + +EXAMPLES + To export all instances, run: + + $ gcloud alpha lustre instances export-data + +POSITIONAL ARGUMENTS + Instance resource - Name of the resource. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument instance 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. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the instance resource. + + To set the location attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --gcs-path-uri=GCS_PATH_URI + URI to a Cloud Storage path in the format: gs://. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --lustre-path=LUSTRE_PATH + Root directory path to the Managed Lustre file system, starting with /. + Defaults to / if unset. + + --request-id=REQUEST_ID + UUID to identify requests. + + ServiceAccount resource - User-specified service account used to perform + the transfer. If unspecified, the Managed Lustre service agent is used. + 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 --service-account on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --service-account=SERVICE_ACCOUNT + ID of the serviceAccount or fully qualified identifier for the + serviceAccount. + + To set the service-account attribute: + ▸ provide the argument --service-account 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 lustre/v1alpha API. The full documentation for this + API can be found at: https://cloud.google.com/managed-lustre/ + +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 lustre instances export-data + diff --git a/gcloud/alpha/lustre/instances/help b/gcloud/alpha/lustre/instances/help new file mode 100644 index 000000000..ace613a32 --- /dev/null +++ b/gcloud/alpha/lustre/instances/help @@ -0,0 +1,46 @@ +NAME + gcloud alpha lustre instances - manage Instance resources + +SYNOPSIS + gcloud alpha lustre instances COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Instance resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create instances. + + delete + (ALPHA) Delete instances. + + describe + (ALPHA) Describe instances. + + export-data + (ALPHA) export instances. + + import-data + (ALPHA) import instances. + + list + (ALPHA) List instances. + + update + (ALPHA) Update instances. + +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 lustre instances + diff --git a/gcloud/alpha/lustre/instances/import-data b/gcloud/alpha/lustre/instances/import-data new file mode 100644 index 000000000..2cb87bf86 --- /dev/null +++ b/gcloud/alpha/lustre/instances/import-data @@ -0,0 +1,101 @@ +NAME + gcloud alpha lustre instances import-data - import instances + +SYNOPSIS + gcloud alpha lustre instances import-data (INSTANCE : --location=LOCATION) + --gcs-path-uri=GCS_PATH_URI [--async] [--lustre-path=LUSTRE_PATH] + [--request-id=REQUEST_ID] [--service-account=SERVICE_ACCOUNT] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) import instances + +EXAMPLES + To import all instances, run: + + $ gcloud alpha lustre instances import-data + +POSITIONAL ARGUMENTS + Instance resource - Name of the resource. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument instance 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. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the instance resource. + + To set the location attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --gcs-path-uri=GCS_PATH_URI + URI to a Cloud Storage path in the format: gs://. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --lustre-path=LUSTRE_PATH + Root directory path to the Managed Lustre file system, starting with /. + Defaults to / if unset. + + --request-id=REQUEST_ID + UUID to identify requests. + + ServiceAccount resource - User-specified service account used to perform + the transfer. If unspecified, the default Lustre P4 service account will + be used. 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 --service-account on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --service-account=SERVICE_ACCOUNT + ID of the serviceAccount or fully qualified identifier for the + serviceAccount. + + To set the service-account attribute: + ▸ provide the argument --service-account 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 lustre/v1alpha API. The full documentation for this + API can be found at: https://cloud.google.com/managed-lustre/ + +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 lustre instances import-data + diff --git a/gcloud/alpha/lustre/instances/list b/gcloud/alpha/lustre/instances/list new file mode 100644 index 000000000..d02248d92 --- /dev/null +++ b/gcloud/alpha/lustre/instances/list @@ -0,0 +1,90 @@ +NAME + gcloud alpha lustre instances list - list instances + +SYNOPSIS + gcloud alpha lustre instances list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List instances + +EXAMPLES + To list all instances, run: + + $ gcloud alpha lustre instances list + +REQUIRED FLAGS + Location resource - The project and location for which to retrieve a list + of instances, in the format projects/{projectId}/locations/{location}. + + To retrieve instance information for all locations, use "-" as the value + of {location}. This represents a Cloud resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +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 lustre/v1alpha API. The full documentation for this + API can be found at: https://cloud.google.com/managed-lustre/ + +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 lustre instances list + diff --git a/gcloud/alpha/lustre/instances/update b/gcloud/alpha/lustre/instances/update new file mode 100644 index 000000000..8b19de8db --- /dev/null +++ b/gcloud/alpha/lustre/instances/update @@ -0,0 +1,160 @@ +NAME + gcloud alpha lustre instances update - update instances + +SYNOPSIS + gcloud alpha lustre instances update (INSTANCE : --location=LOCATION) + [--async] [--capacity-gib=CAPACITY_GIB] [--description=DESCRIPTION] + [--[no-]gke-support-enabled] [--request-id=REQUEST_ID] + [--labels=[LABELS,...] + | --update-labels=[UPDATE_LABELS,...] --clear-labels + | --remove-labels=[__REMOVE_LABELS,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update an instance + +EXAMPLES + To update the instance, run: + + $ gcloud alpha lustre instances update + +POSITIONAL ARGUMENTS + Instance resource - Identifier. The name of the instance. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument instance on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the instance resource. + + To set the location attribute: + ▸ provide the argument instance 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. + + --capacity-gib=CAPACITY_GIB + The storage capacity of the instance in gibibytes (GiB). Allowed values + are from 18000 to 936000, in increments of 9000. + + --description=DESCRIPTION + A user-readable description of the instance. + + --[no-]gke-support-enabled + Indicates whether you want to enable support for GKE clients. By + default, GKE clients are not supported. Use --gke-support-enabled to + enable and --no-gke-support-enabled to disable. + + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + + Update labels. + + At most one of these can be specified: + + --labels=[LABELS,...] + Set labels to new value. Labels as key value pairs. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --update-labels=[UPDATE_LABELS,...] + Update labels value or add key value pair. Labels as key value pairs. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --update-labels=string=string + + JSON Example: + + --update-labels='{"string": "string"}' + + File Example: + + --update-labels=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-labels + Clear labels value and set to empty map. + + --remove-labels=[__REMOVE_LABELS,...] + Remove existing value from map labels. + +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 lustre/v1alpha API. The full documentation for this + API can be found at: https://cloud.google.com/managed-lustre/ + +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 lustre instances update + diff --git a/gcloud/alpha/lustre/operations/cancel b/gcloud/alpha/lustre/operations/cancel new file mode 100644 index 000000000..2dedb27a5 --- /dev/null +++ b/gcloud/alpha/lustre/operations/cancel @@ -0,0 +1,66 @@ +NAME + gcloud alpha lustre operations cancel - cancel operations + +SYNOPSIS + gcloud alpha lustre operations cancel (OPERATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Cancel an operation + +EXAMPLES + To cancel the operation, run: + + $ gcloud alpha lustre operations cancel + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation resource to be cancelled. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument operation on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the operation resource. + + To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the lustre/v1alpha API. The full documentation for this + API can be found at: https://cloud.google.com/managed-lustre/ + +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 lustre operations cancel + diff --git a/gcloud/alpha/lustre/operations/delete b/gcloud/alpha/lustre/operations/delete new file mode 100644 index 000000000..10356aad7 --- /dev/null +++ b/gcloud/alpha/lustre/operations/delete @@ -0,0 +1,66 @@ +NAME + gcloud alpha lustre operations delete - delete operations + +SYNOPSIS + gcloud alpha lustre operations delete (OPERATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete an operation + +EXAMPLES + To delete the operation, run: + + $ gcloud alpha lustre operations delete + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation resource to be deleted. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument operation on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the operation resource. + + To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the lustre/v1alpha API. The full documentation for this + API can be found at: https://cloud.google.com/managed-lustre/ + +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 lustre operations delete + diff --git a/gcloud/alpha/lustre/operations/describe b/gcloud/alpha/lustre/operations/describe new file mode 100644 index 000000000..93c24f372 --- /dev/null +++ b/gcloud/alpha/lustre/operations/describe @@ -0,0 +1,66 @@ +NAME + gcloud alpha lustre operations describe - describe operations + +SYNOPSIS + gcloud alpha lustre operations describe (OPERATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe an operation + +EXAMPLES + To describe the operation, run: + + $ gcloud alpha lustre operations describe + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation resource. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument operation 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. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the operation resource. + + To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the lustre/v1alpha API. The full documentation for this + API can be found at: https://cloud.google.com/managed-lustre/ + +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 lustre operations describe + diff --git a/gcloud/alpha/lustre/operations/help b/gcloud/alpha/lustre/operations/help new file mode 100644 index 000000000..22f5b4399 --- /dev/null +++ b/gcloud/alpha/lustre/operations/help @@ -0,0 +1,40 @@ +NAME + gcloud alpha lustre operations - manage Operation resources + +SYNOPSIS + gcloud alpha lustre operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Operation resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + cancel + (ALPHA) Cancel operations. + + delete + (ALPHA) Delete operations. + + describe + (ALPHA) Describe operations. + + list + (ALPHA) List operations. + + wait + (ALPHA) Wait operations. + +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 lustre operations + diff --git a/gcloud/alpha/lustre/operations/list b/gcloud/alpha/lustre/operations/list new file mode 100644 index 000000000..92567a509 --- /dev/null +++ b/gcloud/alpha/lustre/operations/list @@ -0,0 +1,87 @@ +NAME + gcloud alpha lustre operations list - list operations + +SYNOPSIS + gcloud alpha lustre operations list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List operations + +EXAMPLES + To list all operations, run: + + $ gcloud alpha lustre operations list + +REQUIRED FLAGS + Location resource - The name of the operation's parent resource. 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. + + --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 lustre/v1alpha API. The full documentation for this + API can be found at: https://cloud.google.com/managed-lustre/ + +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 lustre operations list + diff --git a/gcloud/alpha/lustre/operations/wait b/gcloud/alpha/lustre/operations/wait new file mode 100644 index 000000000..d4e2d7738 --- /dev/null +++ b/gcloud/alpha/lustre/operations/wait @@ -0,0 +1,66 @@ +NAME + gcloud alpha lustre operations wait - wait operations + +SYNOPSIS + gcloud alpha lustre operations wait (OPERATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Wait an operation + +EXAMPLES + To wait the operation, run: + + $ gcloud alpha lustre operations wait + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation resource to wait on. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument operation on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the operation resource. + + To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the lustre/v1alpha API. The full documentation for this + API can be found at: https://cloud.google.com/managed-lustre/ + +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 lustre operations wait + diff --git a/gcloud/alpha/netapp/volumes/create b/gcloud/alpha/netapp/volumes/create index 8ca1c1e91..9da54b4d1 100644 --- a/gcloud/alpha/netapp/volumes/create +++ b/gcloud/alpha/netapp/volumes/create @@ -16,10 +16,13 @@ SYNOPSIS [kerberos-5p-read-write=KERBEROS-5P-READ-WRITE], [nfsv3=NFSV3],[nfsv4=NFSV4]] [--hybrid-replication-parameters=[cluster-location=CLUSTER-LOCATION], - [description=DESCRIPTION],[labels=LABELS], + [description=DESCRIPTION], + [hybrid-replication-type=HYBRID-REPLICATION-TYPE],[labels=LABELS], + [large-volume-constituent-count=LARGE-VOLUME-CONSTITUENT-COUNT], [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]] + [peer-volume-name=PEER-VOLUME-NAME],[replication=REPLICATION], + [replication-schedule=REPLICATION-SCHEDULE]] [--labels=[KEY=VALUE,...]] [--large-capacity=LARGE_CAPACITY] [--multiple-endpoints=MULTIPLE_ENDPOINTS] [--restricted-actions=RESTRICTED_ACTION,[...]] @@ -151,7 +154,7 @@ 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=[cluster-location=CLUSTER-LOCATION],[description=DESCRIPTION],[hybrid-replication-type=HYBRID-REPLICATION-TYPE],[labels=LABELS],[large-volume-constituent-count=LARGE-VOLUME-CONSTITUENT-COUNT],[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],[replication-schedule=REPLICATION-SCHEDULE] Hybrid Replication Parameters contains hybrid replication parameters on a volume. @@ -163,7 +166,10 @@ OPTIONAL FLAGS peer-ip-addresses=[PEER-IP-ADDRESS1#PEER-IP-ADDRESS2#...], cluster-location=CLUSTER_LOCATION, description=DESCRIPTION, - labels=[KEY1:VALUE1#KEY2:VALUE2#...] + replication-schedule=REPLICATION_SCHEDULE, + hybrid-replication-type=HYBRID_REPLICATION_TYPE, + large-volume-constituent-count=LARGE_VOLUME_CONSTITUENT_COUNT, + 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, @@ -171,9 +177,13 @@ OPTIONAL FLAGS 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. + description is the description of the replication, replication-schedule + is the schedule of corresponding hybrid replication created, + hybrid-replication-type is the hybrid replication type of the + corresponding hybrid replication created, + large-volume-constituent-count is the number of constituent volumes in + the large volume, 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/alpha/scc/findings/list b/gcloud/alpha/scc/findings/list index 0066b6147..f56be80fc 100644 --- a/gcloud/alpha/scc/findings/list +++ b/gcloud/alpha/scc/findings/list @@ -6,8 +6,10 @@ SYNOPSIS [--compare-duration=COMPARE_DURATION] [--field-mask=FIELD_MASK] [--location=LOCATION; default="global"] [--order-by=ORDER_BY] [--page-token=PAGE_TOKEN] [--read-time=READ_TIME] - [--source=SOURCE; default="-"] [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + [--source=SOURCE; default="-"] + [--folder=FOLDER | --organization=ORGANIZATION | --project=PROJECT] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) List an organization or source's findings. To list across all @@ -164,6 +166,17 @@ FLAGS --source=SOURCE; default="-" Source id. Defaults to all sources. + At most one of these can be specified: + + --folder=FOLDER + The folder ID (e.g., 456) that contains the finding. + + --organization=ORGANIZATION + The organization ID (e.g., 123) that contains the finding. + + --project=PROJECT + The project ID (e.g., example-project) that contains the finding. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/alpha/scc/manage/billing-metadata/describe b/gcloud/alpha/scc/manage/billing-metadata/describe new file mode 100644 index 000000000..2a9ea4edb --- /dev/null +++ b/gcloud/alpha/scc/manage/billing-metadata/describe @@ -0,0 +1,61 @@ +NAME + gcloud alpha scc manage billing-metadata describe - get the billing + metadata for a specific resource + +SYNOPSIS + gcloud alpha scc manage billing-metadata describe + (--organization=ORGANIZATION_ID | --parent=PARENT + | --project=PROJECT_ID_OR_NUMBER) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get the billing metadata for a given Google Cloud resource, + including the associated billing account, cost-related settings, and other + relevant information. + +EXAMPLES + To get the details of a billing metadata for organization 123, run: + + $ gcloud alpha scc manage billing-metadata describe \ + --organization=123 + + To get the details of a billing metadata for project 456, run: + + $ gcloud alpha scc manage billing-metadata describe --project=456 + + You can also specify the parent more generally for organizations: + + $ gcloud alpha scc manage billing-metadata describe \ + --parent=organizations/123 + + Or you can specify the parent for projects: + + $ gcloud alpha scc manage billing-metadata describe \ + --parent=projects/123 + +REQUIRED FLAGS + Exactly one of these must be specified: + + --organization=ORGANIZATION_ID + Organization associated with the billing metadata. + + --parent=PARENT + Parent associated with the billing metadata. Can be one of + organizations/, projects/ + + --project=PROJECT_ID_OR_NUMBER + Project associated with the billing metadata. + +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/scc/manage/billing-metadata/help b/gcloud/alpha/scc/manage/billing-metadata/help new file mode 100644 index 000000000..c60200e3b --- /dev/null +++ b/gcloud/alpha/scc/manage/billing-metadata/help @@ -0,0 +1,26 @@ +NAME + gcloud alpha scc manage billing-metadata - manage billing metadata + +SYNOPSIS + gcloud alpha scc manage billing-metadata COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage billing metadata. + +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) Get the billing metadata for a specific resource. + +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/scc/manage/help b/gcloud/alpha/scc/manage/help index b815e929d..d028f0eb4 100644 --- a/gcloud/alpha/scc/manage/help +++ b/gcloud/alpha/scc/manage/help @@ -16,6 +16,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + billing-metadata + (ALPHA) Manage billing metadata. + custom-modules (ALPHA) Manage Cloud SCC (Security Command Center) custom modules. diff --git a/gcloud/backup-dr/backups/help b/gcloud/backup-dr/backups/help index 0e52cde0a..d3b392d69 100644 --- a/gcloud/backup-dr/backups/help +++ b/gcloud/backup-dr/backups/help @@ -30,6 +30,9 @@ COMMANDS list List Backups. + update + Update the specified Backup. + NOTES This variant is also available: diff --git a/gcloud/backup-dr/backups/update b/gcloud/backup-dr/backups/update new file mode 100644 index 000000000..6904a38a4 --- /dev/null +++ b/gcloud/backup-dr/backups/update @@ -0,0 +1,112 @@ +NAME + gcloud backup-dr backups update - update the specified Backup + +SYNOPSIS + gcloud backup-dr backups update + (BACKUP : --backup-vault=BACKUP_VAULT + --data-source=DATA_SOURCE --location=LOCATION) + --enforced-retention-end-time=ENFORCED_RETENTION_END_TIME [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update the specified Backup. + +EXAMPLES + To update the enforced retention of a backup sample-backup in backup vault + sample-vault, data source sample-ds, project sample-project and location + us-central1, run: + + $ gcloud backup-dr backups update sample-backup \ + --backup-vault=sample-vault --data-source=sample-ds \ + --project=sample-project --location=us-central1 \ + --enforced-retention-end-time="2025-02-14T01:10:20Z" + + To update the expire time of a backup sample-backup in backup vault + sample-vault, data source sample-ds, project sample-project and location + us-central1, run: + + $ gcloud backup-dr backups update sample-backup \ + --backup-vault=sample-vault --data-source=sample-ds \ + --project=sample-project --location=us-central1 \ + --expire-time="2025-02-14T01:10:20Z" + +POSITIONAL ARGUMENTS + Backup resource - Name of the backup to update. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. + + To set the project attribute: + ◆ provide the argument backup on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKUP + ID of the Backup or fully qualified identifier for the Backup. + + To set the name attribute: + ▸ provide the argument backup on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --backup-vault=BACKUP_VAULT + The ID of the Backup Vault. + + To set the backup-vault attribute: + ▸ provide the argument backup on the command line with a fully + specified name; + ▸ provide the argument --backup-vault on the command line. + + --data-source=DATA_SOURCE + The ID of the Data Source. + + To set the data-source attribute: + ▸ provide the argument backup on the command line with a fully + specified name; + ▸ provide the argument --data-source on the command line. + + --location=LOCATION + The location of the Backup. + + To set the location attribute: + ▸ provide the argument backup on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --enforced-retention-end-time=ENFORCED_RETENTION_END_TIME + Backups cannot be deleted until this time or later. This period can be + extended, but not shortened. It should be specified in the format of + "YYYY-MM-DD". + + ◆ For backup configured with a backup appliance, there are additional + restrictions: 1. Enforced retention cannot be extended past the + expiry time. 2. Enforced retention can only be updated for finalized + backups. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +BRIEF + Updates a specific backup + +NOTES + This variant is also available: + + $ gcloud alpha backup-dr backups update + diff --git a/gcloud/beta/compute/backend-services/create b/gcloud/beta/compute/backend-services/create index 298356c96..840240433 100644 --- a/gcloud/beta/compute/backend-services/create +++ b/gcloud/beta/compute/backend-services/create @@ -285,9 +285,9 @@ FLAGS --[no-]enable-cdn Enable or disable Cloud CDN for the backend service. Only available for backend services with --load-balancing-scheme=EXTERNAL that use a - --protocol of HTTP, HTTPS, or HTTP2. Cloud CDN caches HTTP responses at - the edge of Google's network. Cloud CDN is disabled by default. Use - --enable-cdn to enable and --no-enable-cdn to disable. + --protocol of HTTP, HTTPS, HTTP2 or H2C. Cloud CDN caches HTTP + responses at the edge of Google's network. Cloud CDN is disabled by + default. Use --enable-cdn to enable and --no-enable-cdn to disable. --[no-]enable-logging The logging options for the load balancer traffic served by this @@ -541,10 +541,12 @@ FLAGS Load Balancer), the protocol must be one of: TCP, UDP, UNSPECIFIED. If the load-balancing-scheme is INTERNAL_SELF_MANAGED (Traffic - Director), the protocol must be one of: HTTP, HTTPS, HTTP2, GRPC. + Director), the protocol must be one of: HTTP, HTTPS, HTTP2, GRPC, H2C + (beta only). If the load-balancing-scheme is INTERNAL_MANAGED (Internal Application - Load Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + Load Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2, H2C + (beta only). If the load-balancing-scheme is INTERNAL_MANAGED (Internal proxy Network Load Balancer), the protocol must be only TCP. @@ -559,7 +561,8 @@ FLAGS If the load-balancing-scheme is EXTERNAL_MANAGED (Global external Application Load Balancer and regional external Application Load - Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2, H2C (beta + only). If the load-balancing-scheme is EXTERNAL_MANAGED (Global external proxy Network Load Balancer), the protocol must be one of: TCP, SSL. @@ -637,7 +640,7 @@ FLAGS --load-balancing-scheme is EXTERNAL or EXTERNAL_MANAGED, routes requests to backend VMs or endpoints in a NEG, based on the contents of the GCLB cookie set by the load balancer. Only - applicable when --protocol is HTTP, HTTPS, or HTTP2. If the + applicable when --protocol is HTTP, HTTPS,HTTP2 or H2C. If the --load-balancing-scheme is INTERNAL_MANAGED or INTERNAL_SELF_MANAGED, routes requests to backend VMs or endpoints in a NEG, based on the contents of the GCILB cookie set by the @@ -713,21 +716,22 @@ FLAGS Network Load Balancers (global not set and load-balancing-scheme set to EXTERNAL), timeout is ignored. - If the protocol is HTTP, HTTPS, or HTTP2, timeout is a request/response - timeout for HTTP(S) traffic, meaning the amount of time that the load - balancer waits for a backend to return a full response to a request. If - WebSockets traffic is supported, the timeout parameter sets the maximum - amount of time that a WebSocket can be open (idle or not). + If the protocol is HTTP, HTTPS, HTTP2 or H2C, timeout is a + request/response timeout for HTTP(S) traffic, meaning the amount of + time that the load balancer waits for a backend to return a full + response to a request. If WebSockets traffic is supported, the timeout + parameter sets the maximum amount of time that a WebSocket can be open + (idle or not). - For example, for HTTP, HTTPS, or HTTP2 traffic, specifying a timeout of - 10s means that backends have 10 seconds to respond to the load - balancer's requests. The load balancer retries the HTTP GET request one - time if the backend closes the connection or times out before sending - response headers to the load balancer. If the backend sends response - headers or if the request sent to the backend is not an HTTP GET - request, the load balancer does not retry. If the backend does not - reply at all, the load balancer returns a 502 Bad Gateway error to the - client. + For example, for HTTP, HTTPS, HTTP2 or H2C traffic, specifying a + timeout of 10s means that backends have 10 seconds to respond to the + load balancer's requests. The load balancer retries the HTTP GET + request one time if the backend closes the connection or times out + before sending response headers to the load balancer. If the backend + sends response headers or if the request sent to the backend is not an + HTTP GET request, the load balancer does not retry. If the backend does + not reply at all, the load balancer returns a 502 Bad Gateway error to + the client. If the protocol is SSL or TCP, timeout is an idle timeout. diff --git a/gcloud/beta/compute/backend-services/update b/gcloud/beta/compute/backend-services/update index 249440cc0..516421ea7 100644 --- a/gcloud/beta/compute/backend-services/update +++ b/gcloud/beta/compute/backend-services/update @@ -202,9 +202,9 @@ FLAGS --[no-]enable-cdn Enable or disable Cloud CDN for the backend service. Only available for backend services with --load-balancing-scheme=EXTERNAL that use a - --protocol of HTTP, HTTPS, or HTTP2. Cloud CDN caches HTTP responses at - the edge of Google's network. Cloud CDN is disabled by default. Use - --enable-cdn to enable and --no-enable-cdn to disable. + --protocol of HTTP, HTTPS, HTTP2 or H2C. Cloud CDN caches HTTP + responses at the edge of Google's network. Cloud CDN is disabled by + default. Use --enable-cdn to enable and --no-enable-cdn to disable. --[no-]enable-logging The logging options for the load balancer traffic served by this @@ -380,10 +380,12 @@ FLAGS Load Balancer), the protocol must be one of: TCP, UDP, UNSPECIFIED. If the load-balancing-scheme is INTERNAL_SELF_MANAGED (Traffic - Director), the protocol must be one of: HTTP, HTTPS, HTTP2, GRPC. + Director), the protocol must be one of: HTTP, HTTPS, HTTP2, GRPC, H2C + (beta only). If the load-balancing-scheme is INTERNAL_MANAGED (Internal Application - Load Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + Load Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2, H2C + (beta only). If the load-balancing-scheme is INTERNAL_MANAGED (Internal proxy Network Load Balancer), the protocol must be only TCP. @@ -398,7 +400,8 @@ FLAGS If the load-balancing-scheme is EXTERNAL_MANAGED (Global external Application Load Balancer and regional external Application Load - Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2, H2C (beta + only). If the load-balancing-scheme is EXTERNAL_MANAGED (Global external proxy Network Load Balancer), the protocol must be one of: TCP, SSL. @@ -451,7 +454,7 @@ FLAGS --load-balancing-scheme is EXTERNAL or EXTERNAL_MANAGED, routes requests to backend VMs or endpoints in a NEG, based on the contents of the GCLB cookie set by the load balancer. Only - applicable when --protocol is HTTP, HTTPS, or HTTP2. If the + applicable when --protocol is HTTP, HTTPS,HTTP2 or H2C. If the --load-balancing-scheme is INTERNAL_MANAGED or INTERNAL_SELF_MANAGED, routes requests to backend VMs or endpoints in a NEG, based on the contents of the GCILB cookie set by the @@ -526,21 +529,22 @@ FLAGS Network Load Balancers (global not set and load-balancing-scheme set to EXTERNAL), timeout is ignored. - If the protocol is HTTP, HTTPS, or HTTP2, timeout is a request/response - timeout for HTTP(S) traffic, meaning the amount of time that the load - balancer waits for a backend to return a full response to a request. If - WebSockets traffic is supported, the timeout parameter sets the maximum - amount of time that a WebSocket can be open (idle or not). + If the protocol is HTTP, HTTPS, HTTP2 or H2C, timeout is a + request/response timeout for HTTP(S) traffic, meaning the amount of + time that the load balancer waits for a backend to return a full + response to a request. If WebSockets traffic is supported, the timeout + parameter sets the maximum amount of time that a WebSocket can be open + (idle or not). - For example, for HTTP, HTTPS, or HTTP2 traffic, specifying a timeout of - 10s means that backends have 10 seconds to respond to the load - balancer's requests. The load balancer retries the HTTP GET request one - time if the backend closes the connection or times out before sending - response headers to the load balancer. If the backend sends response - headers or if the request sent to the backend is not an HTTP GET - request, the load balancer does not retry. If the backend does not - reply at all, the load balancer returns a 502 Bad Gateway error to the - client. + For example, for HTTP, HTTPS, HTTP2 or H2C traffic, specifying a + timeout of 10s means that backends have 10 seconds to respond to the + load balancer's requests. The load balancer retries the HTTP GET + request one time if the backend closes the connection or times out + before sending response headers to the load balancer. If the backend + sends response headers or if the request sent to the backend is not an + HTTP GET request, the load balancer does not retry. If the backend does + not reply at all, the load balancer returns a 502 Bad Gateway error to + the client. If the protocol is SSL or TCP, timeout is an idle timeout. diff --git a/gcloud/beta/compute/reservations/blocks/describe b/gcloud/beta/compute/reservations/blocks/describe index 79641089d..e547503e2 100644 --- a/gcloud/beta/compute/reservations/blocks/describe +++ b/gcloud/beta/compute/reservations/blocks/describe @@ -10,11 +10,11 @@ DESCRIPTION (BETA) Describe a Compute Engine reservation block. EXAMPLES - To describe a reservation block in reservation exr1 in my-zone with block - name block1, run: + To describe a reservation block in reservation my-reservation in my-zone + with block name my-reservation-block-0001, run: - $ gcloud beta compute reservations blocks describe exr1 \ - --zone=my-zone --block-name=block1 + $ gcloud beta compute reservations blocks describe my-reservation \ + --zone=my-zone --block-name=my-reservation-block-0001 POSITIONAL ARGUMENTS RESERVATION @@ -55,8 +55,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute reservations blocks describe $ gcloud alpha compute reservations blocks describe diff --git a/gcloud/beta/compute/reservations/blocks/help b/gcloud/beta/compute/reservations/blocks/help index 497585b57..e8a8e4beb 100644 --- a/gcloud/beta/compute/reservations/blocks/help +++ b/gcloud/beta/compute/reservations/blocks/help @@ -1,5 +1,6 @@ NAME - gcloud beta compute reservations blocks - + gcloud beta compute reservations blocks - manage Compute Engine reservation + blocks SYNOPSIS gcloud beta compute reservations blocks COMMAND [GCLOUD_WIDE_FLAG ...] @@ -25,8 +26,10 @@ COMMANDS (BETA) Perform maintenance on a reservation block within a reservation. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute reservations blocks $ gcloud alpha compute reservations blocks diff --git a/gcloud/beta/compute/reservations/blocks/list b/gcloud/beta/compute/reservations/blocks/list index dbadf3ee3..3c91d7d47 100644 --- a/gcloud/beta/compute/reservations/blocks/list +++ b/gcloud/beta/compute/reservations/blocks/list @@ -9,20 +9,20 @@ SYNOPSIS DESCRIPTION (BETA) gcloud beta compute reservations blocks list displays all Compute - Engine reservation blocks in an extended reservation. + Engine reservation blocks in a densely deployed reservation. EXAMPLES - To list all reservation blocks in an extended reservation in table form, - run: + To list all reservation blocks in a densely deployed reservation in table + form, run: - $ gcloud beta compute reservations blocks list \ - extended-reservation --zone=us-central1-a --project=my-project + $ gcloud beta compute reservations blocks list my-reservation \ + --zone=us-central1-a --project=my-project - To list the URIs of all reservation blocks in an extended reservation, run: + To list the URIs of all reservation blocks in a densely deployed + reservation, run: - $ gcloud beta compute reservations blocks list \ - extended-reservation --zone=us-central1-a --project=my-project \ - --uri + $ gcloud beta compute reservations blocks list my-reservation \ + --zone=us-central1-a --project=my-project --uri POSITIONAL ARGUMENTS RESERVATION @@ -91,8 +91,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute reservations blocks list $ gcloud alpha compute reservations blocks list diff --git a/gcloud/beta/compute/reservations/blocks/perform-maintenance b/gcloud/beta/compute/reservations/blocks/perform-maintenance index b9f25ec22..81006f21c 100644 --- a/gcloud/beta/compute/reservations/blocks/perform-maintenance +++ b/gcloud/beta/compute/reservations/blocks/perform-maintenance @@ -11,11 +11,12 @@ DESCRIPTION (BETA) Perform maintenance on a reservation block within a reservation. EXAMPLES - To perform maintenance on a reservation block in reservation exr1 in - my-zone with block name block1 with scope all, run: + To perform maintenance on a reservation block in reservation my-reservation + in my-zone with block name my-reservation-block-0001 with scope all, run: - $ gcloud beta compute reservations blocks perform-maintenance exr1 \ - --zone=my-zone --block-name=block1 --scope=all + $ gcloud beta compute reservations blocks perform-maintenance \ + my-reservation --zone=my-zone \ + --block-name=my-reservation-block-0001 --scope=all POSITIONAL ARGUMENTS RESERVATION @@ -69,8 +70,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute reservations blocks perform-maintenance $ gcloud alpha compute reservations blocks perform-maintenance diff --git a/gcloud/beta/compute/reservations/help b/gcloud/beta/compute/reservations/help index ad61228db..ee7acd2f4 100644 --- a/gcloud/beta/compute/reservations/help +++ b/gcloud/beta/compute/reservations/help @@ -22,7 +22,7 @@ GROUPS GROUP is one of the following: blocks - (BETA) + (BETA) Manage Compute Engine reservation blocks. COMMANDS COMMAND is one of the following: diff --git a/gcloud/beta/compute/reservations/perform-maintenance b/gcloud/beta/compute/reservations/perform-maintenance index 1f3d9e334..89bfc5276 100644 --- a/gcloud/beta/compute/reservations/perform-maintenance +++ b/gcloud/beta/compute/reservations/perform-maintenance @@ -12,10 +12,11 @@ DESCRIPTION reservations with reservation blocks. EXAMPLES - To perform maintenance on reservation exr1 in my-zone with scope all, run: + To perform maintenance on reservation my-reservation in my-zone with scope + all, run: - $ gcloud beta compute reservations perform-maintenance exr1 \ - --zone=my-zone --scope=all + $ gcloud beta compute reservations perform-maintenance \ + my-reservation --zone=my-zone --scope=all POSITIONAL ARGUMENTS RESERVATION @@ -64,8 +65,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute reservations perform-maintenance $ gcloud alpha compute reservations perform-maintenance diff --git a/gcloud/beta/config/get b/gcloud/beta/config/get index 1ab7a5cb9..7a471f8ec 100644 --- a/gcloud/beta/config/get +++ b/gcloud/beta/config/get @@ -273,6 +273,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud kms command group. Defaults to https://cloudkms.googleapis.com/ + cloudlocationfinder + Overrides API endpoint for gcloud cloudlocationfinder command + group. Defaults to https://cloudlocationfinder.googleapis.com/ + cloudresourcemanager Overrides API endpoint for gcloud projects command group. Defaults to https://cloudresourcemanager.googleapis.com/ diff --git a/gcloud/beta/config/help b/gcloud/beta/config/help index 6a523c41e..238d1368d 100644 --- a/gcloud/beta/config/help +++ b/gcloud/beta/config/help @@ -305,6 +305,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud kms command group. Defaults to https://cloudkms.googleapis.com/ + cloudlocationfinder + Overrides API endpoint for gcloud cloudlocationfinder command + group. Defaults to https://cloudlocationfinder.googleapis.com/ + cloudresourcemanager Overrides API endpoint for gcloud projects command group. Defaults to https://cloudresourcemanager.googleapis.com/ diff --git a/gcloud/beta/config/list b/gcloud/beta/config/list index 5a6856300..78c5a5572 100644 --- a/gcloud/beta/config/list +++ b/gcloud/beta/config/list @@ -317,6 +317,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud kms command group. Defaults to https://cloudkms.googleapis.com/ + cloudlocationfinder + Overrides API endpoint for gcloud cloudlocationfinder command + group. Defaults to https://cloudlocationfinder.googleapis.com/ + cloudresourcemanager Overrides API endpoint for gcloud projects command group. Defaults to https://cloudresourcemanager.googleapis.com/ diff --git a/gcloud/beta/config/set b/gcloud/beta/config/set index 5612e7eb3..5bf1c7c24 100644 --- a/gcloud/beta/config/set +++ b/gcloud/beta/config/set @@ -320,6 +320,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud kms command group. Defaults to https://cloudkms.googleapis.com/ + cloudlocationfinder + Overrides API endpoint for gcloud cloudlocationfinder command + group. Defaults to https://cloudlocationfinder.googleapis.com/ + cloudresourcemanager Overrides API endpoint for gcloud projects command group. Defaults to https://cloudresourcemanager.googleapis.com/ diff --git a/gcloud/beta/config/unset b/gcloud/beta/config/unset index 86cf30661..0b91a4cde 100644 --- a/gcloud/beta/config/unset +++ b/gcloud/beta/config/unset @@ -281,6 +281,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud kms command group. Defaults to https://cloudkms.googleapis.com/ + cloudlocationfinder + Overrides API endpoint for gcloud cloudlocationfinder command + group. Defaults to https://cloudlocationfinder.googleapis.com/ + cloudresourcemanager Overrides API endpoint for gcloud projects command group. Defaults to https://cloudresourcemanager.googleapis.com/ diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index 855f115e9..76fb7ff93 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -9,8 +9,8 @@ SYNOPSIS gpu-partition-size=GPU_PARTITION_SIZE, gpu-sharing-strategy=GPU_SHARING_STRATEGY, max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...]] - [--addons=[ADDON,...]] [--allow-route-overlap] [--async] - [--auto-monitoring-scope=AUTO_MONITORING_SCOPE] + [--addons=[ADDON[=ENABLED|DISABLED],...]] [--allow-route-overlap] + [--async] [--auto-monitoring-scope=AUTO_MONITORING_SCOPE] [--autoprovisioning-enable-insecure-kubelet-readonly-port] [--autoprovisioning-network-tags=TAGS,[TAGS,...]] [--autoprovisioning-resource-manager-tags=[KEY=VALUE,...]] @@ -133,7 +133,6 @@ SYNOPSIS --master-ipv4-cidr=MASTER_IPV4_CIDR --private-cluster] [--enable-secret-manager --enable-secret-manager-rotation --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL] - [--enable-tpu --enable-tpu-service-networking | --tpu-ipv4-cidr=CIDR] [--ephemeral-storage[=[local-ssd-count=LOCAL-SSD-COUNT]] | --ephemeral-storage-local-ssd[=[count=COUNT]] | --local-nvme-ssd-block[=[count=COUNT]] @@ -207,7 +206,7 @@ FLAGS (Optional) The max number of containers allowed to share each GPU on the node. This field is used together with gpu-sharing-strategy. - --addons=[ADDON,...] + --addons=[ADDON[=ENABLED|DISABLED],...] Addons (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters#Cluster.AddonsConfig) are additional Kubernetes cluster components. Addons specified by this @@ -2113,36 +2112,6 @@ FLAGS Set the rotation period for secrets in the Secret Manager CSI driver provider component. - Flags relating to Cloud TPUs: - - --enable-tpu - Enable Cloud TPUs for this cluster. - - Can not be specified unless --enable-ip-alias is also specified. - - At most one of these can be specified: - - --enable-tpu-service-networking - Enable Cloud TPU's Service Networking mode. In this mode, the CIDR - blocks used by the Cloud TPUs will be allocated and managed by - Service Networking, instead of Kubernetes Engine. - - This cannot be specified if tpu-ipv4-cidr is specified. - - --tpu-ipv4-cidr=CIDR - Set the IP range for the Cloud TPUs. - - Can be specified as a netmask size (e.g. '/20') or as in CIDR - notion (e.g. '10.100.0.0/20'). If given as a netmask size, the IP - range will be chosen automatically from the available space in the - network. - - If unspecified, the TPU CIDR range will use automatic default - '/20'. - - Can not be specified unless '--enable-tpu' and '--enable-ip-alias' - are also specified. - At most one of these can be specified: --ephemeral-storage[=[local-ssd-count=LOCAL-SSD-COUNT]] diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index 1361e5fe0..e390f37c8 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -108,7 +108,6 @@ SYNOPSIS --enable-insecure-binding-system-unauthenticated | --enable-secret-manager --enable-secret-manager-rotation --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL - | --enable-tpu --enable-tpu-service-networking | --tpu-ipv4-cidr=CIDR | --logging-service=LOGGING_SERVICE --monitoring-service=MONITORING_SERVICE | --password=PASSWORD --enable-basic-auth @@ -1513,36 +1512,6 @@ REQUIRED FLAGS Set the rotation period for secrets in the Secret Manager CSI driver provider component. - Flags relating to Cloud TPUs: - - --enable-tpu - Enable Cloud TPUs for this cluster. - - Can not be specified unless --enable-ip-alias is also specified. - - At most one of these can be specified: - - --enable-tpu-service-networking - Enable Cloud TPU's Service Networking mode. In this mode, the - CIDR blocks used by the Cloud TPUs will be allocated and managed - by Service Networking, instead of Kubernetes Engine. - - This cannot be specified if tpu-ipv4-cidr is specified. - - --tpu-ipv4-cidr=CIDR - Set the IP range for the Cloud TPUs. - - Can be specified as a netmask size (e.g. '/20') or as in CIDR - notion (e.g. '10.100.0.0/20'). If given as a netmask size, the IP - range will be chosen automatically from the available space in - the network. - - If unspecified, the TPU CIDR range will use automatic default - '/20'. - - Can not be specified unless '--enable-tpu' and - '--enable-ip-alias' are also specified. - --logging-service=LOGGING_SERVICE (DEPRECATED) Logging service to use for the cluster. Options are: "logging.googleapis.com/kubernetes" (the Google Cloud Logging service diff --git a/gcloud/beta/datastream/private-connections/create b/gcloud/beta/datastream/private-connections/create index 76cab2e7b..7157d56c7 100644 --- a/gcloud/beta/datastream/private-connections/create +++ b/gcloud/beta/datastream/private-connections/create @@ -6,7 +6,7 @@ SYNOPSIS gcloud beta datastream private-connections create (PRIVATE_CONNECTION : --location=LOCATION) --display-name=DISPLAY_NAME (--subnet=SUBNET --vpc-name=VPC_NAME) [--labels=[KEY=VALUE,...]] - [GCLOUD_WIDE_FLAG ...] + [--validate-only] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) (DEPRECATED) Datastream beta version is deprecated. Please @@ -15,7 +15,8 @@ DESCRIPTION Create a Datastream private connection EXAMPLES - To create a privateConnection called 'my-privateConnection', run: + To create a privateConnection with VPC Peering called + 'my-privateConnection', run: $ gcloud beta datastream private-connections create \ my-privateConnection --location=us-central1 \ @@ -60,29 +61,31 @@ REQUIRED FLAGS This must be specified. - --subnet=SUBNET - A free subnet for peering. (CIDR of /29). + Arguments for VPC Peering configuration. - This flag argument must be specified if any of the other arguments in - this group are specified. + --subnet=SUBNET + A free subnet for peering. (CIDR of /29). - Vpc resource - Resource ID of the private connection. This represents a - Cloud resource. (NOTE) Some attributes are not given arguments in this - group but can be set in other ways. + This flag argument must be specified if any of the other arguments + in this group are specified. - To set the project attribute: - ▸ provide the argument --vpc-name on the command line with a fully - specified name; - ▸ provide the argument --project on the command line; - ▸ set the property core/project. + Vpc resource - Resource ID of the VPC network to peer with. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. - This must be specified. + To set the project attribute: + ▫ provide the argument --vpc-name on the command line with a fully + specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. - --vpc-name=VPC_NAME - ID of the vpc or fully qualified identifier for the vpc. + This must be specified. - To set the vpc attribute: - ▫ provide the argument --vpc-name on the command line. + --vpc-name=VPC_NAME + ID of the vpc or fully qualified identifier for the vpc. + + To set the vpc attribute: + ◇ provide the argument --vpc-name on the command line. OPTIONAL FLAGS --labels=[KEY=VALUE,...] @@ -93,6 +96,10 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --validate-only + If set, the request will retrieve the project id to allow in the + network attachment Datastream will connect to. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/dns/managed-zones/create b/gcloud/beta/dns/managed-zones/create index 8d9fd8db5..494591c84 100644 --- a/gcloud/beta/dns/managed-zones/create +++ b/gcloud/beta/dns/managed-zones/create @@ -65,10 +65,10 @@ OPTIONAL FLAGS Enable DNSSEC and allow transferring a signed zone in or out. --forwarding-targets=[IP_ADDRESSES,...] - List of IPv4 addresses of target name servers that the zone will - forward queries to. Ignored for public visibility. Non-RFC1918 - addresses will forward to the target through the Internet. RFC1918 - addresses will forward through the VPC. + List of IPv4/IPv6 addresses or one domain name of the target name + server that the zone will forward queries to. Ignored for public + visibility. Non-RFC1918 addresses will forward to the target through + the Internet. RFC1918 addresses will forward through the VPC. --gkeclusters=[GKECLUSTERS,...] List of GKE clusters that the zone should be visible in if the zone @@ -108,9 +108,10 @@ OPTIONAL FLAGS visibility is [private]. --private-forwarding-targets=[IP_ADDRESSES,...] - List of IPv4 addresses of target name servers that the zone will - forward queries to. Ignored for public visibility. All addresses - specified for this parameter will be reached through the VPC. + List of IPv4/IPv6 addresses or one domain name of the target name + server that the zone will forward queries to. Ignored for public + visibility. All addresses specified for this parameter will be reached + through the VPC. --service-directory-namespace=SERVICE_DIRECTORY_NAMESPACE The fully qualified URL of the service directory namespace that should diff --git a/gcloud/beta/dns/managed-zones/update b/gcloud/beta/dns/managed-zones/update index 814d7ef5a..17ce9ce8b 100644 --- a/gcloud/beta/dns/managed-zones/update +++ b/gcloud/beta/dns/managed-zones/update @@ -73,10 +73,10 @@ FLAGS Enable DNSSEC and allow transferring a signed zone in or out. --forwarding-targets=[IP_ADDRESSES,...] - List of IPv4 addresses of target name servers that the zone will - forward queries to. Ignored for public visibility. Non-RFC1918 - addresses will forward to the target through the Internet. RFC1918 - addresses will forward through the VPC. + List of IPv4/IPv6 addresses or one domain name of the target name + server that the zone will forward queries to. Ignored for public + visibility. Non-RFC1918 addresses will forward to the target through + the Internet. RFC1918 addresses will forward through the VPC. --gkeclusters=[GKECLUSTERS,...] List of GKE clusters that the zone should be visible in if the zone @@ -108,9 +108,10 @@ FLAGS visibility is [private]. --private-forwarding-targets=[IP_ADDRESSES,...] - List of IPv4 addresses of target name servers that the zone will - forward queries to. Ignored for public visibility. All addresses - specified for this parameter will be reached through the VPC. + List of IPv4/IPv6 addresses or one domain name of the target name + server that the zone will forward queries to. Ignored for public + visibility. All addresses specified for this parameter will be reached + through the VPC. --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value diff --git a/gcloud/beta/filestore/instances/create b/gcloud/beta/filestore/instances/create index 6e7de85c7..1f87fa1e9 100644 --- a/gcloud/beta/filestore/instances/create +++ b/gcloud/beta/filestore/instances/create @@ -11,6 +11,7 @@ SYNOPSIS [reserved-ip-range=RESERVED-IP-RANGE] [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--location=LOCATION] + [--managed-ad=[computer=COMPUTER],[domain=DOMAIN]] [--performance=[max-iops=MAX-IOPS],[max-iops-per-tb=MAX-IOPS-PER-TB]] [--protocol=PROTOCOL; default="NFS_V3"] [--region=REGION] [--source-instance=SOURCE_INSTANCE] [--tags=[KEY=VALUE,...]] @@ -19,9 +20,6 @@ SYNOPSIS : --deletion-protection-reason=DELETION_PROTECTION_REASON] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] - [--ldap=[^:^domain=DOMAIN:servers=SERVER1, - SERVER2:users_ou=USERSOU:groups_ou=GROUPSOU,...] - | --managed-ad=[computer=COMPUTER],[domain=DOMAIN]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -41,8 +39,6 @@ EXAMPLES --kms-key=KMS-KEY --kms-keyring=KMS_KEYRING \ --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT \ --managed-ad=domain=DOMAIN,computer=COMPUTER \ - --ldap=^:^domain=DOMAIN:servers=SERVER1,\ - SERVER2:users_ou=USERSOU:groups_ou=GROUPSOU \ --flags-file=FLAGS_FILE --source-instance=SOURCE_INSTANCE Example json configuration file: @@ -245,6 +241,23 @@ OPTIONAL FLAGS --location=LOCATION Location of the Cloud Filestore instance/operation. + Directory services configuration for an instance. + + At most one of these can be specified: + + --managed-ad=[computer=COMPUTER],[domain=DOMAIN] + Managed Active Directory configuration for an instance. Specifies + both the domain name and a computer name (unique to the domain) to be + created by the filestore instance. + + domain + The desired domain full uri. i.e.: + projects/PROJECT/locations/global/domains/DOMAIN + + computer + The desired active directory computer name to be created by + the filestore instance when connecting to the domain. + --performance=[max-iops=MAX-IOPS],[max-iops-per-tb=MAX-IOPS-PER-TB] Performance configuration for the instance. This flag is used to configure the read IOPS provisioned for the instance. The instance's @@ -385,45 +398,6 @@ OPTIONAL FLAGS ▸ provide the argument --kms-project on the command line; ▸ set the property core/project. - Directory services configuration for an instance. - - At most one of these can be specified: - - --ldap=[^:^domain=DOMAIN:servers=SERVER1,SERVER2:users_ou=USERSOU:groups_ou=GROUPSOU,...] - LDAP configuration for an instance. Specifies the domain name, - servers, users_ou, and groups_ou to be created by the filestore - instance. users_ou and groups_ou are optional. - - domain - The desired domain name. i.e.: - 'my-domain.com' - - Servers - The desired LDAP servers. i.e.: - 'ldap.example.com', 'ldap2.example.com' - - Usersou - The desired usersou. - - Groups_ou - The desired groups_ou. - - Use the following format to specify the LDAP configuration: - --ldap=^:^domain=my-domain.com:servers=ldap.example.com,ldap2.example.com:users_ou=users:groups_ou=groups - - --managed-ad=[computer=COMPUTER],[domain=DOMAIN] - Managed Active Directory configuration for an instance. Specifies - both the domain name and a computer name (unique to the domain) to be - created by the filestore instance. - - domain - The desired domain full uri. i.e.: - projects/PROJECT/locations/global/domains/DOMAIN - - computer - The desired active directory computer name to be created by - the filestore instance when connecting to the domain. - 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/firestore/backups/schedules/help b/gcloud/beta/firestore/backups/schedules/help index 6d74f4ee7..3326f86ac 100644 --- a/gcloud/beta/firestore/backups/schedules/help +++ b/gcloud/beta/firestore/backups/schedules/help @@ -26,7 +26,7 @@ COMMANDS (BETA) Describes a Cloud Firestore backup schedule. list - (BETA) Lists backup schedules under a Cloud Firesore database. + (BETA) Lists backup schedules under a Cloud Firestore database. update (BETA) Updates a Cloud Firestore backup schedule. diff --git a/gcloud/beta/firestore/backups/schedules/list b/gcloud/beta/firestore/backups/schedules/list index f3055b6e0..5a2c5fbea 100644 --- a/gcloud/beta/firestore/backups/schedules/list +++ b/gcloud/beta/firestore/backups/schedules/list @@ -1,6 +1,6 @@ NAME gcloud beta firestore backups schedules list - lists backup schedules under - a Cloud Firesore database + a Cloud Firestore database SYNOPSIS gcloud beta firestore backups schedules list --database=DATABASE diff --git a/gcloud/beta/firestore/user-creds/help b/gcloud/beta/firestore/user-creds/help index c1ad6053b..336558113 100644 --- a/gcloud/beta/firestore/user-creds/help +++ b/gcloud/beta/firestore/user-creds/help @@ -32,7 +32,7 @@ COMMANDS (BETA) Enables a Cloud Firestore user creds. list - (BETA) Lists user creds under a Cloud Firesore database. + (BETA) Lists user creds under a Cloud Firestore database. reset-password (BETA) Resets a Cloud Firestore user creds. diff --git a/gcloud/beta/firestore/user-creds/list b/gcloud/beta/firestore/user-creds/list index e01afdb4f..f58209416 100644 --- a/gcloud/beta/firestore/user-creds/list +++ b/gcloud/beta/firestore/user-creds/list @@ -1,6 +1,6 @@ NAME gcloud beta firestore user-creds list - lists user creds under a Cloud - Firesore database + Firestore database SYNOPSIS gcloud beta firestore user-creds list --database=DATABASE diff --git a/gcloud/beta/netapp/volumes/create b/gcloud/beta/netapp/volumes/create index ba668a8ba..74c2b39d2 100644 --- a/gcloud/beta/netapp/volumes/create +++ b/gcloud/beta/netapp/volumes/create @@ -19,10 +19,13 @@ SYNOPSIS [kerberos-5p-read-write=KERBEROS-5P-READ-WRITE], [nfsv3=NFSV3],[nfsv4=NFSV4]] [--hybrid-replication-parameters=[cluster-location=CLUSTER-LOCATION], - [description=DESCRIPTION],[labels=LABELS], + [description=DESCRIPTION], + [hybrid-replication-type=HYBRID-REPLICATION-TYPE],[labels=LABELS], + [large-volume-constituent-count=LARGE-VOLUME-CONSTITUENT-COUNT], [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]] + [peer-volume-name=PEER-VOLUME-NAME],[replication=REPLICATION], + [replication-schedule=REPLICATION-SCHEDULE]] [--labels=[KEY=VALUE,...]] [--large-capacity=LARGE_CAPACITY] [--multiple-endpoints=MULTIPLE_ENDPOINTS] [--restricted-actions=RESTRICTED_ACTION,[...]] @@ -169,7 +172,7 @@ 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=[cluster-location=CLUSTER-LOCATION],[description=DESCRIPTION],[hybrid-replication-type=HYBRID-REPLICATION-TYPE],[labels=LABELS],[large-volume-constituent-count=LARGE-VOLUME-CONSTITUENT-COUNT],[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],[replication-schedule=REPLICATION-SCHEDULE] Hybrid Replication Parameters contains hybrid replication parameters on a volume. @@ -181,7 +184,10 @@ OPTIONAL FLAGS peer-ip-addresses=[PEER-IP-ADDRESS1#PEER-IP-ADDRESS2#...], cluster-location=CLUSTER_LOCATION, description=DESCRIPTION, - labels=[KEY1:VALUE1#KEY2:VALUE2#...] + replication-schedule=REPLICATION_SCHEDULE, + hybrid-replication-type=HYBRID_REPLICATION_TYPE, + large-volume-constituent-count=LARGE_VOLUME_CONSTITUENT_COUNT, + 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, @@ -189,9 +195,13 @@ OPTIONAL FLAGS 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. + description is the description of the replication, replication-schedule + is the schedule of corresponding hybrid replication created, + hybrid-replication-type is the hybrid replication type of the + corresponding hybrid replication created, + large-volume-constituent-count is the number of constituent volumes in + the large volume, 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/beta/scc/findings/list b/gcloud/beta/scc/findings/list index 7984ebe7f..1ea87a987 100644 --- a/gcloud/beta/scc/findings/list +++ b/gcloud/beta/scc/findings/list @@ -6,8 +6,10 @@ SYNOPSIS [--compare-duration=COMPARE_DURATION] [--field-mask=FIELD_MASK] [--location=LOCATION; default="global"] [--order-by=ORDER_BY] [--page-token=PAGE_TOKEN] [--read-time=READ_TIME] - [--source=SOURCE; default="-"] [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + [--source=SOURCE; default="-"] + [--folder=FOLDER | --organization=ORGANIZATION | --project=PROJECT] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) List an organization or source's findings. To list across all @@ -164,6 +166,17 @@ FLAGS --source=SOURCE; default="-" Source id. Defaults to all sources. + At most one of these can be specified: + + --folder=FOLDER + The folder ID (e.g., 456) that contains the finding. + + --organization=ORGANIZATION + The organization ID (e.g., 123) that contains the finding. + + --project=PROJECT + The project ID (e.g., example-project) that contains the finding. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/compute/backend-services/create b/gcloud/compute/backend-services/create index 07447672a..3dc7d8345 100644 --- a/gcloud/compute/backend-services/create +++ b/gcloud/compute/backend-services/create @@ -278,9 +278,9 @@ FLAGS --[no-]enable-cdn Enable or disable Cloud CDN for the backend service. Only available for backend services with --load-balancing-scheme=EXTERNAL that use a - --protocol of HTTP, HTTPS, or HTTP2. Cloud CDN caches HTTP responses at - the edge of Google's network. Cloud CDN is disabled by default. Use - --enable-cdn to enable and --no-enable-cdn to disable. + --protocol of HTTP, HTTPS, HTTP2 or H2C. Cloud CDN caches HTTP + responses at the edge of Google's network. Cloud CDN is disabled by + default. Use --enable-cdn to enable and --no-enable-cdn to disable. --[no-]enable-logging The logging options for the load balancer traffic served by this @@ -531,10 +531,12 @@ FLAGS Load Balancer), the protocol must be one of: TCP, UDP, UNSPECIFIED. If the load-balancing-scheme is INTERNAL_SELF_MANAGED (Traffic - Director), the protocol must be one of: HTTP, HTTPS, HTTP2, GRPC. + Director), the protocol must be one of: HTTP, HTTPS, HTTP2, GRPC, H2C + (beta only). If the load-balancing-scheme is INTERNAL_MANAGED (Internal Application - Load Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + Load Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2, H2C + (beta only). If the load-balancing-scheme is INTERNAL_MANAGED (Internal proxy Network Load Balancer), the protocol must be only TCP. @@ -549,7 +551,8 @@ FLAGS If the load-balancing-scheme is EXTERNAL_MANAGED (Global external Application Load Balancer and regional external Application Load - Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2, H2C (beta + only). If the load-balancing-scheme is EXTERNAL_MANAGED (Global external proxy Network Load Balancer), the protocol must be one of: TCP, SSL. @@ -627,7 +630,7 @@ FLAGS --load-balancing-scheme is EXTERNAL or EXTERNAL_MANAGED, routes requests to backend VMs or endpoints in a NEG, based on the contents of the GCLB cookie set by the load balancer. Only - applicable when --protocol is HTTP, HTTPS, or HTTP2. If the + applicable when --protocol is HTTP, HTTPS,HTTP2 or H2C. If the --load-balancing-scheme is INTERNAL_MANAGED or INTERNAL_SELF_MANAGED, routes requests to backend VMs or endpoints in a NEG, based on the contents of the GCILB cookie set by the @@ -697,21 +700,22 @@ FLAGS Network Load Balancers (global not set and load-balancing-scheme set to EXTERNAL), timeout is ignored. - If the protocol is HTTP, HTTPS, or HTTP2, timeout is a request/response - timeout for HTTP(S) traffic, meaning the amount of time that the load - balancer waits for a backend to return a full response to a request. If - WebSockets traffic is supported, the timeout parameter sets the maximum - amount of time that a WebSocket can be open (idle or not). + If the protocol is HTTP, HTTPS, HTTP2 or H2C, timeout is a + request/response timeout for HTTP(S) traffic, meaning the amount of + time that the load balancer waits for a backend to return a full + response to a request. If WebSockets traffic is supported, the timeout + parameter sets the maximum amount of time that a WebSocket can be open + (idle or not). - For example, for HTTP, HTTPS, or HTTP2 traffic, specifying a timeout of - 10s means that backends have 10 seconds to respond to the load - balancer's requests. The load balancer retries the HTTP GET request one - time if the backend closes the connection or times out before sending - response headers to the load balancer. If the backend sends response - headers or if the request sent to the backend is not an HTTP GET - request, the load balancer does not retry. If the backend does not - reply at all, the load balancer returns a 502 Bad Gateway error to the - client. + For example, for HTTP, HTTPS, HTTP2 or H2C traffic, specifying a + timeout of 10s means that backends have 10 seconds to respond to the + load balancer's requests. The load balancer retries the HTTP GET + request one time if the backend closes the connection or times out + before sending response headers to the load balancer. If the backend + sends response headers or if the request sent to the backend is not an + HTTP GET request, the load balancer does not retry. If the backend does + not reply at all, the load balancer returns a 502 Bad Gateway error to + the client. If the protocol is SSL or TCP, timeout is an idle timeout. diff --git a/gcloud/compute/backend-services/update b/gcloud/compute/backend-services/update index 8609f199b..fa1a35e3f 100644 --- a/gcloud/compute/backend-services/update +++ b/gcloud/compute/backend-services/update @@ -193,9 +193,9 @@ FLAGS --[no-]enable-cdn Enable or disable Cloud CDN for the backend service. Only available for backend services with --load-balancing-scheme=EXTERNAL that use a - --protocol of HTTP, HTTPS, or HTTP2. Cloud CDN caches HTTP responses at - the edge of Google's network. Cloud CDN is disabled by default. Use - --enable-cdn to enable and --no-enable-cdn to disable. + --protocol of HTTP, HTTPS, HTTP2 or H2C. Cloud CDN caches HTTP + responses at the edge of Google's network. Cloud CDN is disabled by + default. Use --enable-cdn to enable and --no-enable-cdn to disable. --[no-]enable-logging The logging options for the load balancer traffic served by this @@ -355,10 +355,12 @@ FLAGS Load Balancer), the protocol must be one of: TCP, UDP, UNSPECIFIED. If the load-balancing-scheme is INTERNAL_SELF_MANAGED (Traffic - Director), the protocol must be one of: HTTP, HTTPS, HTTP2, GRPC. + Director), the protocol must be one of: HTTP, HTTPS, HTTP2, GRPC, H2C + (beta only). If the load-balancing-scheme is INTERNAL_MANAGED (Internal Application - Load Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + Load Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2, H2C + (beta only). If the load-balancing-scheme is INTERNAL_MANAGED (Internal proxy Network Load Balancer), the protocol must be only TCP. @@ -373,7 +375,8 @@ FLAGS If the load-balancing-scheme is EXTERNAL_MANAGED (Global external Application Load Balancer and regional external Application Load - Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2. + Balancer), the protocol must be one of: HTTP, HTTPS, HTTP2, H2C (beta + only). If the load-balancing-scheme is EXTERNAL_MANAGED (Global external proxy Network Load Balancer), the protocol must be one of: TCP, SSL. @@ -426,7 +429,7 @@ FLAGS --load-balancing-scheme is EXTERNAL or EXTERNAL_MANAGED, routes requests to backend VMs or endpoints in a NEG, based on the contents of the GCLB cookie set by the load balancer. Only - applicable when --protocol is HTTP, HTTPS, or HTTP2. If the + applicable when --protocol is HTTP, HTTPS,HTTP2 or H2C. If the --load-balancing-scheme is INTERNAL_MANAGED or INTERNAL_SELF_MANAGED, routes requests to backend VMs or endpoints in a NEG, based on the contents of the GCILB cookie set by the @@ -495,21 +498,22 @@ FLAGS Network Load Balancers (global not set and load-balancing-scheme set to EXTERNAL), timeout is ignored. - If the protocol is HTTP, HTTPS, or HTTP2, timeout is a request/response - timeout for HTTP(S) traffic, meaning the amount of time that the load - balancer waits for a backend to return a full response to a request. If - WebSockets traffic is supported, the timeout parameter sets the maximum - amount of time that a WebSocket can be open (idle or not). + If the protocol is HTTP, HTTPS, HTTP2 or H2C, timeout is a + request/response timeout for HTTP(S) traffic, meaning the amount of + time that the load balancer waits for a backend to return a full + response to a request. If WebSockets traffic is supported, the timeout + parameter sets the maximum amount of time that a WebSocket can be open + (idle or not). - For example, for HTTP, HTTPS, or HTTP2 traffic, specifying a timeout of - 10s means that backends have 10 seconds to respond to the load - balancer's requests. The load balancer retries the HTTP GET request one - time if the backend closes the connection or times out before sending - response headers to the load balancer. If the backend sends response - headers or if the request sent to the backend is not an HTTP GET - request, the load balancer does not retry. If the backend does not - reply at all, the load balancer returns a 502 Bad Gateway error to the - client. + For example, for HTTP, HTTPS, HTTP2 or H2C traffic, specifying a + timeout of 10s means that backends have 10 seconds to respond to the + load balancer's requests. The load balancer retries the HTTP GET + request one time if the backend closes the connection or times out + before sending response headers to the load balancer. If the backend + sends response headers or if the request sent to the backend is not an + HTTP GET request, the load balancer does not retry. If the backend does + not reply at all, the load balancer returns a 502 Bad Gateway error to + the client. If the protocol is SSL or TCP, timeout is an idle timeout. diff --git a/gcloud/compute/commitments/create b/gcloud/compute/commitments/create index 05922c92b..48a2df4b8 100644 --- a/gcloud/compute/commitments/create +++ b/gcloud/compute/commitments/create @@ -105,11 +105,12 @@ OPTIONAL FLAGS accelerator-optimized-a3, accelerator-optimized-a3-mega, accelerator-optimized-a3-ultra, accelerator-optimized-a4, compute-optimized, compute-optimized-c2d, compute-optimized-c3, - compute-optimized-c3d, compute-optimized-h3, general-purpose, - 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, memory-optimized-m4, memory-optimized-x4-16tb, + compute-optimized-c3d, compute-optimized-h3, compute-optimized-h4d, + general-purpose, general-purpose-c4, general-purpose-c4a, + general-purpose-c4d, 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-16tb, memory-optimized-x4-24tb, memory-optimized-x4-32tb, storage-optimized-z3. diff --git a/gcloud/compute/reservations/blocks/describe b/gcloud/compute/reservations/blocks/describe new file mode 100644 index 000000000..474ef4ec1 --- /dev/null +++ b/gcloud/compute/reservations/blocks/describe @@ -0,0 +1,63 @@ +NAME + gcloud compute reservations blocks describe - describe a Compute Engine + reservation block + +SYNOPSIS + gcloud compute reservations blocks describe RESERVATION + --block-name=BLOCK_NAME [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a Compute Engine reservation block. + +EXAMPLES + To describe a reservation block in reservation my-reservation in my-zone + with block name my-reservation-block-0001, run: + + $ gcloud compute reservations blocks describe my-reservation \ + --zone=my-zone --block-name=my-reservation-block-0001 + +POSITIONAL ARGUMENTS + RESERVATION + Name of the reservation to describe. + +REQUIRED FLAGS + --block-name=BLOCK_NAME + The name of the reservation block. + +OPTIONAL FLAGS + --zone=ZONE + Zone of the reservation to describe. If not specified and the + compute/zone property isn't set, you might be prompted to select a zone + (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute reservations blocks describe + + $ gcloud beta compute reservations blocks describe + diff --git a/gcloud/compute/reservations/blocks/help b/gcloud/compute/reservations/blocks/help new file mode 100644 index 000000000..639f4ded0 --- /dev/null +++ b/gcloud/compute/reservations/blocks/help @@ -0,0 +1,34 @@ +NAME + gcloud compute reservations blocks - manage Compute Engine reservation + blocks + +SYNOPSIS + gcloud compute reservations blocks COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Compute Engine reservation blocks. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Describe a Compute Engine reservation block. + + list + List Compute Engine reservation blocks. + + perform-maintenance + Perform maintenance on a reservation block within a reservation. + +NOTES + These variants are also available: + + $ gcloud alpha compute reservations blocks + + $ gcloud beta compute reservations blocks + diff --git a/gcloud/compute/reservations/blocks/list b/gcloud/compute/reservations/blocks/list new file mode 100644 index 000000000..b14b94fec --- /dev/null +++ b/gcloud/compute/reservations/blocks/list @@ -0,0 +1,99 @@ +NAME + gcloud compute reservations blocks list - list Compute Engine reservation + blocks + +SYNOPSIS + gcloud compute reservations blocks list RESERVATION [--zone=ZONE] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute reservations blocks list displays all Compute Engine + reservation blocks in a densely deployed reservation. + +EXAMPLES + To list all reservation blocks in a densely deployed reservation in table + form, run: + + $ gcloud compute reservations blocks list my-reservation \ + --zone=us-central1-a --project=my-project + + To list the URIs of all reservation blocks in a densely deployed + reservation, run: + + $ gcloud compute reservations blocks list my-reservation \ + --zone=us-central1-a --project=my-project --uri + +POSITIONAL ARGUMENTS + RESERVATION + Name of the reservation to operate on. + +FLAGS + --zone=ZONE + Zone of the reservation 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. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute reservations blocks list + + $ gcloud beta compute reservations blocks list + diff --git a/gcloud/compute/reservations/blocks/perform-maintenance b/gcloud/compute/reservations/blocks/perform-maintenance new file mode 100644 index 000000000..225d78757 --- /dev/null +++ b/gcloud/compute/reservations/blocks/perform-maintenance @@ -0,0 +1,78 @@ +NAME + gcloud compute reservations blocks perform-maintenance - perform + maintenance on a reservation block within a reservation + +SYNOPSIS + gcloud compute reservations blocks perform-maintenance RESERVATION + --block-name=BLOCK_NAME [--scope=SCOPE] [--zone=ZONE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Perform maintenance on a reservation block within a reservation. + +EXAMPLES + To perform maintenance on a reservation block in reservation my-reservation + in my-zone with block name my-reservation-block-0001 with scope all, run: + + $ gcloud compute reservations blocks perform-maintenance \ + my-reservation --zone=my-zone \ + --block-name=my-reservation-block-0001 --scope=all + +POSITIONAL ARGUMENTS + RESERVATION + Name of the reservation to perform-maintenance. + +REQUIRED FLAGS + --block-name=BLOCK_NAME + The name of the reservation block. + +OPTIONAL FLAGS + --scope=SCOPE + The maintenance scope to set for the reservation block. SCOPE must be + one of: + + all + Perform maintenance on all hosts in the reservation block. + running + Perform maintenance only on the hosts in the reservation block that + have running VMs. + unused + Perform maintenance only on the hosts in the reservation block that + don't have running VMs. + + --zone=ZONE + Zone of the reservation to perform-maintenance. If not specified and + the compute/zone property isn't set, you might be prompted to select a + zone (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute reservations blocks perform-maintenance + + $ gcloud beta compute reservations blocks perform-maintenance + diff --git a/gcloud/compute/reservations/help b/gcloud/compute/reservations/help index dba44dfa2..d358d0e04 100644 --- a/gcloud/compute/reservations/help +++ b/gcloud/compute/reservations/help @@ -2,7 +2,7 @@ NAME gcloud compute reservations - manage Compute Engine reservations SYNOPSIS - gcloud compute reservations COMMAND [GCLOUD_WIDE_FLAG ...] + gcloud compute reservations GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION Manage Compute Engine reservations. @@ -18,6 +18,12 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +GROUPS + GROUP is one of the following: + + blocks + Manage Compute Engine reservation blocks. + COMMANDS COMMAND is one of the following: @@ -39,6 +45,10 @@ COMMANDS list List Compute Engine reservations. + perform-maintenance + Perform maintenance on a reservation, only applicable to reservations + with reservation blocks. + remove-iam-policy-binding Remove IAM policy binding from a Compute Engine reservation. diff --git a/gcloud/compute/reservations/perform-maintenance b/gcloud/compute/reservations/perform-maintenance new file mode 100644 index 000000000..99d3a2abf --- /dev/null +++ b/gcloud/compute/reservations/perform-maintenance @@ -0,0 +1,72 @@ +NAME + gcloud compute reservations perform-maintenance - perform maintenance on a + reservation, only applicable to reservations with reservation blocks + +SYNOPSIS + gcloud compute reservations perform-maintenance RESERVATION [--scope=SCOPE] + [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Perform maintenance on a reservation, only applicable to reservations with + reservation blocks. + +EXAMPLES + To perform maintenance on reservation my-reservation in my-zone with scope + all, run: + + $ gcloud compute reservations perform-maintenance my-reservation \ + --zone=my-zone --scope=all + +POSITIONAL ARGUMENTS + RESERVATION + Name of the reservation to perform-maintenance. + +FLAGS + --scope=SCOPE + The maintenance scope to set for the reservation. SCOPE must be one of: + + all + Perform maintenance on all hosts in the reservation. + running + Perform maintenance only on the hosts in the reservation that have + running VMs. + unused + Perform maintenance only on the hosts in the reservation that don't + have running VMs. + + --zone=ZONE + Zone of the reservation to perform-maintenance. If not specified and + the compute/zone property isn't set, you might be prompted to select a + zone (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute reservations perform-maintenance + + $ gcloud beta compute reservations perform-maintenance + diff --git a/gcloud/compute/url-maps/invalidate-cdn-cache b/gcloud/compute/url-maps/invalidate-cdn-cache index a5716df72..7650e92db 100644 --- a/gcloud/compute/url-maps/invalidate-cdn-cache +++ b/gcloud/compute/url-maps/invalidate-cdn-cache @@ -3,8 +3,8 @@ NAME for a URL map in Cloud CDN caches SYNOPSIS - gcloud compute url-maps invalidate-cdn-cache URLMAP --path=PATH [--async] - [--global] [--host=HOST] [GCLOUD_WIDE_FLAG ...] + gcloud compute url-maps invalidate-cdn-cache URLMAP [--async] [--global] + [--host=HOST] [--path=PATH] [--tags=TAGS] [GCLOUD_WIDE_FLAG ...] DESCRIPTION gcloud compute url-maps invalidate-cdn-cache requests that Cloud CDN stop @@ -18,7 +18,18 @@ POSITIONAL ARGUMENTS URLMAP Name of the URL map to operate on. -REQUIRED FLAGS +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --global + (Default) The URL map is global. Regional URL maps are not supported. + + --host=HOST + If set, this invalidation will apply only to requests to the specified + host. + --path=PATH A path specifying which objects to invalidate. PATH must start with ``/'' and the only place a ``*'' is allowed is at the end following a @@ -39,17 +50,12 @@ REQUIRED FLAGS ◆ ``/x/y/'': ``/x/y/'' only (and not ``/x/y'') ◆ ``/x/y/*'': ``/x/y/'' and everything under it -OPTIONAL FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. + --tags=TAGS + A single tag or a comma-delimited list of tags. When multiple tags are + specified, the invalidation applies them using boolean OR logic. - --global - (Default) The URL map is global. Regional URL maps are not supported. - - --host=HOST - If set, this invalidation will apply only to requests to the specified - host. + Example: + ◆ --tags=abcd,user123 GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/config/get b/gcloud/config/get index 9bf45f174..a50dde015 100644 --- a/gcloud/config/get +++ b/gcloud/config/get @@ -273,6 +273,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud kms command group. Defaults to https://cloudkms.googleapis.com/ + cloudlocationfinder + Overrides API endpoint for gcloud cloudlocationfinder command + group. Defaults to https://cloudlocationfinder.googleapis.com/ + cloudresourcemanager Overrides API endpoint for gcloud projects command group. Defaults to https://cloudresourcemanager.googleapis.com/ diff --git a/gcloud/config/help b/gcloud/config/help index 735789d6d..86efc1a4f 100644 --- a/gcloud/config/help +++ b/gcloud/config/help @@ -305,6 +305,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud kms command group. Defaults to https://cloudkms.googleapis.com/ + cloudlocationfinder + Overrides API endpoint for gcloud cloudlocationfinder command + group. Defaults to https://cloudlocationfinder.googleapis.com/ + cloudresourcemanager Overrides API endpoint for gcloud projects command group. Defaults to https://cloudresourcemanager.googleapis.com/ diff --git a/gcloud/config/list b/gcloud/config/list index 09afcc301..3f55d1662 100644 --- a/gcloud/config/list +++ b/gcloud/config/list @@ -317,6 +317,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud kms command group. Defaults to https://cloudkms.googleapis.com/ + cloudlocationfinder + Overrides API endpoint for gcloud cloudlocationfinder command + group. Defaults to https://cloudlocationfinder.googleapis.com/ + cloudresourcemanager Overrides API endpoint for gcloud projects command group. Defaults to https://cloudresourcemanager.googleapis.com/ diff --git a/gcloud/config/set b/gcloud/config/set index 755ff41b7..5effaea23 100644 --- a/gcloud/config/set +++ b/gcloud/config/set @@ -320,6 +320,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud kms command group. Defaults to https://cloudkms.googleapis.com/ + cloudlocationfinder + Overrides API endpoint for gcloud cloudlocationfinder command + group. Defaults to https://cloudlocationfinder.googleapis.com/ + cloudresourcemanager Overrides API endpoint for gcloud projects command group. Defaults to https://cloudresourcemanager.googleapis.com/ diff --git a/gcloud/config/unset b/gcloud/config/unset index b76e2eca1..e68505a93 100644 --- a/gcloud/config/unset +++ b/gcloud/config/unset @@ -281,6 +281,10 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud kms command group. Defaults to https://cloudkms.googleapis.com/ + cloudlocationfinder + Overrides API endpoint for gcloud cloudlocationfinder command + group. Defaults to https://cloudlocationfinder.googleapis.com/ + cloudresourcemanager Overrides API endpoint for gcloud projects command group. Defaults to https://cloudresourcemanager.googleapis.com/ diff --git a/gcloud/container/clusters/create b/gcloud/container/clusters/create index dc5abdcf9..036fe9665 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -8,7 +8,8 @@ SYNOPSIS gpu-partition-size=GPU_PARTITION_SIZE, gpu-sharing-strategy=GPU_SHARING_STRATEGY, max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...]] - [--additional-zones=ZONE,[ZONE,...]] [--addons=[ADDON,...]] [--async] + [--additional-zones=ZONE,[ZONE,...]] + [--addons=[ADDON[=ENABLED|DISABLED],...]] [--async] [--auto-monitoring-scope=AUTO_MONITORING_SCOPE] [--autoprovisioning-enable-insecure-kubelet-readonly-port] [--autoprovisioning-network-tags=TAGS,[TAGS,...]] @@ -124,7 +125,6 @@ SYNOPSIS --resource-usage-bigquery-dataset=RESOURCE_USAGE_BIGQUERY_DATASET] [--enable-private-endpoint --enable-private-nodes --master-ipv4-cidr=MASTER_IPV4_CIDR] - [--enable-tpu --tpu-ipv4-cidr=CIDR] [--ephemeral-storage-local-ssd[=[count=COUNT]] | --local-nvme-ssd-block[=[count=COUNT]] | --local-ssd-count=LOCAL_SSD_COUNT] @@ -216,7 +216,7 @@ FLAGS This flag is deprecated. Use --node-locations=PRIMARY_ZONE,[ZONE,...] instead. - --addons=[ADDON,...] + --addons=[ADDON[=ENABLED|DISABLED],...] Addons (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters#Cluster.AddonsConfig) are additional Kubernetes cluster components. Addons specified by this @@ -1979,25 +1979,6 @@ FLAGS netmask of size /28 and should be used in conjunction with the --enable-private-nodes flag. - Flags relating to Cloud TPUs: - - --enable-tpu - Enable Cloud TPUs for this cluster. - - Can not be specified unless --enable-ip-alias is also specified. - - --tpu-ipv4-cidr=CIDR - Set the IP range for the Cloud TPUs. - - Can be specified as a netmask size (e.g. '/20') or as in CIDR notion - (e.g. '10.100.0.0/20'). If given as a netmask size, the IP range will - be chosen automatically from the available space in the network. - - If unspecified, the TPU CIDR range will use automatic default '/20'. - - Can not be specified unless '--enable-tpu' and '--enable-ip-alias' - are also specified. - At most one of these can be specified: --ephemeral-storage-local-ssd[=[count=COUNT]] diff --git a/gcloud/database-migration/objects/lookup b/gcloud/database-migration/objects/lookup index a9a87e431..9fe0e756d 100644 --- a/gcloud/database-migration/objects/lookup +++ b/gcloud/database-migration/objects/lookup @@ -20,7 +20,7 @@ EXAMPLES REQUIRED FLAGS The source object identifier. - This must be specified. + At least one of these must be specified: --database=DATABASE The name of the database to lookup. diff --git a/gcloud/datastream/private-connections/create b/gcloud/datastream/private-connections/create index a85fe28f3..bf6a80411 100644 --- a/gcloud/datastream/private-connections/create +++ b/gcloud/datastream/private-connections/create @@ -5,20 +5,29 @@ NAME SYNOPSIS gcloud datastream private-connections create (PRIVATE_CONNECTION : --location=LOCATION) --display-name=DISPLAY_NAME - (--subnet=SUBNET --vpc=VPC) [--labels=[KEY=VALUE,...]] - [GCLOUD_WIDE_FLAG ...] + (--network-attachment=NETWORK_ATTACHMENT | --subnet=SUBNET --vpc=VPC) + [--labels=[KEY=VALUE,...]] [--validate-only] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a Datastream private connection EXAMPLES - To create a privateConnection called 'my-privateConnection', run: + To create a privateConnection with VPC Peering called + 'my-privateConnection', run: $ gcloud datastream private-connections create \ my-privateConnection --location=us-central1 \ --display-name=my-privateConnection --vpc=vpc-example \ --subnet=10.0.0.0/29 + To create a privateConnection with PSC Interface called + 'my-privateConnection', run: + + $ gcloud datastream private-connections create \ + my-privateConnection --location=us-central1 \ + --display-name=my-privateConnection \ + --network-attachment=network-attachment-example + POSITIONAL ARGUMENTS Private connection resource - The private connection to create. The arguments in this group can be used to specify the attributes of this @@ -55,31 +64,40 @@ REQUIRED FLAGS --display-name=DISPLAY_NAME Friendly name for the private connection. - This must be specified. + Exactly one of these must be specified: - --subnet=SUBNET - A free subnet for peering. (CIDR of /29). + Arguments for Private Service Connect Interface configuration. - This flag argument must be specified if any of the other arguments in - this group are specified. + --network-attachment=NETWORK_ATTACHMENT + Full URI of the network attachment that datastream will connect + to.For example, this would be of the + form:network-attachment=projects/test-project/regions/us-central1/networkAttachments/my-na - Vpc resource - Resource ID of the private connection. This represents a - Cloud resource. (NOTE) Some attributes are not given arguments in this - group but can be set in other ways. + Arguments for VPC Peering configuration. - To set the project attribute: - ▸ provide the argument --vpc on the command line with a fully - specified name; - ▸ provide the argument --project on the command line; - ▸ set the property core/project. + --subnet=SUBNET + A free subnet for peering. (CIDR of /29). - This must be specified. + This flag argument must be specified if any of the other arguments + in this group are specified. - --vpc=VPC - ID of the vpc or fully qualified identifier for the vpc. + Vpc resource - Resource ID of the VPC network to peer with. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. - To set the vpc attribute: - ▫ provide the argument --vpc on the command line. + To set the project attribute: + ▫ provide the argument --vpc on the command line with a fully + specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + This must be specified. + + --vpc=VPC + ID of the vpc or fully qualified identifier for the vpc. + + To set the vpc attribute: + ◇ provide the argument --vpc on the command line. OPTIONAL FLAGS --labels=[KEY=VALUE,...] @@ -90,6 +108,10 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --validate-only + If set, the request will retrieve the project id to allow in the + network attachment Datastream will connect to. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/dns/managed-zones/create b/gcloud/dns/managed-zones/create index acc8bcce2..4e1848788 100644 --- a/gcloud/dns/managed-zones/create +++ b/gcloud/dns/managed-zones/create @@ -65,10 +65,9 @@ OPTIONAL FLAGS Enable DNSSEC and allow transferring a signed zone in or out. --forwarding-targets=[IP_ADDRESSES,...] - List of IPv4 addresses of target name servers that the zone will - forward queries to. Ignored for public visibility. Non-RFC1918 - addresses will forward to the target through the Internet. RFC1918 - addresses will forward through the VPC. + List of IPv4 addresses that the zone will forward queries to. Ignored + for public visibility. Non-RFC1918 addresses will forward to the target + through the Internet. RFC1918 addresses will forward through the VPC. --gkeclusters=[GKECLUSTERS,...] List of GKE clusters that the zone should be visible in if the zone @@ -108,9 +107,9 @@ OPTIONAL FLAGS visibility is [private]. --private-forwarding-targets=[IP_ADDRESSES,...] - List of IPv4 addresses of target name servers that the zone will - forward queries to. Ignored for public visibility. All addresses - specified for this parameter will be reached through the VPC. + List of IPv4 addresses that the zone will forward queries to. Ignored + for public visibility. All addresses specified for this parameter will + be reached through the VPC. --service-directory-namespace=SERVICE_DIRECTORY_NAMESPACE The fully qualified URL of the service directory namespace that should diff --git a/gcloud/dns/managed-zones/update b/gcloud/dns/managed-zones/update index 645a81a8c..66b3775a5 100644 --- a/gcloud/dns/managed-zones/update +++ b/gcloud/dns/managed-zones/update @@ -72,10 +72,9 @@ FLAGS Enable DNSSEC and allow transferring a signed zone in or out. --forwarding-targets=[IP_ADDRESSES,...] - List of IPv4 addresses of target name servers that the zone will - forward queries to. Ignored for public visibility. Non-RFC1918 - addresses will forward to the target through the Internet. RFC1918 - addresses will forward through the VPC. + List of IPv4 addresses that the zone will forward queries to. Ignored + for public visibility. Non-RFC1918 addresses will forward to the target + through the Internet. RFC1918 addresses will forward through the VPC. --gkeclusters=[GKECLUSTERS,...] List of GKE clusters that the zone should be visible in if the zone @@ -107,9 +106,9 @@ FLAGS visibility is [private]. --private-forwarding-targets=[IP_ADDRESSES,...] - List of IPv4 addresses of target name servers that the zone will - forward queries to. Ignored for public visibility. All addresses - specified for this parameter will be reached through the VPC. + List of IPv4 addresses that the zone will forward queries to. Ignored + for public visibility. All addresses specified for this parameter will + be reached through the VPC. --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value diff --git a/gcloud/edge-cache/origins/create b/gcloud/edge-cache/origins/create index 18a41ef97..47bb96350 100644 --- a/gcloud/edge-cache/origins/create +++ b/gcloud/edge-cache/origins/create @@ -4,9 +4,9 @@ NAME SYNOPSIS gcloud edge-cache origins create (ORIGIN : --location=LOCATION) --origin-address=ORIGIN_ADDRESS [--async] [--description=DESCRIPTION] - [--failover-origin=FAILOVER_ORIGIN] [--labels=[KEY=VALUE,...]] - [--max-attempts=MAX_ATTEMPTS] [--port=PORT] [--protocol=PROTOCOL] - [--response-timeout=RESPONSE_TIMEOUT] + [--failover-origin=FAILOVER_ORIGIN] [--flex-shielding=FLEX_SHIELDING] + [--labels=[KEY=VALUE,...]] [--max-attempts=MAX_ATTEMPTS] [--port=PORT] + [--protocol=PROTOCOL] [--response-timeout=RESPONSE_TIMEOUT] [--retry-conditions=[RETRY_CONDITIONS,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -89,6 +89,25 @@ OPTIONAL FLAGS The value of timeout.maxAttemptsTimeout dictates the timeout across all origins. + --flex-shielding=FLEX_SHIELDING + Whenever possible, content will be fetched from origin and cached in or + near the specified region. Best effort. + + Defaults to default global origin shielding. You may specify at most + one region. An empty flag turns off flex shielding. + + FLEX_SHIELDING must be one of: + + ** + Turn off flexible shielding and use the default global origin + shielding. + + africa_south1 + Origin fetch from near africa-south1. + + me_central1 + Origin fetch from near me-central1. + --labels=[KEY=VALUE,...] List of KEY=VALUE labels to attach to this resource. diff --git a/gcloud/edge-cache/origins/update b/gcloud/edge-cache/origins/update index f4980971e..b2cb0a1ef 100644 --- a/gcloud/edge-cache/origins/update +++ b/gcloud/edge-cache/origins/update @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud edge-cache origins update (ORIGIN : --location=LOCATION) [--async] [--description=DESCRIPTION] [--failover-origin=FAILOVER_ORIGIN] - [--labels=[KEY=VALUE,...]] [--max-attempts=MAX_ATTEMPTS] - [--origin-address=ORIGIN_ADDRESS] [--port=PORT] [--protocol=PROTOCOL] + [--flex-shielding=FLEX_SHIELDING] [--labels=[KEY=VALUE,...]] + [--max-attempts=MAX_ATTEMPTS] [--origin-address=ORIGIN_ADDRESS] + [--port=PORT] [--protocol=PROTOCOL] [--response-timeout=RESPONSE_TIMEOUT] [--retry-conditions=[RETRY_CONDITIONS,...]] [GCLOUD_WIDE_FLAG ...] @@ -72,6 +73,25 @@ FLAGS The value of timeout.maxAttemptsTimeout dictates the timeout across all origins. + --flex-shielding=FLEX_SHIELDING + Whenever possible, content will be fetched from origin and cached in or + near the specified region. Best effort. + + Defaults to default global origin shielding. You may specify at most + one region. An empty flag turns off flex shielding. + + FLEX_SHIELDING must be one of: + + ** + Turn off flexible shielding and use the default global origin + shielding. + + africa_south1 + Origin fetch from near africa-south1. + + me_central1 + Origin fetch from near me-central1. + --labels=[KEY=VALUE,...] List of KEY=VALUE labels to attach to this resource. diff --git a/gcloud/firestore/backups/schedules/help b/gcloud/firestore/backups/schedules/help index 7e878e328..64c99a64a 100644 --- a/gcloud/firestore/backups/schedules/help +++ b/gcloud/firestore/backups/schedules/help @@ -26,7 +26,7 @@ COMMANDS Describes a Cloud Firestore backup schedule. list - Lists backup schedules under a Cloud Firesore database. + Lists backup schedules under a Cloud Firestore database. update Updates a Cloud Firestore backup schedule. diff --git a/gcloud/firestore/backups/schedules/list b/gcloud/firestore/backups/schedules/list index da6703ac8..69a48976f 100644 --- a/gcloud/firestore/backups/schedules/list +++ b/gcloud/firestore/backups/schedules/list @@ -1,6 +1,6 @@ NAME gcloud firestore backups schedules list - lists backup schedules under a - Cloud Firesore database + Cloud Firestore database SYNOPSIS gcloud firestore backups schedules list --database=DATABASE diff --git a/gcloud/lustre/help b/gcloud/lustre/help new file mode 100644 index 000000000..71f0548ee --- /dev/null +++ b/gcloud/lustre/help @@ -0,0 +1,28 @@ +NAME + gcloud lustre - manage Lustre resources + +SYNOPSIS + gcloud lustre GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Lustre resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + instances + Manage Instance resources. + + operations + Manage Operation resources. + +NOTES + This variant is also available: + + $ gcloud alpha lustre + diff --git a/gcloud/lustre/instances/create b/gcloud/lustre/instances/create new file mode 100644 index 000000000..cf60c412b --- /dev/null +++ b/gcloud/lustre/instances/create @@ -0,0 +1,146 @@ +NAME + gcloud lustre instances create - create instances + +SYNOPSIS + gcloud lustre instances create (INSTANCE : --location=LOCATION) + --capacity-gib=CAPACITY_GIB --filesystem=FILESYSTEM --network=NETWORK + [--async] [--description=DESCRIPTION] [--gke-support-enabled] + [--labels=[LABELS,...]] [--request-id=REQUEST_ID] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create an instance + +EXAMPLES + To create the instance, run: + + $ gcloud lustre instances create + +POSITIONAL ARGUMENTS + Instance resource - Identifier. The name of the instance. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument instance on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the instance resource. + + To set the location attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --capacity-gib=CAPACITY_GIB + The storage capacity of the instance in gibibytes (GiB). Allowed values + are from 18000 to 936000, in increments of 9000. + + --filesystem=FILESYSTEM + The filesystem name for this instance. This name is used by client-side + tools, including when mounting the instance. Must be eight characters + or less and can only contain letters and numbers. + + Network resource - The full name of the VPC network to which the instance + is connected. Must be in the format + projects/{project_id}/global/networks/{network_name}. 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 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=NETWORK + ID of the network or fully qualified identifier for the network. + + To set the network attribute: + ▸ provide the argument --network on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A user-readable description of the instance. + + --gke-support-enabled + Indicates whether you want to enable support for GKE clients. By + default, GKE clients are not supported. + + --labels=[LABELS,...] + Labels as key value pairs. + + KEY + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + +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 lustre/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/managed-lustre/ + +NOTES + This variant is also available: + + $ gcloud alpha lustre instances create + diff --git a/gcloud/lustre/instances/delete b/gcloud/lustre/instances/delete new file mode 100644 index 000000000..bb216dae6 --- /dev/null +++ b/gcloud/lustre/instances/delete @@ -0,0 +1,84 @@ +NAME + gcloud lustre instances delete - delete instances + +SYNOPSIS + gcloud lustre instances delete (INSTANCE : --location=LOCATION) [--async] + [--request-id=REQUEST_ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete an instance + +EXAMPLES + To delete the instance, run: + + $ gcloud lustre instances delete + +POSITIONAL ARGUMENTS + Instance resource - The resource name of the instance to delete, in the + format projects/{projectId}/locations/{location}/instances/{instanceId}. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument instance on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the instance resource. + + To set the location attribute: + ▸ provide the argument instance 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. + + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes after the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + +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 lustre/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/managed-lustre/ + +NOTES + This variant is also available: + + $ gcloud alpha lustre instances delete + diff --git a/gcloud/lustre/instances/describe b/gcloud/lustre/instances/describe new file mode 100644 index 000000000..7c19f3fd9 --- /dev/null +++ b/gcloud/lustre/instances/describe @@ -0,0 +1,64 @@ +NAME + gcloud lustre instances describe - describe instances + +SYNOPSIS + gcloud lustre instances describe (INSTANCE : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe an instance + +EXAMPLES + To describe the instance, run: + + $ gcloud lustre instances describe + +POSITIONAL ARGUMENTS + Instance resource - The instance resource name, in the format + projects/{projectId}/locations/{location}/instances/{instanceId}. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument instance on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the instance resource. + + To set the location attribute: + ▸ provide the argument instance 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 lustre/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/managed-lustre/ + +NOTES + This variant is also available: + + $ gcloud alpha lustre instances describe + diff --git a/gcloud/lustre/instances/export-data b/gcloud/lustre/instances/export-data new file mode 100644 index 000000000..cc9f139be --- /dev/null +++ b/gcloud/lustre/instances/export-data @@ -0,0 +1,98 @@ +NAME + gcloud lustre instances export-data - export instances + +SYNOPSIS + gcloud lustre instances export-data (INSTANCE : --location=LOCATION) + --gcs-path-uri=GCS_PATH_URI [--async] [--lustre-path=LUSTRE_PATH] + [--request-id=REQUEST_ID] [--service-account=SERVICE_ACCOUNT] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + export instances + +EXAMPLES + To export all instances, run: + + $ gcloud lustre instances export-data + +POSITIONAL ARGUMENTS + Instance resource - Name of the resource. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument instance 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. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the instance resource. + + To set the location attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --gcs-path-uri=GCS_PATH_URI + URI to a Cloud Storage path in the format: gs://. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --lustre-path=LUSTRE_PATH + Root directory path to the Managed Lustre file system, starting with /. + Defaults to / if unset. + + --request-id=REQUEST_ID + UUID to identify requests. + + ServiceAccount resource - User-specified service account used to perform + the transfer. If unspecified, the Managed Lustre service agent is used. + 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 --service-account on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --service-account=SERVICE_ACCOUNT + ID of the serviceAccount or fully qualified identifier for the + serviceAccount. + + To set the service-account attribute: + ▸ provide the argument --service-account 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 lustre/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/managed-lustre/ + +NOTES + This variant is also available: + + $ gcloud alpha lustre instances export-data + diff --git a/gcloud/lustre/instances/help b/gcloud/lustre/instances/help new file mode 100644 index 000000000..3c8d242fa --- /dev/null +++ b/gcloud/lustre/instances/help @@ -0,0 +1,43 @@ +NAME + gcloud lustre instances - manage Instance resources + +SYNOPSIS + gcloud lustre instances COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Instance resources. + +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 instances. + + delete + Delete instances. + + describe + Describe instances. + + export-data + export instances. + + import-data + import instances. + + list + List instances. + + update + Update instances. + +NOTES + This variant is also available: + + $ gcloud alpha lustre instances + diff --git a/gcloud/lustre/instances/import-data b/gcloud/lustre/instances/import-data new file mode 100644 index 000000000..2ebebbe69 --- /dev/null +++ b/gcloud/lustre/instances/import-data @@ -0,0 +1,98 @@ +NAME + gcloud lustre instances import-data - import instances + +SYNOPSIS + gcloud lustre instances import-data (INSTANCE : --location=LOCATION) + --gcs-path-uri=GCS_PATH_URI [--async] [--lustre-path=LUSTRE_PATH] + [--request-id=REQUEST_ID] [--service-account=SERVICE_ACCOUNT] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + import instances + +EXAMPLES + To import all instances, run: + + $ gcloud lustre instances import-data + +POSITIONAL ARGUMENTS + Instance resource - Name of the resource. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument instance 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. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the instance resource. + + To set the location attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --gcs-path-uri=GCS_PATH_URI + URI to a Cloud Storage path in the format: gs://. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --lustre-path=LUSTRE_PATH + Root directory path to the Managed Lustre file system, starting with /. + Defaults to / if unset. + + --request-id=REQUEST_ID + UUID to identify requests. + + ServiceAccount resource - User-specified service account used to perform + the transfer. If unspecified, the default Lustre P4 service account will + be used. 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 --service-account on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --service-account=SERVICE_ACCOUNT + ID of the serviceAccount or fully qualified identifier for the + serviceAccount. + + To set the service-account attribute: + ▸ provide the argument --service-account 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 lustre/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/managed-lustre/ + +NOTES + This variant is also available: + + $ gcloud alpha lustre instances import-data + diff --git a/gcloud/lustre/instances/list b/gcloud/lustre/instances/list new file mode 100644 index 000000000..56b88e502 --- /dev/null +++ b/gcloud/lustre/instances/list @@ -0,0 +1,87 @@ +NAME + gcloud lustre instances list - list instances + +SYNOPSIS + gcloud lustre instances list --location=LOCATION [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List instances + +EXAMPLES + To list all instances, run: + + $ gcloud lustre instances list + +REQUIRED FLAGS + Location resource - The project and location for which to retrieve a list + of instances, in the format projects/{projectId}/locations/{location}. + + To retrieve instance information for all locations, use "-" as the value + of {location}. This represents a Cloud resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +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 lustre/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/managed-lustre/ + +NOTES + This variant is also available: + + $ gcloud alpha lustre instances list + diff --git a/gcloud/lustre/instances/update b/gcloud/lustre/instances/update new file mode 100644 index 000000000..84505de39 --- /dev/null +++ b/gcloud/lustre/instances/update @@ -0,0 +1,157 @@ +NAME + gcloud lustre instances update - update instances + +SYNOPSIS + gcloud lustre instances update (INSTANCE : --location=LOCATION) [--async] + [--capacity-gib=CAPACITY_GIB] [--description=DESCRIPTION] + [--[no-]gke-support-enabled] [--request-id=REQUEST_ID] + [--labels=[LABELS,...] + | --update-labels=[UPDATE_LABELS,...] --clear-labels + | --remove-labels=[__REMOVE_LABELS,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update an instance + +EXAMPLES + To update the instance, run: + + $ gcloud lustre instances update + +POSITIONAL ARGUMENTS + Instance resource - Identifier. The name of the instance. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument instance on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the instance resource. + + To set the location attribute: + ▸ provide the argument instance 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. + + --capacity-gib=CAPACITY_GIB + The storage capacity of the instance in gibibytes (GiB). Allowed values + are from 18000 to 936000, in increments of 9000. + + --description=DESCRIPTION + A user-readable description of the instance. + + --[no-]gke-support-enabled + Indicates whether you want to enable support for GKE clients. By + default, GKE clients are not supported. Use --gke-support-enabled to + enable and --no-gke-support-enabled to disable. + + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + + Update labels. + + At most one of these can be specified: + + --labels=[LABELS,...] + Set labels to new value. Labels as key value pairs. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --update-labels=[UPDATE_LABELS,...] + Update labels value or add key value pair. Labels as key value pairs. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --update-labels=string=string + + JSON Example: + + --update-labels='{"string": "string"}' + + File Example: + + --update-labels=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-labels + Clear labels value and set to empty map. + + --remove-labels=[__REMOVE_LABELS,...] + Remove existing value from map labels. + +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 lustre/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/managed-lustre/ + +NOTES + This variant is also available: + + $ gcloud alpha lustre instances update + diff --git a/gcloud/lustre/operations/cancel b/gcloud/lustre/operations/cancel new file mode 100644 index 000000000..2d9140f6d --- /dev/null +++ b/gcloud/lustre/operations/cancel @@ -0,0 +1,63 @@ +NAME + gcloud lustre operations cancel - cancel operations + +SYNOPSIS + gcloud lustre operations cancel (OPERATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Cancel an operation + +EXAMPLES + To cancel the operation, run: + + $ gcloud lustre operations cancel + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation resource to be cancelled. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument operation on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the operation resource. + + To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the lustre/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/managed-lustre/ + +NOTES + This variant is also available: + + $ gcloud alpha lustre operations cancel + diff --git a/gcloud/lustre/operations/delete b/gcloud/lustre/operations/delete new file mode 100644 index 000000000..49704feaa --- /dev/null +++ b/gcloud/lustre/operations/delete @@ -0,0 +1,63 @@ +NAME + gcloud lustre operations delete - delete operations + +SYNOPSIS + gcloud lustre operations delete (OPERATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete an operation + +EXAMPLES + To delete the operation, run: + + $ gcloud lustre operations delete + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation resource to be deleted. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument operation on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the operation resource. + + To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the lustre/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/managed-lustre/ + +NOTES + This variant is also available: + + $ gcloud alpha lustre operations delete + diff --git a/gcloud/lustre/operations/describe b/gcloud/lustre/operations/describe new file mode 100644 index 000000000..6d2ec280b --- /dev/null +++ b/gcloud/lustre/operations/describe @@ -0,0 +1,63 @@ +NAME + gcloud lustre operations describe - describe operations + +SYNOPSIS + gcloud lustre operations describe (OPERATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe an operation + +EXAMPLES + To describe the operation, run: + + $ gcloud lustre operations describe + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation resource. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument operation 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. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the operation resource. + + To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the lustre/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/managed-lustre/ + +NOTES + This variant is also available: + + $ gcloud alpha lustre operations describe + diff --git a/gcloud/lustre/operations/help b/gcloud/lustre/operations/help new file mode 100644 index 000000000..68ac81f74 --- /dev/null +++ b/gcloud/lustre/operations/help @@ -0,0 +1,37 @@ +NAME + gcloud lustre operations - manage Operation resources + +SYNOPSIS + gcloud lustre operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Operation resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + cancel + Cancel operations. + + delete + Delete operations. + + describe + Describe operations. + + list + List operations. + + wait + Wait operations. + +NOTES + This variant is also available: + + $ gcloud alpha lustre operations + diff --git a/gcloud/lustre/operations/list b/gcloud/lustre/operations/list new file mode 100644 index 000000000..4e7957007 --- /dev/null +++ b/gcloud/lustre/operations/list @@ -0,0 +1,84 @@ +NAME + gcloud lustre operations list - list operations + +SYNOPSIS + gcloud lustre operations list --location=LOCATION [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List operations + +EXAMPLES + To list all operations, run: + + $ gcloud lustre operations list + +REQUIRED FLAGS + Location resource - The name of the operation's parent resource. 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. + + --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 lustre/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/managed-lustre/ + +NOTES + This variant is also available: + + $ gcloud alpha lustre operations list + diff --git a/gcloud/lustre/operations/wait b/gcloud/lustre/operations/wait new file mode 100644 index 000000000..2dd94c839 --- /dev/null +++ b/gcloud/lustre/operations/wait @@ -0,0 +1,63 @@ +NAME + gcloud lustre operations wait - wait operations + +SYNOPSIS + gcloud lustre operations wait (OPERATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Wait an operation + +EXAMPLES + To wait the operation, run: + + $ gcloud lustre operations wait + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation resource to wait on. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument operation on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the operation resource. + + To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the lustre/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/managed-lustre/ + +NOTES + This variant is also available: + + $ gcloud alpha lustre operations wait + diff --git a/gcloud/netapp/volumes/create b/gcloud/netapp/volumes/create index a9714cad6..a1f0cd4a3 100644 --- a/gcloud/netapp/volumes/create +++ b/gcloud/netapp/volumes/create @@ -19,10 +19,13 @@ SYNOPSIS [kerberos-5p-read-write=KERBEROS-5P-READ-WRITE], [nfsv3=NFSV3],[nfsv4=NFSV4]] [--hybrid-replication-parameters=[cluster-location=CLUSTER-LOCATION], - [description=DESCRIPTION],[labels=LABELS], + [description=DESCRIPTION], + [hybrid-replication-type=HYBRID-REPLICATION-TYPE],[labels=LABELS], + [large-volume-constituent-count=LARGE-VOLUME-CONSTITUENT-COUNT], [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]] + [peer-volume-name=PEER-VOLUME-NAME],[replication=REPLICATION], + [replication-schedule=REPLICATION-SCHEDULE]] [--labels=[KEY=VALUE,...]] [--large-capacity=LARGE_CAPACITY] [--multiple-endpoints=MULTIPLE_ENDPOINTS] [--restricted-actions=RESTRICTED_ACTION,[...]] @@ -169,7 +172,7 @@ 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=[cluster-location=CLUSTER-LOCATION],[description=DESCRIPTION],[hybrid-replication-type=HYBRID-REPLICATION-TYPE],[labels=LABELS],[large-volume-constituent-count=LARGE-VOLUME-CONSTITUENT-COUNT],[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],[replication-schedule=REPLICATION-SCHEDULE] Hybrid Replication Parameters contains hybrid replication parameters on a volume. @@ -181,7 +184,10 @@ OPTIONAL FLAGS peer-ip-addresses=[PEER-IP-ADDRESS1#PEER-IP-ADDRESS2#...], cluster-location=CLUSTER_LOCATION, description=DESCRIPTION, - labels=[KEY1:VALUE1#KEY2:VALUE2#...] + replication-schedule=REPLICATION_SCHEDULE, + hybrid-replication-type=HYBRID_REPLICATION_TYPE, + large-volume-constituent-count=LARGE_VOLUME_CONSTITUENT_COUNT, + 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, @@ -189,9 +195,13 @@ OPTIONAL FLAGS 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. + description is the description of the replication, replication-schedule + is the schedule of corresponding hybrid replication created, + hybrid-replication-type is the hybrid replication type of the + corresponding hybrid replication created, + large-volume-constituent-count is the number of constituent volumes in + the large volume, 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/network-connectivity/service-connection-policies/update b/gcloud/network-connectivity/service-connection-policies/update index 9fad1c2db..dfa090ec2 100644 --- a/gcloud/network-connectivity/service-connection-policies/update +++ b/gcloud/network-connectivity/service-connection-policies/update @@ -5,12 +5,12 @@ NAME SYNOPSIS gcloud network-connectivity service-connection-policies update SERVICE_CONNECTION_POLICY - (--subnets=[SUBNETS,...] - : --allowed-google-producers-resource-hierarchy-level=[ALLOWED_GOOGLE_PRODUCERS_RESOURCE_HIERARCHY_LEVEL, - ...] --producer-instance-location=PRODUCER_INSTANCE_LOCATION - --psc-connection-limit=PSC_CONNECTION_LIMIT) [--async] - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--region=REGION] [GCLOUD_WIDE_FLAG ...] + [--allowed-google-producers-resource-hierarchy-level=[ALLOWED_GOOGLE_PRODUCERS_RESOURCE_HIERARCHY_LEVEL, + ...]] [--async] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] + [--producer-instance-location=PRODUCER_INSTANCE_LOCATION] + [--psc-connection-limit=PSC_CONNECTION_LIMIT] [--region=REGION] + [--subnets=[SUBNETS,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update a Service Connection Policy with the given name. @@ -52,55 +52,12 @@ POSITIONAL ARGUMENTS ▸ provide the argument service_connection_policy on the command line. -REQUIRED FLAGS - This must be specified. +FLAGS + --allowed-google-producers-resource-hierarchy-level=[ALLOWED_GOOGLE_PRODUCERS_RESOURCE_HIERARCHY_LEVEL,...] + List of projects, folders, or orgs where the producer instance can be + located in the form "projects/123456789", folders/123456789", or + "organizations/123456789". - Subnetwork resource - Subnetwork to use for IP address management. 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 --subnets 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 --subnets on the command line with a fully - specified name; - ▸ provide the argument --region on the command line. - - This must be specified. - - --subnets=[SUBNETS,...] - IDs of the subnetworks or fully qualified identifiers for the - subnetworks. - - To set the subnetwork attribute: - ▫ provide the argument --subnets on the command line. - - --allowed-google-producers-resource-hierarchy-level=[ALLOWED_GOOGLE_PRODUCERS_RESOURCE_HIERARCHY_LEVEL,...] - List of projects, folders, or orgs where the producer instance can be - located in the form "projects/123456789", folders/123456789", or - "organizations/123456789". - - --producer-instance-location=PRODUCER_INSTANCE_LOCATION - Option that determines where the producer instances can be located - for which connections can be created in the network controlled by - this policy. PRODUCER_INSTANCE_LOCATION must be one of: - - custom-resource-hierarchy-levels - The producer instance must be located in one of the values - provided in the allowed-google-producers-resource-hierarchy-level - flag. - none - The producer instance must be within the same project as this - connection policy. - - --psc-connection-limit=PSC_CONNECTION_LIMIT - Max number of PSC connections for this policy. - -OPTIONAL FLAGS --async Return immediately, without waiting for the operation in progress to complete. @@ -111,11 +68,48 @@ OPTIONAL FLAGS --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. + --producer-instance-location=PRODUCER_INSTANCE_LOCATION + Option that determines where the producer instances can be located for + which connections can be created in the network controlled by this + policy. PRODUCER_INSTANCE_LOCATION must be one of: + + custom-resource-hierarchy-levels + The producer instance must be located in one of the values provided + in the allowed-google-producers-resource-hierarchy-level flag. + none + The producer instance must be within the same project as this + connection policy. + + --psc-connection-limit=PSC_CONNECTION_LIMIT + Max number of PSC connections for this policy. + --region=REGION For resources [service connection policy, subnetwork], provides fallback value for resource region attribute. When the resource's full URI path is not provided, region will fallback to this flag value. + Subnetwork resource - Subnetwork to use for IP address management. 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 --subnets 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 --subnets on the command line with a fully + specified name; + ◆ provide the argument --region on the command line. + + --subnets=[SUBNETS,...] + IDs of the subnetworks or fully qualified identifiers for the + subnetworks. + + To set the subnetwork attribute: + ▸ provide the argument --subnets 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, diff --git a/gcloud/scc/findings/list b/gcloud/scc/findings/list index b387b5d70..9b48d3df8 100644 --- a/gcloud/scc/findings/list +++ b/gcloud/scc/findings/list @@ -5,8 +5,10 @@ SYNOPSIS gcloud scc findings list [PARENT] [--compare-duration=COMPARE_DURATION] [--field-mask=FIELD_MASK] [--location=LOCATION; default="global"] [--order-by=ORDER_BY] [--page-token=PAGE_TOKEN] [--read-time=READ_TIME] - [--source=SOURCE; default="-"] [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + [--source=SOURCE; default="-"] + [--folder=FOLDER | --organization=ORGANIZATION | --project=PROJECT] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION List an organization or source's findings. To list across all sources @@ -161,6 +163,17 @@ FLAGS --source=SOURCE; default="-" Source id. Defaults to all sources. + At most one of these can be specified: + + --folder=FOLDER + The folder ID (e.g., 456) that contains the finding. + + --organization=ORGANIZATION + The organization ID (e.g., 123) that contains the finding. + + --project=PROJECT + The project ID (e.g., example-project) that contains the finding. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/services/api-keys/create b/gcloud/services/api-keys/create index e134efd9e..04a9f058b 100644 --- a/gcloud/services/api-keys/create +++ b/gcloud/services/api-keys/create @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud services api-keys create [--annotations=[KEY=VALUE,...]] [--async] [--display-name=DISPLAY_NAME] [--key-id=KEY_ID] + [--service-account=SERVICE_ACCOUNT] [--api-target=service=SERVICE,[...] --allowed-application=[sha1_fingerprint=SHA1_FINGERPRINT, package_name=PACKAGE_NAME,...] @@ -51,6 +52,11 @@ EXAMPLES --api-target=service=bar.service.com \ --api-target=service=foo.service.com + To create a key with service account: + + $ gcloud services api-keys create \ + --service-account=my-service-account + To create a key with allowed API targets (service and methods are specified): @@ -81,6 +87,10 @@ FLAGS --key-id=KEY_ID User-specified ID of the key to create. + --service-account=SERVICE_ACCOUNT + The email of the service account the key is bound to. If this field is + specified, the key is a service account bound key and auth enabled. + --api-target=service=SERVICE,[...] Repeatable. Specify service and optionally one or multiple specific methods. Both fields are case insensitive. If you need to specify