Редактировать 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 Описание ошибки. |