imjasonh/gcloud-help
1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-08 18:45:13 +00:00
Code Activity

gcloud: Wed Mar 29 10:40:15 UTC 2023

Browse source
This commit is contained in:
Automated 2023-03-29 10:40:15 +00:00
parent 4ccfc7a5e3
commit 5fabf24be7
269 changed files with 6797 additions and 464 deletions
Download patch file Download diff file Expand all files Collapse all files

11
gcloud/alpha/compute/disks/bulk/create
View file

@ -9,9 +9,8 @@ SYNOPSIS
DESCRIPTION
(ALPHA) gcloud alpha compute disks bulk create facilitates the creation of
multiple Compute Engine disks with a single command. Currently, this
includes the ability to consistently clone a set of Async PD secondary
disks with the same consistency group policy.
multiple Compute Engine disks with a single command. This includes cloning
a set of Async PD secondary disks with the same consistency group policy.
EXAMPLES
To consistently clone secondary disks with the same consistency group
@ -27,7 +26,7 @@ EXAMPLES
REQUIRED FLAGS
--source-consistency-group-policy=SOURCE_CONSISTENCY_GROUP_POLICY
URL of the source consistency group resource policy. The resource
policy is always in the region of the source disks.
policy is always the same region as the source disks.
Exactly one of these must be specified:
@ -85,5 +84,7 @@ NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist.
access allowlist. This variant is also available:
$ gcloud beta compute disks bulk create

4
gcloud/alpha/compute/disks/bulk/help
View file

@ -24,5 +24,7 @@ NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist.
access allowlist. This variant is also available:
$ gcloud beta compute disks bulk

39
gcloud/alpha/compute/disks/create
View file

@ -9,6 +9,7 @@ SYNOPSIS
[--guest-os-features=[GUEST_OS_FEATURE,...]] [--interface=INTERFACE]
[--labels=[KEY=VALUE,...]] [--licenses=[LICENSE,...]] [--multi-writer]
[--physical-block-size=PHYSICAL_BLOCK_SIZE; default="4096"]
[--primary-disk-project=PRIMARY_DISK_PROJECT]
[--provisioned-iops=PROVISIONED_IOPS]
[--provisioned-throughput=PROVISIONED_THROUGHPUT]
[--replica-zones=ZONE,ZONE] [--no-require-csek-key-create]
@ -22,12 +23,11 @@ SYNOPSIS
| --source-snapshot=SOURCE_SNAPSHOT]
[--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING
--kms-location=KMS_LOCATION --kms-project=KMS_PROJECT]
[--primary-disk-region=PRIMARY_DISK_REGION
| --primary-disk-zone=PRIMARY_DISK_ZONE]
[--region=REGION | --zone=ZONE]
[--source-disk-region=SOURCE_DISK_REGION
| --source-disk-zone=SOURCE_DISK_ZONE]
[--primary-disk-project=PRIMARY_DISK_PROJECT]
[--primary-disk-region=PRIMARY_DISK_REGION
| --primary-disk-zone=PRIMARY_DISK_ZONE] [GCLOUD_WIDE_FLAG ...]
| --source-disk-zone=SOURCE_DISK_ZONE] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) gcloud alpha compute disks create creates one or more Compute
@ -125,6 +125,9 @@ FLAGS
4096(default) and 16384. PHYSICAL_BLOCK_SIZE must be one of: 4096,
16384.
--primary-disk-project=PRIMARY_DISK_PROJECT
Project of the primary disk for asynchronous replication.
--provisioned-iops=PROVISIONED_IOPS
Provisioned IOPS of disk to create. Only for use with disks of type
pd-extreme and hyperdisk-extreme.
@ -277,6 +280,18 @@ FLAGS
▸ provide the argument --kms-project on the command line;
▸ set the property core/project.
At most one of these can be specified:
--primary-disk-region=PRIMARY_DISK_REGION
Region of the primary disk for asynchronous replication. The primary
and secondary disks must not be in the same region. Overrides the
default compute/region property value for this command invocation.
--primary-disk-zone=PRIMARY_DISK_ZONE
Zone of the primary disk for asynchronous replication. The primary
and secondary disks must not be in the same region. Overrides the
default compute/zone property value for this command invocation.
At most one of these can be specified:
--region=REGION
@ -332,22 +347,6 @@ FLAGS
disk is in the same zone as the source disk. Overrides the default
compute/zone property value for this command invocation.
ASYNC PD FLAGS
--primary-disk-project=PRIMARY_DISK_PROJECT
Project of the primary disk for asynchronous replication.
At most one of these can be specified:
--primary-disk-region=PRIMARY_DISK_REGION
Region of the primary disk for asynchronous replication. The primary
and secondary disks must not be in the same region. Overrides the
default compute/region property value for this command invocation.
--primary-disk-zone=PRIMARY_DISK_ZONE
Zone of the primary disk for asynchronous replication. The primary
and secondary disks must not be in the same region. Overrides the
default compute/zone property value for this command invocation.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,

