Updated domain doc

This commit is contained in:
Priit Tark 2015-01-22 13:08:48 +02:00
parent bd1b2aa687
commit b178d74bcc

View file

@ -2,142 +2,154 @@
### Domain create ### Domain create
Field name | Min-max | Field description Field name Min-max Field description
----------------------- | ------- | ----------------- ------------------------- ------- -----------------
`<create>` | 1 | <create> 1
`-<domain:create>` | 1 | Attribute: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" <domain:create> 1 Attribute: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"
`--<domain:name>` | 1 | Domain name. Can contain unicode characters. <domain:name> 1 Domain name. Can contain unicode characters.
`--<domain:period>` | 0-1 | Registration period for domain. Must add up to 1 / 2 / 3 years. <br> Attribute: unit="y/m/d" <domain:period> 0-1 Registration period for domain.
`--<domain:registrant>` | 1 | Contact reference to the registrant Must add up to 1 / 2 / 3 years.
`--<domain:contact>` | 0-n | Contact reference. Admin contact is required if registrant is a <br> juridical person. Attribute: type="admin / tech" Attribute: unit="y/m/d"
`--<domain:ns>` | 1 | <domain:registrant> 1 Contact reference to the registrant
`---<domain:hostAttr>` | 2-11 | <domain:contact> 0-n Contact reference. Admin contact is required if registrant is
`----<domain:hostName>` | 1 | Hostname of the nameserver a juridical person. Attribute: type="admin / tech"
`----<domain:hostAddr>` | 0-2 | Required if nameserver is under domain zone. Attribute ip="v4 / v6" <domain:ns> 1
`<extension>` | 1 | <domain:hostAttr> 2-11
`-<secDNS:create>` | 0-1 | Attribute: xmlns:secDNS="urn:ietf:params:xml:ns:secDNS-1.1" <domain:hostName> 1 Hostname of the nameserver
`--<secDNS:keyData>` | 1-n | <domain:hostAddr> 0-2 Required if nameserver is under domain zone.
`---<secDNS:flags>` | 1 | Allowed values: 0, 256, 257 Attribute ip="v4 / v6"
`---<secDNS:protocol>` | 1 | Allowed values: 3 <extension> 1
`---<secDNS:alg>` | 1 | Allowed values: 3, 5, 6, 7, 8, 252, 253, 254, 255 <secDNS:create> 0-1 Attribute: xmlns:secDNS="urn:ietf:params:xml:ns:secDNS-1.1"
`---<secDNS:pubKey>` | 1 | Public key <secDNS:keyData> 1-n
`-<eis:extdata>` | 1 | Attribute: xmlns:eis="urn:ee:eis:xml:epp:eis-1.0" <secDNS:flags> 1 Allowed values: 0, 256, 257
`--<eis:legalDocument>` | 1 | Base64 encoded document. Attribute: type="pdf" <secDNS:protocol> 1 Allowed values: 3
`<clTRID>` | 0-1 | Client transaction id <secDNS:alg> 1 Allowed values: 3, 5, 6, 7, 8, 252, 253, 254, 255
<secDNS:pubKey> 1 Public key
<eis:extdata> 1 Attribute: xmlns:eis="urn:ee:eis:xml:epp:eis-1.0"
<eis:legalDocument> 1 Base64 encoded document. Attribute: type="pdf"
<clTRID> 0-1 Client transaction id
[EXAMPLE REQUEST AND RESPONSE](/doc/epp-examples.md#epp-domain-with-valid-user-with-citizen-as-an-owner-creates-a-domain) [EXAMPLE REQUEST AND RESPONSE](/doc/epp-examples.md#epp-domain-with-valid-user-with-citizen-as-an-owner-creates-a-domain)
### Domain update ### Domain update
Field name | Min-max | Field description Field name Min-max Field description
------------------------ | -------- | ----------------- ------------------------ -------- -----------------
`<update>` | 1 | <update> 1
`-<domain:update>` | 1 | Attribute: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" <domain:update> 1 Attribute: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"
`--<domain:name>` | 1 | Domain name. Can contain unicode characters. <domain:name> 1 Domain name. Can contain unicode characters.
`--<domain:chg>` | 0-1 | Attributes to change <domain:chg> 0-1 Attributes to change
`---<domain:registrant>` | 0-1 | Contact reference to the registrant <domain:registrant> 0-1 Contact reference to the registrant
`--<domain:add>` | 0-1 | Objects to add <domain:add> 0-1 Objects to add
`---<domain:contact>` | 0-n | Contact reference. Attribute: type="admin / tech" <domain:contact> 0-n Contact reference. Attribute: type="admin / tech"
`---<domain:status>` | 0-n | Status description. Attribute: s="clientDeleteProhibited / clientHold / <br> clientRenewProhibited / clientTransferProhibited / clientUpdateProhibited" <domain:status> 0-n Status description.
`---<domain:ns>` | 0-1 | Attribute: s="clientDeleteProhibited / clientHold /
`----<domain:hostAttr>` | 1 | clientRenewProhibited / clientTransferProhibited /
`-----<domain:hostName>` | 1 | Hostname of the nameserver clientUpdateProhibited"
`-----<domain:hostAddr>` | 0-2 | Required if nameserver is under domain zone. Attribute ip="v4 / v6" <domain:ns> 0-1
`--<domain:rem>` | 0-1 | Objects to remove <domain:hostAttr> 1
`---<domain:contact>` | 0-n | Contact reference. Attribute: type="admin / tech" <domain:hostName> 1 Hostname of the nameserver
`---<domain:status>` | 0-n | Attribute: s="clientDeleteProhibited / clientHold / clientRenewProhibited / <br> clientTransferProhibited / clientUpdateProhibited" <domain:hostAddr> 0-2 Required if nameserver is under domain zone. Attribute ip="v4 / v6"
`---<domain:ns>` | 0-1 | <domain:rem> 0-1 Objects to remove
`----<domain:hostAttr>` | 1 | <domain:contact> 0-n Contact reference. Attribute: type="admin / tech"
`-----<domain:hostName>` | 1 | Hostname of the nameserver <domain:status> 0-n Attribute: s="clientDeleteProhibited / clientHold /
`<extension>` | 0-1 | Required if registrant is changing clientRenewProhibited / clientTransferProhibited /
`-<secDNS:update>` | 0-1 | Attribute: xmlns:secDNS="urn:ietf:params:xml:ns:secDNS-1.1" clientUpdateProhibited"
`--<secDNS:add>` | 0-1 | <domain:ns> 0-1
`---<secDNS:keyData>` | 1-n | <domain:hostAttr> 1
`----<secDNS:flags>` | 1 | Allowed values: 0, 256, 257 <domain:hostName> 1 Hostname of the nameserver
`----<secDNS:protocol>` | 1 | Allowed values: 3 <extension> 0-1 Required if registrant is changing
`----<secDNS:alg>` | 1 | Allowed values: 3, 5, 6, 7, 8, 252, 253, 254, 255 <secDNS:update> 0-1 Attribute: xmlns:secDNS="urn:ietf:params:xml:ns:secDNS-1.1"
`----<secDNS:pubKey>` | 1 | Public key <secDNS:add> 0-1
`--<secDNS:rem>` | 0-1 | <secDNS:keyData> 1-n
`---<secDNS:keyData>` | 1-n | <secDNS:flags> 1 Allowed values: 0, 256, 257
`----<secDNS:pubKey>` | 1 | Public key <secDNS:protocol> 1 Allowed values: 3
`-<eis:extdata>` | 0-1 | Required if registrant is changing. <br> Attribute: xmlns:eis="urn:ee:eis:xml:epp:eis-1.0" <secDNS:alg> 1 Allowed values: 3, 5, 6, 7, 8, 252, 253, 254, 255
`--<eis:legalDocument>` | 1 | Base64 encoded document. Attribute: type="pdf" <secDNS:pubKey> 1 Public key
`<clTRID>` | 0-1 | Client transaction id <secDNS:rem> 0-1
<secDNS:keyData> 1-n
<secDNS:pubKey> 1 Public key
<eis:extdata> 0-1 Required if registrant is changing.
Attribute: xmlns:eis="urn:ee:eis:xml:epp:eis-1.0"
<eis:legalDocument> 1 Base64 encoded document. Attribute: type="pdf"
<clTRID> 0-1 Client transaction id
[EXAMPLE REQUEST AND RESPONSE](/doc/epp-examples.md#epp-domain-with-valid-user-with-valid-domain-updates-domain-and-adds-objects) [EXAMPLE REQUEST AND RESPONSE](/doc/epp-examples.md#epp-domain-with-valid-user-with-valid-domain-updates-domain-and-adds-objects)
### Domain delete ### Domain delete
Field name | Min-max | Field description Field name Min-max Field description
----------------------- | ------- | ----------------- ----------------------- ------- -----------------
`<delete>` | 1 | <delete> 1
`-<domain:delete>` | 1 | Attribute: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" <domain:delete> 1 Attribute: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"
`--<domain:name>` | 1 | Domain name. Can contain unicode characters. <domain:name> 1 Domain name. Can contain unicode characters.
`<extension>` | 1 | <extension> 1
`-<eis:extdata>` | 1 | Attribute: xmlns:eis="urn:ee:eis:xml:epp:eis-1.0" <eis:extdata> 1 Attribute: xmlns:eis="urn:ee:eis:xml:epp:eis-1.0"
`--<eis:legalDocument>` | 1 | Base64 encoded document. Attribute: type="pdf" <eis:legalDocument> 1 Base64 encoded document. Attribute: type="pdf"
`<clTRID>` | 0-1 | Client transaction id <clTRID> 0-1 Client transaction id
[EXAMPLE REQUEST AND RESPONSE](/doc/epp-examples.md#epp-domain-with-valid-user-with-valid-domain-deletes-domain) [EXAMPLE REQUEST AND RESPONSE](/doc/epp-examples.md#epp-domain-with-valid-user-with-valid-domain-deletes-domain)
### Domain info ### Domain info
Field name | Min-max | Field description Field name Min-max Field description
----------------------- | ------- | ----------------- ----------------------- ------- -----------------
`<info>` | 1 | <info> 1
`-<domain:info>` | 1 | Attribute: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" <domain:info> 1 Attribute: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"
`--<domain:name>` | 1 | Domain name. Can contain unicode characters. <br> Attribute: hosts="all / TODO" <domain:name> 1 Domain name. Can contain unicode characters. <br> Attribute: hosts="all / TODO"
`--<domain:authInfo>` | 0-1 | Required if registrar is not the owner of the domain. <domain:authInfo> 0-1 Required if registrar is not the owner of the domain.
`---<domain:pw>` | 1 | Domain password. Attribute: roid="String" <domain:pw> 1 Domain password. Attribute: roid="String"
`<extension>` | 0-1 | <extension> 0-1
`-<eis:extdata>` | 0-1 | Attribute: xmlns:eis="urn:ee:eis:xml:epp:eis-1.0" <eis:extdata> 0-1 Attribute: xmlns:eis="urn:ee:eis:xml:epp:eis-1.0"
`--<eis:legalDocument>` | 1 | Base64 encoded document. Attribute: type="pdf" <eis:legalDocument> 1 Base64 encoded document. Attribute: type="pdf"
`<clTRID>` | 0-1 | Client transaction id <clTRID> 0-1 Client transaction id
[EXAMPLE REQUEST AND RESPONSE](/doc/epp-examples.md#epp-domain-with-valid-user-with-valid-domain-returns-domain-info) [EXAMPLE REQUEST AND RESPONSE](/doc/epp-examples.md#epp-domain-with-valid-user-with-valid-domain-returns-domain-info)
### Domain renew ### Domain renew
Field name | Min-max | Field description Field name Min-max Field description
----------------------- | ------- | ----------------- ----------------------- ------- -----------------
`<renew>` | 1 | <renew> 1
`-<domain:renew>` | 1 | Attribute: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" <domain:renew> 1 Attribute: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"
`--<domain:name>` | 1 | Domain name. Can contain unicode characters. <br> Attribute: hosts="all / TODO" <domain:name> 1 Domain name. Can contain unicode characters.
`--<domain:curExpDate>` | 1 | Current expiry date (ISO8601 format) Attribute: hosts="all / TODO"
`--<domain:period>` | 1 | Registration period for domain. Must add up to 1 / 2 / 3 years. <br> Attribute: unit="y/m/d" <domain:curExpDate> 1 Current expiry date (ISO8601 format)
`<extension>` | 0-1 | <domain:period> 1 Registration period for domain. Must add up to 1 / 2 / 3 years. <br> Attribute: unit="y/m/d"
`-<eis:extdata>` | 0-1 | Attribute: xmlns:eis="urn:ee:eis:xml:epp:eis-1.0" <extension> 0-1
`--<eis:legalDocument>` | 1 | Base64 encoded document. Attribute: type="pdf" <eis:extdata> 0-1 Attribute: xmlns:eis="urn:ee:eis:xml:epp:eis-1.0"
`<clTRID>` | 0-1 | Client transaction id <eis:legalDocument> 1 Base64 encoded document. Attribute: type="pdf"
<clTRID> 0-1 Client transaction id
[EXAMPLE REQUEST AND RESPONSE](/doc/epp-examples.md#epp-domain-with-valid-user-with-valid-domain-renews-a-domain) [EXAMPLE REQUEST AND RESPONSE](/doc/epp-examples.md#epp-domain-with-valid-user-with-valid-domain-renews-a-domain)
### Domain transfer ### Domain transfer
Field name | Min-max | Field description Field name Min-max Field description
----------------------- | ------- | ----------------- ----------------------- ------- -----------------
`<transfer>` | 1 | <transfer> 1
`-<domain:transfer>` | 1 | Attribute: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" <domain:transfer> 1 Attribute: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"
`--<domain:name>` | 1 | Domain name. Can contain unicode characters. <br> Attribute: hosts="all / TODO" <domain:name> 1 Domain name. Can contain unicode characters.
`--<domain:authInfo>` | 1 | Attribute: hosts="all / TODO"
`---<domain:pw>` | 1 | Domain password. Attribute: roid="String" <domain:authInfo> 1
`<extension>` | 0-1 | <domain:pw> 1 Domain password. Attribute: roid="String"
`-<eis:extdata>` | 0-1 | Attribute: xmlns:eis="urn:ee:eis:xml:epp:eis-1.0" <extension> 0-1
`--<eis:legalDocument>` | 1 | Base64 encoded document. Attribute: type="pdf" <eis:extdata> 0-1 Attribute: xmlns:eis="urn:ee:eis:xml:epp:eis-1.0"
`<clTRID>` | 0-1 | Client transaction id <eis:legalDocument> 1 Base64 encoded document. Attribute: type="pdf"
<clTRID> 0-1 Client transaction id
[EXAMPLE REQUEST AND RESPONSE](/doc/epp-examples.md#epp-domain-with-valid-user-with-two-epp-users-transfers-a-domain) [EXAMPLE REQUEST AND RESPONSE](/doc/epp-examples.md#epp-domain-with-valid-user-with-two-epp-users-transfers-a-domain)
### Domain check ### Domain check
Field name | Min-max | Field description Field name Min-max Field description
----------------------- | ------- | ----------------- ----------------------- ------- -----------------
`<check>` | 1 | <check> 1
`-<domain:check>` | 1 | Attribute: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" <domain:check> 1 Attribute: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"
`--<domain:name>` | 1 | Domain name. Can contain unicode characters. <br> Attribute: hosts="all / TODO" <domain:name> 1 Domain name. Can contain unicode characters. <br> Attribute: hosts="all / TODO"
`<extension>` | 0-1 | <extension> 0-1
`-<eis:extdata>` | 0-1 | Attribute: xmlns:eis="urn:ee:eis:xml:epp:eis-1.0" <eis:extdata> 0-1 Attribute: xmlns:eis="urn:ee:eis:xml:epp:eis-1.0"
`--<eis:legalDocument>` | 1 | Base64 encoded document. Attribute: type="pdf" <eis:legalDocument> 1 Base64 encoded document. Attribute: type="pdf"
`<clTRID>` | 0-1 | Client transaction id <clTRID> 0-1 Client transaction id
[EXAMPLE REQUEST AND RESPONSE](/doc/epp-examples.md#epp-domain-with-valid-user-checks-a-domain) [EXAMPLE REQUEST AND RESPONSE](/doc/epp-examples.md#epp-domain-with-valid-user-checks-a-domain)