DNS管理API

概要

ゾーンは1つのドメインのレコードを保持します。APIを通して行う変更はすべて直ちに VPS.org 名前サーバにプッシュされます。これらのゾーンからドメインを提供するには、レジスタントで名前サーバを ns1.vps.org、ns2.vps.org、ns3.vps.org に設定してください。

変更は一つのステップで保存され、公開されます。名前サーバが変更を拒否すると、要求は 502 を返し、何も保存されません。他のアカウントが管理しているドメイン、他のアカウントのゾーンの親または子、VPS.org 予約名のためのゾーンは作成できません。

必要な権限: dns:list (GET), dns:create (POST), dns:update (PUT, PATCH, sync), dns:delete (DELETE), dns:*

すべてのDNSゾーンを一覧表示する

ゾーンを返します。最近のものを先に、ページ当たり 25 個。レコードはここに含まれません。一つのゾーンを取得してください。

クエリパラメータ

リクエスト例

curl -X GET "https://admin.vps.org/api/v1/dns-zones/?domain=example.com" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

import requests

url = "https://admin.vps.org/api/v1/dns-zones/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers, params={"domain": "example.com"})
for zone in response.json()["results"]:
    print(zone["uuid"], zone["domain"], zone["record_count"])

const response = await fetch('https://admin.vps.org/api/v1/dns-zones/?domain=example.com', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
console.log(data.results);

回答例

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c",
      "domain": "example.com",
      "created_at": "2026-09-06T03:11:48.829693Z",
      "record_count": 5
    }
  ]
}

応答フィールド

応答ステータスコード

DNS ゾーンを作成

ゾーンを作成し、公開します。ゾーンは ns1, ns2, ns3.vps.org の 3 つの NS レコードから始まります。これらはシステムレコードで、編集も削除もできません。

リクエストボディパラメータ

curl -X POST "https://admin.vps.org/api/v1/dns-zones/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'

回答例

{
  "uuid": "c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c",
  "domain": "example.com",
  "created_at": "2026-09-14T21:02:11.402113Z",
  "records": [
    {
      "uuid": "1f2e3d4c-5b6a-4978-8a9b-0c1d2e3f4a5b",
      "record_type": "NS",
      "name": "@",
      "value": "ns1.vps.org",
      "ttl": 86400,
      "priority": null,
      "created_at": "2026-09-14"
    },
    ...
  ],
  "record_count": 3
}

応答ステータスコード

DNS ゾーンの詳細を取得

ゾーンを返します。 ゾーンのレコードはレコード配列に含まれます。 返信は上記の create の返信と同じ形です。

curl -X GET "https://admin.vps.org/api/v1/dns-zones/c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

応答ステータスコード

DNS ゾーンを削除

3 つの名前サーバからゾーンを削除し、それらの中でまだサービスされているものがないか確認し、ゾーンとそのレコードを削除します。名前サーバがゾーンに応答していれば、要求は失敗し、ゾーンは再試行のために保持されます。

curl -X DELETE "https://admin.vps.org/api/v1/dns-zones/c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

応答ステータスコード

ゾーンのレコードをリストまたは追加

GETはゾーン内のすべてのレコードを タイプと名前によりソートされた 単純な配列 (ページ化されていない) として返します。POSTはゾーンにレコードを追加し、公開します。

リクエストボディパラメータ (POST)

リクエスト例

curl -X POST "https://admin.vps.org/api/v1/dns-zones/c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c/records/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"record_type": "MX", "name": "@", "value": "mail.example.com", "ttl": 3600, "priority": 10}'

import requests

zone_uuid = "c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c"
url = f"https://admin.vps.org/api/v1/dns-zones/{zone_uuid}/records/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}
data = {"record_type": "A", "name": "www", "value": "203.0.113.10", "ttl": 3600}

response = requests.post(url, headers=headers, json=data)
print(response.status_code, response.json())

回答例

{
  "uuid": "9d430082-5562-42b4-a0b2-12a6f6c862f9",
  "record_type": "MX",
  "name": "@",
  "value": "mail.example.com",
  "ttl": 3600,
  "priority": 10,
  "created_at": "2026-09-14"
}

応答フィールド

応答ステータスコード

ゾーンを再公開

ゾーンとそのすべてのレコードを名前サーバに再プッシュします。レコードの変更は自動的に公開されますが、公開は最善の努力であり、失敗は元の要求に失敗しません。変更が DNS 検索に表示されない場合にこのオプションを使用してください。要求のボディは必要ありません。

curl -X POST "https://admin.vps.org/api/v1/dns-zones/c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c/sync/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "detail": "Zone example.com synced to PowerDNS"
}

ゾーン間でレコードをリストまたは作成

GETはすべてのゾーンのレコードをドメイン、タイプ、名前順にページごとに25件返します。POSTはゾーンレコードのエンドポイントと同様にレコードを作成しますが、ゾーンはリクエストボディにzone_uuidとして指定します。

クエリパラメータ

curl -X GET "https://admin.vps.org/api/v1/dns-records/?zone=c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c&record_type=A" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl -X POST "https://admin.vps.org/api/v1/dns-records/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"zone_uuid": "c7a1e3f0-2b4d-4e6a-9c8b-0d1f2e3a4b5c", "record_type": "TXT", "name": "@", "value": "v=spf1 mx -all", "ttl": 3600}'

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "4b8e2c10-7d3f-4a5b-9e6c-1a2b3c4d5e6f",
      "record_type": "A",
      "name": "www",
      "value": "203.0.113.10",
      "ttl": 3600,
      "priority": null,
      "created_at": "2026-09-14"
    }
  ]
}

応答ステータスコード

レコードを取得、更新、または削除

GETは1つのレコードを返します。PUTはそれを置き換え、record_type、name、value、ttlを必要とします。PATCHは送信したフィールドのみを変更します。DELETEはレコードを削除し、ボディなしで204を返します。変更は直ちに公開されます。ゾーンで作成されたNSレコードはシステムレコードです。更新または削除すると403を返します。

curl -X PATCH "https://admin.vps.org/api/v1/dns-records/4b8e2c10-7d3f-4a5b-9e6c-1a2b3c4d5e6f/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ttl": 300}'

応答ステータスコード

エラーハンドリング

検証エラーは 400 を返します。問題はフィールド名でキー付けされています。

{
  "priority": ["MX records require a priority value"]
}

DNS 変更をテスト

変更がライブになったことを確認するために、レジスタのデレゲーションまたは解析キャッシュが追いつく前に、VPS.org 名前サーバを直接クエリーします。

dig @ns1.vps.org example.com A
dig @ns2.vps.org example.com MX
dig @ns3.vps.org www.example.com