本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
常见参数
以下列表包含所有操作用于使用查询字符串对 Signature Version 4 请求进行签名的参数。任何特定于操作的参数都列在该操作的主题中。有关签名版本 4 的更多信息,请参阅 I AM 用户指南中的签署 AWS API 请求。
- Action
-
要执行的操作。
类型:字符串。
必需:是
- Version
-
编写请求所针对的 API 版本,格式为 YYYY-MM-DD。
类型:字符串。
必需:是
- X-Amz-Algorithm
-
您用于创建请求签名的哈希算法。
条件:当您在查询字符串中而不是 HTTP 授权标头中包括身份验证信息时,请指定此参数。
类型:字符串
有效值:
AWS4-HMAC-SHA256
必需:条件
- X-Amz-Credential
-
凭证范围值,该值是一个字符串,其中包含您的访问密钥、日期、您要定位的区域、您请求的服务以及终止字符串(“aws4_request”)。值采用以下格式表示:access_key/YYYYMMDD/region/service/aws4_request。
有关更多信息,请参阅 I AM 用户指南中的创建已签名的 AWS API 请求。
条件:当您在查询字符串中而不是 HTTP 授权标头中包括身份验证信息时,请指定此参数。
类型:字符串
必需:条件
- X-Amz-Date
-
用于创建签名的日期。格式必须为 ISO 8601 基本格式 (YYYYMMDD'T'HHMMSS'Z')。例如,以下日期时间是有效的 X-Amz-Date 值:
20120325T120000Z
。条件:X-Amz-Date 对于所有请求都是可选的;它可以用于覆盖对请求签名所使用的日期。如果以 ISO 8601 基本格式指定 Date 标头,则不需要 X-Amz-Date。使用 X-Amz-Date 时,它始终会覆盖 Date 标头的值。有关更多信息,请参阅 I AM 用户指南中的 AWS API 请求签名元素。
类型:字符串
必需:条件
- X-Amz-Security-Token
-
通过调用 AWS Security Token Service (AWS STS)获得的临时安全令牌。有关支持来自 AWS STS的临时安全凭证的服务列表,请参阅《IAM 用户指南》中的使用 IAM 的AWS 服务。
条件:如果您使用来自的临时安全凭证 AWS STS,则必须包含安全令牌。
类型:字符串
必需:条件
- X-Amz-Signature
-
指定从要签名的字符串和派生的签名密钥计算的十六进制编码签名。
条件:当您在查询字符串中而不是 HTTP 授权标头中包括身份验证信息时,请指定此参数。
类型:字符串
必需:条件
- X-Amz-SignedHeaders
-
指定作为规范请求的一部分包含的所有 HTTP 标头。有关指定签名标头的更多信息,请参阅 I AM 用户指南中的创建已签名的 AWS API 请求。
条件:当您在查询字符串中而不是 HTTP 授权标头中包括身份验证信息时,请指定此参数。
类型:字符串
必需:条件