9
gcloud/alpha/compute/disks/start-async-replication
View file

@ -15,9 +15,8 @@ DESCRIPTION
invoked on the primary disk and --secondary-disk must be provided.
EXAMPLES
Replication can only be started from the primary scope. To start
replication from the primary disk 'my-disk-1' in zone us-east1-a to the
secondary disk 'my-disk-2' in zone us-west1-a:
Start replication from the primary disk 'my-disk-1' in zone us-east1-a to
the secondary disk 'my-disk-2' in zone us-west1-a:
$ gcloud alpha compute disks start-async-replication my-disk-1 \
--zone=us-east1-a --secondary-disk=my-disk-2 \
@ -103,5 +102,7 @@ NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist.
access allowlist. This variant is also available:
$ gcloud beta compute disks start-async-replication

4
gcloud/alpha/compute/disks/stop-async-replication
View file

@ -102,5 +102,7 @@ NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist.
access allowlist. This variant is also available:
$ gcloud beta compute disks stop-async-replication

4
gcloud/alpha/compute/disks/stop-group-async-replication
View file

@ -92,5 +92,7 @@ NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist.
access allowlist. This variant is also available:
$ gcloud beta compute disks stop-group-async-replication

11
gcloud/alpha/compute/external-vpn-gateways/create
View file

@ -38,15 +38,20 @@ REQUIRED FLAGS
For example, to create an external VPN gateway with one interface:
$ gcloud alpha compute external-vpn-gateways create \
MY-EXTERNAL-GATEWAY --interfaces 0=8.9.9.9
MY-EXTERNAL-GATEWAY --interfaces 0=192.0.2.0
To create an external VPN gateway with two interfaces: $ gcloud alpha
compute external-vpn-gateways create \ MY-EXTERNAL-GATEWAY --interfaces
0=8.9.9.9,1=8.9.9.10
0=192.0.2.0,1=192.0.2.1
To create an external VPN gateway with four interfaces: $ gcloud alpha
compute external-vpn-gateways create \ MY-EXTERNAL-GATEWAY \
--interfaces 0=8.9.9.9,1=8.9.9.10,2=8.9.9.11,3=8.9.9.12
--interfaces 0=192.0.2.0,1=192.0.2.1,2=192.0.2.3,3=192.0.2.4
To create an external VPN gateway with IPv6 addresses on four
interfaces: $ gcloud alpha compute external-vpn-gateways create \
MY-EXTERNAL-GATEWAY \ --interfaces \
0=2001:db8::1,1=2001:db8::2,2=2001:db8::3,3=2001:db8::4
Note that the redundancy type of the gateway will be automatically
inferred based on the number of interfaces provided:

8
gcloud/alpha/compute/instance-groups/managed/create
View file

@ -306,9 +306,7 @@ OPTIONAL FLAGS
--update-policy-max-surge=MAX_SURGE
Maximum additional number of VMs that can be created during the
update process. This can be a fixed number (e.g. 5) or a percentage
of size to the managed instance group (e.g. 10%). Defaults to 0 if
the managed instance group has stateful configuration, or to the
number of zones in which it operates otherwise.
of size to the managed instance group (e.g. 10%).
--update-policy-max-unavailable=MAX_UNAVAILABLE
Maximum number of VMs that can be unavailable during the update
@ -367,9 +365,7 @@ OPTIONAL FLAGS
--update-policy-replacement-method=UPDATE_POLICY_REPLACEMENT_METHOD
Type of replacement method. Specifies what action will be taken to
update VMs. Defaults to ``recreate`` if the managed instance group
has stateful configuration, or to ``substitute`` otherwise.
UPDATE_POLICY_REPLACEMENT_METHOD must be one of:
update VMs. UPDATE_POLICY_REPLACEMENT_METHOD must be one of:
recreate
Recreate VMs and preserve the VM names. The VM IDs and creation

