GetMediaForFragmentList - Amazon Kinesis Video Streams
Request SyntaxURI요청 파라미터요청 본문응답 구문Response ElementsErrors참고

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

GetMediaForFragmentList

Amazon Kinesis 비디오 스트림에 보관된 데이터에서 프래그먼트 목록 (프래그먼트 번호로 지정) 의 미디어를 가져옵니다.

참고

엔드포인트를 가져오려면 먼저 를 호출해야 합니다 GetDataEndpointAPI. 그런 다음 GetMediaForFragmentList --endpoint-url 파라미터를 사용하여 이 엔드포인트로 요청을 전송합니다.

한도는 Kinesis Video Streams 할당량을 참조하십시오.

중요

Kinesis Video Streams 아카이브 미디어를 API 호출한 후 오류가 발생하는 경우 HTTP 상태 코드 및 응답 본문 외에도 다음과 같은 정보가 포함됩니다.

  • x-amz-ErrorTypeHTTP헤더 - 상태 코드가 제공하는 내용 외에도 보다 구체적인 오류 유형을 포함합니다. HTTP

  • x-amz-RequestIdHTTP헤더 — 문제를 신고하려는 경우 지원 팀에서 요청 ID를 제공하면 문제를 더 잘 진단할 수 있습니다. AWS

HTTP상태 코드와 ErrorType 헤더를 모두 사용하여 오류를 재시도할 수 있는지 여부와 조건에 대해 프로그래밍 방식으로 결정할 수 있을 뿐만 아니라 클라이언트 프로그래머가 성공적으로 다시 시도하기 위해 취해야 할 조치에 대한 정보를 제공할 수 있습니다.

자세한 내용은 이 항목 하단의 오류 섹션 및 일반적인 오류를 참조하십시오.

Request Syntax

POST /getMediaForFragmentList HTTP/1.1
Content-type: application/json

{
   "Fragments": [ "string" ],
   "StreamARN": "string",
   "StreamName": "string"
}

URI요청 파라미터

요청에는 어떤 URI 매개변수도 사용하지 않습니다.

요청 본문

요청은 다음과 같은 JSON 형식의 데이터를 수락합니다.

Fragments

미디어를 검색할 때 사용할 프래그먼트 수 목록입니다. 이 값은 를 사용하여 검색합니다. ListFragments

타입: 문자열 배열

배열 구성원: 최소수는 1개입니다. 최대 항목 수는 1000입니다.

길이 제약: 최소 길이 1. 최대 길이 128.

Pattern: ^[0-9]+$

필수 여부: 예

StreamARN

프래그먼트 미디어를 검색할 스트림의 Amazon 리소스 이름 (ARN). 이 파라미터 또는 파라미터를 지정하십시오. StreamName

유형: 문자열

길이 제약: 최소 길이 1. 최대 길이는 1024입니다.

패턴: arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+

Required: No

StreamName

프래그먼트 미디어를 검색할 스트림의 이름. 이 파라미터 또는 파라미터를 지정합니다. StreamARN

유형: 문자열

길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다.

Pattern: [a-zA-Z0-9_.-]+

필수 여부: 아니요

응답 구문

HTTP/1.1 200
Content-Type: ContentType

Payload

Response Elements

작업이 성공하면 서비스는 HTTP 200개의 응답을 다시 보냅니다.

응답은 다음 HTTP 헤더를 반환합니다.

ContentType

요청된 미디어의 콘텐츠 유형.

길이 제약: 최소 길이 1. 최대 길이 128.

Pattern: ^[a-zA-Z0-9_\.\-]+$

응답은 다음을 HTTP 본문으로 반환합니다.

Payload

Kinesis Video Streams가 반환하는 페이로드는 지정된 스트림의 청크 시퀀스입니다. 청크에 대한 자세한 내용은 을 참조하십시오. PutMedia Kinesis Video Streams가 호출에서 GetMediaForFragmentList 반환하는 청크에는 다음과 같은 추가 MKV Matroska () 태그도 포함됩니다.

  • AWS_ _ KINESISVIDEO FRAGMENT _ NUMBER - 청크에 반환된 프래그먼트 번호입니다.

  • AWS_ _ KINESISVIDEO SERVER SIDE _ TIMESTAMP - 프래그먼트의 서버측 타임스탬프입니다.

  • AWS_ _ KINESISVIDEO PRODUCER SIDE _ TIMESTAMP - 프래그먼트의 프로듀서측 타임스탬프입니다.

예외가 발생할 경우 다음 태그가 포함됩니다.

  • AWS_ KINESISVIDEO _ FRAGMENT _ NUMBER - 예외가 발생한 프래그먼트의 수입니다.

  • AWS_ KINESISVIDEO _ EXCEPTION ERROR _ CODE - 오류의 정수 코드입니다.

  • AWS_ KINESISVIDEO _ EXCEPTION _ MESSAGE - 예외에 대한 텍스트 설명.

Errors

모든 작업에 공통되는 오류에 대한 내용은 일반적인 오류 섹션을 참조하십시오.

ClientLimitExceededException

한도를 초과했기 때문에 Kinesis Video Streams가 요청 병목 현상을 일으켰습니다. 나중에 전화를 걸어 보세요. 한도에 대한 자세한 내용은 Kinesis Video Streams 할당량을 참조하십시오.

HTTP상태 코드: 400

InvalidArgumentException

지정된 매개변수가 제한을 초과하거나, 지원되지 않거나, 사용할 수 없습니다.

HTTP상태 코드: 400

NotAuthorizedException

상태 코드: 403, 호출자가 지정된 스트림에서 작업을 수행할 권한이 없거나 토큰이 만료되었습니다.

HTTP상태 코드: 401

ResourceNotFoundException

GetImagesKinesis Video Streams에서 지정한 스트림을 찾을 수 없는 경우 이 오류가 발생합니다.

GetHLSStreamingSessionURL요청된 시간 범위 내에 LIVE_REPLAY 프래그먼트가 없는 스트림에 대해 a ON_DEMAND 또는 f가 있는 세션이 요청되거나 지난 30초 내에 LIVE 프래그먼트가 없는 스트림에 대해 a가 있는 세션이 요청되면 이 GetDASHStreamingSessionURL 오류가 발생합니다. PlaybackMode PlaybackMode

HTTP상태 코드: 404

참고

언어별 AWS SDKs 기능 중 API 하나에서 이 기능을 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.