기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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 8601
은ExclusiveEndTime
날짜 및 시간 형식이어야 하며 협정 세계시(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를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.