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

# 작업
<a name="API_Operations"></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/)을 참조하세요.

Amazon QLDB에서는 다음 작업을 지원합니다.
+  [CancelJournalKinesisStream](API_CancelJournalKinesisStream.md) 
+  [CreateLedger](API_CreateLedger.md) 
+  [DeleteLedger](API_DeleteLedger.md) 
+  [DescribeJournalKinesisStream](API_DescribeJournalKinesisStream.md) 
+  [DescribeJournalS3Export](API_DescribeJournalS3Export.md) 
+  [DescribeLedger](API_DescribeLedger.md) 
+  [ExportJournalToS3](API_ExportJournalToS3.md) 
+  [GetBlock](API_GetBlock.md) 
+  [GetDigest](API_GetDigest.md) 
+  [GetRevision](API_GetRevision.md) 
+  [ListJournalKinesisStreamsForLedger](API_ListJournalKinesisStreamsForLedger.md) 
+  [ListJournalS3Exports](API_ListJournalS3Exports.md) 
+  [ListJournalS3ExportsForLedger](API_ListJournalS3ExportsForLedger.md) 
+  [ListLedgers](API_ListLedgers.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [StreamJournalToKinesis](API_StreamJournalToKinesis.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateLedger](API_UpdateLedger.md) 
+  [UpdateLedgerPermissionsMode](API_UpdateLedgerPermissionsMode.md) 

Amazon QLDB 세션에서는 다음 작업을 지원합니다.
+  [SendCommand](API_QLDB-Session_SendCommand.md) 

# Amazon QLDB
<a name="API_Operations_Amazon_QLDB"></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/)을 참조하세요.

