Mike.robski: 1 revision: Release 87

2013-11-15T21:22:02Z

1 revision: Release 87

Venzi.iliev: /* Request */

2013-03-28T16:16:20Z

Request

New page

= PUT /domains/''{domainName}''/nameservers =
Set (overwrite) the name servers used to serve the Domain Name System (DNS) records for the domain. Name servers are a set of 0 to 13 distinct hostnames that may be assigned to a domain. Once the name servers are modified using this command, the changes are sent immediately to the registry. However these changes may take several hours to propagate depending on the individual zone files and possible registry zone file publication delays.

__TOC__
== Request ==
<code>PUT /domains/''{domainName}''/nameservers</code>

=== URI Parameters ===
{{DomainName}}

=== Request Headers ===
None.

=== Request Body ===
;Name server array
:An array (list) of name server host names. Name servers are assigned in the order listed.
:: Example: ["a.dns.hostway.net","b.dns.hostway.net"]

== Response ==

=== Status Code ===
;204 OK (No Content)
: Domain nameservers successfully updated

;400 Bad Request
: The domain name, or one of the given hostnames is not valid or is not a registered name server at the registry.
: The request was not completed even if one or more of the name servers is considered valid.

;403 Forbidden
: Domain is not registered in this account and cannot be accessed.

;404 Not Found
: No domain records found for the given domain name.

=== Response Body ===
;None

== Example updating nameservers on a domain. ==
'''Request'''
<nowiki>
PUT /domains/example.com/nameservers

["ns0.example.com","ns1.example.com","ns2.example.com","ns3.example.com","ns4.example.com","ns5.example.com","ns6.example.com"]

</nowiki>

'''Response'''
<nowiki>
204 No Content
</nowiki>

== Example updating nameservers using one or more name server that is not registered. ==
'''Request'''
<nowiki>
PUT /domains/example.com/nameservers

["not-registered.example.com","ns1.example.com","ns2.example.com","ns3.example.com","ns4.example.com","ns5.example.com","ns6.example.com"]

</nowiki>

'''Response'''
<nowiki>
400 Bad Request

"not-registered.example.com" is not a registered name server and cannot be used to update the domain.
</nowiki>

== See also ==
* [[Domain Name Registration|Domain Name Registration API]]
* [[Common Features]]

{{disqus}}
[[Category:Hostway API]]
[[Category:Domain Name Registration API]]

Domains-domainName-nameservers:PUT - Revision history

Mike.robski: 1 revision: Release 87

Venzi.iliev: /* Request */