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

# 使用 AWS CLI （仅限管理 API）访问亚马逊 QLDB
<a name="Tools.CLI"></a>

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

您可以使用 AWS Command Line Interface (AWS CLI) AWS 服务 从命令行控制多个命令并通过脚本自动执行这些操作。您可以根据需要使用 AWS CLI 进行一次性操作。您还可以使用它在实用工具脚本中嵌入 Amazon QLDB 操作。

要进行 CLI 访问，您需要访问密钥 ID 和秘密访问密钥。如果可能，请使用临时凭证代替长期访问密钥。临时凭证包括访问密钥 ID、秘密访问密钥，以及一个指示凭证何时到期的安全令牌。有关更多信息，请参阅 *IAM 用户指南*中的将[临时证书与 AWS 资源配合使用](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html)。

有关 AWS CLI中对 QLDB 可用的所有命令的完整列表和使用示例，请参阅 [AWS CLI 命令参考](https://docs.aws.amazon.com/cli/latest/reference/qldb/index.html)。

**注意**  
 AWS CLI 仅支持中列出的`qldb`管理 API 操作[Amazon QLDB API 参考](api-reference.md)。此 API 仅用于管理分类账资源和非事务数据操作。  
要使用命令行界面通过 `qldb-session`API 运行数据事务，请参阅 [使用 QLDB Shell 访问Amazon QLDB（仅限数据 API）](data-shell.md)。

**Topics**
+ [安装和配置 AWS CLI](#Tools.CLI.InstallingAndConfiguring)
+ [将 AWS CLI 与 QLDB 搭配使用](#Tools.CLI.UsingWithQLDB)

## 安装和配置 AWS CLI
<a name="Tools.CLI.InstallingAndConfiguring"></a>

它们可以在 Linux、macOS 或 Windows 上 AWS CLI 运行。要进行安装和配置，请参见 *AWS Command Line Interface 用户指南* 的以下说明：

1. [安装或更新最新版本的 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)

1. [快速设置](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-quickstart.html)

## 将 AWS CLI 与 QLDB 搭配使用
<a name="Tools.CLI.UsingWithQLDB"></a>

命令行格式包含 Amazon QLDB 操作名称，后跟该操作的参数。除了 AWS CLI JSON 之外，还支持参数值的简写语法。

 使用 `help` 帮助列出 QLDB 中的所有可用命令：

```
aws qldb help
```

 您还可以使用 `help` 来描述特定命令并了解有关其用法的详细信息：

```
aws qldb create-ledger help
```

 例如，要创建分类账，执行以下操作：

```
aws qldb create-ledger --name my-example-ledger --permissions-mode STANDARD
```