mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-12 07:58:28 +00:00
139 lines
4.9 KiB
Text
139 lines
4.9 KiB
Text
NAME
|
|
gcloud alpha compute disks convert - convert a Compute Engine Persistent
|
|
Disk volume to a Hyperdisk volume
|
|
|
|
SYNOPSIS
|
|
gcloud alpha compute disks convert DISK_NAME
|
|
--target-disk-type=TARGET_DISK_TYPE
|
|
[--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING
|
|
--kms-location=KMS_LOCATION --kms-project=KMS_PROJECT]
|
|
[--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...]
|
|
|
|
DESCRIPTION
|
|
(ALPHA) Convert Compute Engine Persistent Disk volumes to Hyperdisk
|
|
volumes.
|
|
|
|
gcloud alpha compute disks convert converts a Compute Engine Persistent
|
|
Disk volume to a Hyperdisk volume. For a comprehensive guide, refer to:
|
|
https://cloud.google.com/sdk/gcloud/reference/compute/disks/convert.
|
|
|
|
EXAMPLES
|
|
The following command converts a Persistent Disk volume to a Hyperdisk
|
|
Balanced volume:
|
|
|
|
$ gcloud alpha compute disks convert my-disk-1 --zone=ZONE \
|
|
--target-disk-type=hyperdisk-balanced
|
|
|
|
POSITIONAL ARGUMENTS
|
|
DISK_NAME
|
|
Name of the disk to operate on.
|
|
|
|
REQUIRED FLAGS
|
|
--target-disk-type=TARGET_DISK_TYPE
|
|
Specifies the type of Hyperdisk to convert to, for example, to convert
|
|
a Hyperdisk Balanced volume, specify hyperdisk-balanced. To get a list
|
|
of available disk types, run gcloud compute disk-types list.
|
|
|
|
OPTIONAL FLAGS
|
|
Key resource - The Cloud KMS (Key Management Service) cryptokey that will
|
|
be used to protect the disk. The 'Compute Engine Service Agent' service
|
|
account must hold permission 'Cloud KMS CryptoKey Encrypter/Decrypter'.
|
|
The arguments in this group can be used to specify the attributes of this
|
|
resource.
|
|
|
|
--kms-key=KMS_KEY
|
|
ID of the key or fully qualified identifier for the key.
|
|
|
|
To set the kms-key attribute:
|
|
▸ provide the argument --kms-key on the command line.
|
|
|
|
This flag argument must be specified if any of the other arguments in
|
|
this group are specified.
|
|
|
|
--kms-keyring=KMS_KEYRING
|
|
The KMS keyring of the key.
|
|
|
|
To set the kms-keyring attribute:
|
|
▸ provide the argument --kms-key on the command line with a fully
|
|
specified name;
|
|
▸ provide the argument --kms-keyring on the command line.
|
|
|
|
--kms-location=KMS_LOCATION
|
|
The Google Cloud location for the key.
|
|
|
|
To set the kms-location attribute:
|
|
▸ provide the argument --kms-key on the command line with a fully
|
|
specified name;
|
|
▸ provide the argument --kms-location on the command line;
|
|
▸ provide the argument --region on the command line.
|
|
|
|
--kms-project=KMS_PROJECT
|
|
The Google Cloud project for the key.
|
|
|
|
To set the kms-project attribute:
|
|
▸ provide the argument --kms-key on the command line with a fully
|
|
specified name;
|
|
▸ provide the argument --kms-project on the command line;
|
|
▸ set the property core/project.
|
|
|
|
At most one of these can be specified:
|
|
|
|
--region=REGION
|
|
Region of the disk to operate on. If not specified, you might be
|
|
prompted to select a region (interactive mode only).
|
|
|
|
To avoid prompting when this flag is omitted, you can set the
|
|
compute/region property:
|
|
|
|
$ gcloud config set compute/region REGION
|
|
|
|
A list of regions can be fetched by running:
|
|
|
|
$ gcloud compute regions list
|
|
|
|
To unset the property, run:
|
|
|
|
$ gcloud config unset compute/region
|
|
|
|
Alternatively, the region can be stored in the environment variable
|
|
CLOUDSDK_COMPUTE_REGION.
|
|
|
|
--zone=ZONE
|
|
Zone of the disk to operate on. If not specified and the compute/zone
|
|
property isn't set, you might be prompted to select a zone
|
|
(interactive mode only).
|
|
|
|
To avoid prompting when this flag is omitted, you can set the
|
|
compute/zone property:
|
|
|
|
$ gcloud config set compute/zone ZONE
|
|
|
|
A list of zones can be fetched by running:
|
|
|
|
$ gcloud compute zones list
|
|
|
|
To unset the property, run:
|
|
|
|
$ gcloud config unset compute/zone
|
|
|
|
Alternatively, the zone can be stored in the environment variable
|
|
CLOUDSDK_COMPUTE_ZONE.
|
|
|
|
GCLOUD WIDE FLAGS
|
|
These flags are available to all commands: --access-token-file, --account,
|
|
--billing-project, --configuration, --flags-file, --flatten, --format,
|
|
--help, --impersonate-service-account, --log-http, --project, --quiet,
|
|
--trace-token, --user-output-enabled, --verbosity.
|
|
|
|
Run $ gcloud help for details.
|
|
|
|
NOTES
|
|
This command is currently in alpha and might change without notice. If this
|
|
command fails with API permission errors despite specifying the correct
|
|
project, you might be trying to access an API with an invitation-only early
|
|
access allowlist. These variants are also available:
|
|
|
|
$ gcloud compute disks convert
|
|
|
|
$ gcloud beta compute disks convert
|
|
|