Подключиться
Yandex Cloud DNS

Метод listRecordSets

Возвращает список наборов записей в указанном каталоге.

HTTP-запрос

GET https://dns.api.cloud.yandex.net/dns/v1/zones/{dnsZoneId}:listRecordSets

Path-параметры

Параметр Описание
dnsZoneId Идентификатор зоны DNS для получения списка наборов записей. Чтобы получить идентификатор зоны DNS, выполните запрос list. Длина строки в символах должна быть равна 20.

Query-параметры

Параметр Описание
pageSize Максимальное количество результатов на странице ответа на запрос. Если количество результатов больше чем page_size, сервис вернет значение nextPageToken, которое можно использовать для получения следующей страницы. Максимальное значение — 1000.
pageToken Токен страницы. Установите значение page_token равным значению поля nextPageToken предыдущего запроса, чтобы получить следующую страницу результатов. Максимальная длина строки в символах — 1000.
filter Параметры фильтрации задач в ответе. В параметрах фильтрации указываются: 1. Имя поля. В настоящее время вы можете использовать фильтрацию только для полей name и type . 2. Оператор. Поддерживаются операторы = и != для одиночных значений, IN и NOT IN для списков значений. 3. Значение или списки значений. Значение длиной от 3 до 63 символов, совпадающее с регулярным выражением ^[a-z][-a-z0-9]{1,61}[a-z0-9]. Пример фильтра: name=my-record-set. Максимальная длина строки в символах — 1000.

Ответ

HTTP Code: 200 - OK

{
  "recordSets": [
    {
      "name": "string",
      "type": "string",
      "ttl": "string",
      "data": [
        "string"
      ]
    }
  ],
  "nextPageToken": "string"
}
Поле Описание
recordSets[] object

Набор записей. Подробнее см. в разделе Ресурсные записи.
recordSets[].
name		 string

Доменное имя.

Длина строки в символах должна быть от 1 до 254.
recordSets[].
type		 string

Тип записи.

Длина строки в символах должна быть от 1 до 20.
recordSets[].
ttl		 string (int64)

Время жизни записи в секундах.

Допустимые значения — от 0 до 2147483647 включительно.
recordSets[].
data[]		 string

Обязательное поле. Значение набора записей.

Количество элементов должно находиться в диапазоне от 1 до 100. Длина строки в символах для каждого значения должна быть от 1 до 255.
nextPageToken string

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

Каждая следующая страница будет иметь свой next_page_token для продолжения перебора страниц результатов.
В этой статье: