Работа с DNS-зонами

GET https://panel.netangels.ru/api/v1/dnszone/[zone_id/]

Получить список принадлежащих вам DNS-зоны. Указав zone_id, можно получить информацию только по одной DNS-зоне. Зона DNS содержит информацию об A-записях, принадлежащих этой зоне, в форме ссылок на соответствующие ресурсы.

Пример запроса:

curl -X GET -H "Accept: application/json" -u "uXXXX:password" 'https://panel.netangels.ru/api/v1/dnszone/'

Пример результата:

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": [
    {
     "adnsrecord_set": [
          "/api/v1/adnsrecord/2/"
      ],
      "comment": "Hello World!",
      "id": "1",
      "name": "example.com"
      "resource_uri": "/api/v1/dnszone/1/",
      "ttl": 3600
    }
  ]
}

Status Codes:

• 200 OK – Удачный исход.
• 404 Not Found – Нет такого объекта или он недоступен.

POST https://panel.netangels.ru/api/v1/dnszone/

Создать новую запись DNS-зоны. Параметры передаются в формате JSON.

Пример запроса

curl --dump-header - -H "Content-Type: application/json" -X POST --data '{"name": "example.com", "ttl": "3700", "comment": "Hello world!"}' -H "Accept: application/json" -u "uXXX:password" 'https://panel.netangels.ru/api/v1/dnszone/'

Пример результата:

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/dnszone/(dnszone_id)/

Изменить комментарий или TTL зоны

Пример запроса

curl --dump-header - -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -u "uXXX:password" --data '{"ttl": "3000", "comment": "FooBar"}' 'https://panel.netangels.ru/api/v1/dnszone/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 – Такой DNS-зоны не существует или она недоступна.

DELETE https://panel.netangels.ru/api/v1/dnszone/(dnszone_id)/

Удалить запись зоны

Пример запроса

curl --dump-header - -X DELETE -H "Accept: application/json" -u "uXXX:password" 'https://panel.netangels.ru/api/v1/dnszone/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 – Невозможно удалить зону, будет возвращено сообщение об ошибке.