Dns-zone-records-recordId:PUT - Revision history

Mike.robski: 1 revision: Release 99

2014-10-14T15:08:19Z

1 revision: Release 99

Mike.robski at 22:14, 13 October 2014

2014-10-13T22:14:59Z

Mike.robski at 22:14, 13 October 2014

2014-10-13T22:14:27Z

Mike.robski: 1 revision: Release 93

2014-05-08T07:35:23Z

1 revision: Release 93

Velko.hristov at 11:54, 25 April 2014

2014-04-25T11:54:15Z

Mike.robski: 1 revision

2013-02-18T23:04:03Z

1 revision

Mike.robski: Created page with "= PUT /dns/''{zone}''/records/''{recordId}'' = Update an existing zone record. TOC == Request == `PUT /dns/''{zone}''/records/''{recordId}''` ==== Request Par..."

2013-02-18T22:57:29Z

Created page with "= PUT /dns/''{zone}''/records/''{recordId}'' = Update an existing zone record. __TOC__ == Request == <code>PUT /dns/''{zone}''/records/''{recordId}''</code> ==== Request Par..."

New page

= PUT /dns/''{zone}''/records/''{recordId}'' =
Update an existing zone record.
__TOC__

== Request ==
<code>PUT /dns/''{zone}''/records/''{recordId}''</code>

==== Request Parameters ====
; zone - ''string''
: The DNS zone of the record.

; recordId - ''string''
: The uniques Id of the record.

=== URI Parameters ===
None.

=== Request Headers ===
; Content-Type
: application/json

; Authorization
: Base64-encoded username & password string

=== Request Body ===

====A record====
<nowiki>
{
"name":{domain},
"type":"A",
"address":{ip_address}
}
</nowiki>

====AAAA record====
<nowiki>
{
"name":{domain},
"type":"AAAA",
"address":{ipv6_address}
}
</nowiki>

====NS record====
<nowiki>
{
"name":{domain},
"type":"NS",
"nsdname":{ns_domain}
}
</nowiki>

====TXT record====
<nowiki>
{
"name":{domain},
"type":"TXT",
"data":{data}
}
</nowiki>

====SRV record====
<nowiki>
{
"name":{domain},
"type":"SRV",
"priority": {priority},
"weight": {weight},
"port": {port},
"target":{target}
}
</nowiki>

====MX record====
<nowiki>
{
"name":{domain},
"type":"MX",
"preference": {preference},
"exchange":{mx_domain}
}
</nowiki>

====CNAME record====
<nowiki>
{
"name":{name},
"type":"CNAME",
"cname":{domain}
}
</nowiki>

== Response ==

=== Status Code ===
; 200 OK
: Success

; 400 Bad Request
:

; 401 Unauthorized
:

; 403 Forbidden
:

; 409 Conflict
:

=== Response Body ===
None.

== Examples ==

=== Unauthorized Request ===
''Request''
<nowiki>
PUT /dns/test.com/records/1234

{
"name": "test",
"type": "CNAME",
"cname": "otherdomain.com."
}
</nowiki>

''Response''
<nowiki>
401 Unauthorized
</nowiki>

=== Successful Update ===

''Request''
<nowiki>
PUT /dns/test.com/records/1234
Authorization: Basic {base64_encoded(username:password)}

{
"name": "test1",
"type": "CNAME",
"cname": "otherdomain1.com."
}
</nowiki>

''Response''
<nowiki>
200 OK

{
"name": "test1",
"type": "CNAME",
"cname": "otherdomain1.com."
}
</nowiki>

== See also ==
* [[DNS|DNS API]]
* [[Common Features]]

{{disqus}}
[[Category:Hostway API]]
[[Category:DNS API]]

