DescribeVolumes#

Description#

Запрос на получение информации о дисках.

Request Parameters#

  • Filter.N — Параметры фильтрации.

    • Тип: Список объектов Filter

    • Необходимо: Нет

  • VolumeId.N — Идентификаторы виртуальных дисков.

    • Тип: Array of strings

    • Необходимо: Нет

Supported Filters#

  • attachment.instance-id — Идентификатор экземпляра, к которому присоединён диск.

  • attachment.device — Название присоединённого к экземпляру устройства (например, disk1).

  • attachment.status — Статус присоединения устройства к экземпляру (attaching | attached | detaching | detached).

  • availability-zone — Название зоны доступности, в которой был создан диск (ru-msk-comp1p | ru-msk-vol51 | ru-msk-vol52).

  • create-time — Время создания диска.

  • size — Размер диска, ГиБ.

  • snapshot-id — Идентификатор снимка диска, из которого был создан диск.

  • status — Статус диска (creating | available | in-use | deleting | error).

  • tag-key — Ключ тега. Такой фильтр позволяет получить диски с тегом с указанным ключом и любым значением.

  • tag:<tag-key> — Пара ключ/значение тега. Ключ тега передаётся в названии фильтра, значение тега — в значении фильтра.

  • volume-id — Идентификатор диска.

  • volume-type — Тип диска (st2 | gp2 | io2).

Response Elements#

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

    • Тип: String

  • volumeSet — Информация о доступных виртуальных дисках.

    • Тип: Список объектов Volume

Examples#

c2-ec2 DescribeVolumes

c2-ec2 DescribeVolumes VolumeId.1 vol-01234567

c2-ec2 DescribeVolumes Filter.1.Name availability-zone Filter.1.Value.1 ru-msk-vol51

c2-ec2 DescribeVolumes Filter.1.Name tag:<tag-key> Filter.1.Value.1 <tag-value>

c2-ec2 DescribeVolumes Filter.1.Name tag-key Filter.1.Value.1 <tag-key>