rfc9803v1.txt | rfc9803.txt | |||
---|---|---|---|---|
skipping to change at line 184 ¶ | skipping to change at line 184 ¶ | |||
"custom" | "custom" | |||
If the value of the "for" attribute is "custom", then the | If the value of the "for" attribute is "custom", then the | |||
<ttl:ttl> element MUST also have a "custom" attribute containing a | <ttl:ttl> element MUST also have a "custom" attribute containing a | |||
DNS record type conforming with the regular expression in | DNS record type conforming with the regular expression in | |||
Section 3.1 of [RFC6895]. Additionally, the record type MUST be | Section 3.1 of [RFC6895]. Additionally, the record type MUST be | |||
registered with IANA in [IANA-RRTYPES]. | registered with IANA in [IANA-RRTYPES]. | |||
"min" | "min" | |||
MUST NOT be present in EPP commands but MAY be present in EPP | MUST NOT be present in EPP commands but MAY be present in EPP | |||
responses (see Section 2.1.1). It is also used by the server to | responses (see Section 2.1.1). It is used by the server to | |||
indicate the lowest value that may be set. | indicate the lowest value that may be set. | |||
"default" | "default" | |||
MUST NOT be present in EPP commands but MAY be present in EPP | MUST NOT be present in EPP commands but MAY be present in EPP | |||
responses (see Section 2.1.1). It is also used by the server to | responses (see Section 2.1.1). It is used by the server to | |||
indicate the default value. | indicate the default value. | |||
"max" | "max" | |||
MUST NOT be present in EPP commands but MAY be present in EPP | MUST NOT be present in EPP commands but MAY be present in EPP | |||
responses (see Section 2.1.1). It is also used by the server to | responses (see Section 2.1.1). It is used by the server to | |||
indicate the highest value that may be set. | indicate the highest value that may be set. | |||
When present, the value of the "min" attribute MUST be lower than the | When present, the value of the "min" attribute MUST be lower than the | |||
value of the "max" attribute. The "default" attribute MUST be | value of the "max" attribute. The "default" attribute MUST be | |||
between the "min" and "max" values, inclusively. | between the "min" and "max" values, inclusively. | |||
1.2.1.1. Element Content | 1.2.1.1. Element Content | |||
The XML schema found in Section 8 of this document restricts the | The XML schema found in Section 8 of this document restricts the | |||
content of <ttl:ttl> elements to be either: | content of <ttl:ttl> elements to be either: | |||
skipping to change at line 272 ¶ | skipping to change at line 272 ¶ | |||
The <ttl:info> element is used by clients to request that the server | The <ttl:info> element is used by clients to request that the server | |||
include additional information in <info> responses for domain and | include additional information in <info> responses for domain and | |||
host objects. | host objects. | |||
It has a single OPTIONAL "policy" attribute, which takes a boolean | It has a single OPTIONAL "policy" attribute, which takes a boolean | |||
value with a default value of "false". | value with a default value of "false". | |||
The semantics of this element are described in Section 2.1.1. | The semantics of this element are described in Section 2.1.1. | |||
1.2.1.3.1. Example | Below is an example of a <ttl:info> element with an explicit "policy" | |||
attribute: | ||||
<ttl:info policy="true"/> | <ttl:info policy="true"/> | |||
1.2.2. Examples | 1.2.2. Examples | |||
1.2.2.1. Explicit TTL Value (<create> or <update> Command) | 1.2.2.1. Explicit TTL Value (<create> or <update> Command) | |||
<ttl:ttl for="NS">3600</ttl:ttl> | <ttl:ttl for="NS">3600</ttl:ttl> | |||
1.2.2.2. Explicit TTL Value (<info> Policy Mode) | 1.2.2.2. Explicit TTL Value (<info> Policy Mode) | |||
skipping to change at line 610 ¶ | skipping to change at line 611 ¶ | |||
2.2.1. EPP <create> Command | 2.2.1. EPP <create> Command | |||
This extension defines an additional element for EPP <create> | This extension defines an additional element for EPP <create> | |||
commands for domain and host objects. | commands for domain and host objects. | |||
The <command> element of the <create> command MAY contain an | The <command> element of the <create> command MAY contain an | |||
<extension> element that MAY contain a <ttl:create> element. This | <extension> element that MAY contain a <ttl:create> element. This | |||
element MUST contain one or more <ttl:ttl> records as described in | element MUST contain one or more <ttl:ttl> records as described in | |||
Section 1.2. | Section 1.2. | |||
If an EPP server receives a <create> command containing a TTL value | ||||
that is outside the server's permitted range, it MUST reject the | ||||
command with a 2004 "Parameter value range error" response. | ||||
Below is an example domain <create> command: | Below is an example domain <create> command: | |||
C: <?xml version="1.0" encoding="UTF-8" standalone="no"?> | C: <?xml version="1.0" encoding="UTF-8" standalone="no"?> | |||
C: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | C: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
C: <command> | C: <command> | |||
C: <create> | C: <create> | |||
C: <domain:create | C: <domain:create | |||
C: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | C: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | |||
C: <domain:name>example.com</domain:name> | C: <domain:name>example.com</domain:name> | |||
C: <domain:period unit="y">1</domain:period> | C: <domain:period unit="y">1</domain:period> | |||
skipping to change at line 673 ¶ | skipping to change at line 678 ¶ | |||
C: <ttl:create | C: <ttl:create | |||
C: xmlns:ttl="urn:ietf:params:xml:ns:epp:ttl-1.0"> | C: xmlns:ttl="urn:ietf:params:xml:ns:epp:ttl-1.0"> | |||
C: <ttl:ttl for="A"/> | C: <ttl:ttl for="A"/> | |||
C: <ttl:ttl for="AAAA">86400</ttl:ttl> | C: <ttl:ttl for="AAAA">86400</ttl:ttl> | |||
C: </ttl:create> | C: </ttl:create> | |||
C: </extension> | C: </extension> | |||
C: <clTRID>ABC-12345</clTRID> | C: <clTRID>ABC-12345</clTRID> | |||
C: </command> | C: </command> | |||
C: </epp> | C: </epp> | |||
If an EPP server receives a <create> command containing a TTL value | ||||
that is outside the server's permitted range, it MUST reject the | ||||
command with a 2004 "Parameter value range error" response. | ||||
2.2.2. EPP <update> Command | 2.2.2. EPP <update> Command | |||
This extension defines an additional element for EPP <update> | This extension defines an additional element for EPP <update> | |||
commands for domain and host objects. | commands for domain and host objects. | |||
The <command> element of the <update> command MAY contain an | The <command> element of the <update> command MAY contain an | |||
<extension> element that MAY contain a <ttl:update> element. This | <extension> element that MAY contain a <ttl:update> element. This | |||
element MUST contain one or more <ttl:ttl> records as described in | element MUST contain one or more <ttl:ttl> records as described in | |||
Section 1.2. | Section 1.2. | |||
If an EPP server receives an <update> command containing a TTL value | ||||
that is outside the server's permitted range, it MUST reject the | ||||
command with a 2004 "Parameter value range error" response. | ||||
Below is an example domain <update> command: | Below is an example domain <update> command: | |||
C: <?xml version="1.0" encoding="UTF-8" standalone="no"?> | C: <?xml version="1.0" encoding="UTF-8" standalone="no"?> | |||
C: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | C: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
C: <command> | C: <command> | |||
C: <update> | C: <update> | |||
C: <domain:update | C: <domain:update | |||
C: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | C: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | |||
C: <domain:name>example.com</domain:name> | C: <domain:name>example.com</domain:name> | |||
C: </domain:update> | C: </domain:update> | |||
skipping to change at line 733 ¶ | skipping to change at line 738 ¶ | |||
C: <ttl:update | C: <ttl:update | |||
C: xmlns:ttl="urn:ietf:params:xml:ns:epp:ttl-1.0"> | C: xmlns:ttl="urn:ietf:params:xml:ns:epp:ttl-1.0"> | |||
C: <ttl:ttl for="A">86400</ttl:ttl> | C: <ttl:ttl for="A">86400</ttl:ttl> | |||
C: <ttl:ttl for="AAAA">3600</ttl:ttl> | C: <ttl:ttl for="AAAA">3600</ttl:ttl> | |||
C: </ttl:update> | C: </ttl:update> | |||
C: </extension> | C: </extension> | |||
C: <clTRID>ABC-12345</clTRID> | C: <clTRID>ABC-12345</clTRID> | |||
C: </command> | C: </command> | |||
C: </epp> | C: </epp> | |||
If an EPP server receives an <update> command containing a TTL value | ||||
that is outside the server's permitted range, it MUST reject the | ||||
command with a 2004 "Parameter value range error" response. | ||||
3. Server Processing of TTL Values | 3. Server Processing of TTL Values | |||
3.1. Permitted Record Types | 3.1. Permitted Record Types | |||
EPP servers MAY restrict the supported DNS record types. For | EPP servers MAY restrict the supported DNS record types. For | |||
example, a server MAY allow clients to specify TTL values for DS | example, a server MAY allow clients to specify TTL values for DS | |||
records only. | records only. | |||
A server that receives a <create> or <update> command that includes a | A server that receives a <create> or <update> command that includes a | |||
restricted record type MUST respond with a 2306 "Parameter value | restricted record type MUST respond with a 2306 "Parameter value | |||
skipping to change at line 865 ¶ | skipping to change at line 866 ¶ | |||
7. IANA Considerations | 7. IANA Considerations | |||
7.1. XML Namespace | 7.1. XML Namespace | |||
This document uses URNs to describe XML namespaces and XML schemas | This document uses URNs to describe XML namespaces and XML schemas | |||
conforming to a registry mechanism described in [RFC3688]. The | conforming to a registry mechanism described in [RFC3688]. The | |||
following URI assignments have been made by IANA: | following URI assignments have been made by IANA: | |||
Registration for the TTL namespace: | Registration for the TTL namespace: | |||
*URI:* urn:ietf:params:xml:ns:epp:ttl-1.0 | URI: urn:ietf:params:xml:ns:epp:ttl-1.0 | |||
*Registrant Contact:* IESG | Registrant Contact: IESG | |||
*XML:* None. Namespace URIs do not represent an XML specification. | XML: None. Namespace URIs do not represent an XML specification. | |||
Registration for the TTL XML schema: | Registration for the TTL XML schema: | |||
*URI:* urn:ietf:params:xml:schema:epp:ttl-1.0 | URI: urn:ietf:params:xml:schema:epp:ttl-1.0 | |||
*Registrant Contact:* IESG | Registrant Contact: IESG | |||
*XML:* See Section 8 of this document. | XML: See Section 8 of this document. | |||
7.2. EPP Extension Registry | 7.2. EPP Extension Registry | |||
The EPP extension described in this document has been registered by | The EPP extension described in this document has been registered by | |||
IANA in the "Extensions for the Extensible Provisioning Protocol | IANA in the "Extensions for the Extensible Provisioning Protocol | |||
(EPP)" registry described in [RFC7451]. The details of the | (EPP)" registry described in [RFC7451]. The details of the | |||
registration are as follows: | registration are as follows: | |||
*Name of Extension:* Extensible Provisioning Protocol (EPP) Mapping | Name of Extension: Extensible Provisioning Protocol (EPP) Mapping | |||
for DNS Time-To-Live (TTL) values | for DNS Time-to-Live (TTL) Values | |||
*Document Status:* Standards Track | Document Status: Standards Track | |||
*Reference:* RFC 9803 | Reference: RFC 9803 | |||
*Registrant:* IESG | Registrant: IESG | |||
*TLDs:* Any | TLDs: Any | |||
*IPR Disclosure:* None | IPR Disclosure: None | |||
*Status:* Active | Status: Active | |||
*Notes:* None | Notes: None | |||
8. Formal Syntax | 8. Formal Syntax | |||
The formal syntax presented here is a complete schema representation | The formal syntax presented here is a complete schema representation | |||
of the extension suitable for automated validation of EPP XML | of the extension suitable for automated validation of EPP XML | |||
instances. | instances. | |||
<?xml version="1.0" encoding="UTF-8"?> | <?xml version="1.0" encoding="UTF-8"?> | |||
<schema | <schema | |||
xmlns="http://www.w3.org/2001/XMLSchema" | xmlns="http://www.w3.org/2001/XMLSchema" | |||
targetNamespace="urn:ietf:params:xml:ns:epp:ttl-1.0" | targetNamespace="urn:ietf:params:xml:ns:epp:ttl-1.0" | |||
xmlns:ttl="urn:ietf:params:xml:ns:epp:ttl-1.0" | xmlns:ttl="urn:ietf:params:xml:ns:epp:ttl-1.0" | |||
elementFormDefault="qualified"> | elementFormDefault="qualified"> | |||
<annotation> | <annotation> | |||
<documentation> | <documentation> | |||
Extensible Provisioning Protocol v1.0 extension | Extensible Provisioning Protocol v1.0 extension | |||
schema for Time-To-Live (TTL) values for domain | schema for Time-to-Live (TTL) Values for domain | |||
and host objects. | and host objects. | |||
</documentation> | </documentation> | |||
</annotation> | </annotation> | |||
<element name="info"> | <element name="info"> | |||
<complexType> | <complexType> | |||
<attribute name="policy" type="boolean" default="false"/> | <attribute name="policy" type="boolean" default="false"/> | |||
</complexType> | </complexType> | |||
</element> | </element> | |||
End of changes. 12 change blocks. | ||||
28 lines changed or deleted | 29 lines changed or added | |||
This html diff was produced by rfcdiff 1.48. |