8
gcloud/alpha/compute/instance-groups/managed/update
View file

@ -308,9 +308,7 @@ FLAGS
--update-policy-max-surge=MAX_SURGE
Maximum additional number of VMs that can be created during the
update process. This can be a fixed number (e.g. 5) or a percentage
of size to the managed instance group (e.g. 10%). Defaults to 0 if
the managed instance group has stateful configuration, or to the
number of zones in which it operates otherwise.
of size to the managed instance group (e.g. 10%).
--update-policy-max-unavailable=MAX_UNAVAILABLE
Maximum number of VMs that can be unavailable during the update
@ -369,9 +367,7 @@ FLAGS
--update-policy-replacement-method=UPDATE_POLICY_REPLACEMENT_METHOD
Type of replacement method. Specifies what action will be taken to
update VMs. Defaults to ``recreate`` if the managed instance group
has stateful configuration, or to ``substitute`` otherwise.
UPDATE_POLICY_REPLACEMENT_METHOD must be one of:
update VMs. UPDATE_POLICY_REPLACEMENT_METHOD must be one of:
recreate
Recreate VMs and preserve the VM names. The VM IDs and creation

30
gcloud/alpha/compute/instance-templates/list
View file

@ -4,16 +4,17 @@ NAME
SYNOPSIS
gcloud alpha compute instance-templates list [NAME ...]
[--regexp=REGEXP, -r REGEXP] [--filter=EXPRESSION] [--limit=LIMIT]
[--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri]
[GCLOUD_WIDE_FLAG ...]
[--regexp=REGEXP, -r REGEXP] [--global | --regions=[REGION,...]]
[--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE]
[--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) gcloud alpha compute instance-templates list displays all Google
Compute Engine instance templates in a project.
By default, instance templates from all zones are listed. The results can
be narrowed down using a filter: --filter="zone:( ZONE ... )".
By default, global instance templates and instance templates from all
regions are listed. The results can be narrowed down by providing the
--global or --regions flag.
EXAMPLES
To list all instance templates in a project in table form, run:
@ -24,11 +25,15 @@ EXAMPLES
$ gcloud alpha compute instance-templates list --uri
To list all instance templates in the us-central1-b and europe-west1-d
zones, run:
To list all global instance templates in a project, run:
$ gcloud alpha compute instance-templates list --global
To list all instance templates in the us-central1 and europe-west1 regions,
given they are regional resources, run:
$ gcloud alpha compute instance-templates list \
--filter="zone:( us-central1-b europe-west1-d )"
--filter="region:( europe-west1 us-central1 )"
POSITIONAL ARGUMENTS
[NAME ...]
@ -46,6 +51,15 @@ FLAGS
Flag --regexp is deprecated. Use --filter="name~'REGEXP'" instead.
At most one of these can be specified:
--global
If provided, only global resources are shown.
--regions=[REGION,...]
If provided, only regional resources are shown. If arguments are
provided, only resources from the given regions are shown.
LIST COMMAND FLAGS
--filter=EXPRESSION
Apply a Boolean filter EXPRESSION to each resource item to be listed.

13
gcloud/alpha/compute/resource-policies/create/disk-consistency-group
View file

@ -7,12 +7,13 @@ SYNOPSIS
[--description=DESCRIPTION] [--region=REGION] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Create a Compute Engine Disk Consistency Group Resource Policy.
(ALPHA) Create a Compute Engine disk consistency group resource policy.
EXAMPLES
To create a Compute Engine Disk Consistency Group policy, run: $ gcloud
alpha compute resource-policies create disk-consistency-group
my-resource-policy --region=REGION
Create a disk consistency group policy:
$ gcloud alpha compute resource-policies create \
disk-consistency-group my-resource-policy --region=REGION
POSITIONAL ARGUMENTS
NAME
@ -54,5 +55,7 @@ NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist.
access allowlist. This variant is also available:
$ gcloud beta compute resource-policies create disk-consistency-group

16
gcloud/alpha/compute/sole-tenancy/node-groups/create
View file

