[要約] RFC 8748は、EPP(Extensible Provisioning Protocol)のための登録料延長に関する規格です。その目的は、EPPの登録料延長機能を提供し、ドメイン登録業者が登録料の期限を延長できるようにすることです。

Internet Engineering Task Force (IETF)                         R. Carney
Request for Comments: 8748                                  GoDaddy Inc.
Category: Standards Track                                       G. Brown
ISSN: 2070-1721                                     CentralNic Group plc
                                                               J. Frakes
                                                              March 2020
        

Registry Fee Extension for the Extensible Provisioning Protocol (EPP)

Extensible Provisioning Protocol(EPP)のレジストリ料金拡張

Abstract

概要

Given the expansion of the DNS namespace and the proliferation of novel business models, it is desirable to provide a method for Extensible Provisioning Protocol (EPP) clients to query EPP servers for the fees and credits associated with various billable transactions and provide expected fees and credits for certain commands and objects. This document describes an EPP extension mapping for registry fees.

DNS名前空間の拡大と新しいビジネスモデルの急増を考慮して、Extensible Provisioning Protocol(EPP)クライアントがEPPサーバーにクエリして、さまざまな請求可能なトランザクションに関連する手数料とクレジットを求め、予想される手数料とクレジットを提供する方法を提供することが望ましい特定のコマンドとオブジェクト。このドキュメントでは、レジストリ料金のEPP拡張マッピングについて説明します。

Status of This Memo

本文書の状態

This is an Internet Standards Track document.

これはInternet Standards Trackドキュメントです。

This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Further information on Internet Standards is available in Section 2 of RFC 7841.

このドキュメントは、IETF(Internet Engineering Task Force)の製品です。これは、IETFコミュニティのコンセンサスを表しています。公開レビューを受け、インターネットエンジニアリングステアリンググループ(IESG)による公開が承認されました。インターネット標準の詳細については、RFC 7841のセクション2をご覧ください。

Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at https://www.rfc-editor.org/info/rfc8748.

このドキュメントの現在のステータス、エラッタ、およびフィードバックの提供方法に関する情報は、https://www.rfc-editor.org/info/rfc8748で入手できます。

Copyright Notice

著作権表示

Copyright (c) 2020 IETF Trust and the persons identified as the document authors. All rights reserved.

著作権(c)2020 IETFトラストおよびドキュメントの作成者として識別された人物。全著作権所有。

This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.

