バージョン

オブジェクト

{
  "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 レスポンス

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