@@ Line 43: / Line 43: @@
+{
      "name": {domain},
      "address": {ip_address},
      "ttl": 3600
@@ Line 52: / Line 51: @@
+{
      "name": {domain},
      "address": {ipv6_address},
      "ttl": 3600
@@ Line 61: / Line 59: @@
+{
      "name": {domain},
      "nsdname": {ns_domain},
      "ttl": 3600
@@ Line 70: / Line 67: @@
+{
      "name": {domain},
      "data": {data},
      "ttl": 3600
@@ Line 79: / Line 75: @@
+{
      "name": {domain},
      "priority": {priority},
      "weight": {weight},
@@ Line 91: / Line 86: @@
+{
      "name": {domain},
      "preference": {preference},
      "exchange": {mx_domain},
@@ Line 101: / Line 95: @@
+{
      "name": {name},
      "cname": {domain},
      "ttl": 3600
@@ Line 131: / Line 124: @@
+{
    "name": "test",
    "cname": "otherdomain.com."
 }</nowiki>
@@ Line 149: / Line 141: @@
+{
    "name": "test1",
    "cname": "otherdomain1.com."
 }</nowiki>

← Older revision	Revision as of 15:08, 14 October 2014
(One intermediate revision by one user not shown)

@@ Line 24: / Line 24: @@
 === Request Body ===
 ====A record====
   <nowiki>
+{
-     "name":{domain},
+     "name": {domain},
-     "type":"A",
+     "type": "A",
-     "address":{ip_address}
+     "address": {ip_address},
+    "ttl": 3600
- </nowiki>
+}</nowiki>
 ====AAAA record====
-  <nowiki>
+ <nowiki>
+{
-     "name":{domain},
+     "name": {domain},
-     "type":"AAAA",
+     "type": "AAAA",
-     "address":{ipv6_address}
+     "address": {ipv6_address},
+    "ttl": 3600
-</nowiki>
+}</nowiki>
 ====NS record====
-  <nowiki>
+ <nowiki>
+{
-     "name":{domain},
+     "name": {domain},
-     "type":"NS",
+     "type": "NS",
-     "nsdname":{ns_domain}
+     "nsdname": {ns_domain},
+    "ttl": 3600
-</nowiki>
+}</nowiki>
 ====TXT record====
-  <nowiki>
+ <nowiki>
+{
-     "name":{domain},
+     "name": {domain},
-     "type":"TXT",
+     "type": "TXT",
-     "data":{data}
+     "data": {data},
+    "ttl": 3600
-</nowiki>
+}</nowiki>
 ====SRV record====
-  <nowiki>
+ <nowiki>
+{
-     "name":{domain},
+     "name": {domain},
-     "type":"SRV",
+     "type": "SRV",
      "priority": {priority},
      "weight": {weight},
      "port": {port},
-     "target":{target}
+     "target": {target},
+    "ttl": 3600
-</nowiki>
+}</nowiki>
 ====MX record====
-  <nowiki>
+ <nowiki>
+{
-     "name":{domain},
+     "name": {domain},
-     "type":"MX",
+     "type": "MX",
      "preference": {preference},
-     "exchange":{mx_domain}
+     "exchange": {mx_domain},
+    "ttl": 3600
-</nowiki>
+}</nowiki>
 ====CNAME record====
   <nowiki>
+{
-     "name":{name},
+     "name": {name},
-     "type":"CNAME",
+     "type": "CNAME",
-     "cname":{domain}
+     "cname": {domain},
+    "ttl": 3600
-</nowiki>
+}</nowiki>
 == Response ==
 === Status Code ===
-; 200 OK
+; 200 OK : Success
 : Success
-; 400 Bad Request
+; 400 Bad Request : TTL is below allowed minimum
-−
-; 401 Unauthorized
+; 401 Unauthorized :
-−
-; 403 Forbidden
+; 403 Forbidden :
-−
-; 409 Conflict
+; 409 Conflict :
-−
 === Response Body ===
@@ Line 124: / Line 133: @@
    "type": "CNAME",
    "cname": "otherdomain.com."
 }</nowiki>
- </nowiki>
 ''Response''
   <nowiki>
 Unauthorized
- </nowiki>
+</nowiki>
 === Successful Update ===
@@ Line 143: / Line 151: @@
    "type": "CNAME",
    "cname": "otherdomain1.com."
 }</nowiki>
- </nowiki>
 ''Response''
@@ Line 154: / Line 161: @@
    "type": "CNAME",
    "cname": "otherdomain1.com."
 }</nowiki>
- </nowiki>
 == See also ==

Dns-zone-records-recordId:PUT - Revision history

Mike.robski: 1 revision: Release 99

Mike.robski at 22:14, 13 October 2014

Mike.robski at 22:14, 13 October 2014

Mike.robski: 1 revision: Release 93

Velko.hristov at 11:54, 25 April 2014

Mike.robski: 1 revision

Mike.robski: Created page with "= PUT /dns/''{zone}''/records/''{recordId}'' = Update an existing zone record. __TOC__ == Request == PUT /dns/''{zone}''/records/''{recordId}'' ==== Request Par..."

Mike.robski: Created page with "= PUT /dns/''{zone}''/records/''{recordId}'' = Update an existing zone record. TOC == Request == `PUT /dns/''{zone}''/records/''{recordId}''` ==== Request Par..."