1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-08 10:35:03 +00:00

gcloud: Thu Jun 22 10:31:35 UTC 2023

This commit is contained in:
Automated 2023-06-22 10:31:35 +00:00
parent 2102dc5511
commit dc0d916cee
219 changed files with 5076 additions and 1639 deletions

View file

@ -0,0 +1,88 @@
NAME
gcloud compute disks bulk create - create multiple Compute Engine disks
SYNOPSIS
gcloud compute disks bulk create
--source-consistency-group-policy=SOURCE_CONSISTENCY_GROUP_POLICY
(--region=REGION | --zone=ZONE) [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
gcloud compute disks bulk create facilitates the creation of 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
policy
'projects/example-project/regions/us-central1/resourcePolicies/example-group-policy'
to target zone 'us-central1-a', run:
$ gcloud compute disks bulk create \
--source-consistency-group-policy=projects/example-project/\
regions/us-central1/resourcePolicies/example-group-policy \
--zone=us-central1-a
REQUIRED FLAGS
--source-consistency-group-policy=SOURCE_CONSISTENCY_GROUP_POLICY
URL of the source consistency group resource policy. The resource
policy is always the same region as the source disks.
Exactly one of these must be specified:
--region=REGION
Target region of the created disks, which currently must be the same
as the source region. If not specified, you might be prompted to
select a region (interactive mode only).
To avoid prompting when this flag is omitted, you can set the
compute/region property:
$ gcloud config set compute/region REGION
A list of regions can be fetched by running:
$ gcloud compute regions list
To unset the property, run:
$ gcloud config unset compute/region
Alternatively, the region can be stored in the environment variable
CLOUDSDK_COMPUTE_REGION.
--zone=ZONE
Target zone of the created disks, which currently must be the same as
the source zone. 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 disks bulk create
$ gcloud beta compute disks bulk create

View file

@ -0,0 +1,28 @@
NAME
gcloud compute disks bulk - manipulate multiple Compute Engine disks with
single command executions
SYNOPSIS
gcloud compute disks bulk COMMAND [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
Manipulate multiple Compute Engine disks with single command executions.
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 multiple Compute Engine disks.
NOTES
These variants are also available:
$ gcloud alpha compute disks bulk
$ gcloud beta compute disks bulk

View file

@ -6,16 +6,20 @@ SYNOPSIS
[--architecture=ARCHITECTURE] [--csek-key-file=FILE]
[--description=DESCRIPTION]
[--guest-os-features=[GUEST_OS_FEATURE,...]] [--labels=[KEY=VALUE,...]]
[--licenses=[LICENSE,...]] [--provisioned-iops=PROVISIONED_IOPS]
[--licenses=[LICENSE,...]]
[--primary-disk-project=PRIMARY_DISK_PROJECT]
[--provisioned-iops=PROVISIONED_IOPS]
[--provisioned-throughput=PROVISIONED_THROUGHPUT]
[--replica-zones=ZONE,ZONE] [--no-require-csek-key-create]
[--resource-policies=[RESOURCE_POLICY,...]] [--size=SIZE] [--type=TYPE]
[--image-family-scope=IMAGE_FAMILY_SCOPE
--image-project=IMAGE_PROJECT --image=IMAGE
| --image-family=IMAGE_FAMILY | --source-disk=SOURCE_DISK
| --source-snapshot=SOURCE_SNAPSHOT]
| --image-family=IMAGE_FAMILY | --primary-disk=PRIMARY_DISK
| --source-disk=SOURCE_DISK | --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] [GCLOUD_WIDE_FLAG ...]
@ -90,6 +94,9 @@ FLAGS
added onto the created disks to indicate the licensing and billing
policies.
--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.
@ -173,6 +180,10 @@ FLAGS
practice to use --image-family when the latest version of an image is
needed.
--primary-disk=PRIMARY_DISK
Primary disk for asynchronous replication. This flag is required when
creating a secondary disk.
--source-disk=SOURCE_DISK
Source disk used to create the disk(s). It is safe to delete a source
disk after a disk has been created from the source disk. To get a
@ -238,6 +249,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

View file

@ -2,7 +2,7 @@ NAME
gcloud compute disks - read and manipulate Compute Engine disks
SYNOPSIS
gcloud compute disks COMMAND [GCLOUD_WIDE_FLAG ...]
gcloud compute disks GROUP | COMMAND [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
Read and manipulate Compute Engine disks.
@ -18,6 +18,13 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
GROUPS
GROUP is one of the following:
bulk
Manipulate multiple Compute Engine disks with single command
executions.
COMMANDS
COMMAND is one of the following:
@ -66,6 +73,15 @@ COMMANDS
snapshot
Create snapshots of Compute Engine persistent disks.
start-async-replication
Start asynchronous replication on a Compute Engine persistent disk.
stop-async-replication
Stop async replication on a Compute Engine persistent disk.
stop-group-async-replication
Consistently stops a group of asynchronously replicating disks.
update
Update a Compute Engine persistent disk.

View file

@ -0,0 +1,107 @@
NAME
gcloud compute disks start-async-replication - start asynchronous
replication on a Compute Engine persistent disk
SYNOPSIS
gcloud compute disks start-async-replication DISK_NAME
--secondary-disk=SECONDARY_DISK (--region=REGION | --zone=ZONE)
(--secondary-disk-region=SECONDARY_DISK_REGION
| --secondary-disk-zone=SECONDARY_DISK_ZONE)
[--secondary-disk-project=SECONDARY_DISK_PROJECT]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
gcloud compute disks start-async-replication starts async replication on a
Compute Engine persistent disk. This command must be invoked on the primary
disk and --secondary-disk must be provided.
EXAMPLES
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 compute disks start-async-replication my-disk-1 \
--zone=us-east1-a --secondary-disk=my-disk-2 \
--secondary-disk-zone=us-west1-a
POSITIONAL ARGUMENTS
DISK_NAME
Name of the disk to operate on.
REQUIRED FLAGS
--secondary-disk=SECONDARY_DISK
Secondary disk for asynchronous replication. This flag is required when
starting replication.
Exactly one of these must be specified:
--region=REGION
Region of the disk to operate on. If not specified, you might be
prompted to select a region (interactive mode only).
To avoid prompting when this flag is omitted, you can set the
compute/region property:
$ gcloud config set compute/region REGION
A list of regions can be fetched by running:
$ gcloud compute regions list
To unset the property, run:
$ gcloud config unset compute/region
Alternatively, the region can be stored in the environment variable
CLOUDSDK_COMPUTE_REGION.
--zone=ZONE
Zone of the disk to operate on. If not specified and the compute/zone
property isn't set, you might be prompted to select a zone
(interactive mode only).
To avoid prompting when this flag is omitted, you can set the
compute/zone property:
$ gcloud config set compute/zone ZONE
A list of zones can be fetched by running:
$ gcloud compute zones list
To unset the property, run:
$ gcloud config unset compute/zone
Alternatively, the zone can be stored in the environment variable
CLOUDSDK_COMPUTE_ZONE.
Exactly one of these must be specified:
--secondary-disk-region=SECONDARY_DISK_REGION
Region of the secondary disk for asynchronous replication. Overrides
the default compute/region property value for this command
invocation.
--secondary-disk-zone=SECONDARY_DISK_ZONE
Zone of the secondary disk for asynchronous replication. Overrides
the default compute/zone property value for this command invocation.
SECONDARY DISK FLAGS
--secondary-disk-project=SECONDARY_DISK_PROJECT
Project of the secondary disk for asynchronous replication.
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 disks start-async-replication
$ gcloud beta compute disks start-async-replication

View file

@ -0,0 +1,87 @@
NAME
gcloud compute disks stop-async-replication - stop async replication on a
Compute Engine persistent disk
SYNOPSIS
gcloud compute disks stop-async-replication DISK_NAME
[--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
gcloud compute disks stop-async-replication stops async replication on a
Compute Engine persistent disk. This command can be invoked either on the
primary or on the secondary disk.
EXAMPLES
Stop replication on the primary disk 'my-disk-1' in zone us-east1-a:
$ gcloud compute disks stop-async-replication my-disk-1 \
--zone=us-east1-a
Stop replication on the secondary disk 'my-disk-2' in zone us-west1-a:
$ gcloud compute disks stop-async-replication my-disk-2 \
--zone=us-west1-a
POSITIONAL ARGUMENTS
DISK_NAME
Name of the disk to stop async replication.
FLAGS
At most one of these can be specified:
--region=REGION
Region of the disk to stop async replication. If not specified, you
might be prompted to select a region (interactive mode only).
To avoid prompting when this flag is omitted, you can set the
compute/region property:
$ gcloud config set compute/region REGION
A list of regions can be fetched by running:
$ gcloud compute regions list
To unset the property, run:
$ gcloud config unset compute/region
Alternatively, the region can be stored in the environment variable
CLOUDSDK_COMPUTE_REGION.
--zone=ZONE
Zone of the disk to stop async replication. 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 disks stop-async-replication
$ gcloud beta compute disks stop-async-replication

View file

@ -0,0 +1,96 @@
NAME
gcloud compute disks stop-group-async-replication - consistently stops a
group of asynchronously replicating disks
SYNOPSIS
gcloud compute disks stop-group-async-replication
DISK_CONSISTENCY_GROUP_POLICY [--region=REGION | --zone=ZONE]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
gcloud compute disks stop-group-async-replication consistently stops a
group of asynchronously replicating disks. This command can be invoked in
either in the primary or secondary scope of the replicating disks.
EXAMPLES
To stop group replication in the primary scope, include the zone or region
of the primary disks. The URL of the disk consistency group resource policy
always uses the region of the primary disks:
$ gcloud compute disks stop-group-async-replication \
projects/my-project/regions/us-west1/resourcePolicies/\
my-policy --zone=us-west1-a
Alternatively, you can stop replication in the secondary scope. Include the
region or zone of the secondary disks. The URL of the disk consistency
group resource policy always uses the region of the primary disks:
$ gcloud compute disks stop-group-async-replication \
projects/my-project/regions/us-west1/resourcePolicies/\
my-policy --zone=us-west2-a
POSITIONAL ARGUMENTS
DISK_CONSISTENCY_GROUP_POLICY
URL of the disk consistency group resource policy. The resourcepolicy
is always in the region of the primary disks.
FLAGS
At most one of these can be specified:
--region=REGION
Region of the consistency group's primary or secondary disks. If not
specified, you might be prompted to select a region (interactive mode
only).
To avoid prompting when this flag is omitted, you can set the
compute/region property:
$ gcloud config set compute/region REGION
A list of regions can be fetched by running:
$ gcloud compute regions list
To unset the property, run:
$ gcloud config unset compute/region
Alternatively, the region can be stored in the environment variable
CLOUDSDK_COMPUTE_REGION.
--zone=ZONE
Zone of the consistency group's primary or secondary disks. 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 disks stop-group-async-replication
$ gcloud beta compute disks stop-group-async-replication