StreamJournalToKinesis - Amazon Quantum 원장 데이터베이스(Amazon QLDB)

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

StreamJournalToKinesis

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

Request Syntax

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

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

name

원장의 명칭입니다.

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

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

필수 사항 여부: Yes

요청 본문

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

ExclusiveEndTime

스트림이 끝날 때를 지정하는 독점 날짜 및 시간입니다. 이 파라미터를 정의하지 않으면 취소하기 전까지 스트림이 무기한 실행됩니다.

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

타입: Timestamp

필수 여부: 아니요

InclusiveStartTime

스트리밍 저널 데이터를 시작할 시작 날짜 및 시간(경계값 포함)입니다. 이 파라미터는 ISO 8601 날짜 및 시간 형식이어야 하며 협정 세계시(UTC)여야 합니다. 예를 들면 2019-06-13T21:36:34Z입니다.

InclusiveStartTime은 미래 시간일 수 없으며 ExclusiveEndTime 이전이어야 합니다.

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

타입: Timestamp

필수 여부: 예

KinesisConfiguration

스트림 요청에 대한 Kinesis Data Streams 대상의 구성 설정입니다.

타입: KinesisConfiguration 객체

필수 여부: 예

RoleArn

저널 스트림에 Kinesis Data Streams 리소스에 데이터 레코드를 쓸 수 있는 QLDB 권한을 부여하는 IAM 역할의 Amazon 리소스 이름(ARN)입니다.

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

타입: 문자열

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

필수 여부: 예

StreamName

QLDB 저널 스트림에 할당할 명칭입니다. 사용자 정의 명칭은 스트림의 목적을 식별하고 나타내는 데 도움이 될 수 있습니다.

주어진 원장의 경우, 스트림 명칭은 다른 활성 스트림들 사이에서 고유해야 합니다. 스트림 명칭은 Amazon QLDB 개발자 가이드Amazon QLDB의 할당량에 정의된 원장 명칭과 동일한 명명 제약 조건을 갖습니다.

타입: 문자열

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

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

필수 여부: 예

Tags

생성하려는 스트림에 태그로 추가하려는 키-값 쌍입니다. 태그 키는 대소문자를 구별합니다. 태그 값은 대소문자를 구분하며 null일 수 있습니다.

유형: 문자열 간 맵

맵 항목: 최소 항목 수는 0개입니다. 최대 항목 수 200개.

키 길이 제약 조건: 최소 길이는 1. 최대 길이 128.

값 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 256입니다.

필수 여부: 아니요

응답 구문

HTTP/1.1 200 Content-type: application/json { "StreamId": "string" }

응답 요소

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

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

StreamId

QLDB가 각 QLDB 저널 스트림에 할당하는 UUID(Base62로 인코딩된 텍스트로 표시됨)입니다.

타입: 문자열

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

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

Errors

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

InvalidParameterException

요청에서 하나 이상의 파라미터가 유효하지 않습니다.

HTTP 상태 코드: 400

ResourceNotFoundException

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

HTTP 상태 코드: 404

ResourcePreconditionNotMetException

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

HTTP 상태 코드: 412

참고

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