ModifyNS


Definition

Modify name servers for a domain name.

Usage

Use this command if you want to use name servers that are different than the name servers currently set for a domain.

ModifyNS updates DNS records at the Registry and in the registrar’s database. ModifyNSHosting, a similar command, redirects to another set of name servers without updating the Registry records.

Availability

All resellers have access to this command.

Implementation on eNom.com

Log on to resellertest.enom.com with Login ID resellid, password resellpw.

https://resellertest.enom.com/domains/DNSConfig.asp?DomainNameID=152533676

On the Domain Name Maintenance page, the save changes button calls the ModifyNS command.

Constraints

The query must meet the following requirements:

  • The login ID and password must be valid.
  • The domain name must belong to this account.
  • The query must pass name servers that are registered at NSI.
  • Name servers for .us names must be located in the United States.

Input parameters

Build the query string using this syntax:

https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
&paramname=paramvalue&nextparamname=nextparamvalue

 

Parameter Status Description Max Size
UID Required Account login ID 20
PW Required Account password 20
SLD Required Second-level domain name (for example, enom in enom.com) 63
TLD Required Top-level domain name (extension) 15
UseDNS Either UseDNS or NSX is Required Use this parameter to switch to our name servers. Permitted value is UseDNS=Default 4
NSX X=1 to maximum of 12 Either UseDNS or NSX is Required Use this parameter to switch to custom name servers or no name servers. Maximum of 12 name servers can be set. To designate custom name servers, supply the use names, for example, NS1=ns1.name-services.com To designate no name servers, supply an empty parameter: NS1= 60
ResponseType Optional Format of response. Permitted values are Text (default), HTML, or XML. 4

 

Returned parameters and values

Parameter Description
Command Name of command executed
ErrCount The number of errors if any occurred. If greater than 0 check the Err(1 to ErrCount) values.
ErrX Error messages explaining the failure. These can be presented as is back to the client.
Done True indicates this entire response has reached you successfully.

 

Notes

  • The default response format is plain text. To receive the response in HTML or XML format, send ResponseType=HTML or ResponseType=XML in your request.
  • Check the return parameter rameter ErrCount If greater than 0 the transaction failed. The parameter Err(ErrCount) can be presented to the client. Otherwise process the returned parameters as defined above.
  • To set name servers to eNom’s set the UseDNS=ours param and don't pass NS(x) name servers. To setname servers to your name servers, set NSX=YourNameServerX and don't pass UseDNS=default. Youcan set up to 12 of your own name servers.

Example