

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# REST リクエスト
<a name="api-requests-rest-overview"></a>

Amazon Route 53 REST リクエストは、[RFC 2616 で定義されている HTTPS ](https://www.ietf.org/rfc/rfc2616.txt)リクエストです。このセクションでは、Route 53 REST リクエストの構造について説明します。

一般的な REST アクションは、単一の HTTPS リクエストを Route 53 に送信し、レスポンスを待つことで構成されます。HTTP リクエストと同様に、Route 53 への REST リクエストには、リクエストメソッド、URI、リクエストヘッダー、場合によってはクエリ文字列またはリクエスト本文が含まれます。レスポンスには HTTP ステータスコードとレスポンスヘッダーが含まれており、レスポンス本文が含まれている場合もあります。

## リクエストの URI
<a name="api-requests-rest-uri"></a>

リクエスト URI は常にスラッシュで始まり、使用する Route 53 API のバージョン (2013-04-01 など) が続きます。URI の残りは、実行の対象である特定のリソースを示します。たとえば、新しいホストゾーンを作成するときに使用する URI を次に示します。(詳細については、「[CreateHostedZone](https://docs.aws.amazon.com/Route53/latest/APIReference/API_CreateHostedZone.html)」を参照してください。)

```
1. /2013-04-01/hostedzone
```

## リクエストタイムスタンプについて
<a name="api-requests-rest-time-stamp"></a>

タイムスタンプは HTTP `Date`ヘッダーまたは AWS `x-amz-date` ヘッダーで指定する必要があります (一部の HTTP クライアントライブラリでは `Date`ヘッダーを設定できません）。`x-amz-date` ヘッダーがある場合、リクエストの認証時に `Date` ヘッダーは無視されます。

タイムスタンプは、リクエストが受信された AWS システム時刻から 5 分以内である必要があります。これ以外の場合、リクエストは失敗し、`RequestExpired` というエラーコードが出力されます。この目的は、相手がリクエストを繰り返すことを防止することです。

日付は、 など、ISO 8601 形式で指定する必要があります`2016-03-03T19:20:25.177Z`。ISO 8601 形式の詳細については、Wikipedia の記事「[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)」を参照してください。

## リクエスト本文
<a name="api-requests-rest-body"></a>

Route 53 API アクションの多くは、リクエストの本文に XML を含める必要があります。XML は Route 53 スキーマに準拠しています。

**Example リクエストの例**  
次のリクエスト例では、シンプルな XML ステートメントを使用して、参照識別子 *myUniqueIdentifier* を使用して example.com という名前のホストゾーンを作成します。  
リクエストの XML 要素は、リストされた順序で表示する必要があります。  

```
 1. POST /2013-04-01/hostedzone HTTP/1.1
 2. host:route53.amazonaws.com
 3. x-amz-date:{{date and time of the request}}
 4. authorization:AWS4-HMAC-SHA256
 5.               Credential=AKIAIOSFODNN7EXAMPLE/{{date of the request in yyyymmdd format}}/us-east-1/route53domains/aws4_request,
 6.               SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
 7.               Signature={{computed signature}}
 8. {{[Other required headers]}}
 9. 		
10. <?xml version="1.0" encoding="UTF-8"?>
11. <CreateHostedZoneRequest xmlns="https://route53.amazonaws.com/
12. doc/2013-04-01/">
13.    <Name>{{example.com.}}</Name>
14.    <CallerReference>{{myUniqueIdentifier}}</CallerReference>
15.    <HostedZoneConfig>
16.       <Comment>{{This is my hosted zone.}}</Comment>
17.    </HostedZoneConfig>
18. </CreateHostedZoneRequest>
```