.. _DescribeVolumes: ############### DescribeVolumes ############### *********** Description *********** Запрос на получение информации о дисках. ****************** Request Parameters ****************** - *Filter.N* — Параметры фильтрации. - Тип: Список объектов :ref:`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:* — Пара ключ/значение тега. Ключ тега передаётся в названии фильтра, значение тега — в значении фильтра. - *volume-id* — Идентификатор диска. - *volume-type* — Тип диска (``st2`` | ``gp2`` | ``io2``). ***************** Response Elements ***************** - *requestId* — Идентификатор запроса. - Тип: String - *volumeSet* — Информация о доступных виртуальных дисках. - Тип: Список объектов :ref:`Volume` ******** Examples ******** .. code-block:: bash 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: Filter.1.Value.1 c2-ec2 DescribeVolumes Filter.1.Name tag-key Filter.1.Value.1