Description
Update records.

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 Token
domain_id - URI UUID Domain ID
record_id - URI UUID Record ID
name(Optional) - plain string Record Name
type(Optional) [A/AAAA/MX/CNAME/TXT/SRV/NS/PTR] plain string Record Type
priority(Optional) - plain int Priority
data(Optional) - plain string Record Data
ttl(Optional) - plain int TTL(second)
description(Optional) - plain string Description
gslb_region(Optional) [JP/US/SG/AUTO(自動割当)] plain string GSLB Region Code In case of GSLB record, enter one of the following : gslb_region、weight、check
gslb_weight(Optional) [0~255] plain int GSLB Priority In case of GSLB record, enter one of the following : gslb_region、weight、check
gslb_check(Optional) [0:OFF/PortNo.] plain int GSLB Health Check Port In case of GSLB record, enter one of the following : gslb_region、weight、check

Response Paramters

Parameter Value Style Type Description
domain_id - plain UUID Domain ID
id - plain string Record ID
name - plain string Record Name
type [A/AAAA/MX/CNAME/TXT/SRV/NS/PTR] plain string Record Type
created_at - plain string Creation Date
updated_at - plain string Update Date
ttl - plain int TTL(second)
data - plain string Record Data
priority - plain string Priority
description - plain string Description
gslb_region [JP/US/SG] plain string GSLB Region Code
gslb_weight [0~255] plain int GSLB Priority
gslb_check [0:OFF/PortNo.] plain int GSLB Health Check Port

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

curl --include https://dns-service.tyo1.cloud.z.com/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"
}'
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
}