.. _CreateVolume:

############
CreateVolume
############

***********
Description
***********

Запрос на создание виртуального диска.

******************
Request Parameters
******************

Необходимые параметры
=====================

- *AvailabilityZone* — Зона доступности.

  - Тип: String
  - Необходимо: Да
  - Возможные значения: ``ru-msk-vol51`` | ``ru-msk-comp1p`` | ``ru-msk-vol52``

Опциональные параметры
======================

- *Iops* — Количество операций ввода/вывода за секунду.

  - Тип: Integer
  - Необходимо: Нет
  - Возможные значения: Допустимые для типа :ref:`io2 <io2VolumeTypeManual>`
  - Ограничение: Только для дисков с типом ``io2``

- *Size* — Размер виртуального диска, ГиБ.

  - Тип: Integer
  - Необходимо: Нет

- *SnapshotId* — Идентификатор снимка диска.

  - Тип: String
  - Необходимо: Нет

- *TagSpecification.N* — Теги, назначаемые создаваемому ресурсу.

  - Тип: Список объектов :ref:`TagSpecification`
  - Необходимо: Нет

- *VolumeType* — Тип диска.

  - Тип: String
  - Необходимо: Нет
  - Возможные значения: ``st2`` | ``gp2`` | ``io2``
  - Значение по умолчанию: ``st2``

*****************
Response Elements
*****************

- *availabilityZone* — Зона доступности диска.

  - Тип: String

- *createTime* — Время создания диска.

  - Тип: Timestamp

- *iops* — Количество операций ввода/вывода за секунду (IOPS), доступных для диска.

  - Тип: Integer

- *requestId* — Идентификатор запроса.

  - Тип: String

- *status* — Текущий статус  диска.

  - Тип: String

- *tagSet* — Теги, связанные с диском.

  - Тип: Список объектов :ref:`Tag`

- *volumeId* — Идентификатор диска.

  - Тип: String

- *volumeType* — Тип диска.

  - Тип: String

********
Examples
********

.. code-block:: bash

   c2-ec2 CreateVolume AvailabilityZone ru-msk-vol51 Size 32

   c2-ec2 CreateVolume AvailabilityZone ru-msk-vol51 Size 32 VolumeType io2 Iops 1600

   c2-ec2 CreateVolume AvailabilityZone ru-msk-vol51 Size 32 TagSpecification.0.ResourceType "volume" \
                       TagSpecification.0.Tag.0.Key "tag_key" TagSpecification.0.Tag.0.Value "tag_value"