Редактировать DNS-запись

  1. HTTP-запрос
  2. Path-параметры
  3. Тело запроса
    1. Представление
    2. Поля
  4. Ответы
    1. Код 200
      1. Представление
      2. Поля
    2. Код 401
      1. Представление
      2. Поля
    3. Код 403
      1. Представление
      2. Поля
    4. Код 404
      1. Представление
      2. Поля
    5. Код 500
      1. Представление
      2. Поля

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

DNS-запись можно задать с помощью идентификатора.

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

HTTP-запрос

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

Path-параметры

orgId *

integer

Идентификатор организации.

domain *

string

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

recordId *

integer

Идентификатор записи.

orgId *

integer

Идентификатор организации.

domain *

string

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

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

EXCHANGE для MX-записи.

name *

string

Имя записи.

port

integer

Порт для SRV-записи.

preference

integer

PREFERENCE для MX-записи.

priority

integer

Приоритет для SRV-записи.

target

string

Цель для записи CNAME или SRV.

text

string

Содержимое для TXT-записи.

ttl *

integer

Время жизни записи в секундах (TTL).

type *

string

Значение по умолчанию: A.

Возможные значения
  1. A
  2. AAAA
  3. CNAME
  4. MX
  5. TXT
  6. SRV
  7. NS
  8. CAA

weight

integer

Вес для SRV-записи.

address

string

Адрес для записи А или ААА.

exchange

string

EXCHANGE для MX-записи.

name *

string

Имя записи.

port

integer

Порт для SRV-записи.

preference

integer

PREFERENCE для MX-записи.

priority

integer

Приоритет для SRV-записи.

target

string

Цель для записи CNAME или SRV.

text

string

Содержимое для TXT-записи.

ttl *

integer

Время жизни записи в секундах (TTL).

type *

string

Значение по умолчанию: A.

Возможные значения
  1. A
  2. AAAA
  3. CNAME
  4. MX
  5. TXT
  6. SRV
  7. NS
  8. CAA

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

EXCHANGE для MX-записи.

flag

integer

Флаг для CAA-записи.

name *

string

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

port

integer

Порт для SRV-записи.

preference

integer

PREFERENCE для MX-записи.

priority

integer

Приоритет для SRV-записи.

recordId

integer

Идентификатор записи.

tag

string

Тег для CAA-записи.

target

string

Цель для записи CNAME или SRV.

text

string

Содержимое для TXT-записи.

ttl *

integer

Время жизни записи в секундах (TTL) .

type *

string

Значение по умолчанию: A.

Возможные значения
  1. A
  2. AAAA
  3. CNAME
  4. MX
  5. TXT
  6. SRV
  7. NS
  8. CAA

value

string

CAA-запись, заключенная в двойные кавычки, например "ca.example.net".

weight

integer

Вес для SRV-записи.

address

string

Адрес для записи А или ААА.

exchange

string

EXCHANGE для MX-записи.

flag

integer

Флаг для CAA-записи.

name *

string

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

port

integer

Порт для SRV-записи.

preference

integer

PREFERENCE для MX-записи.

priority

integer

Приоритет для SRV-записи.

recordId

integer

Идентификатор записи.

tag

string

Тег для CAA-записи.

target

string

Цель для записи CNAME или SRV.

text

string

Содержимое для TXT-записи.

ttl *

integer

Время жизни записи в секундах (TTL) .

type *

string

Значение по умолчанию: A.

Возможные значения
  1. A
  2. AAAA
  3. CNAME
  4. MX
  5. TXT
  6. SRV
  7. NS
  8. CAA

value

string

CAA-запись, заключенная в двойные кавычки, например "ca.example.net".

weight

integer

Вес для SRV-записи.

Код 401

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

{
  "code": integer,
  "details": [
    {
      "@type": string
    }
  ],
  "message": string
}
Скопировано

Представление

Свернуть всё
Развернуть всё

Поля

code

integer

details[]

array

details[].@type

string

message

string

code

integer

details[]

array

details[].@type

string

message

string

Код 403

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

{
  "code": integer,
  "details": [
    {
      "@type": string
    }
  ],
  "message": string
}
Скопировано

Представление

Свернуть всё
Развернуть всё

Поля

code

integer

details[]

array

details[].@type

string

message

string

code

integer

details[]

array

details[].@type

string

message

string

Код 404

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

{
  "code": integer,
  "details": [
    {
      "@type": string
    }
  ],
  "message": string
}
Скопировано

Представление

Свернуть всё
Развернуть всё

Поля

code

integer

details[]

array

details[].@type

string

message

string

code

integer

details[]

array

details[].@type

string

message

string

Код 500

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

{
  "code": integer,
  "details": [
    {
      "@type": string
    }
  ],
  "message": string
}
Скопировано

Представление

Свернуть всё
Развернуть всё

Поля

code

integer

details[]

array

details[].@type

string

message

string

code

integer

details[]

array

details[].@type

string

message

string