この文書は、BCP 78およびIETF文書に関するIETFトラストの法的規定(https://trustee.ietf.org/license-info)の対象であり、この文書の発行日に有効です。これらのドキュメントは、このドキュメントに関するあなたの権利と制限を説明しているため、注意深く確認してください。このドキュメントから抽出されたコードコンポーネントには、Trust Legal Provisionsのセクション4.eに記載されているSimplified BSD Licenseのテキストが含まれている必要があり、Simplified BSD Licenseに記載されているように保証なしで提供されます。

Table of Contents

目次

   1.  Introduction
     1.1.  Conventions Used in This Document
   2.  Migrating to Newer Versions of This Extension
   3.  Extension Elements
     3.1.  Client Commands
     3.2.  Currency Codes
     3.3.  Validity Periods
     3.4.  Fees and Credits
       3.4.1.  Refunds
       3.4.2.  Grace Periods
       3.4.3.  Correlation between Refundability and Grace Periods
       3.4.4.  Applicability
     3.5.  Account Balance
     3.6.  Credit Limit
     3.7.  Classification of Objects
     3.8.  "Phase" and "Subphase" Attributes
     3.9.  Reason
   4.  Server Handling of Fee Information
   5.  EPP Command Mapping
     5.1.  EPP Query Commands
       5.1.1.  EPP <check> Command
       5.1.2.  EPP Transfer Query Command
     5.2.  EPP Transform Commands
       5.2.1.  EPP <create> Command
       5.2.2.  EPP <delete> Command
       5.2.3.  EPP <renew> Command
       5.2.4.  EPP <transfer> Command
       5.2.5.  EPP <update> Command
   6.  Formal Syntax
     6.1.  Fee Extension Schema
   7.  Security Considerations
   8.  IANA Considerations
     8.1.  XML Namespace
     8.2.  EPP Extension Registry
   9.  References
     9.1.  Normative References
     9.2.  Informative References
   Acknowledgements
   Authors' Addresses
        
1. Introduction
1. はじめに

Historically, domain name registries have applied a simple fee structure for billable transactions, namely a basic unit price applied to domain <create>, <renew>, <transfer>, and Redemption Grace Period (RGP) [RFC3915] restore commands. Given the relatively small number of EPP servers to which EPP clients have been required to connect, it has generally been the case that client operators have been able to obtain details of these fees out of band by contacting the server operators.

これまで、ドメイン名レジストリは、請求可能なトランザクションに単純な料金体系を適用してきました。つまり、ドメイン<create>、<renew>、<transfer>、およびRedemption Grace Period(RGP)[RFC3915]復元コマンドに適用される基本単価です。 EPPクライアントが接続する必要のあるEPPサーバーの数が比較的少ないことを考えると、クライアントオペレーターがサーバーオペレーターに連絡することにより、帯域外でこれらの料金の詳細を取得できるのが一般的です。

Given the expansion of the DNS namespace and the proliferation of novel business models, it is desirable to provide a method for EPP clients to query EPP servers for the fees and credits associated with various billable transactions and certain commands and specific objects.

DNS名前空間の拡大と新しいビジネスモデルの急増を考えると、EPPクライアントがEPPサーバーに照会して、さまざまな請求可能なトランザクションと特定のコマンドと特定のオブジェクトに関連する料金とクレジットを照会する方法を提供することが望まれます。

This document describes an extension mapping for version 1.0 of the Extensible Provisioning Protocol (EPP) [RFC5730]. This EPP mapping provides a mechanism by which EPP clients may query the fees and credits associated with various billable transactions and obtain their current account balance.

このドキュメントでは、Extensible Provisioning Protocol(EPP)[RFC5730]のバージョン1.0の拡張マッピングについて説明します。このEPPマッピングは、EPPクライアントがさまざまな請求可能なトランザクションに関連する料金とクレジットを照会し、現在のアカウントの残高を取得するメカニズムを提供します。

1.1. Conventions Used in This Document
1.1. このドキュメントで使用される規則

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.

キーワード「MUST」、「MUST NOT」、「REQUIRED」、「SHALL」、「SHALL NOT」、「SHOULD」、「SHOULD NOT」、「RECOMMENDED」、「NOT RECOMMENDED」、「MAY」、「OPTIONALこのドキュメントの「」は、BCP 14 [RFC2119] [RFC8174]で説明されているように解釈されます。

XML is case sensitive. Unless stated otherwise, the XML specifications and examples provided in this document MUST be interpreted in the character case presented in order to develop a conforming implementation.

XMLでは大文字と小文字が区別されます。特に明記しない限り、このドキュメントで提供されるXMLの仕様と例は、準拠する実装を開発するために、大文字と小文字を区別して解釈する必要があります。

"fee" is used as an abbreviation for "urn:ietf:params:xml:ns:epp:fee-1.0". The XML namespace prefix "fee" is used, but implementations MUST NOT depend on it and instead employ a proper namespace-aware XML parser and serializer to interpret and output the XML documents.

「fee」は「urn:ietf:params:xml:ns:epp:fee-1.0」の省略形として使用されます。 XML名前空間接頭辞「fee」が使用されますが、実装はこれに依存してはならず、適切な名前空間認識XMLパーサーとシリアライザーを使用してXMLドキュメントを解釈および出力します。

In the examples, "C:" represents lines sent by a protocol client, and "S:" represents lines returned by a protocol server. Indentation and white space in the examples are provided only to illustrate element relationships and are not a required feature of this protocol.

この例では、「C:」はプロトコルクライアントによって送信された行を表し、「S:」はプロトコルサーバーによって返された行を表します。例のインデントと空白は、要素の関係を示すためにのみ提供されており、このプロトコルの必須機能ではありません。

2. Migrating to Newer Versions of This Extension
2. この拡張機能の新しいバージョンへの移行

Servers that implement this extension SHOULD provide a way for clients to progressively update their implementations when a new version of the extension is deployed.

この拡張機能を実装するサーバーは、新しいバージョンの拡張機能がデプロイされたときに、クライアントが実装を段階的に更新する方法を提供する必要があります(SHOULD)。

Servers SHOULD (for a temporary migration period) provide support for older versions of the extension in parallel to the newest version and allow clients to select their preferred version via the <svcExtension> element of the <login> command.

サーバーは(一時的な移行期間中)、最新バージョンと並行して古いバージョンの拡張機能をサポートし、クライアントが<login>コマンドの<svcExtension>要素を介して優先バージョンを選択できるようにする必要があります(SHOULD)。

If a client requests multiple versions of the extension at login, then, when preparing responses to commands that do not include extension elements, the server SHOULD only include extension elements in the namespace of the newest version of the extension requested by the client.

クライアントがログイン時に拡張機能の複数のバージョンを要求する場合、拡張要素を含まないコマンドへの応答を準備するとき、サーバーはクライアントによって要求された拡張機能の最新バージョンの名前空間に拡張要素のみを含めるべきです(SHOULD)。

When preparing responses to commands that do include extension elements, the server SHOULD only include extension elements for the extension versions present in the command.

拡張要素を含むコマンドへの応答を準備する場合、サーバーは、コマンドに存在する拡張バージョンの拡張要素のみを含める必要があります(SHOULD)。

3. Extension Elements
3. 拡張要素
3.1. Client Commands
3.1. クライアントコマンド

The <fee:command> element is used in the EPP <check> command to determine the fee that is applicable to the given command.

<fee:command>要素はEPP <check>コマンドで使用され、特定のコマンドに適用される料金を決定します。

The "name" attribute of the <fee:command> is used to define which transform fees the client is requesting information about. The possible values for the "name" attribute are:

<fee:command>の「name」属性は、クライアントが情報を要求している変換料金を定義するために使用されます。 「name」属性の可能な値は次のとおりです。

* "create", indicating a <create> command as defined in [RFC5730].

* 「create」は、[RFC5730]で定義されている<create>コマンドを示します。

* "delete", indicating a <delete> command as defined in [RFC5730].

* 「削除」は、[RFC5730]で定義されている<delete>コマンドを示します。

* "renew", indicating a <renew> command as defined in [RFC5730].

* 「renew」は、[RFC5730]で定義されている<renew>コマンドを示します。

* "update", indicating a <update> command as defined in [RFC5730].

* 「更新」は、[RFC5730]で定義されている<update>コマンドを示します。

* "transfer", indicating a <transfer> command as defined in [RFC5730].

* 「転送」は、[RFC5730]で定義されている<転送>コマンドを示します。

* If the server supports registry grace period mapping [RFC3915], then the server MUST also support the "restore" value as defined in [RFC3915].

* サーバーがレジストリ猶予期間マッピング[RFC3915]をサポートする場合、サーバーは[RFC3915]で定義されている「復元」値もサポートする必要があります。

* "custom", indicating a custom command that MUST set the "customName" attribute with a custom command name. The possible set of custom command name values is dictated by the server policy.

* 「カスタム」は、「customName」属性にカスタムコマンド名を設定する必要があるカスタムコマンドを示します。カスタムコマンド名の値の可能なセットは、サーバーポリシーによって決まります。

The <fee:command> element MAY have an OPTIONAL "phase" attribute specifying a launch phase as described in [RFC8334]. It may also contain an OPTIONAL "subphase" attribute identifying the custom or subphase as described in [RFC8334].

<fee:command>要素は、[RFC8334]で説明されているように、起動フェーズを指定するオプションの「フェーズ」属性を持つ場合があります。 [RFC8334]で説明されているように、カスタムまたはサブフェーズを識別するオプションの「サブフェーズ」属性を含めることもできます。

3.2. Currency Codes
3.2. 通貨コード

The <fee:currency> element is used to indicate the currency in which fees are charged. The value of this element MUST be a three-character currency code from [ISO4217_2015].

<fee:currency>要素は、料金が請求される通貨を示すために使用されます。この要素の値は、[ISO4217_2015]の3文字の通貨コードである必要があります。

Note that [ISO4217_2015] provides the special "XXX" code, which MAY be used if the server uses a non-currency-based system for assessing fees, such as a system of credits.

[ISO4217_2015]は特別な「XXX」コードを提供することに注意してください。これは、サーバーがクレジットのシステムなど、料金を評価するために通貨ベースではないシステムを使用する場合に使用できます。

The use of <fee:currency> elements in client commands is OPTIONAL: if a <fee:currency> element is not present in a command, the server MUST determine the currency based on the server default currency or on the client's account settings, which are agreed to by the client and server via an out-of-band channel. However, the <fee:currency> element MUST be present in the responses.

クライアントコマンドでの<fee:currency>要素の使用はオプションです。<fee:currency>要素がコマンドに存在しない場合、サーバーはサーバーのデフォルトの通貨またはクライアントのアカウント設定に基づいて通貨を決定する必要があります。帯域外チャネルを介してクライアントとサーバーが同意します。ただし、<fee:currency>要素は応答に存在する必要があります。

Servers SHOULD NOT perform a currency conversion if a client uses an incorrect currency code. Servers SHOULD return a 2004 "Parameter value range error" instead.

サーバーは、クライアントが誤った通貨コードを使用する場合、通貨変換を実行してはなりません(SHOULD NOT)。サーバーは2004年の「パラメータ値の範囲エラー」を返す必要があります。

3.3. Validity Periods
3.3. 有効期間

When querying for fee information using the <check> command, the <fee:period> element is used to indicate the validity period, which is to be added to extend the registration period of objects by the <create>, <renew>, and <transfer> commands. Validity periods are measured in years or months, with the appropriate units specified using the "unit" attribute. Valid values for the "unit" attribute are "y" for years and "m" for months. This element is derived from the <domain:period> element described in [RFC5731].

<check>コマンドを使用して料金情報を照会する場合、<fee:period>要素を使用して有効期間を示します。これは、<create>、<renew>、および<転送>コマンド。有効期間は年または月単位で測定され、「unit」属性を使用して適切な単位が指定されます。 「unit」属性の有効な値は、年は「y」、月は「m」です。この要素は、[RFC5731]で説明されている<domain:period>要素から派生しています。

The <fee:period> element is OPTIONAL in <check> commands; if omitted, the server MUST determine the fee(s) using the server default period. The <fee:period> element MUST be present in <check> responses.

<fee:period>要素は、<check>コマンドではオプションです。省略した場合、サーバーはサーバーのデフォルト期間を使用して料金を決定する必要があります。 <fee:period>要素は、<check>応答に存在する必要があります。

3.4. Fees and Credits
3.4. 料金とクレジット

Servers that implement this extension will include elements in responses that provide information about the fees and/or credits associated with a given billable transaction. A fee will result in subtracting from the Account Balance (described in Section 3.5), and a credit will result in adding to the Account Balance (described in Section 3.5).

この拡張機能を実装するサーバーは、特定の請求可能なトランザクションに関連付けられた手数料やクレジットに関する情報を提供する要素を応答に含めます。手数料はアカウント残高から差し引かれ(セクション3.5で説明)、クレジットはアカウント残高に追加されます(セクション3.5で説明)。

The <fee:fee> and <fee:credit> elements are used to provide this information. The presence of a <fee:fee> element in a response indicates a debit against the client's account balance; a <fee:credit> element indicates a credit. A <fee:fee> element MUST have a zero or greater (non-negative) value. A <fee:credit> element MUST have a negative value.

<fee:fee>および<fee:credit>要素は、この情報を提供するために使用されます。応答内の<fee:fee>要素の存在は、クライアントの口座残高に対する借方を示します。 <fee:credit>要素はクレジットを示します。 <fee:fee>要素には、ゼロ以上の(負でない)値が必要です。 <fee:credit>要素には負の値が必要です。

A server MAY respond with multiple <fee:fee> and <fee:credit> elements in the same response. In such cases, the net fee or credit applicable to the transaction is the arithmetic sum of the values of each of the <fee:fee> and/or <fee:credit> elements. This amount applies to the total additional validity period for the object (where applicable).

サーバーは、同じ応答で複数の<fee:fee>および<fee:credit>要素で応答する場合があります。このような場合、トランザクションに適用される正味料金またはクレジットは、<fee:fee>および/または<fee:credit>要素のそれぞれの値の算術合計です。この金額は、オブジェクトの追加の有効期間の合計に適用されます(該当する場合)。

The following attributes are defined for the <fee:fee> element. These are described in detail below:

<fee:fee>要素には、次の属性が定義されています。これらについては、以下で詳しく説明します。

description: an OPTIONAL attribute that provides a human-readable description of the fee. Servers should provide documentation on the possible values of this attribute and their meanings. An OPTIONAL "lang" attribute MAY be present, per the language structure in [RFC5646], to identify the language of the returned text and has a default value of "en" (English). If the "description" attribute is not present, the "lang" attribute can be ignored.

description:人が読める料金の説明を提供するOPTIONAL属性。サーバーは、この属性の可能な値とその意味に関するドキュメントを提供する必要があります。返されるテキストの言語を識別するために、[RFC5646]の言語構造に従って、オプションの "lang"属性が存在する場合があり、デフォルト値は "en"(英語)です。 「description」属性が存在しない場合、「lang」属性は無視できます。

refundable: an OPTIONAL boolean attribute indicating whether the fee is refundable if the object is deleted.

払い戻し可能:オブジェクトが削除された場合に料金が払い戻し可能かどうかを示すオプションのブール属性。

grace-period: an OPTIONAL attribute that provides the time period during which the fee is refundable.

grace-period:手数料が払い戻される期間を提供するOPTIONAL属性。

applied: an OPTIONAL attribute indicating when the fee will be deducted from the client's account.

適用:手数料がクライアントのアカウントからいつ差し引かれるかを示すOPTIONAL属性。

The <fee:credit> element can take a "description" attribute as described above. An OPTIONAL "lang" attribute MAY be present to identify the language of the returned text and has a default value of "en" (English).

<fee:credit>要素は、上記の「説明」属性を取ることができます。オプションの「lang」属性は、返されるテキストの言語を識別するために存在する場合があり、デフォルト値は「en」(英語)です。

3.4.1. Refunds
3.4.1. 払い戻し

<fee:fee> elements MAY have an OPTIONAL "refundable" attribute that takes a boolean value. Fees may be refunded under certain circumstances, such as when a domain application is rejected (as described in [RFC8334]) or when an object is deleted during the relevant grace period (see Section 3.4.2).

<fee:fee>要素には、ブール値を取るオプションの「払い戻し可能」属性が含まれる場合があります。ドメインアプリケーションが拒否された場合([RFC8334]に記載)や、関連する猶予期間中にオブジェクトが削除された場合(3.4.2項を参照)などの特定の状況では、料金が払い戻される場合があります。

If the "refundable" attribute is omitted, then clients SHOULD NOT make any assumptions about the refundability of the fee.

「払い戻し可能」属性が省略されている場合、クライアントは料金の払い戻し可能性についていかなる仮定も行わないでください。

3.4.2. Grace Periods
3.4.2. 猶予期間

[RFC3915] describes a system of "grace periods", which are time periods following a billable transaction during which, if an object is deleted, the client receives a refund.

[RFC3915]は、「猶予期間」のシステムについて説明しています。これは、オブジェクトが削除された場合にクライアントが払い戻しを受け取る請求可能なトランザクションに続く期間です。

The "grace-period" attribute MAY be used to indicate the relevant grace period for a fee. If a server implements the registry grace period extension [RFC3915], it MUST specify the grace period for all relevant transactions.

「猶予期間」属性は、手数料の関連する猶予期間を示すために使用される場合があります。サーバーがレジストリの猶予期間拡張[RFC3915]を実装する場合、すべての関連するトランザクションの猶予期間を指定する必要があります。

If the "grace-period" attribute is omitted, then clients SHOULD NOT make any assumptions about the grace period of the fee.

「猶予期間」属性が省略されている場合、クライアントは料金の猶予期間についていかなる仮定も行わないでください。

3.4.3. Correlation between Refundability and Grace Periods
3.4.3. 返金可能期間と猶予期間の相関関係

If a <fee:fee> element has a "grace-period" attribute, then it MUST also be refundable, and the "refundable" attribute MUST be true. If the "refundable" attribute of a <fee:fee> element is false, then it MUST NOT have a "grace-period" attribute.

<fee:fee>要素に「grace-period」属性がある場合は、それも払い戻し可能である必要があり、「refundable」属性がtrueである必要があります。 <fee:fee>要素の「refundable」属性がfalseの場合、「grace-period」属性を含めることはできません。

3.4.4. Applicability
3.4.4. 適用性

Fees may be applied immediately upon receipt of a command from a client or may only be applied once an out-of-band process (such as the processing of applications at the end of a launch phase) has taken place.

料金は、クライアントからのコマンドの受信時にすぐに適用される場合と、アウトオブバンドプロセス(起動フェーズの終了時のアプリケーションの処理など)が行われた場合にのみ適用される場合があります。

The "applied" attribute of the <fee:fee> element allows servers to indicate whether a fee will be applied immediately or whether it will be applied at some point in the future. This attribute takes two possible values: "immediate" or "delayed".

<fee:fee>要素の「applied」属性を使用すると、サーバーは料金をすぐに適用するか、将来のある時点で適用するかを指定できます。この属性は、「即時」または「遅延」の2つの可能な値を取ります。

3.5. Account Balance
3.5. 勘定残高

The <fee:balance> element is an OPTIONAL element that MAY be included in server responses to transform commands. If present, it can be used by the client to determine the remaining credit at the server.

<fee:balance>要素はOPTIONAL要素であり、変換コマンドへのサーバー応答に含めることができます(MAY)。存在する場合は、クライアントがサーバーでの残りのクレジットを決定するために使用できます。

Whether or not the <fee:balance> is included in responses is a matter of server policy. However, if a server chooses to offer support for this element, it MUST be included in responses to all "transform" or billable commands (e.g., <create>, <renew>, <update>, <delete>, <transfer op="request">).

<fee:balance>が応答に含まれるかどうかは、サーバーポリシーの問題です。ただし、サーバーがこの要素のサポートを提供することを選択した場合は、すべての「変換」または請求可能なコマンド(たとえば、<create>、<renew>、<update>、<delete>、<transfer op =)への応答に含める必要があります。 "リクエスト">)。

