Description

指定したドメインのDNSレコードを追加します。

Request URL

DNS API

POST /v1/domains/{domain_id}/records

Request Json

{
  "name": "ドメイン名.",
  "type": "レコードタイプ",
  "data": "レコード値"
}

Request Parameters

Parameter Value Style Description
X-Auth-Token トークンID header トークンIDを指定します。
Content-Type application/json header データの形式(メディアタイプ)を指定します。
domain_id ドメインID path ドメインのIDを指定します。
name ドメイン名. body 「ドメイン名.」または「名称.ドメイン名.」の形式で指定します。
例 www.ドメイン名.
type A
AAAA
CNAME
MX
NS
SRV
TXT
body DNSレコードのタイプを指定します。
data レコード値 body DNSレコードの値を指定します。
priority
(Optional)
優先度 body 優先度を数値で指定します。「type」にて「MX」や「SRV」を指定する場合に指定します。
weight
(Optional)
重み body 重みを数値で指定します。「type」にて「SRV」を指定する場合に指定します。
port
(Optional)
ポート番号 body ポート番号を数値で指定します。「type」にて「SRV」を指定する場合に指定します。
description
(Optional)
概要 body 任意の文字列を指定します。概要や備考を指定したい際に使用します。

Response Code

Success

200

Example

Request

curl -i -X POST \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Auth-Token: トークンID" \
-d '{"name": "ドメイン名.","type": "レコードタイプ","data": "レコード値"}' \
https://dns-service.tyo1.conoha.io/v1/domains/ドメインID/records

Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 399
Location: http://localhost:9001/v1/domains/89acac79-38e7-497d-807c-a011e1310438/records/2e32e609-3a4f-45ba-bdef-e50eacd345ad
Date: Fri, 02 Nov 2012 19:56:26 GMT

{
  "id": "2e32e609-3a4f-45ba-bdef-e50eacd345ad",
  "name": "www.example.com.",
  "type": "A",
  "created_at": "2012-11-02T19:56:26.366792",
  "updated_at": null,
  "domain_id": "89acac79-38e7-497d-807c-a011e1310438",
  "ttl": null,
  "data": "192.0.2.3",
  "gslb_check": null,
  "gslb_region": null,
  "gslb_weight": null
}

ConoHaにて提供しておりますAPIにつきましては、クラウド基盤として採用しておりますOpenStackの機能にて実装しておりますので、詳細な情報や使い方はOpenStackのドキュメントにてご確認ください。