Amazon QLDB에서는 다음 작업을 지원합니다.
+  [CancelJournalKinesisStream](API_CancelJournalKinesisStream.md) 
+  [CreateLedger](API_CreateLedger.md) 
+  [DeleteLedger](API_DeleteLedger.md) 
+  [DescribeJournalKinesisStream](API_DescribeJournalKinesisStream.md) 
+  [DescribeJournalS3Export](API_DescribeJournalS3Export.md) 
+  [DescribeLedger](API_DescribeLedger.md) 
+  [ExportJournalToS3](API_ExportJournalToS3.md) 
+  [GetBlock](API_GetBlock.md) 
+  [GetDigest](API_GetDigest.md) 
+  [GetRevision](API_GetRevision.md) 
+  [ListJournalKinesisStreamsForLedger](API_ListJournalKinesisStreamsForLedger.md) 
+  [ListJournalS3Exports](API_ListJournalS3Exports.md) 
+  [ListJournalS3ExportsForLedger](API_ListJournalS3ExportsForLedger.md) 
+  [ListLedgers](API_ListLedgers.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [StreamJournalToKinesis](API_StreamJournalToKinesis.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateLedger](API_UpdateLedger.md) 
+  [UpdateLedgerPermissionsMode](API_UpdateLedgerPermissionsMode.md) 

# CancelJournalKinesisStream
<a name="API_CancelJournalKinesisStream"></a>

지정된 Amazon QLDB 저널 스트림을 종료합니다. 스트림을 취소하려면 스트림의 현재 상태가 `ACTIVE`이어야 합니다.

스트리밍을 취소한 후에는 다시 시작할 수 없습니다. 취소된 QLDB 스트림 리소스는 7일의 보존 기간이 적용되므로 이 한도가 만료되면 자동으로 삭제됩니다.

## Request Syntax
<a name="API_CancelJournalKinesisStream_RequestSyntax"></a>

```
DELETE /ledgers/name/journal-kinesis-streams/streamId HTTP/1.1
```

## URI 요청 파라미터
<a name="API_CancelJournalKinesisStream_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [name](#API_CancelJournalKinesisStream_RequestSyntax) **   <a name="qldb-CancelJournalKinesisStream-request-uri-LedgerName"></a>
원장의 명칭입니다.  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
필수 여부: 예

 ** [streamId](#API_CancelJournalKinesisStream_RequestSyntax) **   <a name="qldb-CancelJournalKinesisStream-request-uri-StreamId"></a>
취소할 QLDB 저널 스트림의 UUID(Base62 인코딩된 텍스트로 표시됨)입니다.  
길이 제약 조건: 고정 길이는 22입니다.  
패턴: `^[A-Za-z-0-9]+$`   
필수 여부: 예

## Request Body
<a name="API_CancelJournalKinesisStream_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_CancelJournalKinesisStream_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "StreamId": "string"
}
```

## 응답 요소
<a name="API_CancelJournalKinesisStream_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [StreamId](#API_CancelJournalKinesisStream_ResponseSyntax) **   <a name="qldb-CancelJournalKinesisStream-response-StreamId"></a>
취소된 QLDB 저널 스트림의 UUID(Base62 인코딩된 텍스트)입니다.  
유형: 문자열  
길이 제약 조건: 고정 길이는 22입니다.  
패턴: `^[A-Za-z-0-9]+$` 

## 오류
<a name="API_CancelJournalKinesisStream_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterException **   
요청에서 하나 이상의 파라미터가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
지정된 리소스가 존재하지 않습니다.  
HTTP 상태 코드: 404

 ** ResourcePreconditionNotMetException **   
조건이 미리 충족되지 않아 작업이 실패했습니다.  
HTTP 상태 코드: 412

## 참고
<a name="API_CancelJournalKinesisStream_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/CancelJournalKinesisStream) 

# CreateLedger
<a name="API_CreateLedger"></a>

 AWS 계정 현재 리전의에 새 원장을 생성합니다.

## Request Syntax
<a name="API_CreateLedger_RequestSyntax"></a>

```
POST /ledgers HTTP/1.1
Content-type: application/json

{
   "DeletionProtection": boolean,
   "KmsKey": "string",
   "Name": "string",
   "PermissionsMode": "string",
   "Tags": { 
      "string" : "string" 
   }
}
```

## URI 요청 파라미터
<a name="API_CreateLedger_RequestParameters"></a>

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_CreateLedger_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [DeletionProtection](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-DeletionProtection"></a>
사용자에 의해 삭제되지 않도록 원장을 보호할지 여부를 지정합니다. 원장 생성 중 정의하지 않을 경우 이 기능이 기본적으로 활성화됩니다(`true`).  
삭제 방지가 활성화된 경우 원장을 삭제하려면 먼저 이 기능을 비활성화해야 합니다. `UpdateLedger` 작업을 호출하여 이 파라미터를 `false`로 설정하면 비활성화할 수 있습니다.  
유형: 부울  
필수 항목 여부: 아니요

 ** [KmsKey](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-KmsKey"></a>
원장의 저장 데이터 암호화에 사용할 in AWS Key Management Service (AWS KMS) 키입니다. 자세한 내용을 알아보려면 *Amazon QLDB 개발자 안내서*의 [저장된 암호화](https://docs.aws.amazon.com/qldb/latest/developerguide/encryption-at-rest.html)를 참조하세요.  
다음 옵션 중 하나를 사용하여 이 파라미터를 지정합니다.  
+  `AWS_OWNED_KMS_KEY`: 사용자를 대신하여에서 소유하고 관리하는 AWS KMS AWS 키를 사용합니다.
+  **정의되지 않음**: 기본적으로 AWS 소유 KMS 키를 사용합니다.
+  **유효한 대칭 고객 관리형 KMS 키**: 사용자가 생성, 소유 및 관리하는 계정의 지정된 대칭 암호화 KMS 키를 사용합니다.

  Amazon QLDB에서는 비대칭 키가 지원되지 않습니다. 자세한 내용은 * AWS Key Management Service 개발자 안내서*의 [대칭 및 비대칭 키 사용을](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) 참조하세요.
고객 관리형 KMS 키를 지정하려면 해당 키 ID, Amazon 리소스 이름(ARN), 별칭 이름 또는 별칭 ARN을 사용할 수 있습니다. 별칭 이름을 사용할 때 `"alias/"`를 접두사를 사용합니다. 다른에서 키를 지정하려면 키 ARN 또는 별칭 ARN을 사용해야 AWS 계정합니다.  
예시:  
+ 키 ID: `1234abcd-12ab-34cd-56ef-1234567890ab` 
+ 키 ARN: `arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` 
+ 별칭 이름: `alias/ExampleAlias` 
+ 별칭 ARN: `arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias` 
자세한 내용은 * AWS Key Management Service 개발자 안내서*의 [키 식별자(KeyId)](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id)를 참조하세요.  
유형: 문자열  
길이 제약 조건: 최대 길이는 1,600입니다.  
필수 여부: 아니요

 ** [Name](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-Name"></a>
생성할 원장의 이름입니다. 이름은 현재 리전에 있는의 모든 원장 AWS 계정 중에서 고유해야 합니다.  
원장 이름에 대한 이름 지정 제약 조건은 *Amazon QLDB 개발자 안내서*의 [Amazon QLDB의 할당량](https://docs.aws.amazon.com/qldb/latest/developerguide/limits.html#limits.naming)에 정의되어 있습니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
필수 여부: 예

 ** [PermissionsMode](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-PermissionsMode"></a>
생성하려는 원장에 할당할 권한 모드입니다. 이 파라미터는 다음 값 중 하나를 가질 수 있습니다.  
+  `ALLOW_ALL`: 원장에 대한 API 수준 세분화로 액세스 통제를 가능하게 하는 레거시 권한 모드입니다.

  이 모드를 사용하면 이 원장에 대한 `SendCommand` API 권한이 있는 사용자가 지정된 원장의 모든 표에서 모든 PartiQL 명령(따라서 `ALLOW_ALL`)을 실행할 수 있습니다. 이 모드는 원장에 대해 생성하는 모든 표 수준 또는 명령 수준 IAM 권한 정책을 무시합니다.
+  `STANDARD`: (*권장*) 원장, 테이블 및 PartiQL 명령에 대해 보다 세분화된 액세스 제어를 가능하게 하는 권한 모드입니다..

  기본적으로 이 모드는 이 원장의 모든 표에서 PartiQL 명령을 실행하려는 모든 사용자 요청을 거부합니다. PartiQL 명령 실행을 허용하려면 원장에 대한 `SendCommand` API 권한 외에도 특정 테이블 리소스 및 PartiQL 작업에 대한 IAM 권한 정책을 생성해야 합니다. 자세한 내용은 *Amazon QLDB 개발자 안내서*의 [표준 권한 모드로 시작하기](https://docs.aws.amazon.com/qldb/latest/developerguide/getting-started-standard-mode.html)를 참조하세요.
원장 데이터의 보안을 극대화하려면 `STANDARD` 권한 모드를 사용하는 것이 좋습니다.
타입: 문자열  
유효 값: `ALLOW_ALL | STANDARD`   
필수 사항 여부: 예

 ** [Tags](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-Tags"></a>
생성할 원장에 태그로 추가하려는 키-값 쌍입니다. 태그 키는 대소문자를 구별합니다. 태그 값은 대소문자를 구분하며 null일 수 있습니다.  
유형: 문자열 간 맵  
맵 항목: 최소 항목 수는 0개입니다. 최대 항목 수 200개.  
키 길이 제약 조건: 최소 길이는 1. 최대 길이 128.  
값 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 256입니다.  
필수 여부: 아니요

## 응답 구문
<a name="API_CreateLedger_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Arn": "string",
   "CreationDateTime": number,
   "DeletionProtection": boolean,
   "KmsKeyArn": "string",
   "Name": "string",
   "PermissionsMode": "string",
   "State": "string"
}
```

## 응답 요소
<a name="API_CreateLedger_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Arn](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-Arn"></a>
원장의 Amazon 리소스 이름(ARN)입니다.  
타입: 문자열  
길이 제약 조건: 최소 길이는 20입니다. 최대 길이는 1,600입니다.

 ** [CreationDateTime](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-CreationDateTime"></a>
원장이 생성된 날짜와 시간(epoch 시간 형식)입니다. (epoch 시간 형식은 UTC 기준으로 1970년 1월 1일 자정 12:00:00부터 경과된 초 단위의 시간입니다.)  
유형: 타임스탬프

 ** [DeletionProtection](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-DeletionProtection"></a>
사용자에 의해 삭제되지 않도록 원장을 보호할지 여부를 지정합니다. 원장 생성 중 정의하지 않을 경우 이 기능이 기본적으로 활성화됩니다(`true`).  
삭제 방지가 활성화된 경우 원장을 삭제하려면 먼저 이 기능을 비활성화해야 합니다. `UpdateLedger` 작업을 호출하여 이 파라미터를 `false`로 설정하면 비활성화할 수 있습니다.  
유형: 부울

 ** [KmsKeyArn](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-KmsKeyArn"></a>
원장이 유휴 시 암호화에 사용하는 고객 관리형 KMS 키의 ARN입니다. 이 파라미터가 정의되지 않은 경우 원장은 암호화에 AWS 소유 KMS 키를 사용합니다.  
유형: 문자열  
길이 제약 조건: 최소 길이는 20입니다. 최대 길이는 1,600입니다.

 ** [Name](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-Name"></a>
원장의 명칭입니다.  
타입: 문자열  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$` 

 ** [PermissionsMode](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-PermissionsMode"></a>
생성한 원장의 권한 모드입니다.  
타입: 문자열  
유효 값: `ALLOW_ALL | STANDARD` 

 ** [State](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-State"></a>
원장의 현재 상태입니다.  
타입: 문자열  
유효 값: `CREATING | ACTIVE | DELETING | DELETED` 

## 오류
<a name="API_CreateLedger_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterException **   
요청에서 하나 이상의 파라미터가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
허용되는 최대 리소스 수 제한에 도달했습니다.  
HTTP 상태 코드: 400

 ** ResourceAlreadyExistsException **   
지정된 리소스가 이미 있습니다.  
HTTP 상태 코드: 409

 ** ResourceInUseException **   
지금은 지정된 리소스를 수정할 수 없습니다.  
HTTP 상태 코드: 409

## 참고
<a name="API_CreateLedger_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/CreateLedger) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/CreateLedger) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/CreateLedger) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/CreateLedger) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/CreateLedger) 

# DeleteLedger
<a name="API_DeleteLedger"></a>

원장과 모든 해당 콘텐츠를 삭제합니다. 이 작업은 되돌릴 수 없습니다.

삭제 방지가 활성화된 경우 원장을 삭제하려면 먼저 이 기능을 비활성화해야 합니다. `UpdateLedger` 작업을 호출하여 이 파라미터를 `false`로 설정하면 비활성화할 수 있습니다.

## Request Syntax
<a name="API_DeleteLedger_RequestSyntax"></a>

```
DELETE /ledgers/name HTTP/1.1
```

## URI 요청 파라미터
<a name="API_DeleteLedger_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [name](#API_DeleteLedger_RequestSyntax) **   <a name="qldb-DeleteLedger-request-uri-Name"></a>
삭제할 원장의 이름입니다.  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
필수 여부: 예

## Request Body
<a name="API_DeleteLedger_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_DeleteLedger_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteLedger_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeleteLedger_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterException **   
요청에서 하나 이상의 파라미터가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지금은 지정된 리소스를 수정할 수 없습니다.  
HTTP 상태 코드: 409

 ** ResourceNotFoundException **   
지정된 리소스가 존재하지 않습니다.  
HTTP 상태 코드: 404

 ** ResourcePreconditionNotMetException **   
조건이 미리 충족되지 않아 작업이 실패했습니다.  
HTTP 상태 코드: 412

## 참고
<a name="API_DeleteLedger_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/DeleteLedger) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/DeleteLedger) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/DeleteLedger) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/DeleteLedger) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/DeleteLedger) 

# DescribeJournalKinesisStream
<a name="API_DescribeJournalKinesisStream"></a>

지정된 Amazon QLDB 저널 스트림에 대한 세부 정보를 반환합니다. 출력에는 Amazon 리소스 이름(ARN), 스트림 이름, 현재 상태, 생성 시간, 원본 스트림 생성 요청의 파라미터가 포함됩니다.

이 작업을 수행해도 만료된 저널 스트림은 반환되지 않습니다. 자세한 내용은 *Amazon QLDB 개발자 안내서*의 [터미널 스트림 만료](https://docs.aws.amazon.com/qldb/latest/developerguide/streams.create.html#streams.create.states.expiration)를 참조하세요.

## Request Syntax
<a name="API_DescribeJournalKinesisStream_RequestSyntax"></a>

```
GET /ledgers/name/journal-kinesis-streams/streamId HTTP/1.1
```

## URI 요청 파라미터
<a name="API_DescribeJournalKinesisStream_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [name](#API_DescribeJournalKinesisStream_RequestSyntax) **   <a name="qldb-DescribeJournalKinesisStream-request-uri-LedgerName"></a>
원장의 명칭입니다.  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
필수 여부: 예

 ** [streamId](#API_DescribeJournalKinesisStream_RequestSyntax) **   <a name="qldb-DescribeJournalKinesisStream-request-uri-StreamId"></a>
설명할 QLDB 저널 스트림의 UUID(Base62 인코딩된 텍스트로 표시됨)입니다.  
길이 제약 조건: 고정 길이는 22입니다.  
패턴: `^[A-Za-z-0-9]+$`   
필수 여부: 예

## Request Body
<a name="API_DescribeJournalKinesisStream_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_DescribeJournalKinesisStream_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Stream": { 
      "Arn": "string",
      "CreationTime": number,
      "ErrorCause": "string",
      "ExclusiveEndTime": number,
      "InclusiveStartTime": number,
      "KinesisConfiguration": { 
         "AggregationEnabled": boolean,
         "StreamArn": "string"
      },
      "LedgerName": "string",
      "RoleArn": "string",
      "Status": "string",
      "StreamId": "string",
      "StreamName": "string"
   }
}
```

## 응답 요소
<a name="API_DescribeJournalKinesisStream_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Stream](#API_DescribeJournalKinesisStream_ResponseSyntax) **   <a name="qldb-DescribeJournalKinesisStream-response-Stream"></a>
`DescribeJournalS3Export` 요청에 의해 반환된 QLDB 저널 스트림에 대한 정보입니다.  
타입: [JournalKinesisStreamDescription](API_JournalKinesisStreamDescription.md) 객체

## 오류
<a name="API_DescribeJournalKinesisStream_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterException **   
요청에서 하나 이상의 파라미터가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
지정된 리소스가 존재하지 않습니다.  
HTTP 상태 코드: 404

 ** ResourcePreconditionNotMetException **   
조건이 미리 충족되지 않아 작업이 실패했습니다.  
HTTP 상태 코드: 412

## 참고
<a name="API_DescribeJournalKinesisStream_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/DescribeJournalKinesisStream) 

# DescribeJournalS3Export
<a name="API_DescribeJournalS3Export"></a>

원장 이름, 내보내기 ID, 생성 시간, 현재 상태, 원본 내보내기 생성 요청의 파라미터 등 저널 내보내기 작업에 대한 정보를 반환합니다.

이 작업을 수행해도 만료된 내보내기 작업은 반환되지 않습니다. 자세한 내용을 알아보려면 *Amazon QLDB 개발자 안내서*의 [내보내기 작업 만료](https://docs.aws.amazon.com/qldb/latest/developerguide/export-journal.request.html#export-journal.request.expiration)를 참조하세요.

지정된 `ExportId`의 내보내기 작업이 존재하지 않으면 `ResourceNotFoundException`을 발생시킵니다.

지정된 `Name`의 원장이 존재하지 않으면 `ResourceNotFoundException`을 발생시킵니다.

## Request Syntax
<a name="API_DescribeJournalS3Export_RequestSyntax"></a>

```
GET /ledgers/name/journal-s3-exports/exportId HTTP/1.1
```

## URI 요청 파라미터
<a name="API_DescribeJournalS3Export_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [exportId](#API_DescribeJournalS3Export_RequestSyntax) **   <a name="qldb-DescribeJournalS3Export-request-uri-ExportId"></a>
설명할 저널 내보내기 작업의 UUID(Base62 인코딩된 텍스트로 표시됨)입니다.  
길이 제약 조건: 고정 길이는 22입니다.  
패턴: `^[A-Za-z-0-9]+$`   
필수 여부: 예

 ** [name](#API_DescribeJournalS3Export_RequestSyntax) **   <a name="qldb-DescribeJournalS3Export-request-uri-Name"></a>
원장의 명칭입니다.  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
필수 여부: 예

## Request Body
<a name="API_DescribeJournalS3Export_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_DescribeJournalS3Export_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ExportDescription": { 
      "ExclusiveEndTime": number,
      "ExportCreationTime": number,
      "ExportId": "string",
      "InclusiveStartTime": number,
      "LedgerName": "string",
      "OutputFormat": "string",
      "RoleArn": "string",
      "S3ExportConfiguration": { 
         "Bucket": "string",
         "EncryptionConfiguration": { 
            "KmsKeyArn": "string",
            "ObjectEncryptionType": "string"
         },
         "Prefix": "string"
      },
      "Status": "string"
   }
}
```

## 응답 요소
<a name="API_DescribeJournalS3Export_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [ExportDescription](#API_DescribeJournalS3Export_ResponseSyntax) **   <a name="qldb-DescribeJournalS3Export-response-ExportDescription"></a>
`DescribeJournalS3Export` 요청에 의해 반환된 저널 내보내기 작업에 대한 정보입니다.  
타입: [JournalS3ExportDescription](API_JournalS3ExportDescription.md) 객체

## 오류
<a name="API_DescribeJournalS3Export_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** ResourceNotFoundException **   
지정된 리소스가 존재하지 않습니다.  
HTTP 상태 코드: 404

## 참고
<a name="API_DescribeJournalS3Export_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/DescribeJournalS3Export) 

# DescribeLedger
<a name="API_DescribeLedger"></a>

상태, 권한 모드, 저장 시 암호화 설정, 생성 날짜 등 원장에 대한 정보를 반환합니다.

## Request Syntax
<a name="API_DescribeLedger_RequestSyntax"></a>

```
GET /ledgers/name HTTP/1.1
```

## URI 요청 파라미터
<a name="API_DescribeLedger_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [name](#API_DescribeLedger_RequestSyntax) **   <a name="qldb-DescribeLedger-request-uri-Name"></a>
설명할 원장의 이름입니다.  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
필수 여부: 예

## Request Body
<a name="API_DescribeLedger_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_DescribeLedger_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Arn": "string",
   "CreationDateTime": number,
   "DeletionProtection": boolean,
   "EncryptionDescription": { 
      "EncryptionStatus": "string",
      "InaccessibleKmsKeyDateTime": number,
      "KmsKeyArn": "string"
   },
   "Name": "string",
   "PermissionsMode": "string",
   "State": "string"
}
```

## 응답 요소
<a name="API_DescribeLedger_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Arn](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-Arn"></a>
원장의 Amazon 리소스 이름(ARN)입니다.  
타입: 문자열  
길이 제약 조건: 최소 길이는 20입니다. 최대 길이는 1,600입니다.

 ** [CreationDateTime](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-CreationDateTime"></a>
원장이 생성된 날짜와 시간(epoch 시간 형식)입니다. (epoch 시간 형식은 UTC 기준으로 1970년 1월 1일 자정 12:00:00부터 경과된 초 단위의 시간입니다.)  
유형: 타임스탬프

 ** [DeletionProtection](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-DeletionProtection"></a>
사용자에 의해 삭제되지 않도록 원장을 보호할지 여부를 지정합니다. 원장 생성 중 정의하지 않을 경우 이 기능이 기본적으로 활성화됩니다(`true`).  
삭제 방지가 활성화된 경우 원장을 삭제하려면 먼저 이 기능을 비활성화해야 합니다. `UpdateLedger` 작업을 호출하여 이 파라미터를 `false`로 설정하면 비활성화할 수 있습니다.  
유형: 부울

 ** [EncryptionDescription](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-EncryptionDescription"></a>
원장의 저장 데이터 암호화에 대한 정보. 여기에는 현재 상태, AWS KMS 키, 키에 액세스할 수 없게 된 시간(오류 발생 시)이 포함됩니다. 이 파라미터가 정의되지 않은 경우 원장은 암호화에 AWS 소유 KMS 키를 사용합니다.  
유형: [LedgerEncryptionDescription](API_LedgerEncryptionDescription.md)객체

 ** [Name](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-Name"></a>
원장의 명칭입니다.  
타입: 문자열  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$` 

 ** [PermissionsMode](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-PermissionsMode"></a>
원장의 권한 모드입니다.  
타입: 문자열  
유효 값: `ALLOW_ALL | STANDARD` 

 ** [State](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-State"></a>
원장의 현재 상태입니다.  
타입: 문자열  
유효 값: `CREATING | ACTIVE | DELETING | DELETED` 

## 오류
<a name="API_DescribeLedger_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterException **   
요청에서 하나 이상의 파라미터가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
지정된 리소스가 존재하지 않습니다.  
HTTP 상태 코드: 404

## 참고
<a name="API_DescribeLedger_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/DescribeLedger) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/DescribeLedger) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/DescribeLedger) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/DescribeLedger) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/DescribeLedger) 

# ExportJournalToS3
<a name="API_ExportJournalToS3"></a>

원장에서 날짜 및 시간 범위 내의 저널 콘텐츠를 지정된 Amazon Simple Storage Service(S3) 버킷에 내보냅니다. 저널 내보내기 작업은 Amazon Ion 형식의 텍스트 또는 이진 표현이나 *JSON Lines* 텍스트 형식으로 데이터 객체를 쓸 수 있습니다.

지정된 `Name`의 원장이 존재하지 않으면 `ResourceNotFoundException`을 발생시킵니다.

지정된 `Name`의 원장이 `CREATING` 상태이면 `ResourcePreconditionNotMetException`을 발생시킵니다.

각 원장에 대해 최대 두 개의 동시 저널 내보내기 요청을 시작할 수 있습니다. 이 한도를 초과하면 저널 내보내기 요청에 `LimitExceededException`가 발생합니다.

## Request Syntax
<a name="API_ExportJournalToS3_RequestSyntax"></a>

```
POST /ledgers/name/journal-s3-exports HTTP/1.1
Content-type: application/json

{
   "ExclusiveEndTime": number,
   "InclusiveStartTime": number,
   "OutputFormat": "string",
   "RoleArn": "string",
   "S3ExportConfiguration": { 
      "Bucket": "string",
      "EncryptionConfiguration": { 
         "KmsKeyArn": "string",
         "ObjectEncryptionType": "string"
      },
      "Prefix": "string"
   }
}
```

## URI 요청 파라미터
<a name="API_ExportJournalToS3_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [name](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-uri-Name"></a>
원장의 명칭입니다.  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
필수 여부: 예

## 요청 본문
<a name="API_ExportJournalToS3_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ExclusiveEndTime](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-ExclusiveEndTime"></a>
내보내기할 저널 콘텐츠 범위에 대한 불포함 종료 날짜 및 시간.  
`ISO 8601`은 `ExclusiveEndTime` 날짜 및 시간 형식이어야 하며 협정 세계시(UTC)여야 합니다. 예를 들어 `2019-06-13T21:36:34Z`입니다.  
`ExclusiveEndTime`는 현재 UTC 날짜 및 시간보다 작거나 같아야 합니다.  
유형: 타임스탬프  
필수 여부: 예

 ** [InclusiveStartTime](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-InclusiveStartTime"></a>
내보기할 저널 콘텐츠 범위에 대한 포함 시작 날짜 및 시간.  
`ISO 8601`은 `InclusiveStartTime` 날짜 및 시간 형식이어야 하며 협정 세계시(UTC)여야 합니다. 예를 들어 `2019-06-13T21:36:34Z`입니다.  
`InclusiveStartTime`는 `ExclusiveEndTime` 이전이어야 합니다.  
원장의 `CreationDateTime` 이전인 `InclusiveStartTime`을 제공하는 경우, Amazon QLDB는 기본값을 원장의 `CreationDateTime`으로 설정합니다.  
유형: 타임스탬프  
필수 여부: 예

 ** [OutputFormat](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-OutputFormat"></a>
내보내기할 저널 데이터의 출력 형식. 저널 내보내기 작업은 [Amazon Ion](https://docs.aws.amazon.com/qldb/latest/developerguide/ion.html) 형식의 텍스트 또는 이진 표현이나 [JSON Lines](https://jsonlines.org/) 텍스트 형식으로 데이터 객체를 쓸 수 있습니다.  
기본값: `ION_TEXT`   
JSON Lines 형식에서 내보낸 데이터 객체의 각 저널 블록은 줄 바꿈으로 구분된 유효한 JSON 객체입니다. 이 형식을 사용하여 JSON 내보내기를 Amazon Athena 및 AWS Glue 와 같은 분석 도구와 직접 통합할 수 있습니다. 이러한 서비스는 줄바꿈으로 구분된 JSON을 자동으로 파싱할 수 있기 때문입니다.  
타입: 문자열  
유효 값: `ION_BINARY | ION_TEXT | JSON`   
필수 여부: 아니요

 ** [RoleArn](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-RoleArn"></a>
다음을 수행하기 위해 저널 내보내기 작업에 대한 QLDB 권한을 부여하는 IAM 역할의 Amazon 리소스 이름(ARN)입니다.  
+ Amazon S3 버킷에 객체를 작성합니다.
+ (선택 사항) 내보낸 데이터의 서버 측 암호화를 위해 AWS Key Management Service (AWS KMS)에서 고객 관리형 키를 사용합니다.
저널 내보내기를 요청할 때 QLDB에 역할을 전달하려면 IAM 역할 리소스에서 `iam:PassRole` 작업을 수행할 수 있는 권한이 있어야 합니다. 이는 모든 저널 내보내기 요청에 필요합니다.  
유형: 문자열  
길이 제약 조건: 최소 길이는 20입니다. 최대 길이는 1,600입니다.  
필수 여부: 예

 ** [S3ExportConfiguration](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-S3ExportConfiguration"></a>
내보내기 요청에 대한 Amazon S3 버킷 대상의 구성 설정입니다.  
타입: [S3ExportConfiguration](API_S3ExportConfiguration.md)객체  
필수 여부: 예

## 응답 구문
<a name="API_ExportJournalToS3_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ExportId": "string"
}
```

## 응답 요소
<a name="API_ExportJournalToS3_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [ExportId](#API_ExportJournalToS3_ResponseSyntax) **   <a name="qldb-ExportJournalToS3-response-ExportId"></a>
QLDB가 각 저널 내보내기 작업에 할당하는 UUID(Base62로 인코딩된 텍스트로 표시됨).  
`ExportId`를 사용하여 `DescribeJournalS3Export`를 호출하여 내보내기 요청을 설명하고 작업 상태를 확인할 수 있습니다.  
유형: 문자열  
길이 제약 조건: 고정 길이는 22입니다.  
패턴: `^[A-Za-z-0-9]+$` 

## 오류
<a name="API_ExportJournalToS3_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** ResourceNotFoundException **   
지정된 리소스가 존재하지 않습니다.  
HTTP 상태 코드: 404

 ** ResourcePreconditionNotMetException **   
조건이 미리 충족되지 않아 작업이 실패했습니다.  
HTTP 상태 코드: 412

## 참고
<a name="API_ExportJournalToS3_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ExportJournalToS3) 

# GetBlock
<a name="API_GetBlock"></a>

저널의 지정된 주소에 있는 블록 객체를 반환합니다. 또한 `DigestTipAddress`가 제공된 경우 검증을 위해 지정된 블록의 증명을 반환합니다.

블록의 데이터 콘텐츠에 대한 자세한 내용은 *Amazon QLDB 개발자 안내서*의 [저널 콘텐츠](https://docs.aws.amazon.com/qldb/latest/developerguide/journal-contents.html)를 참조하세요.

지정된 원장이 존재하지 않거나 `DELETING` 상태에 있는 경우 `ResourceNotFoundException`이 발생합니다.

지정된 원장이 `CREATING` 상태에 있으면 `ResourcePreconditionNotMetException`이 발생합니다.

지정된 주소를 가진 블록이 없으면 `InvalidParameterException`이 발생합니다.

## Request Syntax
<a name="API_GetBlock_RequestSyntax"></a>

```
POST /ledgers/name/block HTTP/1.1
Content-type: application/json

{
   "BlockAddress": { 
      "IonText": "string"
   },
   "DigestTipAddress": { 
      "IonText": "string"
   }
}
```

## URI 요청 파라미터
<a name="API_GetBlock_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [name](#API_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-request-uri-Name"></a>
원장의 명칭입니다.  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
필수 여부: 예

## 요청 본문
<a name="API_GetBlock_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [BlockAddress](#API_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-request-BlockAddress"></a>
요청하려는 블록의 위치. 주소는 `strandId` 및 `sequenceNo`라는 두 개의 필드로 구성된 Amazon Ion 구조입니다.  
예를 들어 `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}`입니다.  
타입: [ValueHolder](API_ValueHolder.md)객체  
필수 여부: 예

 ** [DigestTipAddress](#API_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-request-DigestTipAddress"></a>
증명을 요청할 다이제스트에 포함된 최신 블록 위치. 주소는 `strandId` 및 `sequenceNo`라는 두 개의 필드로 구성된 Amazon Ion 구조입니다.  
예를 들어 `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}`입니다.  
유형: [ValueHolder](API_ValueHolder.md)객체  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_GetBlock_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Block": { 
      "IonText": "string"
   },
   "Proof": { 
      "IonText": "string"
   }
}
```

## 응답 요소
<a name="API_GetBlock_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Block](#API_GetBlock_ResponseSyntax) **   <a name="qldb-GetBlock-response-Block"></a>
Amazon Ion 형식의 블록 데이터 객체입니다.  
유형: [ValueHolder](API_ValueHolder.md)객체

 ** [Proof](#API_GetBlock_ResponseSyntax) **   <a name="qldb-GetBlock-response-Proof"></a>
`GetBlock` 요청을 통해 반환된 Amazon Ion 형식의 증명 객체입니다. 증명은 지정된 블록부터 시작하여 Merkle 트리를 사용하여 지정된 다이제스트를 다시 계산하는 데 필요한 해시 값 목록을 포함합니다.  
타입: [ValueHolder](API_ValueHolder.md) 객체

## 오류
<a name="API_GetBlock_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterException **   
요청에서 하나 이상의 파라미터가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
지정된 리소스가 존재하지 않습니다.  
HTTP 상태 코드: 404

 ** ResourcePreconditionNotMetException **   
조건이 미리 충족되지 않아 작업이 실패했습니다.  
HTTP 상태 코드: 412

## 참고
<a name="API_GetBlock_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/GetBlock) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/GetBlock) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/GetBlock) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/GetBlock) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/GetBlock) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/GetBlock) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/GetBlock) 

# GetDigest
<a name="API_GetDigest"></a>

저널에서 가장 최근에 커밋된 블록의 원장 다이제스트를 반환합니다. 응답에는 256비트 해시 값과 블록 주소가 포함됩니다.

## Request Syntax
<a name="API_GetDigest_RequestSyntax"></a>

```
POST /ledgers/name/digest HTTP/1.1
```

## URI 요청 파라미터
<a name="API_GetDigest_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [name](#API_GetDigest_RequestSyntax) **   <a name="qldb-GetDigest-request-uri-Name"></a>
원장의 명칭입니다.  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
필수 여부: 예

## Request Body
<a name="API_GetDigest_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_GetDigest_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Digest": blob,
   "DigestTipAddress": { 
      "IonText": "string"
   }
}
```

## 응답 요소
<a name="API_GetDigest_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Digest](#API_GetDigest_ResponseSyntax) **   <a name="qldb-GetDigest-response-Digest"></a>
`GetDigest` 요청에서 반환된 다이제스트를 나타내는 256비트 해시 값입니다.  
타입: Base64로 인코딩된 이진 데이터 객체  
길이 제약 조건: 고정 길이는 32입니다.

 ** [DigestTipAddress](#API_GetDigest_ResponseSyntax) **   <a name="qldb-GetDigest-response-DigestTipAddress"></a>
요청한 다이제스트에 포함된 최신 블록 위치. 주소는 `strandId` 및 `sequenceNo`라는 두 개의 필드로 구성된 Amazon Ion 구조입니다.  
타입: [ValueHolder](API_ValueHolder.md) 객체

## 오류
<a name="API_GetDigest_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterException **   
요청에서 하나 이상의 파라미터가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
지정된 리소스가 존재하지 않습니다.  
HTTP 상태 코드: 404

 ** ResourcePreconditionNotMetException **   
조건이 미리 충족되지 않아 작업이 실패했습니다.  
HTTP 상태 코드: 412

## 참고
<a name="API_GetDigest_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/GetDigest) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/GetDigest) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/GetDigest) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/GetDigest) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/GetDigest) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/GetDigest) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/GetDigest) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/GetDigest) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/GetDigest) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/GetDigest) 

# GetRevision
<a name="API_GetRevision"></a>

지정된 문서 ID 및 블록 주소의 수정본 데이터 객체를 반환합니다. 또한 `DigestTipAddress`가 제공된 경우 검증을 위해 지정된 수정본의 증명을 반환합니다.

## Request Syntax
<a name="API_GetRevision_RequestSyntax"></a>

```
POST /ledgers/name/revision HTTP/1.1
Content-type: application/json

{
   "BlockAddress": { 
      "IonText": "string"
   },
   "DigestTipAddress": { 
      "IonText": "string"
   },
   "DocumentId": "string"
}
```

## URI 요청 파라미터
<a name="API_GetRevision_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [name](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-uri-Name"></a>
원장의 명칭입니다.  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
필수 여부: 예

## 요청 본문
<a name="API_GetRevision_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [BlockAddress](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-BlockAddress"></a>
검증할 문서 수정본의 블록 위치. 주소는 `strandId` 및 `sequenceNo`라는 두 개의 필드로 구성된 Amazon Ion 구조입니다.  
예를 들어 `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}`입니다.  
타입: [ValueHolder](API_ValueHolder.md)객체  
필수 여부: 예

 ** [DigestTipAddress](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-DigestTipAddress"></a>
증명을 요청할 다이제스트에 포함된 최신 블록 위치. 주소는 `strandId` 및 `sequenceNo`라는 두 개의 필드로 구성된 Amazon Ion 구조입니다.  
예를 들어 `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}`입니다.  
유형: [ValueHolder](API_ValueHolder.md)객체  
필수 여부: 아니요

 ** [DocumentId](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-DocumentId"></a>
검증할 문서의 UUID(Base62로 인코딩된 텍스트로 표시).  
유형: 문자열  
길이 제약 조건: 고정 길이는 22입니다.  
패턴: `^[A-Za-z-0-9]+$`   
필수 여부: 예

## 응답 구문
<a name="API_GetRevision_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Proof": { 
      "IonText": "string"
   },
   "Revision": { 
      "IonText": "string"
   }
}
```

## 응답 요소
<a name="API_GetRevision_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Proof](#API_GetRevision_ResponseSyntax) **   <a name="qldb-GetRevision-response-Proof"></a>
`GetRevision` 요청을 통해 반환된 Amazon Ion 형식의 증명 객체입니다. 증명은 지정된 문서 개정부터 시작하여 Merkle 트리를 사용하여 지정된 다이제스트를 다시 계산하는 데 필요한 해시 값 목록을 포함합니다.  
유형: [ValueHolder](API_ValueHolder.md)객체

 ** [Revision](#API_GetRevision_ResponseSyntax) **   <a name="qldb-GetRevision-response-Revision"></a>
Amazon Ion 형식의 문서 수정본 데이터 객체입니다.  
타입: [ValueHolder](API_ValueHolder.md) 객체

## 오류
<a name="API_GetRevision_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterException **   
요청에서 하나 이상의 파라미터가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
지정된 리소스가 존재하지 않습니다.  
HTTP 상태 코드: 404

 ** ResourcePreconditionNotMetException **   
조건이 미리 충족되지 않아 작업이 실패했습니다.  
HTTP 상태 코드: 412

## 참고
<a name="API_GetRevision_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/GetRevision) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/GetRevision) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/GetRevision) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/GetRevision) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/GetRevision) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/GetRevision) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/GetRevision) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/GetRevision) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/GetRevision) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/GetRevision) 

# ListJournalKinesisStreamsForLedger
<a name="API_ListJournalKinesisStreamsForLedger"></a>

주어진 원장에 대한 모든 Amazon QLDB 저널 스트림을 반환합니다.

이 작업을 수행해도 만료된 저널 스트림은 반환되지 않습니다. 자세한 내용은 *Amazon QLDB 개발자 안내서*의 [터미널 스트림 만료](https://docs.aws.amazon.com/qldb/latest/developerguide/streams.create.html#streams.create.states.expiration)를 참조하세요.

이 작업을 수행하면 최대 `MaxResults`개의 항목이 반환됩니다. 페이지가 매겨져 있으므로 `ListJournalKinesisStreamsForLedger`를 여러 번 호출하여 모든 항목을 검색할 수 있습니다.

## Request Syntax
<a name="API_ListJournalKinesisStreamsForLedger_RequestSyntax"></a>

```
GET /ledgers/name/journal-kinesis-streams?max_results=MaxResults&next_token=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListJournalKinesisStreamsForLedger_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [name](#API_ListJournalKinesisStreamsForLedger_RequestSyntax) **   <a name="qldb-ListJournalKinesisStreamsForLedger-request-uri-LedgerName"></a>
원장의 명칭입니다.  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
필수 여부: 예

 ** [MaxResults](#API_ListJournalKinesisStreamsForLedger_RequestSyntax) **   <a name="qldb-ListJournalKinesisStreamsForLedger-request-uri-MaxResults"></a>
단일 `ListJournalKinesisStreamsForLedger` 요청에서 반환할 결과의 최대 수입니다. (반환되는 결과의 실제 수는 더 작을 수 있습니다.)  
유효 범위: 최소값 1. 최댓값은 100입니다.

 ** [NextToken](#API_ListJournalKinesisStreamsForLedger_RequestSyntax) **   <a name="qldb-ListJournalKinesisStreamsForLedger-request-uri-NextToken"></a>
페이지 매김 토큰으로, 다음 결과 페이지를 검색할 것임을 나타냅니다. 이전 `ListJournalKinesisStreamsForLedger` 호출의 응답에서 `NextToken`의 값을 수신한 경우, 그 값을 여기에 입력으로 사용해야 합니다.  
길이 제약: 최소 길이는 4입니다. 최대 길이는 1024입니다.  
패턴: `^[A-Za-z-0-9+/=]+$` 

## 요청 본문
<a name="API_ListJournalKinesisStreamsForLedger_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListJournalKinesisStreamsForLedger_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Streams": [ 
      { 
         "Arn": "string",
         "CreationTime": number,
         "ErrorCause": "string",
         "ExclusiveEndTime": number,
         "InclusiveStartTime": number,
         "KinesisConfiguration": { 
            "AggregationEnabled": boolean,
            "StreamArn": "string"
         },
         "LedgerName": "string",
         "RoleArn": "string",
         "Status": "string",
         "StreamId": "string",
         "StreamName": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListJournalKinesisStreamsForLedger_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListJournalKinesisStreamsForLedger_ResponseSyntax) **   <a name="qldb-ListJournalKinesisStreamsForLedger-response-NextToken"></a>
+ `NextToken`이 비어 있는 경우, 결과의 마지막 페이지가 처리된 것이며 더 이상 검색할 결과가 없습니다.
+ `NextToken`이 비어 있지 *않으면* 더 많은 결과를 사용할 수 있습니다. 결과의 그 다음 페이지를 검색하려면 후속 `ListJournalKinesisStreamsForLedger` 호출에서 `NextToken`의 값을 사용합니다.
타입: 문자열  
길이 제약: 최소 길이는 4입니다. 최대 길이는 1024입니다.  
패턴: `^[A-Za-z-0-9+/=]+$` 

 ** [Streams](#API_ListJournalKinesisStreamsForLedger_ResponseSyntax) **   <a name="qldb-ListJournalKinesisStreamsForLedger-response-Streams"></a>
현재 주어진 원장과 연결된 QLDB 저널 스트림.  
타입: [JournalKinesisStreamDescription](API_JournalKinesisStreamDescription.md) 객체 배열

## 오류
<a name="API_ListJournalKinesisStreamsForLedger_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterException **   
요청에서 하나 이상의 파라미터가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
지정된 리소스가 존재하지 않습니다.  
HTTP 상태 코드: 404

 ** ResourcePreconditionNotMetException **   
조건이 미리 충족되지 않아 작업이 실패했습니다.  
HTTP 상태 코드: 412

## 참고
<a name="API_ListJournalKinesisStreamsForLedger_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 

# ListJournalS3Exports
<a name="API_ListJournalS3Exports"></a>

현재 AWS 계정 및 리전과 관련된 모든 원장에 대한 모든 저널 내보내기 작업을 반환합니다.

이 작업은 최대 `MaxResults` 항목을 반환하며 `ListJournalS3Exports` 여러 번 호출하여 모든 항목을 검색할 수 있도록 페이지가 매겨집니다.

이 작업을 수행해도 만료된 내보내기 작업은 반환되지 않습니다. 자세한 내용을 알아보려면 *Amazon QLDB 개발자 안내서*의 [내보내기 작업 만료](https://docs.aws.amazon.com/qldb/latest/developerguide/export-journal.request.html#export-journal.request.expiration)를 참조하세요.

## Request Syntax
<a name="API_ListJournalS3Exports_RequestSyntax"></a>

```
GET /journal-s3-exports?max_results=MaxResults&next_token=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListJournalS3Exports_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [MaxResults](#API_ListJournalS3Exports_RequestSyntax) **   <a name="qldb-ListJournalS3Exports-request-uri-MaxResults"></a>
단일 `ListJournalS3Exports` 요청에서 반환할 결과의 최대 수입니다. (반환되는 결과의 실제 수는 더 작을 수 있습니다.)  
유효 범위: 최소값 1. 최댓값은 100입니다.

 ** [NextToken](#API_ListJournalS3Exports_RequestSyntax) **   <a name="qldb-ListJournalS3Exports-request-uri-NextToken"></a>
페이지 매김 토큰으로, 다음 결과 페이지를 검색할 것임을 나타냅니다. 이전 `ListJournalS3Exports` 호출의 응답에서 `NextToken`의 값을 수신한 경우, 그 값을 여기에 입력으로 사용해야 합니다.  
길이 제약: 최소 길이는 4입니다. 최대 길이는 1024입니다.  
패턴: `^[A-Za-z-0-9+/=]+$` 

## 요청 본문
<a name="API_ListJournalS3Exports_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListJournalS3Exports_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "JournalS3Exports": [ 
      { 
         "ExclusiveEndTime": number,
         "ExportCreationTime": number,
         "ExportId": "string",
         "InclusiveStartTime": number,
         "LedgerName": "string",
         "OutputFormat": "string",
         "RoleArn": "string",
         "S3ExportConfiguration": { 
            "Bucket": "string",
            "EncryptionConfiguration": { 
               "KmsKeyArn": "string",
               "ObjectEncryptionType": "string"
            },
            "Prefix": "string"
         },
         "Status": "string"
      }
   ],
   "NextToken": "string"
}
```

## 응답 요소
<a name="API_ListJournalS3Exports_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [JournalS3Exports](#API_ListJournalS3Exports_ResponseSyntax) **   <a name="qldb-ListJournalS3Exports-response-JournalS3Exports"></a>
현재 AWS 계정 및 리전과 관련된 모든 원장에 대한 저널 내보내기 작업입니다.  
타입: [JournalS3ExportDescription](API_JournalS3ExportDescription.md)객체 배열

 ** [NextToken](#API_ListJournalS3Exports_ResponseSyntax) **   <a name="qldb-ListJournalS3Exports-response-NextToken"></a>
+ `NextToken`이 비어 있는 경우, 결과의 마지막 페이지가 처리된 것이며 더 이상 검색할 결과가 없습니다.
+ `NextToken`이 비어 있지 *않으면* 더 많은 결과를 입수할 수 있습니다. 결과의 그 다음 페이지를 검색하려면 후속 `ListJournalS3Exports` 호출에서 `NextToken`의 값을 사용합니다.
타입: 문자열  
길이 제약: 최소 길이는 4입니다. 최대 길이는 1024입니다.  
패턴: `^[A-Za-z-0-9+/=]+$` 

## 오류
<a name="API_ListJournalS3Exports_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md)를 참조하십시오.

## 참고
<a name="API_ListJournalS3Exports_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ListJournalS3Exports) 

# ListJournalS3ExportsForLedger
<a name="API_ListJournalS3ExportsForLedger"></a>

지정된 원장에 대해 저널 내보내기 작업을 모두 반환합니다.

이 작업은 최대 `MaxResults` 항목을 반환하며 `ListJournalS3ExportsForLedger` 여러 번 호출하여 모든 항목을 검색할 수 있도록 페이지가 매겨집니다.

이 작업을 수행해도 만료된 내보내기 작업은 반환되지 않습니다. 자세한 내용을 알아보려면 *Amazon QLDB 개발자 안내서*의 [내보내기 작업 만료](https://docs.aws.amazon.com/qldb/latest/developerguide/export-journal.request.html#export-journal.request.expiration)를 참조하세요.

## Request Syntax
<a name="API_ListJournalS3ExportsForLedger_RequestSyntax"></a>

```
GET /ledgers/name/journal-s3-exports?max_results=MaxResults&next_token=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListJournalS3ExportsForLedger_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [MaxResults](#API_ListJournalS3ExportsForLedger_RequestSyntax) **   <a name="qldb-ListJournalS3ExportsForLedger-request-uri-MaxResults"></a>
단일 `ListJournalS3ExportsForLedger` 요청에서 반환할 결과의 최대 수입니다. (반환되는 결과의 실제 수는 더 작을 수 있습니다.)  
유효 범위: 최소값 1. 최댓값은 100입니다.

 ** [name](#API_ListJournalS3ExportsForLedger_RequestSyntax) **   <a name="qldb-ListJournalS3ExportsForLedger-request-uri-Name"></a>
원장의 명칭입니다.  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
필수 여부: 예

 ** [NextToken](#API_ListJournalS3ExportsForLedger_RequestSyntax) **   <a name="qldb-ListJournalS3ExportsForLedger-request-uri-NextToken"></a>
페이지 매김 토큰으로, 다음 결과 페이지를 검색할 것임을 나타냅니다. 이전 `ListJournalS3ExportsForLedger` 호출의 응답에서 `NextToken`의 값을 수신한 경우, 그 값을 여기에 입력으로 사용해야 합니다.  
길이 제약: 최소 길이는 4입니다. 최대 길이는 1024입니다.  
패턴: `^[A-Za-z-0-9+/=]+$` 

## 요청 본문
<a name="API_ListJournalS3ExportsForLedger_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListJournalS3ExportsForLedger_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "JournalS3Exports": [ 
      { 
         "ExclusiveEndTime": number,
         "ExportCreationTime": number,
         "ExportId": "string",
         "InclusiveStartTime": number,
         "LedgerName": "string",
         "OutputFormat": "string",
         "RoleArn": "string",
         "S3ExportConfiguration": { 
            "Bucket": "string",
            "EncryptionConfiguration": { 
               "KmsKeyArn": "string",
               "ObjectEncryptionType": "string"
            },
            "Prefix": "string"
         },
         "Status": "string"
      }
   ],
   "NextToken": "string"
}
```

## 응답 요소
<a name="API_ListJournalS3ExportsForLedger_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [JournalS3Exports](#API_ListJournalS3ExportsForLedger_ResponseSyntax) **   <a name="qldb-ListJournalS3ExportsForLedger-response-JournalS3Exports"></a>
현재 지정된 원장과 연관된 저널 내보내기 작업입니다.  
타입: [JournalS3ExportDescription](API_JournalS3ExportDescription.md)객체 배열

 ** [NextToken](#API_ListJournalS3ExportsForLedger_ResponseSyntax) **   <a name="qldb-ListJournalS3ExportsForLedger-response-NextToken"></a>
+ `NextToken`이 비어 있는 경우, 결과의 마지막 페이지가 처리된 것이며 더 이상 검색할 결과가 없습니다.
+ `NextToken`이 비어 있지 *않으면* 더 많은 결과를 입수할 수 있습니다. 결과의 그 다음 페이지를 검색하려면 후속 `ListJournalS3ExportsForLedger` 호출에서 `NextToken`의 값을 사용합니다.
타입: 문자열  
길이 제약: 최소 길이는 4입니다. 최대 길이는 1024입니다.  
패턴: `^[A-Za-z-0-9+/=]+$` 

## 오류
<a name="API_ListJournalS3ExportsForLedger_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md)를 참조하십시오.

## 참고
<a name="API_ListJournalS3ExportsForLedger_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ListJournalS3ExportsForLedger) 

# ListLedgers
<a name="API_ListLedgers"></a>

현재 AWS 계정 및 리전과 연결된 모든 원장을 반환합니다.

이 작업은 최대 `MaxResults`개의 항목을 반환하며 `ListLedgers`를 여러 번 호출함으로써 모든 항목을 검색할 수 있도록 페이지가 매겨집니다.

## Request Syntax
<a name="API_ListLedgers_RequestSyntax"></a>

```
GET /ledgers?max_results=MaxResults&next_token=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListLedgers_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [MaxResults](#API_ListLedgers_RequestSyntax) **   <a name="qldb-ListLedgers-request-uri-MaxResults"></a>
단일 `ListLedgers` 요청에서 반환할 결과의 최대 수입니다. (반환되는 결과의 실제 수는 더 작을 수 있습니다.)  
유효 범위: 최소값 1. 최댓값은 100입니다.

 ** [NextToken](#API_ListLedgers_RequestSyntax) **   <a name="qldb-ListLedgers-request-uri-NextToken"></a>
페이지 매김 토큰으로, 다음 결과 페이지를 검색할 것임을 나타냅니다. 이전 `ListLedgers` 호출의 응답에서 `NextToken`의 값을 수신한 경우, 그 값을 여기에 입력으로 사용해야 합니다.  
길이 제약: 최소 길이는 4입니다. 최대 길이는 1024입니다.  
패턴: `^[A-Za-z-0-9+/=]+$` 

## 요청 본문
<a name="API_ListLedgers_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListLedgers_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Ledgers": [ 
      { 
         "CreationDateTime": number,
         "Name": "string",
         "State": "string"
      }
   ],
   "NextToken": "string"
}
```

## 응답 요소
<a name="API_ListLedgers_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Ledgers](#API_ListLedgers_ResponseSyntax) **   <a name="qldb-ListLedgers-response-Ledgers"></a>
현재 AWS 계정 및 리전과 연결된 원장입니다.  
타입: [LedgerSummary](API_LedgerSummary.md) 객체 배열

 ** [NextToken](#API_ListLedgers_ResponseSyntax) **   <a name="qldb-ListLedgers-response-NextToken"></a>
더 많은 결과가 있는지 여부를 나타내는 페이지 매김 토큰:  
+ `NextToken`이 비어 있는 경우, 결과의 마지막 페이지가 처리된 것이며 더 이상 검색할 결과가 없습니다.
+ `NextToken`이 비어 있지 *않으면* 더 많은 결과를 입수할 수 있습니다. 결과의 그 다음 페이지를 검색하려면 후속 `ListLedgers` 호출에서 `NextToken`의 값을 사용합니다.
타입: 문자열  
길이 제약: 최소 길이는 4입니다. 최대 길이는 1024입니다.  
패턴: `^[A-Za-z-0-9+/=]+$` 

## 오류
<a name="API_ListLedgers_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md)를 참조하십시오.

## 참고
<a name="API_ListLedgers_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ListLedgers) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ListLedgers) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ListLedgers) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ListLedgers) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ListLedgers) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

지정된 Amazon QLDB 리소스의 모든 태그를 반환합니다.

## Request Syntax
<a name="API_ListTagsForResource_RequestSyntax"></a>

```
GET /tags/resourceArn HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListTagsForResource_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [resourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="qldb-ListTagsForResource-request-uri-ResourceArn"></a>
태그를 열거할 Amazon 리소스 이름(ARN)입니다. 예시:  
 `arn:aws:qldb:us-east-1:123456789012:ledger/exampleLedger`   
길이 제약 조건: 최소 길이는 20입니다. 최대 길이는 1,600입니다.  
필수 여부: 예

## Request Body
<a name="API_ListTagsForResource_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListTagsForResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Tags": { 
      "string" : "string" 
   }
}
```

## 응답 요소
<a name="API_ListTagsForResource_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="qldb-ListTagsForResource-response-Tags"></a>
지정된 Amazon QLDB 리소스와 현재 연계되어 있는 태그.  
유형: 문자열 간 맵  
맵 항목: 최소 항목 수는 0개입니다. 최대 항목 수 200개.  
키 길이 제약 조건: 최소 길이는 1. 최대 길이 128.  
값 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 256입니다.

## 오류
<a name="API_ListTagsForResource_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterException **   
요청에서 하나 이상의 파라미터가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
지정된 리소스가 존재하지 않습니다.  
HTTP 상태 코드: 404

## 참고
<a name="API_ListTagsForResource_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ListTagsForResource) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ListTagsForResource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ListTagsForResource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ListTagsForResource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ListTagsForResource) 

# StreamJournalToKinesis
<a name="API_StreamJournalToKinesis"></a>

주어진 Amazon QLDB 원장에 대한 저널 스트림을 생성합니다. 스트림은 원장의 저널에 체결된 모든 문서 개정본을 캡처하고 지정된 Amazon Kinesis Data Streams 리소스로 데이터를 전송합니다.

## Request Syntax
<a name="API_StreamJournalToKinesis_RequestSyntax"></a>

```
POST /ledgers/name/journal-kinesis-streams HTTP/1.1
Content-type: application/json

{
   "ExclusiveEndTime": number,
   "InclusiveStartTime": number,
   "KinesisConfiguration": { 
      "AggregationEnabled": boolean,
      "StreamArn": "string"
   },
   "RoleArn": "string",
   "StreamName": "string",
   "Tags": { 
      "string" : "string" 
   }
}
```

## URI 요청 파라미터
<a name="API_StreamJournalToKinesis_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [name](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-uri-LedgerName"></a>
원장의 명칭입니다.  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
필수 여부: 예

## 요청 본문
<a name="API_StreamJournalToKinesis_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ExclusiveEndTime](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-ExclusiveEndTime"></a>
스트림이 끝날 때를 지정하는 독점 날짜 및 시간입니다. 이 파라미터를 정의하지 않으면 취소하기 전까지 스트림이 무기한 실행됩니다.  
`ISO 8601`은 `ExclusiveEndTime` 날짜 및 시간 형식이어야 하며 협정 세계시(UTC)여야 합니다. 예를 들어 `2019-06-13T21:36:34Z`입니다.  
타입: Timestamp  
필수 여부: 아니요

 ** [InclusiveStartTime](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-InclusiveStartTime"></a>
스트리밍 저널 데이터를 시작할 시작 날짜 및 시간(경계값 포함)입니다. 이 파라미터는 `ISO 8601` 날짜 및 시간 형식이어야 하며 협정 세계시(UTC)여야 합니다. 예를 들어 `2019-06-13T21:36:34Z`입니다.  
`InclusiveStartTime`은 미래 시간일 수 없으며 `ExclusiveEndTime` 이전이어야 합니다.  
원장의 `CreationDateTime` 이전인 `InclusiveStartTime`을 제공하는 경우 , QLDB는 실제로 기본값을 원장의 `CreationDateTime`으로 설정합니다.  
타입: Timestamp  
필수 여부: 예

 ** [KinesisConfiguration](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-KinesisConfiguration"></a>
스트림 요청에 대한 Kinesis Data Streams 대상의 구성 설정입니다.  
타입: [KinesisConfiguration](API_KinesisConfiguration.md) 객체  
필수 여부: 예

 ** [RoleArn](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-RoleArn"></a>
저널 스트림에 Kinesis Data Streams 리소스에 데이터 레코드를 쓸 수 있는 QLDB 권한을 부여하는 IAM 역할의 Amazon 리소스 이름(ARN)입니다.  
저널 스트림을 요청할 때 QLDB에 역할을 전달하려면 IAM 역할 리소스에서 `iam:PassRole` 작업을 수행할 수 있는 권한이 있어야 합니다. 이는 모든 저널 스트림 요청에 필요합니다.  
타입: 문자열  
길이 제약 조건: 최소 길이는 20입니다. 최대 길이는 1,600입니다.  
필수 여부: 예

 ** [StreamName](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-StreamName"></a>
QLDB 저널 스트림에 할당할 명칭입니다. 사용자 정의 명칭은 스트림의 목적을 식별하고 나타내는 데 도움이 될 수 있습니다.  
주어진 원장의 경우, 스트림 명칭은 다른 *활성* 스트림들 사이에서 고유해야 합니다. 스트림 명칭은 *Amazon QLDB 개발자 가이드*의 [Amazon QLDB의 할당량](https://docs.aws.amazon.com/qldb/latest/developerguide/limits.html#limits.naming)에 정의된 원장 명칭과 동일한 명명 제약 조건을 갖습니다.  
타입: 문자열  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
필수 여부: 예

 ** [Tags](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-Tags"></a>
생성하려는 스트림에 태그로 추가하려는 키-값 쌍입니다. 태그 키는 대소문자를 구별합니다. 태그 값은 대소문자를 구분하며 null일 수 있습니다.  
유형: 문자열 간 맵  
맵 항목: 최소 항목 수는 0개입니다. 최대 항목 수 200개.  
키 길이 제약 조건: 최소 길이는 1. 최대 길이 128.  
값 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 256입니다.  
필수 여부: 아니요

## 응답 구문
<a name="API_StreamJournalToKinesis_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "StreamId": "string"
}
```

## 응답 요소
<a name="API_StreamJournalToKinesis_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [StreamId](#API_StreamJournalToKinesis_ResponseSyntax) **   <a name="qldb-StreamJournalToKinesis-response-StreamId"></a>
QLDB가 각 QLDB 저널 스트림에 할당하는 UUID(Base62로 인코딩된 텍스트로 표시됨)입니다.  
타입: 문자열  
길이 제약 조건: 고정 길이는 22입니다.  
패턴: `^[A-Za-z-0-9]+$` 

## 오류
<a name="API_StreamJournalToKinesis_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterException **   
요청에서 하나 이상의 파라미터가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
지정된 리소스가 존재하지 않습니다.  
HTTP 상태 코드: 404

 ** ResourcePreconditionNotMetException **   
조건이 미리 충족되지 않아 작업이 실패했습니다.  
HTTP 상태 코드: 412

## 참고
<a name="API_StreamJournalToKinesis_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/StreamJournalToKinesis) 

# TagResource
<a name="API_TagResource"></a>

지정된 Amazon QLDB 리소스에 하나 이상의 태그를 추가합니다.

리소스는 최대 50개의 태그를 가질 수 있습니다. 리소스에 대해 50개가 넘는 태그를 만들려고 하면 요청이 실패하고 오류가 반환됩니다.

## Request Syntax
<a name="API_TagResource_RequestSyntax"></a>

```
POST /tags/resourceArn HTTP/1.1
Content-type: application/json

{
   "Tags": { 
      "string" : "string" 
   }
}
```

## URI 요청 파라미터
<a name="API_TagResource_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [resourceArn](#API_TagResource_RequestSyntax) **   <a name="qldb-TagResource-request-uri-ResourceArn"></a>
태그를 추가할 Amazon 리소스 이름(ARN)입니다. 예시:  
 `arn:aws:qldb:us-east-1:123456789012:ledger/exampleLedger`   
길이 제약 조건: 최소 길이는 20입니다. 최대 길이는 1,600입니다.  
필수 여부: 예

## 요청 본문
<a name="API_TagResource_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="qldb-TagResource-request-Tags"></a>
지정된 QLDB 리소스에 태그로 추가할 키-값 쌍입니다. 태그 키는 대소문자를 구별합니다. 리소스에 이미 있는 키를 지정하면 요청이 실패하고 오류가 반환됩니다. 태그 값은 대소문자를 구분하며 null일 수 있습니다.  
유형: 문자열 간 맵  
맵 항목: 최소 항목 수는 0개입니다. 최대 항목 수 200개.  
키 길이 제약 조건: 최소 길이는 1. 최대 길이 128.  
값 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 256.  
필수 여부: 예

## 응답 구문
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_TagResource_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_TagResource_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterException **   
요청에서 하나 이상의 파라미터가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
지정된 리소스가 존재하지 않습니다.  
HTTP 상태 코드: 404

## 참고
<a name="API_TagResource_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/TagResource) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/TagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/TagResource) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/TagResource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/TagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/TagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/TagResource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/TagResource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/TagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

지정된 Amazon QLDB 리소스에서 하나 이상의 태그를 제거합니다. 삭제할 태그 키를 최대 50개 지정할 수 있습니다.

## Request Syntax
<a name="API_UntagResource_RequestSyntax"></a>

```
DELETE /tags/resourceArn?tagKeys=TagKeys HTTP/1.1
```

## URI 요청 파라미터
<a name="API_UntagResource_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [resourceArn](#API_UntagResource_RequestSyntax) **   <a name="qldb-UntagResource-request-uri-ResourceArn"></a>
태그를 제거할 Amazon 리소스 이름(ARN)입니다. 예시:  
 `arn:aws:qldb:us-east-1:123456789012:ledger/exampleLedger`   
길이 제약 조건: 최소 길이는 20입니다. 최대 길이는 1,600입니다.  
필수 여부: 예

 ** [TagKeys](#API_UntagResource_RequestSyntax) **   <a name="qldb-UntagResource-request-uri-TagKeys"></a>
제거할 태그 키의 목록입니다.  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
길이 제약: 최소 길이 1. 최대 길이는 128.  
필수 여부: 예

## Request Body
<a name="API_UntagResource_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_UntagResource_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_UntagResource_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterException **   
요청에서 하나 이상의 파라미터가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
지정된 리소스가 존재하지 않습니다.  
HTTP 상태 코드: 404

## 참고
<a name="API_UntagResource_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/UntagResource) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/UntagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/UntagResource) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/UntagResource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/UntagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/UntagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/UntagResource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/UntagResource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/UntagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/UntagResource) 

# UpdateLedger
<a name="API_UpdateLedger"></a>

원장의 속성을 업데이트합니다.

## Request Syntax
<a name="API_UpdateLedger_RequestSyntax"></a>

```
PATCH /ledgers/name HTTP/1.1
Content-type: application/json

{
   "DeletionProtection": boolean,
   "KmsKey": "string"
}
```

## URI 요청 파라미터
<a name="API_UpdateLedger_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [name](#API_UpdateLedger_RequestSyntax) **   <a name="qldb-UpdateLedger-request-uri-Name"></a>
원장의 명칭입니다.  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
필수 여부: 예

## 요청 본문
<a name="API_UpdateLedger_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [DeletionProtection](#API_UpdateLedger_RequestSyntax) **   <a name="qldb-UpdateLedger-request-DeletionProtection"></a>
사용자에 의해 삭제되지 않도록 원장을 보호할지 여부를 지정합니다. 원장 생성 중 정의하지 않을 경우 이 기능이 기본적으로 활성화됩니다(`true`).  
삭제 방지가 활성화된 경우 원장을 삭제하려면 먼저 이 기능을 비활성화해야 합니다. `UpdateLedger` 작업을 호출하여 이 파라미터를 `false`로 설정하면 비활성화할 수 있습니다.  
유형: 부울  
필수 항목 여부: 아니요

 ** [KmsKey](#API_UpdateLedger_RequestSyntax) **   <a name="qldb-UpdateLedger-request-KmsKey"></a>
원장의 저장 데이터 암호화에 사용할 in AWS Key Management Service (AWS KMS) 키입니다. 자세한 내용을 알아보려면 *Amazon QLDB 개발자 안내서*의 [저장된 암호화](https://docs.aws.amazon.com/qldb/latest/developerguide/encryption-at-rest.html)를 참조하세요.  
다음 옵션 중 하나를 사용하여 이 파라미터를 지정합니다.  
+  `AWS_OWNED_KMS_KEY`: 사용자를 대신하여에서 소유하고 관리하는 AWS KMS AWS 키를 사용합니다.
+  **정의되지 않음**: 원장의 KMS 키를 변경하지 않습니다.
+  **유효한 대칭 고객 관리형 KMS 키**: 사용자가 생성, 소유 및 관리하는 계정의 지정된 대칭 암호화 KMS 키를 사용합니다.

  Amazon QLDB에서는 비대칭 키가 지원되지 않습니다. 자세한 내용은 * AWS Key Management Service 개발자 안내서*의 [대칭 및 비대칭 키 사용을](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) 참조하세요.
고객 관리형 KMS 키를 지정하려면 해당 키 ID, Amazon 리소스 이름(ARN), 별칭 이름 또는 별칭 ARN을 사용할 수 있습니다. 별칭 이름을 사용할 때 `"alias/"`를 접두사를 사용합니다. 다른에서 키를 지정하려면 키 ARN 또는 별칭 ARN을 사용해야 AWS 계정합니다.  
예시:  
+ 키 ID: `1234abcd-12ab-34cd-56ef-1234567890ab` 
+ 키 ARN: `arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` 
+ 별칭 이름: `alias/ExampleAlias` 
+ 별칭 ARN: `arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias` 
자세한 내용은 * AWS Key Management Service 개발자 안내서*의 [키 식별자(KeyId)](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id)를 참조하세요.  
유형: 문자열  
길이 제약 조건: 최대 길이는 1,600입니다.  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_UpdateLedger_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Arn": "string",
   "CreationDateTime": number,
   "DeletionProtection": boolean,
   "EncryptionDescription": { 
      "EncryptionStatus": "string",
      "InaccessibleKmsKeyDateTime": number,
      "KmsKeyArn": "string"
   },
   "Name": "string",
   "State": "string"
}
```

## 응답 요소
<a name="API_UpdateLedger_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Arn](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-Arn"></a>
원장의 Amazon 리소스 이름(ARN)입니다.  
타입: 문자열  
길이 제약 조건: 최소 길이는 20입니다. 최대 길이는 1,600입니다.

 ** [CreationDateTime](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-CreationDateTime"></a>
원장이 생성된 날짜와 시간(epoch 시간 형식)입니다. (epoch 시간 형식은 UTC 기준으로 1970년 1월 1일 자정 12:00:00부터 경과된 초 단위의 시간입니다.)  
유형: 타임스탬프

 ** [DeletionProtection](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-DeletionProtection"></a>
사용자에 의해 삭제되지 않도록 원장을 보호할지 여부를 지정합니다. 원장 생성 중 정의하지 않을 경우 이 기능이 기본적으로 활성화됩니다(`true`).  
삭제 방지가 활성화된 경우 원장을 삭제하려면 먼저 이 기능을 비활성화해야 합니다. `UpdateLedger` 작업을 호출하여 이 파라미터를 `false`로 설정하면 비활성화할 수 있습니다.  
유형: 부울

 ** [EncryptionDescription](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-EncryptionDescription"></a>
원장의 저장 데이터 암호화에 대한 정보. 여기에는 현재 상태, AWS KMS 키, 키에 액세스할 수 없게 된 시간(오류 발생 시)이 포함됩니다.  
유형: [LedgerEncryptionDescription](API_LedgerEncryptionDescription.md)객체

 ** [Name](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-Name"></a>
원장의 명칭입니다.  
타입: 문자열  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$` 

 ** [State](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-State"></a>
원장의 현재 상태입니다.  
타입: 문자열  
유효 값: `CREATING | ACTIVE | DELETING | DELETED` 

## 오류
<a name="API_UpdateLedger_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterException **   
요청에서 하나 이상의 파라미터가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
지정된 리소스가 존재하지 않습니다.  
HTTP 상태 코드: 404

## 참고
<a name="API_UpdateLedger_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/UpdateLedger) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/UpdateLedger) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/UpdateLedger) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/UpdateLedger) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/UpdateLedger) 

# UpdateLedgerPermissionsMode
<a name="API_UpdateLedgerPermissionsMode"></a>

원장의 권한 모드를 업데이트합니다.

**중요**  
`STANDARD` 권한 모드로 전환하기 전에 먼저 필요한 모든 IAM 정책과 표 태그를 생성하여 사용자에게 방해가 되지 않도록 해야 합니다. 자세히 알아보려면 *Amazon QLDB 개발자 가이드*의 [표준 권한 모드로 마이그레이션](https://docs.aws.amazon.com/qldb/latest/developerguide/ledger-management.basics.html#ledger-mgmt.basics.update-permissions.migrating)을 참조하세요.

## Request Syntax
<a name="API_UpdateLedgerPermissionsMode_RequestSyntax"></a>

```
PATCH /ledgers/name/permissions-mode HTTP/1.1
Content-type: application/json

{
   "PermissionsMode": "string"
}
```

## URI 요청 파라미터
<a name="API_UpdateLedgerPermissionsMode_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [name](#API_UpdateLedgerPermissionsMode_RequestSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-request-uri-Name"></a>
원장의 명칭입니다.  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
필수 여부: 예

## 요청 본문
<a name="API_UpdateLedgerPermissionsMode_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [PermissionsMode](#API_UpdateLedgerPermissionsMode_RequestSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-request-PermissionsMode"></a>
원장에 할당할 권한 모드입니다. 이 파라미터는 다음 값 중 하나를 가질 수 있습니다.  
+  `ALLOW_ALL`: 원장에 대한 API 수준 세분화로 액세스 통제를 가능하게 하는 레거시 권한 모드입니다.

  이 모드를 사용하면 이 원장에 대한 `SendCommand` API 권한이 있는 사용자가 지정된 원장의 모든 표에서 모든 PartiQL 명령(따라서 `ALLOW_ALL`)을 실행할 수 있습니다. 이 모드는 원장에 대해 생성하는 모든 표 수준 또는 명령 수준 IAM 권한 정책을 무시합니다.
+  `STANDARD`: (*권장*) 원장, 테이블 및 PartiQL 명령에 대해 보다 세분화된 액세스 제어를 가능하게 하는 권한 모드입니다..

  기본적으로 이 모드는 이 원장의 모든 표에서 PartiQL 명령을 실행하려는 모든 사용자 요청을 거부합니다. PartiQL 명령 실행을 허용하려면 원장에 대한 `SendCommand` API 권한 외에도 특정 테이블 리소스 및 PartiQL 작업에 대한 IAM 권한 정책을 생성해야 합니다. 자세한 내용은 *Amazon QLDB 개발자 안내서*의 [표준 권한 모드로 시작하기](https://docs.aws.amazon.com/qldb/latest/developerguide/getting-started-standard-mode.html)를 참조하세요.
원장 데이터의 보안을 극대화하려면 `STANDARD` 권한 모드를 사용하는 것이 좋습니다.
타입: 문자열  
유효 값: `ALLOW_ALL | STANDARD`   
필수 여부: 예

## 응답 구문
<a name="API_UpdateLedgerPermissionsMode_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Arn": "string",
   "Name": "string",
   "PermissionsMode": "string"
}
```

## 응답 요소
<a name="API_UpdateLedgerPermissionsMode_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Arn](#API_UpdateLedgerPermissionsMode_ResponseSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-response-Arn"></a>
원장의 Amazon 리소스 이름(ARN)입니다.  
타입: 문자열  
길이 제약 조건: 최소 길이는 20입니다. 최대 길이는 1,600입니다.

 ** [Name](#API_UpdateLedgerPermissionsMode_ResponseSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-response-Name"></a>
원장의 명칭입니다.  
타입: 문자열  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$` 

 ** [PermissionsMode](#API_UpdateLedgerPermissionsMode_ResponseSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-response-PermissionsMode"></a>
원장의 현재 권한 모드입니다.  
타입: 문자열  
유효 값: `ALLOW_ALL | STANDARD` 

## 오류
<a name="API_UpdateLedgerPermissionsMode_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterException **   
요청에서 하나 이상의 파라미터가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
지정된 리소스가 존재하지 않습니다.  
HTTP 상태 코드: 404

## 참고
<a name="API_UpdateLedgerPermissionsMode_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 

# Amazon QLDB 세션
<a name="API_Operations_Amazon_QLDB_Session"></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/)을 참조하세요.

Amazon QLDB 세션에서는 다음 작업을 지원합니다.
+  [SendCommand](API_QLDB-Session_SendCommand.md) 

# SendCommand
<a name="API_QLDB-Session_SendCommand"></a>

Amazon QLDB 원장에 명령을 보냅니다.

**참고**  
이 API와 직접 상호 작용하는 대신 QLDB 드라이버 또는 QLDB 쉘을 사용하여 원장에서 데이터 트랜잭션을 실행하는 것이 좋습니다.  
 AWS SDK로 작업하는 경우 QLDB 드라이버를 사용합니다. 드라이버는 이 *QLDB 세션* 데이터 API 위에 높은 수준의 추상화 계층을 제공하고 사용자를 대신하여 `SendCommand` 작업을 관리합니다. 지원되는 프로그래밍 언어에 대한 자세한 내용과 목록은 *Amazon QLDB 개발자 가이드*의 [드라이버 시작하기](https://docs.aws.amazon.com/qldb/latest/developerguide/getting-started-driver.html)를 참조하세요.
 AWS Command Line Interface (AWS CLI)로 작업하는 경우 QLDB 쉘을 사용합니다. 쉘은 QLDB 드라이버를 사용하여 원장과 상호 작용하는 명령줄 인터페이스입니다. 자세한 설명은 [Accessing Amazon QLDB using the QLDB shell](https://docs.aws.amazon.com/qldb/latest/developerguide/data-shell.html) 섹션을 참조하세요.

## 구문 요청
<a name="API_QLDB-Session_SendCommand_RequestSyntax"></a>

```
{
   "AbortTransaction": { 
   },
   "CommitTransaction": { 
      "CommitDigest": blob,
      "TransactionId": "string"
   },
   "EndSession": { 
   },
   "ExecuteStatement": { 
      "Parameters": [ 
         { 
            "IonBinary": blob,
            "IonText": "string"
         }
      ],
      "Statement": "string",
      "TransactionId": "string"
   },
   "FetchPage": { 
      "NextPageToken": "string",
      "TransactionId": "string"
   },
   "SessionToken": "string",
   "StartSession": { 
      "LedgerName": "string"
   },
   "StartTransaction": { 
   }
}
```

## 요청 파라미터
<a name="API_QLDB-Session_SendCommand_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [AbortTransaction](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-AbortTransaction"></a>
현재 트랜잭션을 중지하는 명령입니다.  
타입: [AbortTransactionRequest](API_QLDB-Session_AbortTransactionRequest.md) 객체  
필수 여부: 아니요

 ** [CommitTransaction](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-CommitTransaction"></a>
지정된 트랜잭션을 체결하는 명령입니다.  
타입: [CommitTransactionRequest](API_QLDB-Session_CommitTransactionRequest.md) 객체  
필수 여부: 아니요

 ** [EndSession](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-EndSession"></a>
현재 세션을 종료하는 명령입니다.  
타입: [EndSessionRequest](API_QLDB-Session_EndSessionRequest.md) 객체  
필수 여부: 아니요

 ** [ExecuteStatement](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-ExecuteStatement"></a>
지정된 트랜잭션에서 문을 실행하는 명령입니다.  
타입: [ExecuteStatementRequest](API_QLDB-Session_ExecuteStatementRequest.md) 객체  
필수 여부: 아니요

 ** [FetchPage](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-FetchPage"></a>
페이지를 가져오는 명령입니다.  
타입: [FetchPageRequest](API_QLDB-Session_FetchPageRequest.md) 객체  
필수 여부: 아니요

 ** [SessionToken](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-SessionToken"></a>
현재 명령의 세션 토큰을 지정합니다. 세션 토큰은 세션 수명 내내 일정합니다.  
세션 토큰을 가져오려면 `StartSession` 명령을 실행합니다. 이 `SessionToken`는 현재 세션 중에 실행되는 모든 후속 명령에 필요합니다.  
타입: 문자열  
길이 제약: 최소 길이는 4입니다. 최대 길이는 1024입니다.  
패턴: `^[A-Za-z-0-9+/=]+$`   
필수 여부: 아니요

 ** [StartSession](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-StartSession"></a>
새 세션을 시작하는 명령입니다. 응답의 일부로 세션 토큰을 얻습니다.  
타입: [StartSessionRequest](API_QLDB-Session_StartSessionRequest.md) 객체  
필수 여부: 아니요

 ** [StartTransaction](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-StartTransaction"></a>
새 트랜잭션을 시작하는 명령입니다.  
타입: [StartTransactionRequest](API_QLDB-Session_StartTransactionRequest.md) 객체  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_QLDB-Session_SendCommand_ResponseSyntax"></a>

```
{
   "AbortTransaction": { 
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      }
   },
   "CommitTransaction": { 
      "CommitDigest": blob,
      "ConsumedIOs": { 
         "ReadIOs": number,
         "WriteIOs": number
      },
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      },
      "TransactionId": "string"
   },
   "EndSession": { 
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      }
   },
   "ExecuteStatement": { 
      "ConsumedIOs": { 
         "ReadIOs": number,
         "WriteIOs": number
      },
      "FirstPage": { 
         "NextPageToken": "string",
         "Values": [ 
            { 
               "IonBinary": blob,
               "IonText": "string"
            }
         ]
      },
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      }
   },
   "FetchPage": { 
      "ConsumedIOs": { 
         "ReadIOs": number,
         "WriteIOs": number
      },
      "Page": { 
         "NextPageToken": "string",
         "Values": [ 
            { 
               "IonBinary": blob,
               "IonText": "string"
            }
         ]
      },
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      }
   },
   "StartSession": { 
      "SessionToken": "string",
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      }
   },
   "StartTransaction": { 
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      },
      "TransactionId": "string"
   }
}
```

## 응답 요소
<a name="API_QLDB-Session_SendCommand_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [AbortTransaction](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-AbortTransaction"></a>
중단된 트랜잭션의 세부 정보를 포함합니다.  
타입: [AbortTransactionResult](API_QLDB-Session_AbortTransactionResult.md) 객체

 ** [CommitTransaction](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-CommitTransaction"></a>
커밋된 트랜잭션의 세부 정보를 포함합니다.  
타입: [CommitTransactionResult](API_QLDB-Session_CommitTransactionResult.md) 객체

 ** [EndSession](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-EndSession"></a>
종료된 세션의 세부 정보를 포함합니다.  
타입: [EndSessionResult](API_QLDB-Session_EndSessionResult.md) 객체

 ** [ExecuteStatement](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-ExecuteStatement"></a>
실행된 명령문의 세부 정보를 포함합니다.  
타입: [ExecuteStatementResult](API_QLDB-Session_ExecuteStatementResult.md) 객체

 ** [FetchPage](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-FetchPage"></a>
가져온 페이지의 세부 정보를 포함합니다.  
타입: [FetchPageResult](API_QLDB-Session_FetchPageResult.md) 객체

 ** [StartSession](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-StartSession"></a>
세션 토큰이 포함된 시작된 세션의 세부 정보를 포함합니다. 이 `SessionToken`는 현재 세션 중에 실행되는 모든 후속 명령에 필요합니다.  
타입: [StartSessionResult](API_QLDB-Session_StartSessionResult.md) 객체

 ** [StartTransaction](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-StartTransaction"></a>
시작된 트랜잭션의 세부 정보를 포함합니다.  
타입: [StartTransactionResult](API_QLDB-Session_StartTransactionResult.md) 객체

## 오류
<a name="API_QLDB-Session_SendCommand_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** BadRequestException **   
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.  
HTTP 상태 코드: 400

 ** CapacityExceededException **   
요청이 원장의 처리 용량을 초과할 때 반환됩니다.  
HTTP 상태 코드: 400

 ** InvalidSessionException **   
제한 시간이 초과되었거나 만료되어 세션이 더 이상 존재하지 않는 경우 반환됩니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
활성 세션 수와 같은 리소스 제한을 초과할 경우 반환됩니다.  
HTTP 상태 코드: 400

 ** OccConflictException **   
OCC(*낙관적 동시성 제어*)의 검증 단계에서 실패로 인해 트랜잭션을 저널에 기록할 수 없을 때 반환됩니다.  
HTTP 상태 코드: 400

 ** RateExceededException **   
요청율이 허용된 처리량을 초과할 때 반환됩니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_QLDB-Session_SendCommand_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-session-2019-07-11/SendCommand) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-session-2019-07-11/SendCommand) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-session-2019-07-11/SendCommand) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-session-2019-07-11/SendCommand) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-session-2019-07-11/SendCommand)