Host management

The management of name servers via the EPP Gateway allows for easy checking, creation, deleting, and updating of name servers.

1. Check Host availability

The EPP <check> command is used to determine if a name server host exists. It provides a hint that allows a client to anticipate the success or failure of provisioning, changing or deleting a name server host object.

Command request contain following element:

  • <host:name> – fully qualified host name. Registrar is able to provide multiple <host:name> in a single request.

After successful command execution response will include all host names provided in request with attribute “avail” and value “0” or “1”. “0” mean that host cannot be created, “1” mean that host syntax is correct and can be created.

 

2. Create Host

Name server hosts can be created using the <host:create> element. Child elements include:

  • A <host:name> element that contains the fully qualified name of a host.
  • Zero or more OPTIONAL <host:addr> elements that contain the IP addresses to be associated with the host.
    • Each element MAY contain an “IP” attribute to identify the IP address format.
    • Attribute value “v4″ is used to denote an IPv4 address format.
    • Attribute value “v6″ is used to denote an IPv6 address format.
    • If the “IP” attribute is not specified, “v4″ is the default attribute value.

 

 

3. Query Host

The EPP <info> command is used to retrieve information associated with a host object.

Command request contain following element:

  • <host:name> – fully qualified host name.

 

 

4. Update Host

The EPP <update> command for name sever hosts allows modification of attributes of a host object. The <update> command MUST contain a <host:update> element that identifies the host.

The <host:update> element contains the following child elements:

  • A <host:name> element that contains full qualified name of the host to be updated.
  • An OPTIONAL <host:add> element that contains attribute values to be added to the object.
  • An OPTIONAL <host:rem> element that contains attribute values to be removed from the object.
  • An OPTIONAL <host:chg> element that contains object attribute values to be changed.

 

 

5. Delete Host

The <delete> command allows a client to delete a name server host object. In addition to the standard EPP command elements, the <delete> command MUST contain a <host:delete> that identifies the host.

 

 

6. Host status codes

Same as for domain objects there is 2 different types of status codes: client and server codes. Client status codes are set by registrars. Server status codes are set by ST Registry and they take precedence over client codes.

The following are two tables containing 10 possible host object status codes, these tables will explain what each status means.

Server codes:

Status code Description
ok This is the standard status for a domain, meaning it has no holds or restrictions. This status code is set and removed by ST Registry as other status values are added or removed.
linked The host object has at least one active association with a domain object. Registrars are unable to delete such host object unless all associations between host object and domains will be destroyed. To find all domains with association to corresponding host object please refer to the manual – Collections.
serverDeleteProhibited Any request to delete host object will be rejected by ST Registry.
serverUpdateProhibited Any request to update host object (other than to remove this status) will be rejected by ST Registry.
pendingCreate This status code indicates that a request to create host object has been received and is being processed. Status is removed when host object will be propagated to the root ST zone.
pendingUpdate This status indicates that a request to update host object has been received and is being processed. Status is removed when host object updates will be propagated to the root ST zone.
pendingTransfer This status indicates that a request to transfer the host object superordinate domain object has been received and is being processed.
pendingDelete This status indicates that a request to delete host object has been received and is being processed. Status code is removed and host object completely deleted from ST Registry repository after changes propagated to the root ST zone.

 

7. Response codes

To simplify initial integration process, instead of general error messages, ST Registry provide different response messages for same response code depending from exception which generated corresponding response code. Below you can find list of all possible response codes and their messages for host related operations.

Response code Message
1000 Command completed successfully
2003 Missing host name
2005 Invalid host:name
2005 Invalid host:addr
2203 Operation not permitted
2302 Host already exists
2302 Host with name {hostaname} already exists
2304 Object status prohibits operation
2305 Host must be subordinate to one of the registrar domains