レコード作成 | Z.com Cloud パブリッククラウド リファレンス

レコード作成

Description

ドメインに対し1レコード作成します。

Request URL

Designate API v1.0

POST /v1/domains/{domain_id}/records

Request Json

{
  "name": "ホスト名.",
  "type": "レコードタイプ",
  "data": "レコード値",
  "gslb_check": GSLBヘルスチェックポート,
  "gslb_region": "GSLBリージョンコード",
  "gslb_weight": GSLB優先度
}

Request Parameters

Parameter Value Style Description
X-Auth-Token Userトークン header トークン発行 にて払い出されたID
name ホスト名 plain ホスト名はFQDNで指定し
てください。
例:[www.example.com]
のレコードを作成する場合
["name": "www.example.
com."]
type レコードタイプ plain 以下のいずれかを設定します。
[A/AAAA/MX/CNAME/
TXT/SRV/NS/PTR]
data レコード値 plain 作成するレコードの値。
例:Aレコードの場合はIPアドレスが該当します。
priority 優先度 plain 以下の範囲にて優先度を設定できます。
[0~65535] MX/SRVレコードでは必須となります。
ttl(Optional) TTL(秒) plain 以下の範囲にてTTL値を設定します。
[60~2147483647]
description(Optional) レコードの説明・概要 plain レコードついて任意の説明・概要を指定します。
gslb_region(Optional) GSLBリージョンコード plain GSLBレコードの場合gslb_region、weight、checkいずれかを入力します。
[JP/US/SG/AUTO(自動割当)]      ※gslb_regionについては、現在JPのみ指定可能です。
gslb_weight(Optional) GSLB優先度 plain GSLBレコードの場合gslb_region、weight、checkいずれかを入力します。
[0~255]
gslb_check(Optional) GSLBヘルスチェックポート plain GSLBレコードの場合gslb_region、weight、checkいずれかを入力します。
[0:OFF/PortNo.]

Response

  • Normal response codes
200

Example

  • Request
curl -i -X POST \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Auth-Token: トークンID" \
-d'{
  "name": "ホスト名.",
  "ttl" : TTL,
  "type": "レコードタイプ",
  "data": "レコード値"
}' \
https://dns-service.jpt1.cloud.z.com/v1/domains/ドメインID/records

  • Response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 377
Location: http://dns-service.jpt1.cloud.z.com/v1/domains/ドメインID/records/レコードID
X-Openstack-Request-Id: req-c68b88a4-37c8-4b2c-8aa5-b5e88baf2b5f
Date: Mon, 16 Mar 2020 09:55:59 GMT

{
  "created_at": "2019-02-05T08:16:41.000000",
  "data": "レコード値.",
  "description": 備考,
  "domain_id": "ドメインID",
  "gslb_check": GSLBヘルスチェックポート,
  "gslb_region": GSLBリージョンコード,
  "gslb_weight": GSLB優先度,
  "id": "レコードID",
  "name": "ドメイン名.",
  "priority": 優先度,
  "ttl": TTL,
  "type": "レコードタイプ",
  "updated_at": null
}