Работа с A-записями¶
-
GET
https://panel.netangels.ru/api/v1/adnsrecord/[record_id/]
¶ Запросить принадлежащие вам А-записи, либо с указанием record_id информацию только по одной записи.
Пример запроса:
curl -X GET -H "Accept: application/json" -u "uXXXX:password" 'https://panel.netangels.ru/api/v1/adnsrecord/'
Пример результата:
HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "meta": { "limit": 20, "next": null, "offset": 0, "previous": null, "total_count": 1 }, "objects": [ { "full_name": "www.example.com", "ip": "127.0.0.1", "name": "example", "resource_uri": "/api/v1/adnsrecord/6/", "www": true, "zone": "/api/v1/dnszone/3/" } ] }
Status Codes: - 200 OK – Удачный исход.
- 404 Not Found – Нет такого объекта или он недоступен.
-
POST
https://panel.netangels.ru/api/v1/adnsrecord/
¶ Создать новую А-запись DNS. Параметры передаются в формате JSON.
Пример запроса
curl --dump-header - -H "Content-Type: application/json" -X POST --data '{"zone": "/api/v1/dnszone/3/", "name": "example.com", "ip": "127.0.0.1"}' -H "Accept: application/json" -u "uXXX:password" 'https://panel.netangels.ru/api/v1/adnsrecord/'
Пример результата:
HTTP/1.1 201 CREATED Content-Type: text/html; charset=utf-8
Status Codes: - 201 Created – Запись создана.
- 400 Bad Request – Неправильный запрос - будет возвращён json с сообщениями об ошибках.
-
PUT
https://panel.netangels.ru/api/v1/adnsrecord/
(adnsrecord_id)/
¶ Изменить параметры A-записи
Пример запроса
curl --dump-header - -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -u "uXXX:password" --data '{"ip": "127.0.0.1"}' 'https://panel.netangels.ru/api/v1/adnsrecord/1/'
Пример результата:
HTTP/1.1 204 NO CONTENT Content-Type: text/html; charset=utf-8
Status Codes: - 204 No Content – Запись изменена.
- 400 Bad Request – Неправильные параметры - будет возвращён json с сообщениями об ошибках.
- 404 Not Found – Такой записи не существует или она недоступна для вашего аккаунта.
-
DELETE
https://panel.netangels.ru/api/v1/adnsrecord/
(adnsrecord_id)/
¶ Удалить A-запись
Пример запроса
curl --dump-header - -X DELETE -H "Accept: application/json" -u "uXXX:password" 'https://panel.netangels.ru/api/v1/adnsrecord/3/'
Пример результата
HTTP/1.1 204 NO CONTENT Content-Type: text/html; charset=utf-8
Status Codes: - 204 No Content – Запись удалена.
- 404 Not Found – Такой DNS записи не существует или она недоступна для вашего аккаунта.
- 400 Bad Request – Невозможно удалить запись DNS, будет возвращено сообщение об ошибке.