ゾーン

オブジェクト

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 36,
      "maxLength": 36
    },
    "name": {
      "type": "string",
      "minLength": 4,
      "maxLength": 255
    },
    "current_version_id": {
      "type": "string",
      "minLength": 36,
      "maxLength": 36
    }
  }
}

プロパティ

プロパティ

説明

id

string

ゾーンを一意に識別する ID

name

string

4文字以上255文字以下のドメイン名

current_version_id

string

現在アクティブな バージョン の ID

作成

Gehirn DNS に新しいゾーンを作成します。

HTTP リクエスト

POST /dns/v1/zones HTTP/1.1
Host: api.gis.gehirn.jp

リクエストボディ

作成したいゾーンオブジェクトをリクエストしてください。

HTTP レスポンス

作成されたゾーンオブジェクトが返ります。

一覧

Gehirn DNS に存在するすべてのゾーンを取得します。

HTTP リクエスト

GET /dns/v1/zones HTTP/1.1
Host: api.gis.gehirn.jp

リクエストボディ

リクエストボディは必要ありません。

HTTP レスポンス

ひとつ以上のゾーンオブジェクトを要素とする JSON array がレスポンスされます。

取得

Gehirn DNS に存在する個別のゾーンを取得します。

HTTP リクエスト

GET /dns/v1/zones/:zone_id HTTP/1.1
Host: api.gis.gehirn.jp

パラメーター

パラメーター

zone_id

取得するゾーンの ID

リクエストボディ

リクエストボディは必要ありません。

HTTP レスポンス

指定したゾーンオブジェクトが返ります。

削除

Gehirn DNS から個別のゾーンを削除します。

HTTP リクエスト

DELETE /dns/v1/zones/:zone_id HTTP/1.1
Host: api.gis.gehirn.jp

パラメーター

パラメーター

zone_id

削除するゾーンの ID

リクエストボディ

リクエストボディは必要ありません。

HTTP レスポンス

削除されたゾーンオブジェクトが返ります。