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

# REST 請求
<a name="api-requests-rest-overview"></a>

Amazon Route 53 REST 請求是 HTTPS 請求，如 [RFC 2616 ](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 陳述式來建立名為 example.com 的託管區域，其中包含參考識別碼 *myUniqueIdentifier*。  
請求中的 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>
```