Добавить DNS-запись

Запрос позволяет добавить DNS-запись для домена.

Примечание

Требуется разрешение на управление DNS (чтение и запись).

Request

POST

https://api360.yandex.net/directory/v1/org/{orgId}/domains/{domain}/dns

Path parameters

Name

Description

domain*

Type: string

Полное доменное имя. Например example.com. Для кириллических доменов (например домен.рф) используйте кодировку Punycode.

orgId*

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,
    "flag": 0,
    "tag": "string",
    "value": "string"
}

Name	Description
name*	Type: string Имя записи.
ttl*	Type: integer<int64> Время жизни записи в секундах (TTL).
type*	Type: v1RecordType Тип DNS-записи. Default: `A` Enum: `A`, `AAAA`, `CNAME`, `MX`, `TXT`, `SRV`, `NS`, `CAA`
address	Type: string Адрес для записи А или ААА.
exchange	Type: string `EXCHANGE` для MX-записи.
flag	Type: integer<int64> Флаг для CAA-записи.
port	Type: integer<int64> Порт для SRV-записи.
preference	Type: integer<int64> `PREFERENCE` для MX-записи.
priority	Type: integer<int64> Приоритет для SRV-записи.
tag	Type: string Тег для CAA-записи.
target	Type: string Цель для записи CNAME или SRV.
text	Type: string Содержимое для TXT-записи.
value	Type: string CAA-запись, заключенная в двойные кавычки, например `"ca.example.net"`.
weight	Type: integer<int64> Вес для SRV-записи.

v1RecordType

Тип DNS-записи.

Type

Description

v1RecordType

Default: A

Enum: A, AAAA, CNAME, MX, TXT, SRV, NS, CAA

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 `EXCHANGE` для MX-записи.
flag	Type: integer<int64> Флаг для CAA-записи.
name	Type: string Полное доменное имя. Например `example.com`. Для кириллических доменов (например `домен.рф`) используйте кодировку Punycode.
port	Type: integer<int64> Порт для SRV-записи.
preference	Type: integer<int64> `PREFERENCE` для MX-записи.
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: `A` Enum: `A`, `AAAA`, `CNAME`, `MX`, `TXT`, `SRV`, `NS`, `CAA`
value	Type: string CAA-запись, заключенная в двойные кавычки, например `"ca.example.net"`.
weight	Type: integer<int64> Вес для SRV-записи.

400 Bad Request

Некорректный запрос.

Body

application/json

{
    "code": 0,
    "message": "string",
    "details": [
        {
            "@type": "string"
        }
    ]
}

Name	Description
code	Type: integer<int32> Код ошибки.
details	Type: protobufAny[] Дополнительные сведения об ошибке.
message	Type: string Описание ошибки.

protobufAny

Name	Description
@type	Type: string
...rest	Type: any

401 Unauthorized

Пользователь не авторизован.

Body

application/json

{
    "code": 0,
    "message": "string",
    "details": [
        {
            "@type": "string"
        }
    ]
}

Name	Description
code	Type: integer<int32> Код ошибки.
details	Type: protobufAny[] Дополнительные сведения об ошибке.
message	Type: string Описание ошибки.

403 Forbidden

У пользователя или приложения нет прав на доступ к ресурсу, запрос отклонен.

Body

application/json

{
    "code": 0,
    "message": "string",
    "details": [
        {
            "@type": "string"
        }
    ]
}

Name	Description
code	Type: integer<int32> Код ошибки.
details	Type: protobufAny[] Дополнительные сведения об ошибке.
message	Type: string Описание ошибки.

404 Not Found

Запрашиваемый ресурс не найден.

Body

application/json

{
    "code": 0,
    "message": "string",
    "details": [
        {
            "@type": "string"
        }
    ]
}

Name	Description
code	Type: integer<int32> Код ошибки.
details	Type: protobufAny[] Дополнительные сведения об ошибке.
message	Type: string Описание ошибки.

500 Internal Server Error

Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.

Body

application/json

{
    "code": 0,
    "message": "string",
    "details": [
        {
            "@type": "string"
        }
    ]
}

Name	Description
code	Type: integer<int32> Код ошибки.
details	Type: protobufAny[] Дополнительные сведения об ошибке.
message	Type: string Описание ошибки.

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

Получить DNS-записи домена

Удалить DNS-запись