dcloud ec2 volumes create

Create a volume in a region

IAM ec2:CreateVolumeChanges state

Encrypted (LUKS2, key per volume from KMS) unless `encrypted` is false. An encrypted volume opens at `/dev/mapper/ews-vol-<provider volume id>` on an instance launched with the volume helper; format and mount that device. `kmsKeyId` wraps the volume key under one of your KMS keys (needs `kms:Encrypt` on it); disabling or deleting that key makes the volume unopenable.

Synopsis

dcloud ec2 volumes create --name name --size-gib sizeGib --region-id regionId [flags]

Flags

  • --nameRequired

    string

    A display name

    Constraints: 1-64 chars

  • --size-gibRequired

    number

    Size in GiB; a restore needs at least the snapshot’s size

    Constraints: integer, 10-10000

  • --region-idRequired

    string

    The region to create it in, e.g. de1

    Constraints: min 1 chars

  • --availability-zone-idOptional

    string

    The zone it lives in; it attaches only to instances there. Default de1a

    Constraints: /^[a-z]+[0-9]+[a-z]$/

  • --tagsOptional

    map of string

    Tags for the volume; your organization’s required keys must be present

    Constraints: key=value

  • --encryptedOptional

    boolean (--encrypted / --no-encrypted)

    Encrypt the volume at rest with a key of its own, held in KMS (default true); a restore follows the snapshot instead

    Default: true

  • --kms-key-idOptional

    string

    One of your KMS keys to wrap the volume key (needs kms:Encrypt on it); omitted: the platform key. Not with snapshotId

    Constraints: uuid

  • --snapshot-idOptional

    string

    Restore this volume snapshot onto the new volume (same zone, at least its size)

    Constraints: /^snap-[0-9a-f]{6,32}$/

Example

dcloud ec2 volumes create --name example --size-gib 1 --region-id example

Generated from the API description, the same one the API checks requests against and the CLI is built from.