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
}