API - Публичный DNS - База знаний LinxCloudServices

База знаний

AUTHENTICATION AND AUTHORIZATION

Как и для любого OpenStack сервиса для авторизации и аутентификации используется keystone.

VARS

tenant — OpenStack project uuid. Стандартный номер проекта, который можно найти в личном кабинете MCS. Отличие от OpenStack — в uuid используются дефисы;
dns-uuid — уникальный идентификатор DNS записи;
record-type — тип записи: A, AAAA, CNAME, и т.д;
a-uuid — уникальный идентификатор А записи для DNS.

CREATE DNS RECORD

REQUEST

Заголовки:

Content-Type: application/json

Тело запроса:

RESPONSE

Заголовки:

Location: https://mcs.mail.ru/public-dns/v2/dns/a5ef043e-b517-4c45-a727-e8298f5d47d6
Content-Type: application/json; charset=UTF-8
Content-Length: 441

Код ответа:

201 — DNS запись создана успешно.

Тело ответа:

GET DNS RECORD

REQUEST

RESPONSE

Код ответа:

200 — успешный ответ.
404 — DNS запись не найдена.
409 — DNS запись уже существует.

Тело ответа:

LIST DNS RECORDS

REQUEST

RESPONSE

Код ответа:

200 — успешный ответ.

Тело ответа:

UPDATE DNS RECORD

REQUEST

Заголовки:

Content-Type: application/json

Тело запроса:

RESPONSE

Код ответа:

200 — успешный ответ.
404 — DNS запись не найдена.

Тело ответа:

DELETE DNS RECORD

REQUEST

RESPONSE

Код ответа:

204 — Удалено.
404 — DNS запись не найдена.

CREATE A RECORD FOR EXISTING DNS

REQUEST

Заголовки:

Content-Type: application/json

Тело запроса:

RESPONSE

Заголовки:

Location: https://mcs.mail.ru/public-dns/v2/dns/a5ef043e-b517-4c45-a727-e8298f5d47d6/a/631519fb-f2d3-43e0-ae9c-8f18adcf3b1a
Content-Type: application/json; charset=UTF-8
Content-Length: 211

Код ответа:

201 — A запись создана успешно.
409 — A запись уже существует.

Тело ответа:

GET A RECORD FOR EXISTING DNS

REQUEST

RESPONSE

Код ответа:

200 — успешный ответ.
404 — A запись не найдена.

Тело ответа:

LIST A RECORDS FOR EXISTING DNS

REQUEST

RESPONSE

Код ответа:

200 — успешный ответ.

Тело ответа:

UPDATE A RECORD FOR EXISTING DNS

REQUEST

Заголовки:

Content-Type: application/json

Тело запроса:

RESPONSE

Код ответа:

200 — успешный ответ.
404 — A запись не найдена.

Тело ответа:

DELETE A RECORD FOR EXISTING DNS

REQUEST

RESPONSE

Код ответа:

202 — Удалено.
404 — A запись не найдена

AAAA, CNAME, MX, NS, SRV, TXT RECORDS

Все операции абсолютно аналогичны A-записи, за исключением полей. Ниже примеры ответов.

URL

AAAA

Тело ответа:

CNAME

Тело ответа:

SRV

Тело ответа:

TXT

Тело ответа: