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