バージョン¶

オブジェクト¶

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 36,
      "maxLength": 36
    },
    "base": {
      "type": "string",
      "minLength": 36,
      "maxLength": 36
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "editable": {
      "type": "boolean"
    },
    "created_at": {
      "type": "string"
    },
    "last_modified_at": {
      "type": "string"
    }
  }
}

プロパティ¶

プロパティ	型	説明
id	string	バージョンを一意に識別する ID
name	string	バージョンを説明する任意の名前
base	string	クローン元バージョンの ID
editable	boolean	バージョンの編集可否
created_at	string	ISO8601 で表現されるバージョンの作成日時
last_modified_at	string	ISO8601 で表現されるバージョンの最終編集日時

作成¶

指定したゾーンに新しいバージョンを作成します。

HTTP リクエスト¶

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

パラメーター¶

パラメーター	値
zone_id	バージョンを作成するゾーンの ID

リクエストボディ¶

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

HTTP レスポンス¶

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

一覧¶

指定したゾーンに存在するすべてのバージョンを取得します。

HTTP リクエスト¶

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

パラメーター¶

パラメーター	値
zone_id	取得するバージョンを含むゾーンの ID

リクエストボディ¶

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

HTTP レスポンス¶

ひとつ以上のバージョンオブジェクトを要素とする JSON array が返ります。

取得¶

指定したゾーンに存在する個別のバージョンを取得します。

HTTP リクエスト¶

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

パラメーター¶

パラメーター	値
zone_id	取得するバージョンを含むゾーンの ID
version_id	取得するバージョンの ID

リクエストボディ¶

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

HTTP レスポンス¶

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

編集¶

指定したゾーンに存在する個別のバージョンを編集します。

HTTP リクエスト¶

PUT /dns/v1/zones/:zone_id/versions/:version_id HTTP/1.1
Host: api.gis.gehirn.jp

パラメーター¶

パラメーター	値
zone_id	編集するバージョンを含むゾーンの ID
version_id	編集するバージョンの ID

リクエストボディ¶

編集したバージョンオブジェクトをリクエストしてください。

HTTP レスポンス¶

編集されたバージョンオブジェクトが返ります。

削除¶

指定したゾーンから個別のバージョンを削除します。

HTTP リクエスト¶

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

パラメーター¶

パラメーター	値
zone_id	削除するバージョンを含むゾーンの ID
version_id	削除するバージョンの ID

リクエストボディ¶

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

HTTP レスポンス¶

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