The value of the <fee:balance> MAY be negative. A negative balance indicates that the server has extended a line of credit to the client (see Section 3.6).

<fee:balance>の値は負の場合があります。負の残高は、サーバーがクライアントに信用枠を拡張したことを示します(セクション3.6を参照)。

If a server includes a <fee:balance> element in response to transform commands, the value of the element MUST reflect the client's account balance after any fees or credits associated with that command have been applied. If the "applied" attribute of the <fee:fee> element is "delayed", then the <fee:balance> MUST reflect the client's account balance without any fees or credits associated with that command.

変換コマンドに応答してサーバーに<fee:balance>要素が含まれる場合、そのコマンドに関連付けられた手数料またはクレジットが適用された後、要素の値はクライアントのアカウント残高を反映する必要があります。 <fee:fee>要素の「applied」属性が「delayed」の場合、<fee:balance>は、そのコマンドに関連付けられた手数料やクレジットなしでクライアントのアカウント残高を反映する必要があります。

3.6. Credit Limit
3.6. 与信限度

As described above, if a server returns a response containing a <fee:balance> with a negative value, then the server has extended a line of credit to the client. A server MAY also include in responses a <fee:creditLimit> element that indicates the maximum credit available to a client. A server MAY reject certain transactions if the absolute value of the <fee:balance> is equal to or exceeds the value of the <fee:creditLimit> element.

上記のように、サーバーが負の値を持つ<fee:balance>を含む応答を返す場合、サーバーはクライアントに信用枠を拡張しています。サーバーは、クライアントが利用できる最大のクレジットを示す<fee:creditLimit>要素もレスポンスに含めることができます。 <fee:balance>の絶対値が<fee:creditLimit>要素の値以上の場合、サーバーは特定のトランザクションを拒否してもよい(MAY)。

Whether or not the <fee:creditLimit> is included in responses is a matter of server policy. However, if a server chooses to offer support for this element, it MUST be included in responses to all "transform" commands (e.g., <create>, <renew>, <update>, <delete>, <transfer op="request">).

<fee:creditLimit>が応答に含まれるかどうかは、サーバーポリシーの問題です。ただし、サーバーがこの要素のサポートを提供する場合は、すべての「変換」コマンド(<create>、<renew>、<update>、<delete>、<transfer op = "request)への応答に含める必要があります。 ">)。

3.7. Classification of Objects
3.7. オブジェクトの分類

Objects may be assigned to a particular class, category, or tier, each of which has a particular fee or set of fees associated with it. The <fee:class> element, which MAY appear in <check> and transform responses, is used to indicate the classification of an object.

オブジェクトは、特定のクラス、カテゴリ、または階層に割り当てることができ、それぞれに特定の料金または一連の料金が関連付けられています。 <check>および変換応答に表示される場合がある<fee:class>要素は、オブジェクトの分類を示すために使用されます。

If a server makes use of this element, it should provide clients with a list of all the values that the element may take via an out-of-band channel. Servers MUST NOT use values that do not appear on this list.

サーバーがこの要素を使用する場合、要素が帯域外チャネルを介して取得できるすべての値のリストをクライアントに提供する必要があります。サーバーは、このリストにない値を使用してはなりません(MUST NOT)。

Servers that make use of this element MUST use a <fee:class> element with the value "standard" for all objects that are subject to the standard or default fee.

この要素を使用するサーバーは、標準またはデフォルトの料金の対象となるすべてのオブジェクトに対して、値が「standard」の<fee:class>要素を使用する必要があります。

3.8. "Phase" and "Subphase" Attributes
3.8. 「フェーズ」および「サブフェーズ」属性

The <fee:command> element has two attributes, "phase" and "subphase", that provide additional information related to a specific launch phase, as described in [RFC8334]. These attributes are used as filters that should refine the server processing.

<fee:command>要素には「フェーズ」と「サブフェーズ」という2つの属性があり、[RFC8334]で説明されているように、特定の起動フェーズに関連する追加情報を提供します。これらの属性は、サーバー処理を調整するフィルターとして使用されます。

If the client <fee:command> contains a server-supported combination of phase/subphase, the server MUST return the fee data (including the phase/subphase attribute(s)) for the specific combination.

クライアント<fee:command>にサーバーがサポートするフェーズ/サブフェーズの組み合わせが含まれている場合、サーバーは特定の組み合わせの料金データ(フェーズ/サブフェーズ属性を含む)を返さなければなりません(MUST)。

If the client <fee:command> contains no "phase"/"subphase" attributes and the server has only one active phase/subphase combination, the server MUST return the data (including the "phase"/"subphase" attribute(s)) of the currently active phase/subphase.

クライアントの<fee:command>に「フェーズ」/「サブフェーズ」属性が含まれておらず、サーバーにアクティブなフェーズ/サブフェーズの組み合わせが1つしかない場合、サーバーはデータを返す必要があります(「フェーズ」/「サブフェーズ」属性を含む) )現在アクティブなフェーズ/サブフェーズの。

If the client <fee:command> contains no phase/subphase attributes and the server has more than one active phase/subphase combination, the server MUST respond with a 2003 "Required parameter missing" error.

クライアント<fee:command>にフェーズ/サブフェーズ属性が含まれておらず、サーバーに複数のアクティブなフェーズ/サブフェーズの組み合わせがある場合、サーバーは2003の「必須パラメーターがありません」エラーで応答する必要があります。

If the client <fee:command> contains no phase/subphase attributes and the server is currently in a "quiet period" (e.g., not accepting registrations or applications), the server MUST return data consistent with the default general availability phase (e.g., "open" or "claims"), including the appropriate phase/subphase attribute(s).

クライアント<fee:command>にフェーズ/サブフェーズ属性が含まれておらず、サーバーが現在「休止期間」にある場合(たとえば、登録またはアプリケーションを受け入れない)、サーバーはデフォルトの一般可用性フェーズ(たとえば、 「オープン」または「クレーム」)、適切なフェーズ/サブフェーズ属性を含みます。

If the client <fee:command> contains a phase attribute with no subphase and the server has only one active subphase (or no subphase) of this phase, the server MUST return the data (including the phase/ subphase attribute(s)) of the provided phase and currently active subphase.

クライアント<fee:command>にサブフェーズのないフェーズ属性が含まれ、サーバーにこのフェーズのアクティブなサブフェーズが1つしかない(またはサブフェーズがない)場合、サーバーは(フェーズ/サブフェーズ属性を含む)データを返さなければなりません(MUST)。指定されたフェーズと現在アクティブなサブフェーズ。

If the client <fee:command> contains a phase attribute with no subphase and the server has more than one active subphase combination of this phase, the server MUST respond with a 2003 "Required parameter missing" error.

クライアント<fee:command>にサブフェーズのないフェーズ属性が含まれ、サーバーにこのフェーズのアクティブなサブフェーズの組み合わせが複数ある場合、サーバーは2003の「必須パラメーターがありません」エラーで応答する必要があります。

If the client <fee:command> contains a subphase with no phase attribute, the server MUST respond with a 2003 "Required parameter missing" error.

クライアント<fee:command>にフェーズ属性のないサブフェーズが含まれている場合、サーバーは2003の「必須パラメーターが見つかりません」エラーで応答する必要があります。

If the client <fee:command> contains a phase attribute not defined in [RFC8334] or not supported by the server, the server MUST respond with a 2004 "Parameter value range error".

クライアント<fee:command>に[RFC8334]で定義されていないか、サーバーでサポートされていないフェーズ属性が含まれている場合、サーバーは2004年の「パラメーター値の範囲エラー」で応答する必要があります。

If the client <fee:command> contains a subphase attribute (or phase/ subphase combination) not supported by the server, the server MUST respond with a 2004 "Parameter value range error".

クライアント<fee:command>にサーバーでサポートされていないサブフェーズ属性(またはフェーズ/サブフェーズの組み合わせ)が含まれている場合、サーバーは2004年の「パラメーター値の範囲エラー」で応答する必要があります。

3.9. Reason
3.9. 理由

The <fee:reason> element is used to provide server-specific text in an effort to better explain why a <check> command did not complete as the client expected. An OPTIONAL "lang" attribute MAY be present to identify the language, per the language structure in [RFC5646], of the returned text and has a default value of "en" (English).

<fee:reason>要素は、<check>コマンドがクライアントの期待どおりに完了しなかった理由をより詳しく説明するために、サーバー固有のテキストを提供するために使用されます。 [RFC5646]の言語構造に従って、返されるテキストの言語を識別するためのオプションの「lang」属性が存在してもよく、デフォルト値は「en」(英語)です。

The <fee:reason> element can be used within the server response <fee:command> element or within the <fee:cd> element. See Section 5.1.1 for details on the <fee:cd> "check data" element.

<fee:reason>要素は、サーバー応答<fee:command>要素内または<fee:cd>要素内で使用できます。 <fee:cd>の「データの確認」要素の詳細については、セクション5.1.1を参照してください。

If the server cannot calculate the relevant fees because the object, command, currency, period, class, or some combination is invalid per server policy, the server has two ways of handling the error processing of <fee:command> element(s):

オブジェクト、コマンド、通貨、期間、クラス、またはいくつかの組み合わせがサーバーポリシーごとに無効であるためにサーバーが関連する料金を計算できない場合、サーバーには<fee:command>要素のエラー処理を処理する2つの方法があります。

1. Fast-fail: The server, upon error identification, MAY stop processing <fee:command> elements and return a <fee:cd> to the client containing the <fee:objID> and a <fee:reason> element detailing the reason for failure.

1. Fast-fail:サーバーは、エラーが特定されると、<fee:command>要素の処理を停止し、<fee:objID>および<fee:reason>要素を含むクライアントに<fee:cd>の理由を詳細に返します。失敗。

          S: <fee:cd avail="0">
          S:   <fee:objID>example.xyz</fee:objID>
          S:   <fee:reason>Only 1 year registration periods are
          S:   valid.</fee:reason>
          S: </fee:cd>
        

2. Partial-fail: The server, upon error identification, MAY continue processing <fee:command> elements and return a <fee:cd> to the client containing the successfully processed <fee:command> elements and failed <fee:command> elements. All returned failed <fee:command> elements MUST have a <fee:reason> element detailing the reason for failure, and the server MAY additionally include a <fee:reason> element at the <fee:cd> level.

