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

# 常见参数
<a name="CommonParameters"></a>

**重要**  
终止支持通知：现有客户将能够使用 Amazon QLDB，直到 2025 年 7 月 31 日终止支持。有关更多详细信息，请参阅[将亚马逊 QLDB 账本迁移到亚马逊 Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/)。

以下列表包含所有操作用于使用查询字符串对 Signature Version 4 请求进行签名的参数。任何特定于操作的参数都列在该操作的主题中。有关签名版本 4 的更多信息，请参阅 I *AM 用户指南*中的[签署 AWS API 请求](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)。

 **Action**   <a name="CommonParameters-Action"></a>
要执行的操作。  
类型：字符串。  
必需：是

 **Version**   <a name="CommonParameters-Version"></a>
请求所针对的 API 版本，以格式表示 YYYY-MM-DD。  
类型：字符串。  
必需：是

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
您用于创建请求签名的哈希算法。  
条件：当您在查询字符串中而不是 HTTP 授权标头中包括身份验证信息时，请指定此参数。  
类型：字符串  
有效值：`AWS4-HMAC-SHA256`  
必需：条件

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
凭证范围值，该值是一个字符串，其中包含您的访问密钥、日期、您要定位的区域、您请求的服务以及终止字符串（“aws4\$1request”）。值采用以下格式表示：*access\$1key*/*YYYYMMDD*/*region*/*service*/aws4\$1request。  
有关更多信息，请参阅 I *AM 用户指南*中的[创建已签名的 AWS API 请求](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)。  
条件：当您在查询字符串中而不是 HTTP 授权标头中包括身份验证信息时，请指定此参数。  
类型：字符串  
必需：条件

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
用于创建签名的日期。格式必须为 ISO 8601 基本格式 (YYYYMMDD'T'HHMMSS'Z')。例如，以下日期时间是有效 X-Amz-Date值：`20120325T120000Z`。  
条件： X-Amz-Date 对所有请求而言是可选的；它可以用于覆盖对请求签名所使用的日期。如果日期标题以 ISO 8601 基本格式指定，则 X-Amz-Date不是必填项。使用 X-Amz-Date时，它总是会覆盖 Date 标题的值。有关更多信息，请参阅 I *AM 用户指南*中的 [AWS API 请求签名要素](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html)。  
类型：字符串  
必需：条件

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
通过调用 AWS Security Token Service (AWS STS) 获得的临时安全令牌。有关支持来自 AWS STS的临时安全凭证的服务列表，请参阅《IAM 用户指南》**中的[使用 IAM 的AWS 服务](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。  
条件：如果您使用的是中的临时安全证书 AWS STS，则必须包含安全令牌。  
类型：字符串  
必需：条件

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
指定从要签名的字符串和派生的签名密钥计算的十六进制编码签名。  
条件：当您在查询字符串中而不是 HTTP 授权标头中包括身份验证信息时，请指定此参数。  
类型：字符串  
必需：条件

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
指定作为规范请求的一部分包含的所有 HTTP 标头。有关指定签名标头的更多信息，请参阅 I *AM 用户指南*中的[创建已签名的 AWS API 请求](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)。  
条件：当您在查询字符串中而不是 HTTP 授权标头中包括身份验证信息时，请指定此参数。  
类型：字符串  
必需：条件