REST リクエスト

Amazon Route 53 REST リクエストは、RFC 2616 で定義されている HTTPS リクエストです。このセクションでは、Route 53 REST リクエストの構造について説明します。

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

リクエストの URI

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

/2013-04-01/hostedzone

リクエストタイムスタンプについて

タイムスタンプは 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」を参照してください。

リクエスト本文

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

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