Volumes

Create a volume

Create a volume with specified parameters.

post/diskgroups/{DgId}/volumes

Request

Path parameters

DgIdstring required

Diskgroup identifier.

Query parameters

nodenamestring

If specified, volume will be created on the specified node. Else, a node where diskgroup is created will be chosen internally. Error will be returned for a nodename specified which does not has the particular diskgroup created.

Request body

Namestring required

Name of the volume

Sizestring required

Size of the volume

Layout'concat' | 'mirror' | 'stripe' | 'mirror-stripe' | 'mirror-concat' | 'concat-mirror' | 'stripe-mirror'

Layout of the volume

Nstripeinteger

Number of stripes/columns

Stripeunitstring

Specifies the stripe unit size to use for ecoded volume or for striped plexes

Nmirrorinteger

Number of mirrors for mirrored layout

Initstring

Specify how to initialize a new volume

StorageSpecificationstring

Storage specification to select certain types of disks for the allocation during volume creation like ctlr:c1 or mediatype:ssd etc.

Nloginteger

Specified number of log mirrors to be created for given logtype

Logleninteger

Specifies a log length to use for dirty-region log (DRL) subdisks for mirrored volumes

Mirrorstring

Specifies that volumes should be mirrored across instances of a particular disk class like array (enclr), ctlr, host, site etc.

Stripestring

Specifies that volumes should be striped across instances of a particular disk class like array (enclr), ctlr, host, site etc.

MirrorConfinestring

Specifies a required list of disk classes for confining a mirror

Requirestring

Specifies a list of storage specifications for a volume allocation operation. The storage chosen must match all of the requirements specified.

Usestring

Specifies a list of storage specifications for a volume allocation operation. The storage chosen must match one or more of the requirements specified.

Regionszstring

Specifies the size of each region that is tracked by a bit in the maps within a DCO volume

Usetypestring

Specifies the usage type (e.g. fsgen) to use when creating a new volume

Vxcloudboolean

Specify true or false to create a cloud volume for block level tiering

Fscloudboolean

Specify true or false to create a cloud volume for file level tiering

Encryptedboolean

Specify true or false based on whether encryption is required or not

Fastresyncboolean

Specify true or false based on whether fastresync is required or not

Response

The request has succeeded.

detailstring

Error details.

statusinteger

http code

Changes

No recorded changes to this operation across all 1 revision of this API.