View a markdown version of this page

REST 請求 - Amazon Route 53
請求 URI關於請求時間戳記請求主體

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

REST 請求

Amazon Route 53 REST 請求是 HTTPS 請求，如 RFC 2616 所定義。本節說明 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 結構描述。

範例範例請求

下列範例請求使用簡單的 XML 陳述式來建立名為 example.com 的託管區域，其中包含參考識別碼 myUniqueIdentifier。

請求中的 XML 元素必須依列出的順序顯示。

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>