Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help

       gcloud  compute	disks create - create Google Compute Engine persistent

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

       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 run-
       ning 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 differ-
       ent 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 cre-
       ating 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

       NAME [NAME ...]
	 The names of the disks	to create.

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

	 Alias		      Project
	 centos-6	      centos-cloud

	 centos-7	      centos-cloud
	 container-vm	      google-containers
	 coreos		      coreos-cloud
	 debian-7	      debian-cloud
	 debian-7-backports   debian-cloud
	 debian-8	      debian-cloud
	 opensuse-13	      opensuse-cloud
	 rhel-6		      rhel-cloud
	 rhel-7		      rhel-cloud
	 sles-11	      suse-cloud
	 sles-12	      suse-cloud
	 ubuntu-12-04	      ubuntu-os-cloud
	 ubuntu-14-04	      ubuntu-os-cloud
	 ubuntu-15-04	      ubuntu-os-cloud
	 ubuntu-15-10	      ubuntu-os-cloud
	 windows-2008-r2      windows-cloud
	 windows-2012-r2      windows-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	match-
	 ing 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 giga-
	 byte 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

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

       --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 com-
	 pute/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

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



Want to link to this manual page? Use this URL:

home | help