2. 部分的な失敗:サーバーは、エラーの識別時に、<fee:command>要素の処理を続行し、正常に処理された<fee:command>要素と失敗した<fee:command>要素を含む<fee:cd>をクライアントに返します。返されたすべての失敗した<fee:command>要素には、失敗の理由を詳述した<fee:reason>要素が必要です。サーバーは、<fee:cd>レベルで<fee:reason>要素を追加で含めることができます(MAY)。

          S: <fee:cd avail="0">
          S:   <fee:objID>example.xyz</fee:objID>
          S:   <fee:command name="create">
          S:     <fee:period unit="y">2</fee:period>
          S:     <fee:reason>Only 1 year registration periods are
          S:     valid.</fee:reason>
          S:   </fee:command>
          S: </fee:cd>
        

In either failure scenario, the server MUST set the <fee:cd> "avail" attribute to false (0), and the server MUST process all objects in the client request.

どちらの失敗シナリオでも、サーバーは<fee:cd>の "avail"属性をfalse(0)に設定する必要があり、サーバーはクライアント要求内のすべてのオブジェクトを処理する必要があります。

4. Server Handling of Fee Information
4. 料金情報のサーバー処理

Depending on the server policy, a client MAY be required to include the extension elements described in this document for certain transform commands. Servers must provide clear documentation to clients about the circumstances in which this extension must be used.

サーバーポリシーによっては、特定の変換コマンドについて、このドキュメントで説明されている拡張要素をクライアントに含める必要がある場合があります。サーバーは、この拡張機能を使用する必要がある状況について、クライアントに明確なドキュメントを提供する必要があります。

The server MUST return avail="0" in its response to a <check> command for any object in the <check> command that does not include the <fee:check> extension where the server would fail a domain <create> command when no <fee> extension is provided for that same object.

サーバーは、ドメインが<create>コマンドに失敗したときに<fee:check>拡張を含まない<check>コマンドのオブジェクトの<check>コマンドへの応答でavail = "0"を返す必要があります。同じオブジェクトに<fee>拡張は提供されません。

If a server receives a <check> command from a client that results in no possible fee combination, the server MUST set the "avail" attribute of the <fee:cd> element to false (0) and provide a <fee:reason>.

サーバーがクライアントから<check>コマンドを受け取り、料金の組み合わせが発生しない場合、サーバーは<fee:cd>要素の "avail"属性をfalse(0)に設定し、<fee:reason>を提供する必要があります。 。

If a server receives a <check> command from a client that results in an ambiguous result (i.e., multiple possible fee combinations), the server MUST reject the command with a 2003 "Required parameter missing" error.

サーバーがクライアントから<check>コマンドを受信して​​、あいまいな結果(つまり、複数の可能な料金の組み合わせ)になる場合、サーバーは2003の「必須パラメーターがありません」というエラーでコマンドを拒否する必要があります。

If a server receives a command from a client that does not include the fee extension data elements required by the server for that command, then the server MUST respond with a 2003 "Required parameter missing" error.

サーバーがそのコマンドにサーバーが必要とする料金拡張データ要素を含まないクライアントからのコマンドを受信した場合、サーバーは2003の「必須パラメーターがありません」エラーで応答する必要があります。

If the total fee provided by the client is less than the server's own calculation of the fee or the server determines the currency is inappropriate for that command, then the server MUST reject the command with a 2004 "Parameter value range error".

クライアントから提供された合計料金がサーバー自身の料金の計算より少ない場合、またはサーバーが通貨がそのコマンドに不適切であると判断した場合、サーバーは2004年の「パラメーター値の範囲エラー」でコマンドを拒否する必要があります。

5. EPP Command Mapping
5. EPPコマンドのマッピング

A detailed description of the EPP syntax and semantics can be found in [RFC5730].

EPPの構文とセマンティクスの詳細な説明は、[RFC5730]にあります。

5.1. EPP Query Commands
5.1. EPPクエリコマンド

This extension does not add any elements to the EPP <poll> or <info> commands or responses.

この拡張機能は、EPP <poll>または<info>コマンドまたは応答に要素を追加しません。

5.1.1. EPP <check> Command
5.1.1. EPP <check>コマンド

This extension defines a new command called the Fee Check Command that defines additional elements for the EPP <check> command to provide fee information.

この拡張機能は、料金情報を提供するEPP <check>コマンドの追加要素を定義する料金チェックコマンドと呼ばれる新しいコマンドを定義します。

The command MAY contain an <extension> element, which MAY contain a <fee:check> element. The <fee:check> element MAY contain one <fee:currency> element and MUST contain one or more <fee:command> elements.

コマンドには<extension>要素が含まれる場合があり、これには<fee:check>要素が含まれる場合があります。 <fee:check>要素は1つの<fee:currency>要素を含むことができ(MAY)、1つ以上の<fee:command>要素を含まなければなりません(MUST)。

The <fee:command> element(s) MUST contain a "name" attribute (see Section 3.1), an OPTIONAL "phase" attribute, and an OPTIONAL "subphase" attribute (see Section 3.8). The <fee:command> element(s) MAY have the following child elements:

<fee:command>要素には、「name」属性(セクション3.1を参照)、OPTIONAL「フェーズ」属性、およびOPTIONAL「サブフェーズ」属性(セクション3.8を参照)が含まれている必要があります。 <fee:command>要素には、次の子要素が含まれる場合があります。

* An OPTIONAL <fee:period> element (as described in Section 3.3).

* オプションの<fee:period>要素(セクション3.3で説明)。

Example <check> command:

<check>コマンドの例:

   C: <?xml version="1.0" encoding="utf-8" standalone="no"?>
   C: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   C:   <command>
   C:     <check>
   C:       <domain:check
   C:         xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
   C:         <domain:name>example.com</domain:name>
   C:         <domain:name>example.net</domain:name>
   C:         <domain:name>example.xyz</domain:name>
   C:       </domain:check>
   C:     </check>
   C:     <extension>
   C:       <fee:check xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0">
   C:         <fee:currency>USD</fee:currency>
   C:         <fee:command name="create">
   C:           <fee:period unit="y">2</fee:period>
   C:         </fee:command>
   C:         <fee:command name="renew"/>
   C:         <fee:command name="transfer"/>
   C:         <fee:command name="restore"/>
   C:       </fee:check>
   C:     </extension>
   C:     <clTRID>ABC-12345</clTRID>
   C:   </command>
   C: </epp>
        

When the server receives a <check> command that includes the extension elements described above, its response MUST contain an <extension> element, which MUST contain a child <fee:chkData> element. The <fee:chkData> element MUST contain a <fee:currency> element and a <fee:cd> element for each object referenced in the client <check> command.

サーバーが上記の拡張要素を含む<check>コマンドを受信すると、その応答には、子<fee:chkData>要素を含まなければならない<extension>要素が含まれている必要があります。 <fee:chkData>要素には、クライアントの<check>コマンドで参照される各オブジェクトの<fee:currency>要素と<fee:cd>要素が含まれている必要があります。

Each <fee:cd> (check data) element MUST contain the following child elements:

各<fee:cd>(データのチェック)要素には、次の子要素を含める必要があります。

* A <fee:objID> element, which MUST match an element referenced in the client <check> command.

* <fee:objID>要素。クライアントの<check>コマンドで参照される要素と一致する必要があります。

* An OPTIONAL <fee:class> element (as described in Section 3.7).

* オプションの<fee:class>要素(セクション3.7で説明)。

* A <fee:command> element matching each <fee:command> (unless the "avail" attribute of the <fee:cd> is false) that appeared in the corresponding <fee:check> of the client command. This element MAY have the OPTIONAL "standard" attribute, with a default value of "0" (or "false"), which indicates whether the fee is the standard or default fee (see Section 3.7). This element MAY have the OPTIONAL "phase" and "subphase" attributes, which will match the same attributes in the corresponding <fee:command> element of the client command if sent by the client.

* クライアントコマンドの対応する<fee:check>に表示された各<fee:command>に一致する<fee:command>要素(<fee:cd>の「avail」属性がfalseでない場合)。この要素はオプションの「標準」属性を持つことができ、デフォルト値は「0」(または「false」)で、料金が標準料金かデフォルト料金かを示します(セクション3.7を参照)。この要素は、オプションの「フェーズ」および「サブフェーズ」属性を持つことができます。これは、クライアントから送信された場合、クライアントコマンドの対応する<fee:command>要素の同じ属性と一致します。

The <fee:cd> element also has an OPTIONAL "avail" attribute, which is a boolean. If the value of this attribute evaluates to false, this indicates that the server cannot calculate the relevant fees because the object, command, currency, period, class, or some combination is invalid per server policy. If "avail" is false, then the <fee:cd> or the <fee:command> element MUST contain a <fee:reason> element (as described in Section 3.9), and the server MAY eliminate some or all of the <fee:command> element(s).

<fee:cd>要素には、ブール値であるOPTIONAL "avail"属性もあります。この属性の値がfalseと評価される場合、オブジェクト、コマンド、通貨、期間、クラス、または一部の組み合わせがサーバーポリシーごとに無効であるため、サーバーが関連する料金を計算できないことを示しています。 「avail」がfalseの場合、<fee:cd>または<fee:command>要素には<fee:reason>要素(3.9節で説明)が含まれている必要があり、サーバーは<の一部またはすべてを削除できます(MAY)。 fee:command>要素。

The <fee:command> element(s) MAY have the following child elements:

<fee:command>要素には、次の子要素が含まれる場合があります。

* An OPTIONAL <fee:period> element (as described in Section 3.3), which contains the same unit, if present, that appeared in the <fee:period> element of the command. If the value of the parent <fee:command> element is "restore", this element MUST NOT be included; otherwise, it MUST be included. If no <fee:period> appeared in the client command (and the command is not "restore"), then the server MUST return its default period value.

* オプションの<fee:period>要素(セクション3.3で説明)。これには、コマンドの<fee:period>要素に表示されたのと同じユニットが存在する場合は、それが含まれます。親の<fee:command>要素の値が「restore」の場合、この要素を含めることはできません。それ以外の場合は、含める必要があります。 <fee:period>がクライアントコマンドにない場合(およびコマンドが「復元」でない場合)、サーバーはデフォルトの期間値を返す必要があります。

* Zero or more <fee:fee> elements (as described in Section 3.4).

* ゼロ個以上の<fee:fee>要素(セクション3.4で説明)。

* Zero or more <fee:credit> elements (as described in Section 3.4).

* ゼロ個以上の<fee:credit>要素(セクション3.4で説明)。

* An OPTIONAL <fee:reason> element (as described in Section 3.9).

* オプションの<fee:reason>要素(3.9節で説明)。

If the "avail" attribute of the <fee:cd> element is true (1) and if no <fee:fee> elements are present in a <fee:command> element, this indicates that no fee will be assessed by the server for this command.

<fee:cd>要素の「avail」属性がtrue(1)で、<fee:fee>要素が<fee:command>要素に存在しない場合、これはサーバーによって料金が評価されないことを示しますこのコマンドの場合。

