기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DescribeImageGenerationConfiguration
지정된 Kinesis 비디오 ImageGenerationConfiguration 스트림에 대한 을 가져옵니다.
Request Syntax
POST /describeImageGenerationConfiguration HTTP/1.1
Content-type: application/json
{
"StreamARN": "string",
"StreamName": "string"
}URI 요청 파라미터
요청은 URI 파라미터를 사용하지 않습니다.
요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
- StreamARN
-
이미지 생성 구성을 검색하는 데 사용할 Kinesis 비디오 스트림의 Amazon 리소스 이름 (ARN) 입니다. 또는 를 지정해야 합니다.
StreamNameStreamARN유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 1024입니다.
패턴:
arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+Required: No
- StreamName
-
이미지 생성 구성을 검색할 스트림의 이름.
StreamName또는 를 지정해야 합니다StreamARN.유형: 문자열
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다.
패턴:
[a-zA-Z0-9_.-]+필수 여부: 아니요
응답 구문
HTTP/1.1 200
Content-type: application/json
{
"ImageGenerationConfiguration": {
"DestinationConfig": {
"DestinationRegion": "string",
"Uri": "string"
},
"Format": "string",
"FormatConfig": {
"string" : "string"
},
"HeightPixels": number,
"ImageSelectorType": "string",
"SamplingInterval": number,
"Status": "string",
"WidthPixels": number
}
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- ImageGenerationConfiguration
-
Kinesis 비디오 스트림 (KVS) 이미지 전송에 필요한 정보가 포함된 구조입니다. 이 구조가 null인 경우 구성이 스트림에서 삭제됩니다.
Errors
모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- AccessDeniedException
-
이 작업을 수행하는 데 필요한 권한은 없습니다.
HTTP 상태 코드: 401
- ClientLimitExceededException
-
허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams가 요청 병목 현상을 일으켰습니다. 나중에 전화를 걸어 보세요.
HTTP 상태 코드: 400
- InvalidArgumentException
-
이 입력 매개변수의 값이 유효하지 않습니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
Amazon Kinesis Video Streams에서 지정한 스트림을 찾을 수 없습니다.
HTTP 상태 코드: 404
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
