GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  GCLOUD_COMPUTE_DISKS_CREATE (1)

NAME

gcloud compute disks create - create Google Compute Engine persistent disks

CONTENTS

SYNOPSIS


gcloud compute disks create NAME [NAME ...] [--description DESCRIPTION] [--image IMAGE | --source-snapshot SOURCE_SNAPSHOT] [--image-project IMAGE_PROJECT] [--size SIZE] [--type TYPE] [--zone ZONE] [GLOBAL-FLAG ...]

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 the gcloud compute instances create command. Disks can also be attached to instances that are already running using gcloud 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 (using 'gcloud compute images create’) and creating a new disk using --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.

--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.

AliasProject
centos-6centos-cloud
centos-7centos-cloud
container-vmgoogle-containers
coreoscoreos-cloud
debian-7debian-cloud
debian-7-backportsdebian-cloud
debian-8debian-cloud
opensuse-13opensuse-cloud
rhel-6rhel-cloud
rhel-7rhel-cloud
sles-11suse-cloud
sles-12suse-cloud
ubuntu-12-04ubuntu-os-cloud
ubuntu-14-04ubuntu-os-cloud
ubuntu-15-04ubuntu-os-cloud
ubuntu-15-10ubuntu-os-cloud
windows-2008-r2windows-cloud
windows-2012-r2windows-cloud

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.

--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. 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 the ’gcloud 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 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.

GLOBAL FLAGS

Run $ gcloud help for a description of flags available to all commands.

Search for    or go to Top of page |  Section 1 |  Main Index


GCLOUD_COMPUTE_DISKS_CREATE (1) -->

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.