If the "avail" attribute of the <fee:cd> element is true (1), then the <fee:command> element MUST NOT contain a <fee:reason> element.

<fee:cd>要素の「avail」属性がtrue(1)の場合、<fee:command>要素に<fee:reason>要素を含めてはなりません(MUST NOT)。

Example <check> response:

<check>応答の例:

   S: <?xml version="1.0" encoding="utf-8" standalone="no"?>
   S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   S:   <response>
   S:     <result code="1000">
   S:       <msg>Command completed successfully</msg>
   S:     </result>
   S:     <resData>
   S:       <domain:chkData
   S:         xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
   S:         <domain:cd>
   S:           <domain:name avail="1">example.com</domain:name>
   S:         </domain:cd>
   S:         <domain:cd>
   S:           <domain:name avail="1">example.net</domain:name>
   S:         </domain:cd>
   S:         <domain:cd>
   S:           <domain:name avail="1">example.xyz</domain:name>
   S:         </domain:cd>
   S:       </domain:chkData>
   S:     </resData>
   S:     <extension>
   S:       <fee:chkData
   S:           xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0">
   S:         <fee:currency>USD</fee:currency>
   S:         <fee:cd avail="1">
   S:           <fee:objID>example.com</fee:objID>
   S:           <fee:class>Premium</fee:class>
   S:           <fee:command name="create">
   S:             <fee:period unit="y">2</fee:period>
   S:             <fee:fee
   S:               description="Registration Fee"
   S:               refundable="1"
   S:               grace-period="P5D">10.00</fee:fee>
   S:           </fee:command>
   S:           <fee:command name="renew">
   S:             <fee:period unit="y">1</fee:period>
   S:             <fee:fee
   S:               description="Renewal Fee"
   S:               refundable="1"
   S:               grace-period="P5D">10.00</fee:fee>
   S:           </fee:command>
   S:           <fee:command name="transfer">
   S:             <fee:period unit="y">1</fee:period>
   S:             <fee:fee
   S:               description="Transfer Fee"
   S:               refundable="1"
   S:               grace-period="P5D">10.00</fee:fee>
   S:           </fee:command>
   S:           <fee:command name="restore">
   S:             <fee:fee
   S:               description="Redemption Fee">15.00</fee:fee>
   S:           </fee:command>
   S:         </fee:cd>
   S:         <fee:cd avail="1">
   S:           <fee:objID>example.net</fee:objID>
   S:           <fee:class>standard</fee:class>
   S:           <fee:command name="create" standard="1">
   S:             <fee:period unit="y">2</fee:period>
   S:             <fee:fee
   S:               description="Registration Fee"
   S:               refundable="1"
   S:               grace-period="P5D">5.00</fee:fee>
   S:           </fee:command>
   S:           <fee:command name="renew" standard="1">
   S:             <fee:period unit="y">1</fee:period>
   S:             <fee:fee
   S:               description="Renewal Fee"
   S:               refundable="1"
   S:               grace-period="P5D">5.00</fee:fee>
   S:           </fee:command>
   S:           <fee:command name="transfer" standard="1">
   S:             <fee:period unit="y">1</fee:period>
   S:             <fee:fee
   S:               description="Transfer Fee"
   S:               refundable="1"
   S:               grace-period="P5D">5.00</fee:fee>
   S:           </fee:command>
   S:           <fee:command name="restore" standard="1">
   S:             <fee:fee
   S:               description="Redemption Fee">5.00</fee:fee>
   S:           </fee:command>
   S:         </fee:cd>
   S:         <fee:cd avail="0">
   S:           <fee:objID>example.xyz</fee:objID>
   S:           <fee:command name="create">
   S:             <fee:period unit="y">2</fee:period>
   S:             <fee:reason>Only 1 year registration periods are
   S:               valid.</fee:reason>
   S:           </fee:command>
   S:         </fee:cd>
   S:       </fee:chkData>
   S:     </extension>
   S:     <trID>
   S:       <clTRID>ABC-12345</clTRID>
   S:       <svTRID>54322-XYZ</svTRID>
   S:     </trID>
   S:   </response>
   S: </epp>
        
5.1.2. EPP Transfer Query Command
5.1.2. EPP転送クエリコマンド

This extension does not add any elements to the EPP <transfer> query command, but it does include elements in the response when the extension is included in the <login> command service extensions.

この拡張機能はEPP <転送>クエリコマンドに要素を追加しませんが、拡張機能が<login>コマンドサービス拡張に含まれている場合、応答に要素を含めます。

When the <transfer> query command has been processed successfully, if the client has included the extension in the <login> command service <svcExtension> element, and if the client is authorized by the server to view information about the transfer, then the server MAY include in the <extension> section of the EPP response a <fee:trnData> element, which contains the following child elements:

<transfer>クエリコマンドが正常に処理されたとき、クライアントが<login>コマンドサービスの<svcExtension>要素に拡張を含め、クライアントがサーバーに転送に関する情報を表示することを承認されている場合、サーバーはEPP応答の<extension>セクションに、次の子要素を含む<fee:trnData>要素を含めることができます。

* A <fee:currency> element (as described in Section 3.2).

* <fee:currency>要素(セクション3.2で説明)。

* A <fee:period> element (as described in Section 3.3).

* <fee:period>要素(セクション3.3で説明)。

* Zero or more <fee:fee> elements (as described in Section 3.4) containing the fees that will be charged to the gaining client.

* 獲得クライアントに請求される料金を含む0個以上の<fee:fee>要素(セクション3.4で説明)。

* Zero or more <fee:credit> elements (as described in Section 3.4) containing the credits that will be refunded to the losing client.

* 負けたクライアントに返金されるクレジットを含む0個以上の<fee:credit>要素(セクション3.4で説明)。

Servers SHOULD omit <fee:credit> when returning a response to the gaining client and omit <fee:fee> elements when returning a response to the losing client.

サーバーは、獲得するクライアントに応答を返すときに<fee:credit>を省略し、喪失するクライアントに応答を返すときに<fee:fee>要素を省略する必要があります(SHOULD)。

If no <fee:trnData> element is included in the response, then no fee will be assessed by the server for the transfer.

応答に<fee:trnData>要素が含まれていない場合、サーバーは転送に対して手数料を課しません。

Example <transfer> query response:

<転送>クエリ応答の例:

   S: <?xml version="1.0" encoding="utf-8" standalone="no"?>
   S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   S:   <response>
   S:     <result code="1001">
   S:       <msg>Command completed successfully; action pending</msg>
   S:     </result>
   S:     <resData>
   S:       <domain:trnData
   S:         xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
   S:         <domain:name>example.com</domain:name>
   S:         <domain:trStatus>pending</domain:trStatus>
   S:         <domain:reID>ClientX</domain:reID>
   S:         <domain:reDate>2019-06-08T22:00:00.0Z</domain:reDate>
   S:         <domain:acID>ClientY</domain:acID>
   S:         <domain:acDate>2019-06-13T22:00:00.0Z</domain:acDate>
   S:         <domain:exDate>2021-09-08T22:00:00.0Z</domain:exDate>
   S:       </domain:trnData>
   S:     </resData>
   S:     <extension>
   S:       <fee:trnData xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0">
   S:         <fee:currency>USD</fee:currency>
   S:         <fee:period unit="y">1</fee:period>
   S:         <fee:fee>5.00</fee:fee>
   S:       </fee:trnData>
   S:     </extension>
   S:     <trID>
   S:       <clTRID>ABC-12345</clTRID>
   S:       <svTRID>54322-XYZ</svTRID>
   S:     </trID>
   S:   </response>
   S: </epp>
        
5.2. EPP Transform Commands
5.2. EPP変換コマンド
5.2.1. EPP <create> Command
5.2.1. EPP <create>コマンド

This extension adds elements to both the EPP <create> command and response when the extension is included in the <login> command service extensions.

この拡張は、拡張が<login>コマンドサービス拡張に含まれている場合、EPP <create>コマンドと応答の両方に要素を追加します。

When submitting a <create> command to the server, the client MAY include in the <extension> element a <fee:create> element, which includes the following child elements:

<create>コマンドをサーバーに送信すると、クライアントは<extension>要素に<fee:create>要素を含めることができます。これには、次の子要素が含まれます。

* An OPTIONAL <fee:currency> element (as described in Section 3.2).

* オプションの<fee:currency>要素(セクション3.2で説明)。

* One or more <fee:fee> elements (as described in Section 3.4).

* 1つ以上の<fee:fee>要素(セクション3.4で説明)。

When the <create> command has been processed successfully, the client included the extension in the <login> command service extensions, and a fee was assessed by the server for the transaction, the server MUST include in the <extension> section of the EPP response a <fee:creData> element, which contains the following child elements:

<create>コマンドが正常に処理され、クライアントが<login>コマンドサービス拡張に拡張を含め、手数料がサーバーによってトランザクションに対して評価された場合、サーバーはEPPの<extension>セクションに含める必要があります次の子要素を含む<fee:creData>要素を応答します。

* A <fee:currency> element (as described in Section 3.2).

* <fee:currency>要素(セクション3.2で説明)。

* Zero or more <fee:fee> elements (as described in Section 3.4).

* ゼロ個以上の<fee:fee>要素(セクション3.4で説明)。

* Zero or more <fee:credit> elements (as described in Section 3.4).

* ゼロ個以上の<fee:credit>要素(セクション3.4で説明)。

* An OPTIONAL <fee:balance> element (as described in Section 3.5).

* オプションの<fee:balance>要素(セクション3.5で説明)。

* An OPTIONAL <fee:creditLimit> element (as described in Section 3.6).

* オプションの<fee:creditLimit>要素(セクション3.6で説明)。

Example <create> command:

<create>コマンドの例:

   C: <?xml version="1.0" encoding="utf-8" standalone="no"?>
   C: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   C:   <command>
   C:     <create>
   C:       <domain:create
   C:         xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
   C:         <domain:name>example.com</domain:name>
   C:         <domain:period unit="y">2</domain:period>
   C:         <domain:ns>
   C:           <domain:hostObj>ns1.example.net</domain:hostObj>
   C:           <domain:hostObj>ns2.example.net</domain:hostObj>
   C:         </domain:ns>
   C:         <domain:registrant>jd1234</domain:registrant>
   C:         <domain:contact type="admin">sh8013</domain:contact>
   C:         <domain:contact type="tech">sh8013</domain:contact>
   C:         <domain:authInfo>
   C:           <domain:pw>2fooBAR</domain:pw>
   C:         </domain:authInfo>
   C:       </domain:create>
   C:     </create>
   C:     <extension>
   C:       <fee:create xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0">
   C:         <fee:currency>USD</fee:currency>
   C:         <fee:fee>5.00</fee:fee>
   C:       </fee:create>
   C:     </extension>
   C:     <clTRID>ABC-12345</clTRID>
   C:   </command>
   C: </epp>
        

Example <create> response:

