レコード作成

Description

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

Request URL

DNS API

POST /v1/domains/{domainid}/records

Request Json

{
  "name": "ドメイン名.",
  "type": "レコードタイプ",
  "data": "レコード値",
  "priority": "優先度",
  "weight": "重み",
  "port": "ポート番号"
}

Request Parameters

Parameter	Value	Style	Description
X-Auth-Token	トークン	header	トークンの情報を指定します。トークンの発行方法は、トークン発行にてご確認ください。
Content-Type	application/json	header	データの種類(メディアタイプ)を指定します。
domainid	ドメインID	path	対象ドメインのUUIDとして設定されているドメインIDを指定します。ドメインIDの確認方法は、ドメイン一覧取得を実行の上、レスポンス結果から対象ドメインのドメイン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」を指定する場合に指定します。

Response Code

Success

Example

・Aレコードの場合

Request

curl -X POST \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Auth-Token: トークン" \
-d '{"name": "www.ドメイン名.","type": "A","data": "IPアドレス"}' \
https://dns-service.c3j1.conoha.io/v1/domains/ドメインID/records

Response

{
	"uuid": "レコードID",
	"domain_uuid": "ドメインID",
	"name": "www.ドメイン名.",
	"type": "A",
	"data": "XXX.XXX.XXX.XXX",
	"priority": null,
	"weight": null,
	"port": null,
	"ttl": 3600,
	"created_at": "2023-12-07T07:58:39.098406Z",
	"updated_at": "2023-12-07T07:58:39.098447Z"
}

・MXレコードの場合

Request

curl -X POST \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Auth-Token: トークン" \
-d '{"name": "ドメイン名.","type": "MX","data": "mail.ドメイン名.","priority": "10"}' \
https://dns-service.c3j1.conoha.io/v1/domains/ドメインID/records

Response

{
	"uuid": "レコードID",
	"domain_uuid": "ドメインID",
	"name": "ドメイン名.",
	"type": "MX",
	"data": "mail.ドメイン名.",
	"priority": 10,
	"weight": null,
	"port": null,
	"ttl": 3600,
	"created_at": "2023-12-07T08:06:18.346181Z",
	"updated_at": "2023-12-07T08:06:18.346202Z"
}

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