Description

ドメインに設定されている指定したDNSレコードを更新(変更)します。

Request URL

DNS API

PUT /v1/domains/{domain_id}/records/{record_id}

Request Json

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

Request Parameters

Parameter Value Style Description
X-Auth-Token トークンID header トークンIDを指定します。
Content-Type application/json header データの形式(メディアタイプ)を指定します。
domain_id ドメインID path ドメインのIDを指定します。
record_id レコードID path レコードのIDを指定します。
name
(Optional)
ドメイン名. body 「ドメイン名.」または「名称.ドメイン名.」の形式で指定します。
例 www.ドメイン名.
data
(Optional)
レコード値 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 PUT \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Auth-Token: トークンID" \
-d '{"name": "ドメイン名.","data": "レコード値"}' \
https://dns-service.tyo1.conoha.io/v1/domains/ドメインID/records/レコードID

Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 446
Date: Sun, 04 Nov 2012 13:22:36 GMT

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

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