<create>応答の例:

   S: <?xml version="1.0" encoding="utf-8" standalone="no"?>
   S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   S:   <response>
   S:     <result code="1000">
   S:       <msg>Command completed successfully</msg>
   S:     </result>
   S:     <resData>
   S:       <domain:creData
   S:         xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
   S:         <domain:name>example.com</domain:name>
   S:         <domain:crDate>2019-04-03T22:00:00.0Z</domain:crDate>
   S:         <domain:exDate>2021-04-03T22:00:00.0Z</domain:exDate>
   S:       </domain:creData>
   S:     </resData>
   S:     <extension>
   S:       <fee:creData xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0">
   S:         <fee:currency>USD</fee:currency>
   S:         <fee:fee
   S:           description="Registration Fee"
   S:           lang="en"
   S:           refundable="1"
   S:           grace-period="P5D">5.00</fee:fee>
   S:         <fee:balance>-5.00</fee:balance>
   S:         <fee:creditLimit>1000.00</fee:creditLimit>
   S:       </fee:creData>
   S:     </extension>
   S:     <trID>
   S:       <clTRID>ABC-12345</clTRID>
   S:       <svTRID>54321-XYZ</svTRID>
   S:     </trID>
   S:   </response>
   S: </epp>
        
5.2.2. EPP <delete> Command
5.2.2. EPP <delete>コマンド

This extension does not add any elements to the EPP <delete> command, but it does include elements in the response when the extension is included in the <login> command service extensions.

この拡張機能はEPP <delete>コマンドに要素を追加しませんが、拡張機能が<login>コマンドサービス拡張に含まれている場合、応答に要素を含めます。

When the <delete> command has been processed successfully and the client included the extension in the <login> command service extensions, the server MAY include in the <extension> section of the EPP response a <fee:delData> element, which contains the following child elements:

<delete>コマンドが正常に処理され、クライアントが<login>コマンドサービス拡張に拡張を含めた場合、サーバーはEPP応答の<extension>セクションに、<fee:delData>要素を含めることができます。次の子要素:

* A <fee:currency> element (as described in Section 3.2).

* <fee:currency>要素(セクション3.2で説明)。

* Zero or more <fee:fee> elements (as described in Section 3.4).

* ゼロ個以上の<fee:fee>要素(セクション3.4で説明)。

* Zero or more <fee:credit> elements (as described in Section 3.4).

* ゼロ個以上の<fee:credit>要素(セクション3.4で説明)。

* An OPTIONAL <fee:balance> element (as described in Section 3.5).

* オプションの<fee:balance>要素(セクション3.5で説明)。

* An OPTIONAL <fee:creditLimit> element (as described in Section 3.6).

* オプションの<fee:creditLimit>要素(セクション3.6で説明)。

Example <delete> response:

<delete>応答の例:

   S: <?xml version="1.0" encoding="utf-8" standalone="no"?>
   S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   S:   <response>
   S:     <result code="1000">
   S:       <msg>Command completed successfully</msg>
   S:     </result>
   S:     <extension>
   S:       <fee:delData
   S:         xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0">
   S:         <fee:currency>USD</fee:currency>
   S:         <fee:credit
   S:           description="AGP Credit"
   S:           lang="en">-5.00</fee:credit>
   S:         <fee:balance>1005.00</fee:balance>
   S:       </fee:delData>
   S:     </extension>
   S:     <trID>
   S:       <clTRID>ABC-12345</clTRID>
   S:       <svTRID>54321-XYZ</svTRID>
   S:     </trID>
   S:   </response>
   S: </epp>
        
5.2.3. EPP <renew> Command
5.2.3. EPP <renew>コマンド

This extension adds elements to both the EPP <renew> command and response when the extension is included in the <login> command service extensions.

この拡張は、拡張が<login>コマンドサービス拡張に含まれている場合、EPP <renew>コマンドと応答の両方に要素を追加します。

When submitting a <renew> command to the server, the client MAY include in the <extension> element a <fee:renew> element, which includes the following child elements:

<renew>コマンドをサーバーに送信すると、クライアントは<extension>要素に<fee:renew>要素を含めることができます。これには、次の子要素が含まれます。

* An OPTIONAL <fee:currency> element (as described in Section 3.2).

* オプションの<fee:currency>要素(セクション3.2で説明)。

* One or more <fee:fee> elements (as described in Section 3.4).

* 1つ以上の<fee:fee>要素(セクション3.4で説明)。

When the <renew> command has been processed successfully and the client included the extension in the <login> command service extensions, the server MAY include in the <extension> section of the EPP response a <fee:renData> element, which contains the following child elements:

<renew>コマンドが正常に処理され、クライアントが<login>コマンドサービス拡張に拡張を含めた場合、サーバーはEPP応答の<extension>セクションに<fee:renData>要素を含めることができます。次の子要素:

* A <fee:currency> element (as described in Section 3.2).

* <fee:currency>要素(セクション3.2で説明)。

* Zero or more <fee:fee> elements (as described in Section 3.4).

* ゼロ個以上の<fee:fee>要素(セクション3.4で説明)。

* Zero or more <fee:credit> elements (as described in Section 3.4).

* ゼロ個以上の<fee:credit>要素(セクション3.4で説明)。

* An OPTIONAL <fee:balance> element (as described in Section 3.5).

* オプションの<fee:balance>要素(セクション3.5で説明)。

* An OPTIONAL <fee:creditLimit> element (as described in Section 3.6).

* オプションの<fee:creditLimit>要素(セクション3.6で説明)。

Example <renew> command:

<renew>コマンドの例:

   C: <?xml version="1.0" encoding="utf-8" standalone="no"?>
   C: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   C:   <command>
   C:     <renew>
   C:       <domain:renew
   C:         xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
   C:         <domain:name>example.com</domain:name>
   C:         <domain:curExpDate>2019-04-03</domain:curExpDate>
   C:         <domain:period unit="y">5</domain:period>
   C:       </domain:renew>
   C:     </renew>
   C:     <extension>
   C:       <fee:renew xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0">
   C:         <fee:currency>USD</fee:currency>
   C:         <fee:fee>5.00</fee:fee>
   C:       </fee:renew>
   C:     </extension>
   C:     <clTRID>ABC-12345</clTRID>
   C:   </command>
   C: </epp>
        

Example <renew> response:

<renew>応答の例:

   S: <?xml version="1.0" encoding="utf-8" standalone="no"?>
   S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   S:   <response>
   S:     <result code="1000">
   S:       <msg>Command completed successfully</msg>
   S:     </result>
   S:     <resData>
   S:       <domain:renData
   S:         xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
   S:         <domain:name>example.com</domain:name>
   S:         <domain:exDate>2024-04-03T22:00:00.0Z</domain:exDate>
   S:       </domain:renData>
   S:     </resData>
   S:     <extension>
   S:       <fee:renData xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0">
   S:         <fee:currency>USD</fee:currency>
   S:         <fee:fee
   S:           refundable="1"
   S:           grace-period="P5D">5.00</fee:fee>
   S:         <fee:balance>1000.00</fee:balance>
   S:       </fee:renData>
   S:     </extension>
   S:     <trID>
   S:       <clTRID>ABC-12345</clTRID>
   S:       <svTRID>54322-XYZ</svTRID>
   S:     </trID>
   S:   </response>
   S: </epp>
        
5.2.4. EPP <transfer> Command
5.2.4. EPP <転送>コマンド

This extension adds elements to both the EPP <transfer> command and response when the value of the "op" attribute of the <transfer> command element is "request" and the extension is included in the <login> command service extensions.

この拡張は、<transfer>コマンド要素の「op」属性の値が「request」であり、拡張が<login>コマンドサービス拡張に含まれている場合に、EPP <transfer>コマンドと応答の両方に要素を追加します。

When submitting a <transfer> command to the server, the client MAY include in the <extension> element a <fee:transfer> element, which includes the following child elements:

<transfer>コマンドをサーバーに送信すると、クライアントは<extension>要素に<fee:transfer>要素を含めることができます。これには、次の子要素が含まれます。

* An OPTIONAL <fee:currency> element (as described in Section 3.2).

* オプションの<fee:currency>要素(セクション3.2で説明)。

* One or more <fee:fee> elements (as described in Section 3.4).

* 1つ以上の<fee:fee>要素(セクション3.4で説明)。

When the <transfer> command has been processed successfully and the client included the extension in the <login> command service extensions, the server MAY include in the <extension> section of the EPP response a <fee:trnData> element, which contains the following child elements:

<transfer>コマンドが正常に処理され、クライアントが<login>コマンドサービス拡張に拡張を含めた場合、サーバーはEPP応答の<extension>セクションに<fee:trnData>要素を含めることができます。次の子要素:

* A <fee:currency> element (as described in Section 3.2).

* <fee:currency>要素(セクション3.2で説明)。

* Zero or more <fee:fee> elements (as described in Section 3.4).

* ゼロ個以上の<fee:fee>要素(セクション3.4で説明)。

* Zero or more <fee:credit> elements (as described in Section 3.4).

* ゼロ個以上の<fee:credit>要素(セクション3.4で説明)。

* An OPTIONAL <fee:balance> element (as described in Section 3.5).

* オプションの<fee:balance>要素(セクション3.5で説明)。

* An OPTIONAL <fee:creditLimit> element (as described in Section 3.6).

* オプションの<fee:creditLimit>要素(セクション3.6で説明)。

Example <transfer> command:

<転送>コマンドの例:

   C: <?xml version="1.0" encoding="utf-8" standalone="no"?>
   C: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   C:   <command>
   C:     <transfer op="request">
   C:       <domain:transfer
   C:         xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
   C:         <domain:name>example.com</domain:name>
   C:         <domain:period unit="y">1</domain:period>
   C:         <domain:authInfo>
   C:           <domain:pw roid="JD1234-REP">2fooBAR</domain:pw>
   C:         </domain:authInfo>
   C:       </domain:transfer>
   C:     </transfer>
   C:     <extension>
   C:      <fee:transfer xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0">
   C:        <fee:currency>USD</fee:currency>
   C:        <fee:fee>5.00</fee:fee>
   C:      </fee:transfer>
   C:     </extension>
   C:     <clTRID>ABC-12345</clTRID>
   C:   </command>
   C: </epp>
        

Example <transfer> response:

<転送>応答の例:

   S: <?xml version="1.0" encoding="utf-8" standalone="no"?>
   S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   S:   <response>
   S:     <result code="1001">
   S:       <msg>Command completed successfully; action pending</msg>
   S:     </result>
   S:     <resData>
   S:       <domain:trnData
   S:         xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
   S:         <domain:name>example.com</domain:name>
   S:         <domain:trStatus>pending</domain:trStatus>
   S:         <domain:reID>ClientX</domain:reID>
   S:         <domain:reDate>2019-06-08T22:00:00.0Z</domain:reDate>
   S:         <domain:acID>ClientY</domain:acID>
   S:         <domain:acDate>2019-06-13T22:00:00.0Z</domain:acDate>
   S:         <domain:exDate>2021-09-08T22:00:00.0Z</domain:exDate>
   S:       </domain:trnData>
   S:     </resData>
   S:     <extension>
   S:       <fee:trnData xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0">
   S:         <fee:currency>USD</fee:currency>
   S:         <fee:fee
   S:           refundable="1"
   S:           grace-period="P5D">5.00</fee:fee>
   S:       </fee:trnData>
   S:     </extension>
   S:     <trID>
   S:       <clTRID>ABC-12345</clTRID>
   S:       <svTRID>54322-XYZ</svTRID>
   S:     </trID>
   S:   </response>
   S: </epp>
        
