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

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