MENU

Description
レコード情報を更新する

Request URL

Designate API v1.0

PUT /v1/domains/(uuid: domain_id)/records/(uuid: id)

Request Paramters

Parameter Value Style Type Description
X-Auth-Token - header string Userトークン
domain_id - URI UUID ドメインID
record_id - URI UUID レコードID
name(Optional) - plain string レコード名
type(Optional) [A/AAAA/MX/CNAME/TXT/SRV/NS/PTR] plain string レコードタイプ ※指定は可能だが変更は不可
priority(Optional) - plain int 優先度
data(Optional) - plain string レコード値
ttl(Optional) [60~2147483647] plain int TTL(秒)
description(Optional) - plain string 備考
gslb_region(Optional) [JP/US/SG/AUTO(自動割当)] plain string GSLBリージョンコード、GSLBレコードの場合gslb_region、weight、check何れかを入力
gslb_weight(Optional) [0~255] plain int GSLB優先度、GSLBレコードの場合gslb_region、weight、check何れかを入力
gslb_check(Optional) [0:OFF/PortNo.] plain int GSLBヘルスチェックポート、GSLBレコードの場合gslb_region、weight、check何れかを入力

Response Paramters

Parameter Value Style Type Description
domain_id - plain UUID ドメインID
id - plain string レコードID
name - plain string レコード名
type [A/AAAA/MX/CNAME/TXT/SRV/NS/PTR] plain string レコードタイプ
created_at - plain string 作成日
updated_at - plain string 更新日
ttl - plain int TTL(秒)
data - plain string レコード値
priority - plain string 優先度
description - plain string 備考
gslb_region [JP/US/SG] plain string GSLBリージョンコード
gslb_weight [0~255] plain int GSLB優先度
gslb_check [0:OFF/PortNo.] plain int GSLBヘルスチェックポート

Request Json

{
  "name": "www.example.com.",
  "type": "A",
  "data": "192.0.2.5"
}

Normal response codes

200 - OK

Error response codes

401 – Access Denied
400 – Invalid Object
409 – Duplicate Record

Example
※エンドポイントURLにつきましては、お客様環境によって異なりますので、コントロールパネルにてご確認の上ご利用ください。

  • REQ
curl --include https://dns-service.tyo1.conoha.io/v1/domains/89acac79-38e7-497d-807c-a011e1310438/records/2e32e609-3a4f-45ba-bdef-e50eacd345ad \
-X PUT \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Auth-Token: 39be9f8d53044388b7f2e867eba8b140" \
-d
'{
  "name": "www.example.com.",
  "type": "A",
  "data": "192.0.2.5"
}'
  • RES
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
}