5.2.5. EPP <update> Command
5.2.5. EPP <update>コマンド

This extension adds elements to both the EPP <update> command and response when the extension is included in the <login> command service extensions.

この拡張は、拡張が<login>コマンドサービス拡張に含まれている場合に、EPP <update>コマンドと応答の両方に要素を追加します。

When submitting an <update> command to the server, the client MAY include in the <extension> element a <fee:update> element, which includes the following child elements:

<update>コマンドをサーバーに送信すると、クライアントは<extension>要素に<fee:update>要素を含めることができます。これには、次の子要素が含まれます。

* An OPTIONAL <fee:currency> element (as described in Section 3.2).

* オプションの<fee:currency>要素(セクション3.2で説明)。

* One or more <fee:fee> elements (as described in Section 3.4).

* 1つ以上の<fee:fee>要素(セクション3.4で説明)。

When the <update> command has been processed successfully and the client included the extension in the <login> command service extensions, the server MAY include in the <extension> section of the EPP response a <fee:updData> element, which contains the following child elements:

<update>コマンドが正常に処理され、クライアントが<login>コマンドサービス拡張に拡張を含めた場合、サーバーはEPP応答の<extension>セクションに<fee:updData>要素を含めることができます。次の子要素:

* A <fee:currency> element (as described in Section 3.2).

* <fee:currency>要素(セクション3.2で説明)。

* Zero or more <fee:fee> elements (as described in Section 3.4).

* ゼロ個以上の<fee:fee>要素(セクション3.4で説明)。

* Zero or more <fee:credit> elements (as described in Section 3.4).

* ゼロ個以上の<fee:credit>要素(セクション3.4で説明)。

* An OPTIONAL <fee:balance> element (as described in Section 3.5).

* オプションの<fee:balance>要素(セクション3.5で説明)。

* An OPTIONAL <fee:creditLimit> element (as described in Section 3.6).

* オプションの<fee:creditLimit>要素(セクション3.6で説明)。

Example <update> command:

<update>コマンドの例:

   C: <?xml version="1.0" encoding="utf-8" standalone="no"?>
   C: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   C:   <command>
   C:     <update>
   C:       <domain:update
   C:         xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
   C:         <domain:name>example.com</domain:name>
   C:         <domain:chg>
   C:           <domain:registrant>sh8013</domain:registrant>
   C:         </domain:chg>
   C:       </domain:update>
   C:     </update>
   C:     <extension>
   C:       <fee:update xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0">
   C:         <fee:currency>USD</fee:currency>
   C:         <fee:fee>5.00</fee:fee>
   C:       </fee:update>
   C:     </extension>
   C:     <clTRID>ABC-12345</clTRID>
   C:   </command>
   C: </epp>
        

Example <update> response:

<update>応答の例:

   S: <?xml version="1.0" encoding="utf-8" standalone="no"?>
   S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   S:   <response>
   S:     <result code="1000">
   S:       <msg>Command completed successfully</msg>
   S:     </result>
   S:     <extension>
   S:       <fee:updData xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0">
   S:         <fee:currency>USD</fee:currency>
   S:         <fee:fee>5.00</fee:fee>
   S:       </fee:updData>
   S:     </extension>
   S:     <trID>
   S:       <clTRID>ABC-12345</clTRID>
   S:       <svTRID>54321-XYZ</svTRID>
   S:     </trID>
   S:   </response>
   S: </epp>
        
6. Formal Syntax
6. 正式な構文

One schema is presented here -- the EPP Fee Extension schema.

ここに1つのスキーマ、EPP Fee Extensionスキーマを示します。

The formal syntax presented here is a complete schema representation of the object mapping suitable for automated validation of EPP XML instances.

ここに示す正式な構文は、EPP XMLインスタンスの自動検証に適したオブジェクトマッピングの完全なスキーマ表現です。

6.1. Fee Extension Schema
6.1. 料金延長スキーマ

The formal syntax presented here is a complete schema representation [W3C.REC-xmlschema-1-20041028] of the object mapping suitable for automated validation of EPP XML instances. The <CODE BEGINS> and <CODE ENDS> tags are not part of the schema; they are used to note the beginning and end of the schema for URI registration purposes.

ここに示す正式な構文は、EPP XMLインスタンスの自動検証に適したオブジェクトマッピングの完全なスキーマ表現[W3C.REC-xmlschema-1-20041028]です。 <CODE BEGINS>および<CODE ENDS>タグはスキーマの一部ではありません。これらは、URI登録の目的でスキーマの最初と最後を示すために使用されます。

   <CODE BEGINS>
   <?xml version="1.0" encoding="utf-8"?>
   <schema xmlns="http://www.w3.org/2001/XMLSchema"
     xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0"
     xmlns:eppcom="urn:ietf:params:xml:ns:eppcom-1.0"
     xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"
     targetNamespace="urn:ietf:params:xml:ns:epp:fee-1.0"
     elementFormDefault="qualified">
        
     <import namespace="urn:ietf:params:xml:ns:eppcom-1.0" />
     <import namespace="urn:ietf:params:xml:ns:domain-1.0" />
        
     <annotation>
       <documentation>
         Extensible Provisioning Protocol v1.0 Fee Extension
       </documentation>
     </annotation>
        
     <!-- Child elements found in EPP commands and responses -->
     <element name="check" type="fee:checkType" />
     <element name="chkData" type="fee:chkDataType" />
     <element name="create" type="fee:transformCommandType" />
     <element name="creData" type="fee:transformResultType" />
     <element name="renew" type="fee:transformCommandType" />
     <element name="renData" type="fee:transformResultType" />
     <element name="transfer" type="fee:transformCommandType" />
     <element name="trnData" type="fee:transformResultType" />
     <element name="update" type="fee:transformCommandType" />
     <element name="updData" type="fee:transformResultType" />
     <element name="delData" type="fee:transformResultType" />
        
     <!-- client <check> command -->
     <complexType name="checkType">
       <sequence>
         <element name="currency" type="fee:currencyType"
           minOccurs="0" />
         <element name="command" type="fee:commandType"
           minOccurs="1" maxOccurs="unbounded" />
       </sequence>
     </complexType>
        
     <complexType name="objectIdentifierType">
       <simpleContent>
         <extension base="eppcom:labelType">
           <attribute name="element"
           type="NMTOKEN" default="name" />
         </extension>
       </simpleContent>
     </complexType>
        
     <!-- server <check> result -->
     <complexType name="chkDataType">
       <sequence>
         <element name="currency" type="fee:currencyType" />
         <element name="cd" type="fee:objectCDType"
           maxOccurs="unbounded" />
       </sequence>
     </complexType>
        
     <complexType name="objectCDType">
       <sequence>
         <element name="objID" type="fee:objectIdentifierType" />
         <element name="class" type="token" minOccurs="0" />
         <element name="command" type="fee:commandDataType"
           minOccurs="0" maxOccurs="unbounded" />
         <element name="reason" type="fee:reasonType" minOccurs="0" />
       </sequence>
       <attribute name="avail" type="boolean" default="1" />
     </complexType>
        
     <!-- general transform (create, renew, update, transfer) command-->
     <complexType name="transformCommandType">
       <sequence>
         <element name="currency" type="fee:currencyType"
           minOccurs="0" />
         <element name="fee" type="fee:feeType"
           maxOccurs="unbounded" />
         <element name="credit" type="fee:creditType"
           minOccurs="0" maxOccurs="unbounded" />
       </sequence>
     </complexType>
        
     <!-- general transform (create, renew, update) result -->
     <complexType name="transformResultType">
       <sequence>
         <element name="currency" type="fee:currencyType"
           minOccurs="0" />
         <element name="period" type="domain:periodType"
           minOccurs="0" />
         <element name="fee" type="fee:feeType"
           minOccurs="0" maxOccurs="unbounded" />
         <element name="credit" type="fee:creditType"
           minOccurs="0" maxOccurs="unbounded" />
         <element name="balance" type="fee:balanceType"
           minOccurs="0" />
         <element name="creditLimit" type="fee:creditLimitType"
           minOccurs="0" />
       </sequence>
     </complexType>
        
     <!-- common types -->
     <simpleType name="currencyType">
       <restriction base="string">
         <pattern value="[A-Z]{3}" />
       </restriction>
     </simpleType>
        
     <complexType name="commandType">
       <sequence>
         <element name="period" type="domain:periodType"
           minOccurs="0" maxOccurs="1" />
       </sequence>
       <attribute name="name" type="fee:commandEnum" use="required"/>
       <attribute name="customName" type="token"/>
       <attribute name="phase" type="token" />
       <attribute name="subphase" type="token" />
     </complexType>
        
     <complexType name="commandDataType">
       <complexContent>
         <extension base="fee:commandType">
           <sequence>
             <element name="fee" type="fee:feeType"
               minOccurs="0" maxOccurs="unbounded" />
             <element name="credit" type="fee:creditType"
               minOccurs="0" maxOccurs="unbounded" />
             <element name="reason" type="fee:reasonType"
               minOccurs="0" />
           </sequence>
           <attribute name="standard" type="boolean" default="0" />
         </extension>
       </complexContent>
     </complexType>
        
     <complexType name="reasonType">
       <simpleContent>
         <extension base="token">
           <attribute name="lang" type="language" default="en"/>
         </extension>
       </simpleContent>
     </complexType>
        
     <simpleType name="commandEnum">
       <restriction base="token">
         <enumeration value="create"/>
         <enumeration value="delete"/>
         <enumeration value="renew"/>
         <enumeration value="update"/>
         <enumeration value="transfer"/>
         <enumeration value="restore"/>
         <enumeration value="custom"/>
       </restriction>
     </simpleType>
        
     <simpleType name="nonNegativeDecimal">
       <restriction base="decimal">
         <minInclusive value="0" />
       </restriction>
     </simpleType>
        
     <simpleType name="negativeDecimal">
       <restriction base="decimal">
         <maxInclusive value="0" />
       </restriction>
     </simpleType>
        
     <complexType name="feeType">
       <simpleContent>
         <extension base="fee:nonNegativeDecimal">
           <attribute name="description"/>
           <attribute name="lang" type="language" default="en"/>
           <attribute name="refundable" type="boolean" />
           <attribute name="grace-period" type="duration" />
           <attribute name="applied">
             <simpleType>
               <restriction base="token">
                 <enumeration value="immediate" />
                 <enumeration value="delayed" />
               </restriction>
             </simpleType>
           </attribute>
         </extension>
       </simpleContent>
     </complexType>
        
     <complexType name="creditType">
       <simpleContent>
         <extension base="fee:negativeDecimal">
           <attribute name="description"/>
           <attribute name="lang" type="language" default="en"/>
         </extension>
       </simpleContent>
     </complexType>
        
     <simpleType name="balanceType">
       <restriction base="decimal" />
     </simpleType>
        
     <simpleType name="creditLimitType">
       <restriction base="decimal" />
     </simpleType>
        
   </schema>
   <CODE ENDS>
        
