Получить DNS-записи домена
Запрос позволяет получить все DNS-записи, которые были установлены для домена.
Примечание
Требуется разрешение на управление DNS (чтение и запись).
Request
GET
https://api360.yandex.net/directory/v1/org/{orgId}/domains/{domain}/dns
Path parameters
|
Name |
Description |
|
domain* |
Type: string Полное доменное имя. Например |
|
orgId* |
Type: integer<int64> Идентификатор организации. |
Query parameters
|
Name |
Description |
|
page |
Type: integer<int64> Номер страницы ответа. Значение по умолчанию — |
|
perPage |
Type: integer<int64> Количество сотрудников на одной странице ответа. Значение по умолчанию — |
Responses
200 OK
Запрос успешно выполнен.
Body
application/json
{
"records": [
{
"recordId": 0,
"type": "A",
"name": "string",
"ttl": 0,
"address": "string",
"target": "string",
"exchange": "string",
"preference": 0,
"text": "string",
"port": 0,
"priority": 0,
"weight": 0,
"flag": 0,
"tag": "string",
"value": "string"
}
],
"page": 0,
"pages": 0,
"perPage": 0,
"total": 0
}
|
Name |
Description |
|
page |
Type: integer<int64> Номер страницы ответа. |
|
pages |
Type: integer<int64> Количество страниц ответа. |
|
perPage |
Type: integer<int64> Количество записей на одной странице ответа. |
|
records |
Type: v1Record[] Список DNS-записей. |
|
total |
Type: integer<int64> Общее количество записей. |
v1Record
|
Name |
Description |
|
address |
Type: string Адрес для записи А или ААА. |
|
exchange |
Type: string
|
|
flag |
Type: integer<int64> Флаг для CAA-записи. |
|
name |
Type: string Полное доменное имя. Например |
|
port |
Type: integer<int64> Порт для SRV-записи. |
|
preference |
Type: integer<int64>
|
|
priority |
Type: integer<int64> Приоритет для SRV-записи. |
|
recordId |
Type: integer<int64> Идентификатор записи. |
|
tag |
Type: string Тег для CAA-записи. |
|
target |
Type: string Цель для записи CNAME или SRV. |
|
text |
Type: string Содержимое для TXT-записи. |
|
ttl |
Type: integer<int64> Время жизни записи в секундах (TTL) . |
|
type |
Type: v1RecordType Тип DNS-записи. Default: Enum: |
|
value |
Type: string CAA-запись, заключенная в двойные кавычки, например |
|
weight |
Type: integer<int64> Вес для SRV-записи. |
v1RecordType
Тип DNS-записи.
|
Type |
Description |
|
Default: Enum: |
401 Unauthorized
Пользователь не авторизован.
Body
application/json
{
"code": 0,
"message": "string",
"details": [
null
]
}
|
Name |
Description |
|
code |
Type: integer<int32> Код ошибки. |
|
details |
Type: any[] Дополнительные сведения об ошибке. |
|
message |
Type: string Описание ошибки. |
403 Forbidden
У пользователя или приложения нет прав на доступ к ресурсу, запрос отклонен.
Body
application/json
{
"code": 0,
"message": "string",
"details": [
null
]
}
|
Name |
Description |
|
code |
Type: integer<int32> Код ошибки. |
|
details |
Type: any[] Дополнительные сведения об ошибке. |
|
message |
Type: string Описание ошибки. |
404 Not Found
Запрашиваемый ресурс не найден.
Body
application/json
{
"code": 0,
"message": "string",
"details": [
null
]
}
|
Name |
Description |
|
code |
Type: integer<int32> Код ошибки. |
|
details |
Type: any[] Дополнительные сведения об ошибке. |
|
message |
Type: string Описание ошибки. |
500 Internal Server Error
Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.
Body
application/json
{
"code": 0,
"message": "string",
"details": [
null
]
}
|
Name |
Description |
|
code |
Type: integer<int32> Код ошибки. |
|
details |
Type: any[] Дополнительные сведения об ошибке. |
|
message |
Type: string Описание ошибки. |