常见参数 - AWS Transfer Family

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

常见参数

以下列表包含所有操作用于使用查询字符串对 Signature Version 4 请求进行签名的参数。任何特定于操作的参数都列在该操作的主题中。有关 Signature Version 4 的更多信息,请参阅《IAM 用户指南》中的签署 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。

有关更多信息,请参阅《IAM 用户指南》中的创建已签名的 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 标头的值。有关更多信息,请参阅《IAM 用户指南》中的 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 标头。有关指定已签名标头的更多信息,请参阅《IAM 用户指南》中的创建已签名的 AWS API 请求

条件:当您在查询字符串中而不是 HTTP 授权标头中包括身份验证信息时,请指定此参数。

类型:字符串

必需:条件