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

# 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)