Glossary¶
Objects¶
The IRS EPP protocol uses three object types:
Domain objects contain information about domain names,
Contact objects contain information about the contacts that are associated with domain names, like the registrant, the admin contact, the technical contact and the new optional billing contact; See the Contacts section for more info, and
Host objects contain nameserver information.
Object Status Values¶
Client Status values are assigned by the Registrar while Server Status values are either automatically assigned by IRS or manually assigned by a system-level user. Support Status values are manually assigned by a system-level user.
Status |
Description |
|---|---|
clientDeleteProhibited |
This status prevents the object from being removed from the Registry and can be assigned to Domains, Contacts, or Hosts. |
clientHold |
Assigned by the Registrar, this status stops the Registry from activating a Domain in DNS which means that the domain name will not resolve. This status cannot be assigned to Contacts or Hosts. |
clientRenewProhibited |
This status prevents Domains from being renewed and cannot be assigned to either Contacts or Hosts. Note: A domain with the clientRenewProhibited status is still subject to automatic renewals as this status will only prevent manual or explicit renewals. |
clientUpdateProhibited |
This status prevents properties of the object in the Registry from being modified and can be assigned to Domains, Contacts, or Hosts. |
clientTransferProhibited |
.nz Registrars are not permitted to set clientTransferProhibited status flag. |
Status |
Description |
|---|---|
Inactive |
This status is assigned to a Domain that is not associated with any Hosts which means that the domain name is not activated in DNS and will not resolve. This status cannot be assigned to Contacts or Hosts. |
Ok |
This is the normal status value for an object that has no pending operations or restrictions and is automatically assigned or removed by IRS as other status values are assigned or removed. |
serverDeleteProhibited |
This status prevents the object from being removed from the Registry and can be assigned to Domains, Contacts, or Hosts. |
serverHold |
Automatically assigned by IRS or manually assigned by a system-level user, this status stops the Registry from activating a Domain in DNS which means that the domain name will not resolve. This status cannot be assigned to Contacts or Hosts. |
serverRenewProhibited |
This status prevents Domains from being renewed and cannot be assigned to either Contacts or Hosts. Note: A domain with the serverRenewProhibited status is prevented from being subject to automatic renewal. |
serverTransferProhibited |
This status prevents Domains from being transferred and cannot be assigned to either Contacts or Hosts. |
serverUpdateProhibited |
This status prevents the object in the Registry from being modified and can be assigned to Domains, Contacts, or Hosts. |
Status |
Description |
|---|---|
serverDeleteProhibited |
This status prevents the object from being removed from the Registry and can be assigned to Domains, Contacts, or Hosts. |
serverHold |
Automatically assigned by IRS or manually assigned by a system-level user, this status stops the Registry from activating a Domain in DNS which means that the domain name will not resolve. This status cannot be assigned to Contacts or Hosts. |
serverRenewProhibited |
This status prevents Domains from being renewed and cannot be assigned to either Contacts or Hosts. Note: A domain with the serverRenewProhibited status is prevented from being subject to automatic renewal. |
serverTransferProhibited |
This status prevents Domains from being transferred and cannot be assigned to either Contacts or Hosts. |
serverUpdateProhibited |
This status prevents the object in the Registry from being modified and can be assigned to Domains, Contacts, or Hosts. |
Pending Status Values
Pending status values are automatically assigned by IRS to indicate that an operation affecting an object has been started but has not been completed. Operations affecting objects in IRS can be delayed for a number of reasons such as a requirement for review and approval. As the values are assigned or removed automatically, they cannot be configured manually.
Status |
Description |
|---|---|
pendingCreate |
The object has been initially created in IRS but its addition to the Registry has not been completed. This status can be assigned to Domains or Contacts. |
pendingDelete |
The object is in the process of being deleted in IRS but its removal from the Registry has not been completed. This status can be assigned to Domains, Contacts, or Hosts. |
pendingRenew |
The renewal of a domain has been initiated in IRS but has not been completed. This status cannot be assigned to Contacts or Hosts. |
pendingTransfer |
The transfer of a domain has been initiated in IRS but has not been completed. This status can be assigned to Domains, Contacts, or Hosts. |
pendingUpdate |
Modification of the properties of an object has been initiated in IRS but has not been completed. This status can be assigned to Domains, Contacts, or Hosts. |
Domain Lifecycle Status¶
The IRS registry platform implements a domain life cycle in accordance with Section 3.1 of RFC 3915
The stages/states of a domain life cycle are (Note. EPP status codes in brackets):
EPP Status Code |
Description |
OTE Setting |
Production Setting |
|---|---|---|---|
Available |
The domain name is available for registration. |
N/A |
N/A |
addPeriod |
This grace period is provided after the initial registration of a domain name. If the registrar deletes the domain name during this period, there is a refund for the cost of the registration and the domain goes straight to a pending delete state, skipping the redemption period. While in addPeriod a domain may not be transferred. |
1 day |
5 days |
Registered (ok) |
The domain name is registered and active, it has no pending operations or prohibitions. |
||
Renew period (renewPeriod) |
The grace period after a domain has been explicitly renewed by the Registrar. This grace period following a domain name renewal allows the Registrar to delete the domain if necessary and obtain a credit for the cost of the renewal. |
1 day |
5 days |
Auto-renew period (autoRenewPeriod) |
This grace period occurs after a domain has been automatically renewed by the Registry. If the domain is deleted during this period, there is a refund for the cost of the renewal. |
1 day |
45 days |
Redemption period (redemptionPeriod) |
The grace period following the deletion of a domain name from the Registry. During this period, the domain name no longer resolves and cannot be renewed but the Registrar has the option to use the restore command to return the domain name to the registered state. |
2 days |
90 days |
Pending Restore (pendingRestore) |
The period during which a domain name is in the process of being restored to the Registry after having been in the redemptionPeriod stage. i.e. the pending restore period is the time allowed between posting a restore request and a restore report. If a restore report is not received then the domain returns to a redemption state. |
5 days |
5 days |
Pending Delete (pendingDelete) |
A successful Domain Delete request transitions a domain object into pending delete state within the Registry. (A domain name that has been deleted transitions from registered, to redemption, and then to pending delete.) In the pending delete state, the domain name cannot be renewed or restored under any circumstances and is in the process of being removed from the Registry database to become available when the period ends. NOTE pendingDelete is a lifecycle state and a domain server status. When a domain is deleted it goes into the redemptionPeriod life cycle state and is assigned a server status of pendingDelete. When a domain has completed the redemptionPeriod it goes into the pendingDelete life cycle state and has a server status of pendingDelete until the domain Object Status is made available. |
0 days |
0 days |
Transfer Period (transferPeriod) |
This grace period is provided after the successful transfer of a domain name from one registrar to another. It’s used when there is a charge for a registrar transfer and the grace period is the time when the transfer can be undone and a registry refund for the transfer is applied. Under .nz policy there is no charge for the cost of a transfer of a .nz domain name, therefore this grace period is set to 0 days. A renewal fee will be charged if the term of .nz domain name has been extended as part of a transfer from one Registrar to another, however please note the Renewal Grace Period will not apply. This means if the domain is deleted immediately after the transfer there will be no refund on the renewal fee. |
0 days |
0 days |
New Terminology¶
Name |
Description |
|---|---|
Authorisation code (Auth-Code) |
The Auth-Code (previously known as the UDAI in the SRS, and a.k.a. EPP code, authorisation code, transfer code, or Auth-Info Code), is a generated passcode required to transfer a domain name between registrars; the code is intended to indicate that the domain name holder has authorised the transfer. An Auth-Code will expire 30 days after creation or reset. |
IRS |
InternetNZ Registry System |