View a markdown version of this page

REST 请求 - Amazon Route 53
请求 URI关于请求时间戳请求正文

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

REST 请求

根据 RFC 2616 的定义，亚马逊 Route 53 R EST 请求是 HTTPS 请求。本节介绍了 Route 53 的 REST 请求的结构。

典型的 REST 操作包括向 Route 53 发送一个 HTTPS 请求并等待响应。与任何 HTTP 请求一样，对 Route 53 的 REST 请求包含请求方法、URI、请求标头，有时还包含查询字符串或请求正文。响应包含 HTTP 状态码、响应标题，有时候包含响应主体。

请求 URI

请求 URI 始终以正斜杠开头，然后是您使用的 Route 53 API 的版本（例如 2013-04-01）。URI 的余项表示您希望起作用的特定资源。例如，以下是您在创建新的托管区域时使用的 URI。（有关更多信息，请参阅 CreateHostedZone。）

/2013-04-01/hostedzone

关于请求时间戳

您必须在 HTTP Date 标头或标头中提供时间戳（某些 HTTP 客户端库不允许您设置标Date头）。 AWS x-amz-date当 x-amz-date 标头呈现时，系统在验证请求身份时会忽略任何 Date 标头。

时间戳必须在收到请求的 AWS 系统时间的 5 分钟以内。如果不在，请求失败，出现RequestExpired错误代码。这是为了防止对手重播您的请求。

例如，必须以 ISO 8601 格式指定日期。2016-03-03T19:20:25.177Z有关 ISO 8601 格式的更多信息，请参阅维基百科文章 ISO 8601。

请求正文

许多 Route 53 API 操作都要求您在请求正文中包含 XML。XML 符合 Route 53 架构。

例请求示例

以下示例请求使用简单的 XML 语句创建名为 example.com 的托管区域，其参考标识符为 my。UniqueIdentifier

请求中的 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>