常见参数 - Amazon Comprehend

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

常见参数

以下列表包含所有操作使用查询字符串对签名版本 4 请求进行签名时使用的参数。任何操作特有的参数在该操作的对应主题中列出。有关签名版本 4 的更多信息,请参阅签名版本 4 签名流程中的Amazon Web Services 一般参考.

Action

要执行的操作。

类型:字符串

需: 是

Version

为请求编写的 API 版本,格式为 YYYYYY-MM-DD。

类型:字符串

需: 是

X-Amz-Algorithm

用于创建请求签名的哈希算法。

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

类型:字符串

有效值:AWS4-HMAC-SHA256

需: 条件

X-Amz-Credential

凭证范围值,该值是一个字符串,其中包含您的访问密钥、日期、您要定位的服务和终止字符串(“aws4_request”)。此值采用以下格式表示:access_key/YYYYYYMMDD/领域/服务/aws4_request。

有关更多信息,请参阅 。Task 2:针对签名版本 4 创建待签字符串中的Amazon Web Services 一般参考.

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

类型:字符串

需: 条件

X-Amz-Date

用于创建签名的日期。格式必须为 ISO 8601 基本格式(YYYYYMDD'T'HHMSSSSSSSSSSSSSSSSSSSSSSSSSSSS' 例如,以下日期时间是有效的 X-Amz Date 值:20120325T120000Z.

条件:X-Amz Date 对所有请求而言是可选的;它可以用于覆盖对请求签名所使用的日期。如果使用 ISO 8601 基本格式指定了日期标头,则无需。使用 X-Amz Date。有关更多信息,请参阅 。处理签名版本 4 中的日期中的Amazon Web Services 一般参考.

类型:字符串

需: 条件

X-Amz-Security-Token

通过调用获得的临时安全令牌AWSToken ServiceAWSSTS)。有关支持来自的临时安全证书的服务的列表AWSCurity Token ServiceAWS与 IAM 结合使用的服务中的IAM 用户指南.

条件:如果您使用的是来自的临时安全凭证AWS安全令牌服务,则必须包含安全令牌。

类型:字符串

需: 条件

X-Amz-Signature

指定根据待签字符串和派生的签名密钥计算出的十六进制编码签名。

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

类型:字符串

需: 条件

X-Amz-SignedHeaders

指定作为规范请求的一部分包含的所有 HTTP 标头。想要了解更多有关指定签名标头的信息,请参阅Task 1:针对签名版本 4 创建规范请求中的Amazon Web Services 一般参考.

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

类型:字符串

需: 条件