기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # GetMediaForFragmentList Amazon Kinesis 비디오 스트림의 아카이브된 데이터에서 조각 목록(조각 번호로 지정됨)에 대한 미디어를 가져옵니다. **참고** 먼저 `GetDataEndpoint` API를 호출하여 엔드포인트를 가져와야 합니다. 그런 다음 [--endpoint-url 파라미터를](https://docs.aws.amazon.com/cli/latest/reference/) 사용하여이 엔드포인트로 `GetMediaForFragmentList` 요청을 보냅니다. 제한은 [Kinesis Video Streams 할당량을 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). **중요** Kinesis Video Streams 아카이브 미디어 API를 호출한 후 HTTP 상태 코드 및 응답 본문 외에도 오류가 발생하면 다음과 같은 정보가 포함됩니다. `x-amz-ErrorType` HTTP 헤더 - HTTP 상태 코드가 제공하는 것 외에도 보다 구체적인 오류 유형을 포함합니다. `x-amz-RequestId` HTTP 헤더 -에 문제를 보고하려는 경우 요청 ID가 주어지면 AWS지원 팀이 문제를 더 잘 진단할 수 있습니다. HTTP 상태 코드와 ErrorType 헤더를 모두 활용하여 오류를 재시도할 수 있는지 여부와 조건에 대해 프로그래밍 방식으로 결정할 수 있으며, 클라이언트 프로그래머가 다시 시도하기 위해 수행해야 할 작업에 대한 정보를 제공할 수 있습니다. 자세한 내용은이 주제 하단의 **오류** 섹션과 [일반적인 오류를 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html). ## Request Syntax ``` POST /getMediaForFragmentList HTTP/1.1 Content-type: application/json { "Fragments": [ "{{string}}" ], "StreamARN": "{{string}}", "StreamName": "{{string}}" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [Fragments](#API_reader_GetMediaForFragmentList_RequestSyntax) ** 미디어를 검색할 조각 수의 목록입니다. 를 사용하여 이러한 값을 검색합니다[ListFragments](API_reader_ListFragments.md). 타입: 문자열 배열 배열 구성원: 최소수는 1개입니다. 최대 항목 수는 1000입니다. 길이 제약: 최소 길이 1. 최대 길이 128. 패턴: `^[0-9]+$` 필수 여부: 예 ** [StreamARN](#API_reader_GetMediaForFragmentList_RequestSyntax) ** 조각 미디어를 검색할 스트림의 Amazon 리소스 이름(ARN)입니다. 이 파라미터 또는 `StreamName` 파라미터를 지정합니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_reader_GetMediaForFragmentList_RequestSyntax) ** 조각 미디어를 검색할 스트림의 이름입니다. 이 파라미터 또는 `StreamARN` 파라미터를 지정합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-Type: {{ContentType}} {{Payload}} ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 응답에 다음 HTTP 헤더가 반환됩니다. ** [ContentType](#API_reader_GetMediaForFragmentList_ResponseSyntax) ** 요청된 미디어의 콘텐츠 유형입니다. 길이 제약: 최소 길이 1. 최대 길이 128. 패턴: `^[a-zA-Z0-9_\.\-]+$` 응답은 다음 내용을 HTTP 본문으로 반환합니다. ** [Payload](#API_reader_GetMediaForFragmentList_ResponseSyntax) ** Kinesis Video Streams가 반환하는 페이로드는 지정된 스트림의 청크 시퀀스입니다. 청크에 대한 자세한 내용은 [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)를 참조하세요. Kinesis Video Streams가 `GetMediaForFragmentList` 호출에서 반환하는 청크에는 다음과 같은 추가 Matroska(MKV) 태그도 포함됩니다. + 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 - 예외에 대한 텍스트 설명입니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 제한을 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. 제한에 대한 자세한 내용은 [Kinesis Video Streams 할당량을 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). HTTP 상태 코드: 400 ** InvalidArgumentException ** 지정된 파라미터가 제한을 초과하거나, 지원되지 않거나, 사용할 수 없습니다. HTTP 상태 코드: 400 ** NotAuthorizedException ** 상태 코드: 403, 호출자가 지정된 스트림에서 작업을 수행할 권한이 없거나 토큰이 만료되었습니다. HTTP 상태 코드: 401 ** ResourceNotFoundException ** `GetImages` Kinesis Video Streams가 지정한 스트림을 찾을 수 없는 경우에서이 오류가 발생합니다. `GetHLSStreamingSessionURL` 요청된 시간 범위 내에 조각`LIVE_REPLAY`이 없는 스트림에 대해 `ON_DEMAND` 또는 `PlaybackMode`가 있는 세션이 요청되거나 지난 30초 내에 조각이 없는 스트림에 대해 `PlaybackMode`가 있는 세션`LIVE`이 요청되면이 오류가 `GetDASHStreamingSessionURL` 발생합니다. HTTP 상태 코드: 404 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList)