If a registration period is not specified then a registration or renewal will be for the default period of two years.
The following request snippet sets the registration period to 1 year:
...
<domain:create
xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"
xsi:schemaLocation="urn:ietf:params:xml:ns:domain-1.0 domain-1.0.xsd">
<domain:name>epp-example.co.uk</domain:name>
<domain:period unit="y">1</domain:period>
<domain:registrant>EXAMPLE123</domain:registrant>
...
The following request snippet sets the registration period to 5 years on renewal
...
<domain:renew
xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"
xsi:schemaLocation="urn:ietf:params:xml:ns:domain-1.0 domain-1.0.xsd">
<domain:name>epp-example.co.uk</domain:name>
<domain:curExpDate>2011-11-01</domain:curExpDate>
<domain:period unit="y">5</domain:period>
...
Alternatively, registration periods set in multiples of 12 months may also be used for registration and renewal requests. For example:
...
<domain:renew
xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"
xsi:schemaLocation="urn:ietf:params:xml:ns:domain-1.0 domain-1.0.xsd">
<domain:name>epp-example.co.uk</domain:name>
<domain:curExpDate>2011-11-01</domain:curExpDate>
<domain:period unit="m">36</domain:period>
...
The auto-period and next-period fields may be set at the same time as the auto-bill and next-bill fields respectively using the domain-nom-ext-1.2 extensions. In the following example, an extension to the <domain:create> command, the domain name is set up on registration to renew 5 days before expiry for 6 years.
...In this example, an extension to the <domain:update> command, the domain name is set up to renew 1 day before expiry for 1 year.
<extension>
<domain-ext:create
xmlns:domain-ext="http://www.nominet.org.uk/epp/xml/domain-nom-ext-1.2"
xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/domain-nom-ext-1.2
domain-nom-ext-1.2.xsd">
<domain-ext:auto-bill>5</domain-ext:auto-bill>
<domain-ext:auto-period>6</domain-ext:auto-period>
</domain-ext:create>
</extension>
...
...
<extension>
<domain-ext:update
xmlns:domain-ext="http://www.nominet.org.uk/epp/xml/domain-nom-ext-1.2"
xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/domain-nom-ext-1.2
domain-nom-ext-1.2.xsd">
<domain-ext:auto-bill>1</domain-ext:auto-bill>
<domain-ext:auto-period>1</domain-ext:auto-period>
</domain-ext:update>
</extension>
...
Automaton
Registration requests
By including the period field in a registration request, the registration period may be set to a value other than two years. The following snippet sets the registration period to 3 years....
period: 3y
...
...We have also extended the renewal request so that the current expiry date for a domain can be specified as part of the request:
period: 48m
...
...If the current expiry date in the request is wrong then the renewal request will fail.
current-expiry: 20120629
...
auto-bill: 6
auto-period: 5
...
<domain:renew
xmlns:domain="http://www.nominet.org.uk/epp/xml/nom-domain-2.2"
xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/nom-domain-2.2 nom-domain-2.2.xsd">
<domain:name>epp-example.co.uk</domain:name>
<domain:curExpDate>2011-11-01</domain:curExpDate>
<domain:period unit="y">5</domain:period>
...
Relevant dates:The number of WHOIS domain registration status statements will be reduced from 7 to 3 leaving:
Registered on: DD-MMM-YYYY
Expiry date: DD-MMM-YYYY
Last updated: DD-MMM-YYYY
Registration status:
Registered until expiry date.
Registration status:
Renewal required.
Registration status:
Registration not required.