DescribeHosts#

Description#

Запрос на получение списка всех существующих выделенных серверов и их описаний. Возможно применение одного или нескольких фильтров по параметрам выделенных серверов.

Request Parameters#

  • Filter.N — Имя параметра фильтрации.

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

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

  • HostId.N — Идентификатор выделенного сервера.

    • Тип: Array of strings

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

Supported Filters#

  • auto-placement — Автоматическое размещение.

    • Тип: String

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

    • Значения: on | off

  • availability-zone — Зона доступности.

    • Тип: String

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

  • instance-type — Тип поддерживаемого экземпляра выделенного сервера.

    • Тип: String

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

  • state — Состояние выделенного сервера.

    • Тип: String

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

    • Значения: pending | available | under-assessment | permanent-failure | temporary-failure | released | released-permanent-failure

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

    • Тип: String

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

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

    • Тип: String

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

Response Elements#

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

    • Тип: String

  • hostSet — Массив выделенных серверов.

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