使用 存取 Amazon QLDB AWS CLI （僅限管理 API)

重要

支援終止通知：現有客戶將可以使用 Amazon QLDB，直到 07/31/2025 的支援結束為止。如需詳細資訊，請參閱將 Amazon QLDB Ledger 遷移至 Amazon Aurora PostgreSQL。

您可以使用 AWS Command Line Interface (AWS CLI) AWS 服務 從命令列控制多個 ，並透過指令碼自動化它們。您可以視需要使用 AWS CLI 進行一次性操作。您也可以使用它在公用程式指令碼中內嵌 Amazon QLDB 操作。

對於 CLI 存取，您需要存取金鑰 ID 和私密存取金鑰。盡可能使用臨時憑證，而不是長期存取金鑰。臨時憑證包含存取金鑰 ID、私密存取金鑰，以及指出憑證何時到期的安全符記。如需詳細資訊，請參閱《IAM 使用者指南》中的將臨時登入資料與 AWS 資源搭配使用。

如需 中可用於 QLDB 之所有命令的完整清單和使用範例 AWS CLI，請參閱 AWS CLI 命令參考。

注意

AWS CLI 僅支援 中列出的qldb管理 API 操作Amazon QLDB API 參考。此 API 僅用於管理分類帳資源和非交易資料操作。

若要使用命令列界面使用 qldb-session API 執行資料交易，請參閱 使用 QLDB shell 存取 Amazon QLDB （僅限資料 API)。

安裝和設定 AWS CLI

AWS CLI 會在 Linux、macOS 或 Windows 上執行。若要安裝和設定它，請參閱 AWS Command Line Interface 使用者指南中的下列說明：

1. 安裝或更新最新版本的 AWS CLI

2. 快速設定

AWS CLI 搭配 QLDB 使用

命令列格式包含 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