7. Security Considerations
7. セキュリティに関する考慮事項

The mapping extensions described in this document do not provide any security services beyond those described by the EPP [RFC5730], the EPP domain name mapping [RFC5731], and the protocol layers used by the EPP. The security considerations described in these other specifications apply to this specification as well. This extension passes financial information using the EPP protocol, so confidentiality and integrity protection must be provided by the transport mechanism. All transports compliant with [RFC5730] provide the needed level of confidentiality and integrity protections. The server will only provide information, including financial information, that is relevant to the authenticated client.

このドキュメントで説明されているマッピング拡張機能は、EPP [RFC5730]、EPPドメイン名マッピング[RFC5731]、およびEPPで使用されるプロトコルレイヤーで説明されているものを超えるセキュリティサービスを提供しません。これらの他の仕様で説明されているセキュリティの考慮事項は、この仕様にも適用されます。この拡張機能はEPPプロトコルを使用して財務情報を渡すため、トランスポートメカニズムによって機密性と整合性を保護する必要があります。 [RFC5730]に準拠するすべてのトランスポートは、必要なレベルの機密性と完全性の保護を提供します。サーバーは、認証されたクライアントに関連する財務情報を含む情報のみを提供します。

8. IANA Considerations
8. IANAに関する考慮事項
8.1. XML Namespace
8.1. XML名前空間

This document uses URNs to describe XML namespaces and XML schemas conforming to a registry mechanism described in [RFC3688].

このドキュメントでは、URNを使用して、[RFC3688]で説明されているレジストリメカニズムに準拠するXML名前空間とXMLスキーマについて説明します。

Registration request for the fee namespace:

料金名前空間の登録リクエスト:

   URI: urn:ietf:params:xml:ns:epp:fee-1.0
        

Registrant Contact: IESG

登録者の連絡先:IESG

XML: None. Namespace URIs do not represent an XML specification.

XML:なし。名前空間URIはXML仕様を表していません。

Registration request for the fee schema:

料金スキーマの登録リクエスト:

   URI: urn:ietf:params:xml:schema:epp:fee-1.0
        

Registrant Contact: IESG

登録者の連絡先:IESG

XML: See Section 6 of this document.

XML:このドキュメントのセクション6を参照してください。

8.2. EPP Extension Registry
8.2. EPP拡張レジストリ

The EPP extension described in this document has been registered by IANA in the "Extensions for the Extensible Provisioning Protocol (EPP)" registry described in [RFC7451]. The details of the registration are as follows:

このドキュメントで説明されているEPP拡張機能は、[RFC7451]で説明されている "Extensions for the Extensible Provisioning Protocol(EPP)"レジストリにIANAによって登録されています。登録内容は以下のとおりです。

Name of Extension: Registry Fee Extension for the Extensible Provisioning Protocol (EPP)

拡張機能の名前:Extensible Provisioning Protocol(EPP)のレジストリ料金拡張機能

Document status: Standards Track

ドキュメントのステータス:標準化過程

Reference: RFC 8748

リファレンス:RFC 8748

   Registrant Name and Email Address: IESG <iesg@ietf.org>
        

TLDs: Any

TLD:任意

IPR Disclosure: None

IPR開示:なし

Status: Active

ステータス:アクティブ

Notes: None

注:なし

9. References
9. 参考文献
9.1. Normative References
9.1. 引用文献

[ISO4217_2015] ISO, "Codes for the representation of currencies", ISO 4217:2015, August 2015, <https://www.iso.org/standard/64758.html>.

[ISO4217_2015] ISO、「通貨を表すためのコード」、ISO 4217:2015、2015年8月、<https://www.iso.org/standard/64758.html>。

[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, <https://www.rfc-editor.org/info/rfc2119>.

[RFC2119] Bradner、S。、「要件レベルを示すためにRFCで使用するキーワード」、BCP 14、RFC 2119、DOI 10.17487 / RFC2119、1997年3月、<https://www.rfc-editor.org/info/ rfc2119>。

[RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, DOI 10.17487/RFC3688, January 2004, <https://www.rfc-editor.org/info/rfc3688>.

[RFC3688] Mealling、M。、「The IETF XML Registry」、BCP 81、RFC 3688、DOI 10.17487 / RFC3688、2004年1月、<https://www.rfc-editor.org/info/rfc3688>。

[RFC3915] Hollenbeck, S., "Domain Registry Grace Period Mapping for the Extensible Provisioning Protocol (EPP)", RFC 3915, DOI 10.17487/RFC3915, September 2004, <https://www.rfc-editor.org/info/rfc3915>.

[RFC3915] Hollenbeck、S。、「Extensible Provisioning Protocol(EPP)のドメインレジストリ猶予期間マッピング」、RFC 3915、DOI 10.17487 / RFC3915、2004年9月、<https://www.rfc-editor.org/info/ rfc3915>。

[RFC5646] Phillips, A., Ed. and M. Davis, Ed., "Tags for Identifying Languages", BCP 47, RFC 5646, DOI 10.17487/RFC5646, September 2009, <https://www.rfc-editor.org/info/rfc5646>.

[RFC5646]フィリップス、A。、エド。 M.デイビス編、「言語を識別するためのタグ」、BCP 47、RFC 5646、DOI 10.17487 / RFC5646、2009年9月、<https://www.rfc-editor.org/info/rfc5646>。

[RFC5730] Hollenbeck, S., "Extensible Provisioning Protocol (EPP)", STD 69, RFC 5730, DOI 10.17487/RFC5730, August 2009, <https://www.rfc-editor.org/info/rfc5730>.

[RFC5730] Hollenbeck、S。、「Extensible Provisioning Protocol(EPP)」、STD 69、RFC 5730、DOI 10.17487 / RFC5730、2009年8月、<https://www.rfc-editor.org/info/rfc5730>。

[RFC5731] Hollenbeck, S., "Extensible Provisioning Protocol (EPP) Domain Name Mapping", STD 69, RFC 5731, DOI 10.17487/RFC5731, August 2009, <https://www.rfc-editor.org/info/rfc5731>.

[RFC5731] Hollenbeck、S。、「Extensible Provisioning Protocol(EPP)Domain Name Mapping」、STD 69、RFC 5731、DOI 10.17487 / RFC5731、2009年8月、<https://www.rfc-editor.org/info/rfc5731 >。

[RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, May 2017, <https://www.rfc-editor.org/info/rfc8174>.

[RFC8174] Leiba、B。、「RFC 2119キーワードの大文字と小文字のあいまいさ」、BCP 14、RFC 8174、DOI 10.17487 / RFC8174、2017年5月、<https://www.rfc-editor.org/info/ rfc8174>。

[RFC8334] Gould, J., Tan, W., and G. Brown, "Launch Phase Mapping for the Extensible Provisioning Protocol (EPP)", RFC 8334, DOI 10.17487/RFC8334, March 2018, <https://www.rfc-editor.org/info/rfc8334>.

[RFC8334] Gould、J.、Tan、W。、およびG. Brown、「Launch Phase Mapping for the Extensible Provisioning Protocol(EPP)」、RFC 8334、DOI 10.17487 / RFC8334、2018年3月、<https:// www。 rfc-editor.org/info/rfc8334>。

[W3C.REC-xmlschema-1-20041028] Thompson, H., Beech, D., Maloney, M., and N. Mendelsohn, "XML Schema Part 1: Structures Second Edition", World Wide Web Consortium Recommendation REC-xmlschema-1-20041028, October 2004, <http://www.w3.org/TR/2004/REC-xmlschema-1-20041028>.

[W3C.REC-xmlschema-1-20041028] Thompson、H.、Beech、D.、Maloney、M。、およびN. Mendelsohn、「XML Schema Part 1:Structures Second Edition」、World Wide Web Consortium Recommendation REC-xmlschema -1-20041028、2004年10月、<http://www.w3.org/TR/2004/REC-xmlschema-1-20041028>。

9.2. Informative References
9.2. 参考引用

[RFC7451] Hollenbeck, S., "Extension Registry for the Extensible Provisioning Protocol", RFC 7451, DOI 10.17487/RFC7451, February 2015, <https://www.rfc-editor.org/info/rfc7451>.

[RFC7451] Hollenbeck、S。、「Extensible Registry for the Extensible Provisioning Protocol」、RFC 7451、DOI 10.17487 / RFC7451、2015年2月、<https://www.rfc-editor.org/info/rfc7451>。

Acknowledgements

謝辞

The authors wish to thank the following persons for their feedback and suggestions:

著者はフィードバックと提案をしてくれた以下の人たちに感謝したい。

* James Gould of Verisign Inc. * Luis Munoz of ISC * Michael Young * Ben Levac * Jeff Eckhaus * Seth Goldman of Google * Klaus Malorny and Michael Bauland of Knipp * Jody Kolker, Joe Snitker, and Kevin Allendorf of GoDaddy * Michael Holloway of Com Laude * Santosh Kalsangrah of Impetus Infotech * Alex Mayrhofer of Nic.at * Thomas Corte of Knipp Medien und Kommunikation GmbH

* Verisign Inc.のJames Gould * ISCのLuis Munoz * Michael Young * Ben Levac * Jeff Eckhaus * GoogleのSeth Goldman * KnippのKlaus MalornyおよびMichael Bauland * GoDaddyのJody Kolker、Joe Snitker、およびGoDaddyのKevin Allendorf * ComのMichael Holloway Laude * Impetus InfotechのSantosh Kalsangrah * Nic.atのAlex Mayrhofer * Knipp Medien und Kommunikation GmbHのThomas Corte

Authors' Addresses

著者のアドレス

Roger Carney GoDaddy Inc. 14455 N. Hayden Rd. #219 Scottsdale, AZ 85260 United States of America

ロジャーカーニーGoDaddy Inc. 14455 N. Hayden Rd。 #219スコッツデール、アリゾナ州85260アメリカ合衆国

   Email: rcarney@godaddy.com
   URI:   http://www.godaddy.com
        

Gavin Brown CentralNic Group plc 35-39 Moorgate London EC2R 6AR United Kingdom

Gavin Brown CentralNic Group plc 35-39 Moorgate London EC2R 6ARイギリス

   Phone: +44 20 33 88 0600
   Email: gavin.brown@centralnic.com
   URI:   http://www.centralnic.com
        

Jothan Frakes

ジョサン・フレークス

   Email: jothan@jothan.com
   URI:   http://jothan.com