Update domain.md

Table design changes to improve readability ie first column in one line, Mardown Extra table design best practices (https://github.com/carwin/markdown-styleguide)
This commit is contained in:
Timo Võhmar 2015-01-20 11:03:30 +02:00
parent b3c0b5d824
commit 821b29273c

View file

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