SetDNSHost


Definition

Dynamically updates the IP address of the host computer in our name server records.

Usage

Use this command to update the IP address of a host that does not have a static IP address.

If possible, use this command in a secure mode: https instead of http.

Availability

All customers have access to this command.

Implementation on eNom.com

This command is not implemented on enom.com.

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 domain name must have a password.
  • The host must be set as an IP address.

Input parameters

Build the query string using this syntax:

Query

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
Zone Required The host and domain name that you want to update in the DNS. For example, www.resellerdocs.com 93
DomainPassword Required Password for managing the domain (a domain that uses the SetDNSHost command must have a password) 60
Address Optional The IP address to set the DNS record to. If omitted, the IP you are coming from (as our server sees it) is used. For example, if you are connecting to our server through a proxy, the proxy server's IP will be used. 15
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, sendResponseType=HTML or ResponseType=XML in your request.
  • Check the return parameter 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.

Example