Yandex Cloud
  • Сервисы
  • Решения
  • Почему Yandex Cloud
  • Сообщество
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Language / Region
© 2022 ООО «Яндекс.Облако»
Yandex Cloud DNS
  • Начало работы
  • Пошаговые инструкции
    • Все инструкции
    • Зоны
      • Создать внутреннюю зону DNS
      • Создать публичную зону DNS
      • Изменить зону DNS
      • Удалить зону DNS
    • Записи
      • Создать запись
      • Изменить запись
      • Удалить запись
  • Концепции
    • Обзор
    • Зоны DNS
    • Ресурсные записи
    • Интеграция с Compute Cloud
    • Квоты и лимиты
  • Практические руководства
    • Настройка локального кеширующего DNS-резолвера
    • Миграция DNS-зон из Яндекс 360
    • Интеграция с корпоративным сервисом DNS
    • Настройка Cloud DNS для доступа к кластерам управляемых баз данных из других облачных сетей
  • Управление доступом
  • Правила тарификации
  • Справочник API
    • Аутентификация в API
    • gRPC (англ.)
      • Overview
      • DnsZoneService
      • OperationService
    • REST (англ.)
      • Overview
      • DnsZone
        • Overview
        • create
        • delete
        • get
        • getRecordSet
        • list
        • listAccessBindings
        • listOperations
        • listRecordSets
        • setAccessBindings
        • update
        • updateAccessBindings
        • updateRecordSets
        • upsertRecordSets
  1. Справочник API
  2. REST (англ.)
  3. DnsZone
  4. listRecordSets

Method listRecordSets

Статья создана
Yandex.Cloud
  • HTTP request
  • Path parameters
  • Query parameters
  • Response

Retrieves the list of record sets in the specified folder.

HTTP request

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

Path parameters

Parameter Description
dnsZoneId ID of the DNS zone to list record sets in. To get a DNS zone ID, make a list request. The string length in characters must be equal to 20.

Query parameters

Parameter Description
pageSize The maximum number of results per page to return. If the number of available results is larger than page_size, the service returns a nextPageToken that can be used to get the next page of results in subsequent list requests. The maximum value is 1000.
pageToken Page token. To get the next page of results, set page_token to the nextPageToken returned by a previous list request. The maximum string length in characters is 1000.
filter A filter expression that filters record sets listed in the response. The expression consists of one or more conditions united by AND operator: <condition1> [AND <condition2> [<...> AND <conditionN>]]. Each condition has the form <field> <operator> <value>, where: 1. <field> is the field name. Currently you can use filtering only on the name and type fields. 2. <operator> is a logical operator, one of =, !=, IN, NOT IN. 3. <value> represents a value. 3.1. In case of single value condition (= or !=), the value is a string in double (") or single (') quotes. C-style escape sequences are supported (\" turns to ", \' to ', \\ to backslash). 3.2. In case of a list of values condition (IN or NOT IN), the value is (<string1>, <string2>, .., <stringN>), where <string> is a string in double (") or single (') quotes. Examples of a filter: name="my-record-set", type IN ("MX","A") AND name="works.on.my.machine.". The maximum string length in characters is 1000.

Response

HTTP Code: 200 - OK

{
  "recordSets": [
    {
      "name": "string",
      "type": "string",
      "ttl": "string",
      "data": [
        "string"
      ]
    }
  ],
  "nextPageToken": "string"
}
Field Description
recordSets[] object

A record set. For details about the concept, see Resource record.

recordSets[].
name
string

Domain name.

The string length in characters must be 1-254.

recordSets[].
type
string

Record type.

The string length in characters must be 1-20.

recordSets[].
ttl
string (int64)

Time to live in seconds.

Acceptable values are 0 to 2147483647, inclusive.

recordSets[].
data[]
string

Required. Data of the record set.

The number of elements must be in the range 1-100. The string length in characters for each value must be 1-255.

nextPageToken string

Token for getting the next page of the list. If the number of results is greater than the specified pageSize, use next_page_token as the value for the pageToken parameter in the next list request.

Each subsequent page will have its own next_page_token to continue paging through the results.

Была ли статья полезна?

Language / Region
© 2022 ООО «Яндекс.Облако»
В этой статье:
  • HTTP request
  • Path parameters
  • Query parameters
  • Response