기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
ListJournalKinesisStreamsForLedger
주어진 원장에 대한 모든 Amazon QLDB 저널 스트림을 반환합니다.
이 작업을 수행해도 만료된 저널 스트림은 반환되지 않습니다. 자세한 내용은 Amazon QLDB 개발자 안내서의 터미널 스트림 만료를 참조하십시오.
이 작업을 수행하면 최대 MaxResults개의 항목이 반환됩니다. 페이지가 매겨져 있으므로 ListJournalKinesisStreamsForLedger를 여러 번 호출하여 모든 항목을 검색할 수 있습니다.
Request Syntax
GET /ledgers/name/journal-kinesis-streams?max_results=MaxResults&next_token=NextToken HTTP/1.1
URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
- name
-
원장의 명칭입니다.
길이 제약: 최소 길이 1. 최대 길이 32.
패턴:
(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$필수 사항 여부: Yes
- MaxResults
-
단일
ListJournalKinesisStreamsForLedger요청에서 반환할 결과의 최대 수입니다. (반환되는 결과의 실제 수는 더 작을 수 있습니다.)유효 범위: 최소값은 1입니다. 최댓값은 100입니다.
- NextToken
-
페이지 매김 토큰으로, 다음 결과 페이지를 검색할 것임을 나타냅니다. 이전
ListJournalKinesisStreamsForLedger호출의 응답에서NextToken의 값을 수신한 경우, 그 값을 여기에 입력으로 사용해야 합니다.길이 제약: 최소 길이는 4입니다. 최대 길이는 1024입니다.
패턴:
^[A-Za-z-0-9+/=]+$
요청 본문
해당 요청에는 본문이 없습니다.
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Streams": [
{
"Arn": "string",
"CreationTime": number,
"ErrorCause": "string",
"ExclusiveEndTime": number,
"InclusiveStartTime": number,
"KinesisConfiguration": {
"AggregationEnabled": boolean,
"StreamArn": "string"
},
"LedgerName": "string",
"RoleArn": "string",
"Status": "string",
"StreamId": "string",
"StreamName": "string"
}
]
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- NextToken
-
-
NextToken이 비어 있는 경우, 결과의 마지막 페이지가 처리된 것이며 더 이상 검색할 결과가 없습니다. -
NextToken이 비어 있지 않으면 더 많은 결과를 사용할 수 있습니다. 결과의 그 다음 페이지를 검색하려면 후속ListJournalKinesisStreamsForLedger호출에서NextToken의 값을 사용합니다.
타입: 문자열
길이 제약: 최소 길이는 4입니다. 최대 길이는 1024입니다.
패턴:
^[A-Za-z-0-9+/=]+$ -
- Streams
-
현재 주어진 원장과 연결된 QLDB 저널 스트림.
타입: JournalKinesisStreamDescription 객체 배열
Errors
모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하십시오.
- InvalidParameterException
-
요청에서 하나 이상의 파라미터가 유효하지 않습니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
지정된 리소스가 존재하지 않습니다.
HTTP 상태 코드: 404
- ResourcePreconditionNotMetException
-
조건이 미리 충족되지 않아 작업이 실패했습니다.
HTTP 상태 코드: 412
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
