

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Acceso a Amazon QLDB mediante la (solo API AWS CLI de administración)
<a name="Tools.CLI"></a>

**importante**  
Aviso de fin del soporte: los clientes actuales podrán utilizar Amazon QLDB hasta que finalice el soporte, el 31 de julio de 2025. Para obtener más información, consulte [Migración de un registro de Amazon QLDB a Amazon Aurora](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) PostgreSQL.

Puede usar el AWS Command Line Interface (AWS CLI) para controlar varios Servicios de AWS desde la línea de comandos y automatizarlos mediante scripts. Puede usarlo AWS CLI para operaciones únicas según sea necesario. También puede usarla para incluir operaciones de Amazon QLDB en scripts de utilidades.

Para acceder a la CLI, necesita un ID de clave de acceso y una clave de acceso secreta. Cuando sea posible, utilice credenciales temporales en lugar de claves de acceso. Las credenciales temporales incluyen un ID de clave de acceso y una clave de acceso secreta, pero, además, incluyen un token de seguridad que indica cuándo caducan las credenciales. Para obtener más información, consulte [Uso de credenciales temporales con AWS recursos](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) en la *Guía del usuario de IAM*.

Para obtener un listado completo y ejemplos de uso de todos los comandos disponibles para QLDB en la AWS CLI, consulte [Referencia de comandos de AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/qldb/index.html).

**nota**  
 AWS CLI Solo admite las operaciones `qldb` de la API de administración que se enumeran en. [Referencia de la API de Amazon QLDB](api-reference.md) Esta API se usa únicamente para administrar los recursos del libro mayor y para las operaciones de datos no transaccionales.  
Para ejecutar transacciones de datos con la API `qldb-session` mediante una interfaz de la línea de comandos, consulte [Acceso a Amazon QLDB mediante el intérprete de comandos de QLDB (solo API de datos)](data-shell.md).

**Topics**
+ [Instalación y configuración de la AWS CLI](#Tools.CLI.InstallingAndConfiguring)
+ [Uso del AWS CLI con QLDB](#Tools.CLI.UsingWithQLDB)

## Instalación y configuración de la AWS CLI
<a name="Tools.CLI.InstallingAndConfiguring"></a>

Se AWS CLI ejecuta en Linux, macOS o Windows. Para instalarla y configurarla, vea las siguientes instrucciones en la *Guía del usuario de AWS Command Line Interface *:

1. [Instalar o actualizar la última versión del AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)

1. [Configuración Rápida](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-quickstart.html)

## Uso del AWS CLI con QLDB
<a name="Tools.CLI.UsingWithQLDB"></a>

El formato de la línea de comandos se compone de un nombre de operación de Amazon QLDB seguido de los parámetros de dicha operación. AWS CLI Admite una sintaxis abreviada para los valores de los parámetros, además de JSON.

 Utilice la `help` para mostrar todos los comandos disponibles en QLDB: 

```
aws qldb help
```

 También puede utilizar la `help` para describir un comando específico y obtener más información sobre su uso: 

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

 Por ejemplo, para crear un libro mayor: 

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