기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
ListStreams
StreamInfo
객체 배열을 반환합니다. 각 객체는 스트림을 설명합니다. 특정 조건을 충족하는 스트림만 검색하려면 a를 지정하면 StreamNameCondition
됩니다.
Request Syntax
POST /listStreams HTTP/1.1
Content-type: application/json
{
"MaxResults": number
,
"NextToken": "string
",
"StreamNameCondition": {
"ComparisonOperator": "string
",
"ComparisonValue": "string
"
}
}
URI 요청 파라미터
요청은 URI 파라미터를 사용하지 않습니다.
요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
- MaxResults
-
응답에서 반환할 최대 스트림 수입니다. 기본값은 10,000입니다.
타입: 정수
유효한 범위: 최소값 1. 최대값은 10,000입니다.
필수 여부: 아니요
- NextToken
-
이 매개 변수를 지정하는 경우
ListStreams
작업 결과가 잘리면 호출은NextToken
응답에서 를 반환합니다. 다른 스트림 배치를 가져오려면 다음 요청 시 이 토큰을 제공하십시오.타입: 문자열
길이 제한: 최소 길이는 0. 최대 길이는 512입니다.
패턴:
[a-zA-Z0-9+/=]*
Required: No
- StreamNameCondition
-
선택 사항: 특정 조건을 충족하는 스트림만 반환합니다. 현재는 스트림 이름의 접두사만 조건으로 지정할 수 있습니다.
유형: StreamNameCondition객체
필수 항목 여부: 아니요
응답 구문
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"StreamInfoList": [
{
"CreationTime": number,
"DataRetentionInHours": number,
"DeviceName": "string",
"KmsKeyId": "string",
"MediaType": "string",
"Status": "string",
"StreamARN": "string",
"StreamName": "string",
"Version": "string"
}
]
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- NextToken
-
응답이 잘린 경우 호출 시 토큰과 함께 이 요소가 반환됩니다. 다음 스트림 배치를 가져오려면 다음 요청에서 이 토큰을 사용하세요.
타입: 문자열
길이 제한: 최소 길이는 0. 최대 길이는 512입니다.
패턴:
[a-zA-Z0-9+/=]*
- StreamInfoList
-
StreamInfo
객체 어레이.타입: StreamInfo 객체 배열
Errors
모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- ClientLimitExceededException
-
허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams가 요청 병목 현상을 일으켰습니다. 나중에 전화를 걸어 보세요.
HTTP 상태 코드: 400
- InvalidArgumentException
-
이 입력 매개변수의 값이 유효하지 않습니다.
HTTP 상태 코드: 400
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.