Подключиться
Войти
Yandex Managed Service for Redis

Метод listHosts

Получает список хостов для указанного кластера.

HTTP-запрос

GET https://mdb.api.cloud.yandex.net/managed-redis/v1/clusters/{clusterId}/hosts

Path-параметры

Параметр Описание
clusterId Обязательное поле. Идентификатор кластера Redis. Чтобы получить идентификатор кластера, используйте запрос list. Максимальная длина строки в символах — 50.

Query-параметры

Параметр Описание
pageSize Максимальное количество результатов на странице ответа на запрос. Если количество результатов больше чем pageSize, сервис вернет значение nextPageToken, которое можно использовать для получения следующей страницы. Допустимые значения — от 0 до 1000 включительно.
pageToken Токен страницы. Установите значение pageToken равным значению поля nextPageToken предыдущего запроса, чтобы получить следующую страницу результатов. Максимальная длина строки в символах — 100.

Ответ

HTTP Code: 200 - OK

{
  "hosts": [
    {
      "name": "string",
      "clusterId": "string",
      "zoneId": "string",
      "subnetId": "string",
      "resources": {
        "resourcePresetId": "string",
        "diskSize": "string"
      },
      "role": "string",
      "health": "string",
      "services": [
        {
          "type": "string",
          "health": "string"
        }
      ],
      "shardName": "string"
    }
  ],
  "nextPageToken": "string"
}
Поле Описание
hosts[] object

Cписок хостов для кластера.
hosts[].
name		 string

Имя хоста Redis. Имя хоста назначается MDB во время создания и не может быть изменено. Длина 1-63 символов.

Имя уникально для всех существующих хостов MDB в Яндекс.Облаке, так как оно определяет полное доменное имя (FQDN) хоста.
hosts[].
clusterId		 string

Идентификатор кластера Redis. Этот идентификатор генерирует MDB при создании.
hosts[].
zoneId		 string

Идентификатор зоны доступности, в которой находится хост Redis.
hosts[].
subnetId		 string

Идентификатор подсети, к которой принадлежит хост.
hosts[].
resources		 object

Ресурсы, выделенные хосту Redis.
hosts[].
resources.
resourcePresetId		 string

Идентификатор набора вычислительных ресурсов, доступных хосту (процессор, память и т. д.). Все доступные наборы ресурсов перечислены в документации.
hosts[].
resources.
diskSize		 string (int64)

Объем хранилища, доступного хосту, в байтах.
hosts[].
role		 string

Роль хоста в кластере.

  • ROLE_UNKNOWN: Роль хоста в кластере неизвестна.
  • MASTER: Хост является мастером в кластере Redis.
  • REPLICA: Хост является репликой в кластере Redis.
hosts[].
health		 string

Код работоспособности хоста.

  • HEALTH_UNKNOWN: Состояние хоста неизвестно.
  • ALIVE: Хозяин выполняет все свои функции нормально.
  • DEAD: Хост не работает и не может выполнять свои основные функции.
  • DEGRADED: Хост деградировал, и может выполнять только некоторые из своих основных функций.
hosts[].
services[]		 object

Сервисы, предоставляемые хостом.
hosts[].
services[].
type		 string

Тип сервиса, предоставляемого хостом.

  • REDIS: Хост — сервер Redis.
  • ARBITER: Хост предоставляет только сервис Sentinel (хост кворума).
  • REDIS_CLUSTER: Хост является узлом Redis Cluster.
hosts[].
services[].
health		 string

Код состояния доступности сервера.

  • HEALTH_UNKNOWN: Работоспособность сервера неизвестна.
  • ALIVE: Сервер работает нормально.
  • DEAD: Сервер отключен или не отвечает.
hosts[].
shardName		 string
nextPageToken string

Токен для получения следующей страницы результатов в ответе. Если количество результатов больше чем pageSize, используйте nextPageToken в качестве значения параметра pageToken в следующем запросе списка ресурсов. Все последующие запросы будут получать свои значения nextPageToken для перебора страниц результатов.