Domains-domainName-hosts:PUT
From Hostway API Documentation
Revision as of 12:25, 31 January 2014 by Mike.robski (Talk | contribs)
PUT /domains/{domainName}/hosts
Replaces the hosts list of a domain. Host names must be valid names for the domain, e.g. ns1.example.com is valid host for the domain example.com. Creating hosts will add the proper addresses to the root DNS servers of the registry,
Contents |
Request
PUT /domains/{domainName}/hosts
Parameters
None.
URI Parameters
- domainName - string
- The domain name. IE: example.com is a valid domain name, whereas http://www.example.com or www.example.com are not. If the domain name is invalid, or is otherwise not registerable such as for a non-existent or non-supported TLD, an error will be returned. Domain names are case insensitive. The domain name must be an open or suspended product under the authenticated franchise.
Request Headers
Content-Type: application/json
Request Body
The hosts for the domain.
Parameters
- hosts - list
- The list of hosts
- name - string
- The host name
- address - string
- The IP address of the host.
Response
Status Code
- 204 No Content
- Returned on success
- 404 Not Found
- No domain records found for the given domain name.
- 500 Internal Server Error
- An error has occurred with the registry,
Response Body
The hosts to set for the domain.
Example of replacing the hosts
Request
Content-Length: 0
PUT /domains/example.com/hosts
{"hosts": [{
"name": "ns1.ng-test-fitnesse-20130202-0605.com",
"address": "133.45.67.1"}, {
"name": "ns2.ng-test-fitnesse-20130202-0605.com",
"address": "133.45.67.2"}]}
Response
204 No Content
See also
