本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 存取 Amazon QLDB AWS CLI （僅限管理 API)
<a name="Tools.CLI"></a>

**重要**  
終止支援通知：現有客戶將可以使用 Amazon QLDB，直到 07/31/2025 終止支援為止。如需詳細資訊，請參閱[將 Amazon QLDB Ledger 遷移至 Amazon 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)。

如需 中可用於 QLDB 之所有命令的完整清單和使用範例 AWS CLI，請參閱 [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>

 AWS CLI 會在 Linux、macOS 或 Windows 上執行。若要安裝和設定它，請參閱*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 操作名稱，後面接著該操作的參數。除了 JSON 之外， AWS CLI 還支援參數值的速記語法。

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

```
aws qldb help
```

 您也可以使用 `help` 來描述特定命令，並進一步了解其用量：

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

 例如，若要建立總帳：

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