CreateVolume

GET /?Action=CreateVolume
Description

Creates a BSU volume in a specified Region.
BSU volumes can be attached to an instance in the same Availability Zone. You can create a new empty volume or restore a volume from an existing snapshot.
You can create the following volume types: Enterprise (io1) for provisioned IOPS SSD volumes, Performance (gp2) for general purpose SSD volumes, or Magnetic (standard) volumes.

Body parameter

Required: false
Name: CreateVolumeRequest

Name Description Required Schema Default Example

AvailabilityZone

The Availability Zone in which you want to create the volume.

true

string

DryRun

If set to true, checks whether you have the required permissions to perform the action.

false

boolean

Iops

The number of I/O operations per second (only for io1 volumes). The maximum number of IOPS allowed for io1 volumes is 13000.

false

integer

Size

The size of the volume, in gibibytes (GiB). The maximum allowed size for a volume is 14,901 GiB.

true

integer

SnapshotId

The ID of the snapshot from which you want to create the volume.

false

string

VolumeType

The type of volume you want to create (io1 | gp2 | standard). If not specified, a standard volume is created. For more information about volumes types, see Volume Types and IOPS.

false

string
Responses
HTTP Code 200
HTTP Code Description Schema

200

Volume

Response 200

Response 200

Name Description Required Schema Default Example

attachmentSet.N

Information about the volume attachments.

false

VolumeAttachment

availabilityZone

The Availability Zone of the volume.

false

string

createTime

The time at which the volume was created.

false

string

iops

The number of I/O operations per second (only for io1 and gp2 volumes).

false

integer

requestId

The ID of the request.

false

string

size

The size of the volume, in GiB.

false

integer

snapshotId

The ID of the snapshot from which the volume was created.

false

string

status

The state of the volume (always creating when creating a volume).

false

string

tagSet.N

The tags associated with the volume.

false

Tag

volumeId

The ID of the newly created volume.

false

string

volumeType

The type of the volume.

false

string