ExportJournalToS3 - 아마존 퀀텀 레저 데이터베이스 (아마존QLDB)
Request SyntaxURI 요청 파라미터요청 본문응답 구문응답 요소Errors참고

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

ExportJournalToS3

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

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

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

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

Request Syntax

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 요청 파라미터

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

name

원장의 명칭입니다.

길이 제약: 최소 길이 1. 최대 길이 32.

패턴: (?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$

필수 사항 여부: Yes

요청 본문

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

ExclusiveEndTime

내보내기할 저널 콘텐츠 범위에 대한 불포함 종료 날짜 및 시간.

ISO 8601은 ExclusiveEndTime 날짜 및 시간 형식이어야 하며 협정 세계시(UTC)여야 합니다. 예를 들면 2019-06-13T21:36:34Z입니다.

ExclusiveEndTime는 현재 UTC 날짜 및 시간보다 작거나 같아야 합니다.

유형: 타임스탬프

필수 여부: 예

InclusiveStartTime

내보기할 저널 콘텐츠 범위에 대한 포함 시작 날짜 및 시간.

ISO 8601은 InclusiveStartTime 날짜 및 시간 형식이어야 하며 협정 세계시(UTC)여야 합니다. 예를 들면 2019-06-13T21:36:34Z입니다.

InclusiveStartTime는 ExclusiveEndTime 이전이어야 합니다.

원장의 CreationDateTime 이전인 InclusiveStartTime을 제공하는 경우, Amazon QLDB는 기본값을 원장의 CreationDateTime으로 설정합니다.

유형: 타임스탬프

필수 여부: 예

OutputFormat

내보내기할 저널 데이터의 출력 형식. 저널 내보내기 작업은 Amazon Ion 형식의 텍스트 또는 이진 표현이나 JSON Lines 텍스트 형식으로 데이터 객체를 쓸 수 있습니다.

기본값: ION_TEXT

JSON Lines 형식에서 내보낸 데이터 객체의 각 저널 블록은 줄 바꿈으로 구분된 유효한 JSON 객체입니다. 이 형식을 사용하여 JSON 내보내기를 Amazon Athena 및 AWS Glue 와 같은 분석 도구와 직접 통합할 수 있습니다. 이러한 서비스는 줄바꿈으로 구분된 JSON을 자동으로 파싱할 수 있기 때문입니다.

타입: 문자열

유효 값: ION_BINARY | ION_TEXT | JSON

필수 여부: 아니요

RoleArn

다음을 수행하기 위해 저널 내보내기 작업에 대한 QLDB 권한을 부여하는 IAM 역할의 Amazon 리소스 이름(ARN)입니다.

  • Amazon S3 버킷에 객체를 작성합니다.

  • (선택 사항) 내보낸 데이터의 서버 측 암호화에 고객 관리 키 in AWS Key Management Service (AWS KMS) 을 사용하십시오.

저널 내보내기를 요청할 때 QLDB에 역할을 전달하려면 IAM 역할 리소스에서 iam:PassRole 작업을 수행할 수 있는 권한이 있어야 합니다. 이는 모든 저널 내보내기 요청에 필요합니다.

타입: 문자열

길이 제약 조건: 최소 길이는 20입니다. 최대 길이는 1,600입니다.

필수 여부: 예

S3ExportConfiguration

내보내기 요청에 대한 Amazon S3 버킷 대상의 구성 설정입니다.

유형: S3ExportConfiguration객체

필수 여부: 예

응답 구문

HTTP/1.1 200
Content-type: application/json

{
   "ExportId": "string"
}

응답 요소

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

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

ExportId

QLDB가 각 저널 내보내기 작업에 할당하는 UUID(Base62로 인코딩된 텍스트로 표시됨).

ExportId를 사용하여 DescribeJournalS3Export를 호출하여 내보내기 요청을 설명하고 작업 상태를 확인할 수 있습니다.

타입: 문자열

길이 제약 조건: 고정 길이는 22입니다.

패턴: ^[A-Za-z-0-9]+$

Errors

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하십시오.

ResourceNotFoundException

지정된 리소스가 존재하지 않습니다.

HTTP 상태 코드: 404

ResourcePreconditionNotMetException

조건이 미리 충족되지 않아 작업이 실패했습니다.

HTTP 상태 코드: 412

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.