Accès à Amazon QLDB à l'aide du AWS CLI (gestion API uniquement)

Important

Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez Migrer un Amazon QLDB Ledger vers Amazon Aurora SQL Postgre.

Vous pouvez utiliser le plugin AWS Command Line Interface (AWS CLI) pour contrôler plusieurs Services AWS depuis la ligne de commande et automatisez-les via des scripts. Vous pouvez utiliser le plugin AWS CLI pour des opérations ponctuelles selon les besoins. Vous pouvez également l'utiliser pour intégrer les QLDB opérations Amazon dans des scripts utilitaires.

Pour CLI y accéder, vous avez besoin d'un identifiant de clé d'accès et d'une clé d'accès secrète. Utilisation des informations d'identification temporaires au lieu des clés d'accès à long terme si possible. Les informations d'identification temporaires incluent un ID de clé d'accès, une clé d'accès secrète et un jeton de sécurité qui indique la date d'expiration des informations d'identification. Pour plus d'informations, voir Utilisation d'informations d'identification temporaires avec AWS ressources du guide de IAM l'utilisateur.

Pour une liste complète et des exemples d'utilisation de toutes les commandes disponibles QLDB dans AWS CLI, consultez le AWS CLI Référence de commande.

Note

Le AWS CLI prend uniquement en charge les API opérations de qldb gestion répertoriées dans leQLDBAPIRéférence Amazon. Ceci API est utilisé uniquement pour gérer les ressources du registre et pour les opérations de données non transactionnelles.

Pour exécuter des transactions de données à l'qldb-sessionAPIaide d'une interface de ligne de commande, voirAccès à Amazon QLDB via le QLDB shell (données API uniquement).

Installation et configuration du AWS CLI

Le AWS CLI fonctionne sous Linux, macOS ou Windows. Pour l'installer et le configurer, consultez les instructions suivantes dans le AWS Command Line Interface Guide de l'utilisateur  :

1. Installation ou mise à jour de la dernière version du AWS CLI

2. Configuration rapide

Utilisation de AWS CLI avec QLDB

Le format de ligne de commande consiste en un nom d'QLDBopération Amazon, suivi des paramètres de cette opération. Le AWS CLI prend en charge une syntaxe abrégée pour les valeurs des paramètres, en plus de. JSON

Permet help de répertorier toutes les commandes disponibles dans QLDB :

aws qldb help

Vous pouvez également utiliser help pour décrire une commande spécifique et en savoir plus sur son utilisation :

aws qldb create-ledger help

Par exemple, pour créer un registre :

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