

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 를 사용하여 Amazon QLDB에 액세스 AWS CLI (관리 API만 해당)
<a name="Tools.CLI"></a>

**중요**  
지원 종료 공지: 기존 고객은 07/31/2025에 지원이 종료될 때까지 Amazon QLDB를 사용할 수 있습니다. 자세한 내용은 [Amazon QLDB 원장을 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) 참조하세요.

 AWS CLI의 QLDB에 사용할 수 있는 모든 명령의 전체 목록을 보려면 [AWS CLI 명령 참조](https://docs.aws.amazon.com/cli/latest/reference/qldb/index.html)를 참조하세요.

**참고**  
는에 나열된 `qldb` 관리 API 작업 AWS CLI 만 지원합니다[Amazon QLDB API 참조](api-reference.md). 이 API는 원장 리소스 관리 및 비트랜잭션 데이터 작업에만 사용됩니다.  
명령줄 인터페이스를 사용하여 `qldb-session` API로 데이터 트랜잭션을 실행하려면 [QLDB 쉘을 사용하여 Amazon QLDB에 액세스(데이터 API만 해당)](data-shell.md)을 참조하세요.

**Topics**
+ [AWS CLI설치 및 구성](#Tools.CLI.InstallingAndConfiguring)
+ [QLDB AWS CLI 에서 사용](#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)

## QLDB AWS CLI 에서 사용
<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
```