@ -5,7 +5,9 @@ NAME
SYNOPSIS
gcloud alpha compute sole-tenancy node-groups create NAME
--node-template=NODE_TEMPLATE --target-size=TARGET_SIZE
[--description=DESCRIPTION] [--maintenance-policy=MAINTENANCE_POLICY]
[--description=DESCRIPTION]
[--maintenance-interval=MAINTENANCE_INTERVAL]
[--maintenance-policy=MAINTENANCE_POLICY]
[--maintenance-window-start-time=START_TIME] [--zone=ZONE]
[--autoscaler-mode=AUTOSCALER_MODE
: --max-nodes=MAX_NODES --min-nodes=MIN_NODES]
@ -36,6 +38,18 @@ OPTIONAL FLAGS
--description=DESCRIPTION
An optional description of this resource.
--maintenance-interval=MAINTENANCE_INTERVAL
Specifies the frequency of planned maintenance events.
MAINTENANCE_INTERVAL must be one of:
as-needed
VMs are eligible to receive infrastructure and hypervisor updates
as they become available.
recurrent
VMs receive infrastructure and hypervisor updates on a periodic
basis, minimizing the number of maintenance operations (live
migrations or terminations) on an individual VM.
--maintenance-policy=MAINTENANCE_POLICY
Determines the maintenance behavior during host maintenance events. For
more information, see

17
gcloud/alpha/compute/tpus/queued-resources/create
View file

@ -7,7 +7,10 @@ SYNOPSIS
(QUEUED_RESOURCE : --zone=ZONE) --accelerator-type=ACCELERATOR_TYPE
--runtime-version=RUNTIME_VERSION
(--node-id=NODE_ID | --node-count=NODE_COUNT --node-prefix=NODE_PREFIX)
[--async] [--best-effort] [--guaranteed] [--internal-ips] [--reserved]
[--async] [--best-effort] [--guaranteed] [--internal-ips]
[--reservation-host-folder=RESERVATION_HOST_FOLDER]
[--reservation-host-organization=RESERVATION_HOST_ORGANIZATION]
[--reservation-host-project=RESERVATION_HOST_PROJECT] [--reserved]
[--valid-after-duration=VALID_AFTER_DURATION]
[--valid-after-time=VALID_AFTER_TIME]
[--valid-until-duration=VALID_UNTIL_DURATION]
@ -124,6 +127,18 @@ OPTIONAL FLAGS
default is that external IP addresses will be associated with the TPU
workers.
--reservation-host-folder=RESERVATION_HOST_FOLDER
The folder hosting the reservation that the TPU should use. Only one
reservation host entity may be specified.
--reservation-host-organization=RESERVATION_HOST_ORGANIZATION
The organization hosting the reservation that the TPU should use. Only
one reservation host entity may be specified.
--reservation-host-project=RESERVATION_HOST_PROJECT
The project hosting the reservation that the TPU should use. Only one
reservation host entity may be specified.
--reserved
Specifies the request should be scheduled on reserved capacity.

3
gcloud/alpha/compute/tpus/queued-resources/help
View file

@ -28,6 +28,9 @@ COMMANDS
list
(ALPHA) List Queued Resources.
reset
(ALPHA) Reset a Queued 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

75
gcloud/alpha/compute/tpus/queued-resources/reset Normal file
View file

@ -0,0 +1,75 @@
NAME
gcloud alpha compute tpus queued-resources reset - reset a Queued Resource
SYNOPSIS
gcloud alpha compute tpus queued-resources reset
(QUEUED_RESOURCE : --zone=ZONE) [--async] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Reset an existing Queued Resource.
To get a list of Queued Resources for resetting, run:
$ gcloud alpha compute tpus queued-resources list
EXAMPLES
To reset a Queued Resource in zone us-central1-b and project my-project,
run:
$ gcloud alpha compute tpus queued-resources reset \
--zone=us-central1-b --project=my-project
POSITIONAL ARGUMENTS
Queued resource resource - The Queued Resource you want to reset. 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 queued_resource 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.
QUEUED_RESOURCE
ID of the queued_resource or fully qualified identifier for the
queued_resource. To set the queued_resource attribute:
▸ provide the argument queued_resource on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--zone=ZONE
The compute/zone of the Cloud TPU.
If not specified, will use default compute/zone.
To set the zone attribute:
▸ provide the argument queued_resource on the command line with a
fully specified name;
▸ provide the argument --zone on the command line;
▸ set the property compute/zone.
FLAGS
--async
Return immediately, without waiting for the operation in progress to
complete.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,
--help, --impersonate-service-account, --log-http, --project, --quiet,
--trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
API REFERENCE
This command uses the tpu/v2alpha1 API. The full documentation for this API
can be found at: https://cloud.google.com/tpu/
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.