Редактировать DNS-запись
Запрос позволяет редактировать DNS-запись для домена.
DNS-запись можно задать с помощью идентификатора.
Примечание
Требуется разрешение на управление DNS (чтение и запись).
Request
POST
https://api360.yandex.net/directory/v1/org/{orgId}/domains/{domain}/dns/{recordId}
Path parameters
Name |
Description |
domain* |
Type: string Полное доменное имя. Например |
orgId* |
Type: integer<int64> Идентификатор организации. |
recordId* |
Type: integer<int64> Идентификатор записи. |
Body
application/json
{
"type": "A",
"name": "string",
"ttl": 0,
"address": "string",
"target": "string",
"exchange": "string",
"preference": 0,
"text": "string",
"port": 0,
"priority": 0,
"weight": 0
}
Name |
Description |
name* |
Type: string Имя записи. |
ttl* |
Type: integer<int64> Время жизни записи в секундах (TTL). |
type* |
Type: v1RecordType Тип DNS-записи. Default: Enum: |
address |
Type: string Адрес для записи А или ААА. |
exchange |
Type: string
|
port |
Type: integer<int64> Порт для SRV-записи. |
preference |
Type: integer<int64>
|
priority |
Type: integer<int64> Приоритет для SRV-записи. |
target |
Type: string Цель для записи CNAME или SRV. |
text |
Type: string Содержимое для TXT-записи. |
weight |
Type: integer<int64> Вес для SRV-записи. |
v1RecordType
Тип DNS-записи.
Type |
Description |
Default: Enum: |
Responses
200 OK
Запрос успешно выполнен.
Body
application/json
{
"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"
}
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-записи. |
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 Описание ошибки. |