Редактировать DNS-запись
Запрос позволяет редактировать DNS-запись для домена.
DNS-запись можно задать с помощью идентификатора.
HTTP-запрос
POST https://api360.yandex.net/directory/v1/org/{orgId}/domains/{domain}/dns/{recordId}
Path-параметры
orgId * | integer Идентификатор организации. |
domain * | string Полное доменное имя. Например |
recordId * | integer Идентификатор записи. |
* Обязательный параметр
Тело запроса
{ "address": string, "exchange": string, "name": string, "port": integer, "preference": integer, "priority": integer, "target": string, "text": string, "ttl": integer, "type": string, "weight": integer }
Скопировано
Представление
Поля
address | string Адрес для записи А или ААА. |
exchange | string
|
name * | string Имя записи. |
port | integer Порт для SRV-записи. |
preference | integer
|
priority | integer Приоритет для SRV-записи. |
target | string Цель для записи CNAME или SRV. |
text | string Содержимое для TXT-записи. |
ttl * | integer Время жизни записи в секундах (TTL). |
type * | string Значение по умолчанию:
|
weight | integer Вес для SRV-записи. |
address | string Адрес для записи А или ААА. |
exchange | string
|
name * | string Имя записи. |
port | integer Порт для SRV-записи. |
preference | integer
|
priority | integer Приоритет для SRV-записи. |
target | string Цель для записи CNAME или SRV. |
text | string Содержимое для TXT-записи. |
ttl * | integer Время жизни записи в секундах (TTL). |
type * | string Значение по умолчанию:
|
weight | integer Вес для SRV-записи. |
* Обязательный параметр
Ответы
Код 200
Запрос успешно выполнен.
{ "address": string, "exchange": string, "flag": integer, "name": string, "port": integer, "preference": integer, "priority": integer, "recordId": integer, "tag": string, "target": string, "text": string, "ttl": integer, "type": string, "value": string, "weight": integer }
Скопировано
Представление
Поля
address | string Адрес для записи А или ААА. |
exchange | string
|
flag | integer Флаг для CAA-записи. |
name * | string Полное доменное имя. Например |
port | integer Порт для SRV-записи. |
preference | integer
|
priority | integer Приоритет для SRV-записи. |
recordId | integer Идентификатор записи. |
tag | string Тег для CAA-записи. |
target | string Цель для записи CNAME или SRV. |
text | string Содержимое для TXT-записи. |
ttl * | integer Время жизни записи в секундах (TTL) . |
type * | string Значение по умолчанию:
|
value | string CAA-запись, заключенная в двойные кавычки, например |
weight | integer Вес для SRV-записи. |
address | string Адрес для записи А или ААА. |
exchange | string
|
flag | integer Флаг для CAA-записи. |
name * | string Полное доменное имя. Например |
port | integer Порт для SRV-записи. |
preference | integer
|
priority | integer Приоритет для SRV-записи. |
recordId | integer Идентификатор записи. |
tag | string Тег для CAA-записи. |
target | string Цель для записи CNAME или SRV. |
text | string Содержимое для TXT-записи. |
ttl * | integer Время жизни записи в секундах (TTL) . |
type * | string Значение по умолчанию:
|
value | string CAA-запись, заключенная в двойные кавычки, например |
weight | integer Вес для SRV-записи. |
* Обязательный параметр
Код 401
Пользователь не авторизован.
{ "code": integer, "details": [ { "@type": string } ], "message": string }
Скопировано
Представление
Поля
code | integer |
details[] | array |
details[]. | string |
message | string |
code | integer |
details[] | array |
details[]. | string |
message | string |
* Обязательный параметр
Код 403
У пользователя или приложения нет прав на доступ к ресурсу, запрос отклонен.
{ "code": integer, "details": [ { "@type": string } ], "message": string }
Скопировано
Представление
Поля
code | integer |
details[] | array |
details[]. | string |
message | string |
code | integer |
details[] | array |
details[]. | string |
message | string |
* Обязательный параметр
Код 404
Запрашиваемый ресурс не найден.
{ "code": integer, "details": [ { "@type": string } ], "message": string }
Скопировано
Представление
Поля
code | integer |
details[] | array |
details[]. | string |
message | string |
code | integer |
details[] | array |
details[]. | string |
message | string |
* Обязательный параметр
Код 500
Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.
{ "code": integer, "details": [ { "@type": string } ], "message": string }
Скопировано
Представление
Поля
code | integer |
details[] | array |
details[]. | string |
message | string |
code | integer |
details[] | array |
details[]. | string |
message | string |
* Обязательный параметр