- NAME
- gcloud-compute-disks-create - Create Google Compute Engine persistent disks
- SYNOPSIS
-
gcloud compute disks create NAME [NAME …] [--description DESCRIPTION] [--format FORMAT] [--help] [--image IMAGE | --source-snapshot SOURCE_SNAPSHOT] [--image-project IMAGE_PROJECT] [--project PROJECT] [--quiet, -q] [--size SIZE] [--type TYPE] [--zone ZONE] [-h]
- DESCRIPTION
-
gcloud compute disks create
creates one or more Google Compute Engine persistent disks. When creating virtual machine instances, disks can be attached to the instances through thegcloud compute instances create
command. Disks can also be attached to instances that are already running usinggloud compute instances attach-disk
. -
Disks are zonal resources, so they reside in a particular zone
for their entire lifetime. The contents of a disk can be moved
to a different zone by snapshotting the disk (using
gcloud compute disks snapshot
) and creating a new disk using “--source-snapshot” in the desired zone. The contents of a disk can also be moved across project or zone by creating an image (usinggcloud compute images create
) and creating a new disk using “--source-image” in the desired project and/or zone. - When creating disks, be sure to include the “--zone” option:
-
$ gcloud compute disks create my-disk-1 my-disk-2 --zone us-east1-a
- POSITIONAL ARGUMENTS
-
-
NAME [NAME …]
- The names of the disks to create.
-
- FLAGS
-
-
--description
DESCRIPTION
- An optional, textual description for the disks being created.
-
--format
FORMAT
- Specify a format for printed output. By default, a command-specific human-friendly output format is used. Setting this flag to one of the available options will serialize the result of the command in the chosen format and print it to stdout. Supported formats are: "json", "text", "yaml".
-
--help
- Display detailed help.
-
--image
IMAGE
- An image to apply to the disks being created. When using this option, the size of the disks must be at least as large as the image size. Use “--size” to adjust the size of the disks.
- The value for this option can be the name of an image or an alias from the table below.
-
Alias Project Image Name centos-6 centos-cloud centos-6 coreos coreos-cloud coreos-beta debian-7 debian-cloud debian-7-wheezy debian-7-backports debian-cloud backports-debian-7-wheezy opensuse-13 opensuse-cloud opensuse-13-1 rhel-6 rhel-cloud rhel-6 sles-11 suse-cloud sles-11 - When the value is an alias, this tool will query the public image project that contains the image type to find the latest image matching the alias. The user’s project is also queried for an image with the same name as the alias. If a conflict exists, the user will be prompted to resolve the conflict.
- To specify an image in another project for which there is no alias, use “--image-project”. When “--image-project” is present, no API calls are made to resolve the image. This property is useful for scripts.
- This flag is mutually exclusive with “--source-snapshot”.
-
--image-project
IMAGE_PROJECT
- The project against which all image references will be resolved. See “--image” for more details.
-
--project
PROJECT
- Google Cloud Platform project to use for this invocation.
-
--quiet
- Disable all interactive prompts when running gcloud commands. If input is required, defaults will be used, or an error will be raised.
-
--size
SIZE
- Indicates the size of the disks. The value must be a whole number followed by a size unit of “KB” for kilobyte, “MB” for megabyte, “GB” for gigabyte, or “TB” for terabyte. For example, “10GB” will produce 10 gigabyte disks. If omitted, a default size of 500 GB is used for standard disks and 200GB for SSD disks. The minimum size a disk can have is 1 GB. Disk size must be a multiple of 10 GB.
-
--source-snapshot
SOURCE_SNAPSHOT
-
A source snapshot used to create the disks. It is safe to
delete a snapshot after a disk has been created from the
snapshot. In such cases, the disks will no longer reference
the deleted snapshot. To get a list of snapshots in your
current project, run
gcloud compute snapshots list
. A snapshot from an existing disk can be created using thegcloud compute disks snapshot
command. This flag is mutually exclusive with “--image”. - When using this option, the size of the disks must be at least as large as the snapshot size. Use “--size” to adjust the size of the disks.
-
--type
TYPE
-
Specifies the type of disk to create. To get a
list of available disk types, run
gcloud compute disk-types list
. The default disk type is pd-standard. -
--zone
ZONE
- The zone of the disks to create. If not specified, you will be prompted to select a zone.
- 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 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”.
-
-h
- Print a summary help and exit.
-
gcloud compute disks create
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License , and code samples are licensed under the Apache 2.0 License . For details, see our Site Policies .
Last updated August 11, 2014.