SetDomainSRVHosts


Definition

Create or edit SRV host records for a domain name.

Usage

Use this command to create or edit SRV (service) records for a domain name.

This command deletes all previously existing SRV records for the domain name. You must include all SRV records that you want to end up with, in the query string.

SRV records are required for some newer Internet protocols such as SIP and XMPP. Some other protocols support, but do not require, SRV records.

This command allows a user to supply the components of an SRV record that are discretionary, then adds TTL, Class, and formatting to produce a complete SRV record.

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/control-panel/default.asp?DomainNameID=152533676

The save button calls the SetDomainSRVHosts 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 domain name must use our name servers.

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
HostIDX Optional
Required
ID number of an existing host record, if it exists and you want to edit it. Use the GetDomainSRVHosts command to retrieve SRV record ID numbers.
ServiceX Required Service type of this record. Required format is 1 to 14 characters in length; includes lower-case letters, digits, and hyphens; and begins and ends with a letter or digit 14
ProtocolX Required Transport protocol for this record, such as TCP or UDP 14
PriorityX Required Priority for this record. Lowest priority values are used first, working toward higher priority values when lower values are unavailable. Use this value to designate backup service. Permitted values are numbers from 0 to 65535 5
WeightX Required Proportion of time to use this record. Records of equal priority are added and the total normalized to 100%. Use this parameter to specify load balancing among records of the same priority. Permitted values are numbers from 0 to 65535 5
PortX Required Port to use for this service. Permitted format is numbers from 0 to 65535 5
TargetX Required Fully qualified domain name for this SRV record. Permitted format is SRVRecordName.SLD.TLD. (include the trailing period in a fully qualified domain name)
ResponseType Optional Format of response. Permitted values are Text (default), HTML, or XML. 4

 

Returned parameters and values

Parameter Description
InsertedCount Number of SRV records added
UpdatedCount Number of SRV records edited
DeletedCount Number of SRV records deleted
Success Success status of this query
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 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