기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # GetClip 지정된 시간 범위 동안 지정된 비디오 스트림에서 아카이브된 온디맨드 미디어가 포함된 MP4 파일(클립)을 다운로드합니다. StreamName 및 StreamARN 파라미터는 모두 선택 사항이지만이 API 작업을 호출할 때 StreamName 또는 StreamARN을 지정해야 합니다. **참고** 먼저 `GetDataEndpoint` API를 호출하여 엔드포인트를 가져와야 합니다. 그런 다음 [--endpoint-url 파라미터를](https://docs.aws.amazon.com/cli/latest/reference/) 사용하여이 엔드포인트로 `GetClip` 요청을 보냅니다. Amazon Kinesis 비디오 스트림에는 MP4를 통해 데이터를 제공하기 위한 다음과 같은 요구 사항이 있습니다. + [비디오 재생 트랙 요구 사항](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/video-playback-requirements.html). + 데이터 보존이 0보다 커야 합니다. + 각 조각의 비디오 추적에는 H.264용 AVC(Advanced Video Coding) 형식 및 H.265용 HEVC 형식의 코덱 프라이빗 데이터가 포함되어야 합니다. 자세한 내용은 [MPEG-4 사양 ISO/IEC 14496-15](https://www.iso.org/standard/55980.html)를 참조하십시오. 스트림 데이터를 지정된 형식에 맞게 조정하는 방법에 대한 자세한 내용은 [NAL 적응 플래그](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-reference-nal.html)를 참조하십시오. + 각 조각의 오디오 조각에는 AAC 형식([AAC 사양 ISO/IEC 13818-7](https://www.iso.org/standard/43345.html)) 또는 [MS Wave 형식](https://www.mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/WAVE.html)의 코덱 프라이빗 데이터가 포함되어야 합니다. `GetClip.OutgoingBytes` Amazon CloudWatch 지표를 모니터링하여 발신 데이터의 양을 모니터링할 수 있습니다. CloudWatch를 사용하여 Kinesis Video Streams를 모니터링하는 방법에 대한 자세한 내용은 [Kinesis Video Streams 모니터링을 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/monitoring.html). 요금 정보는 [Amazon Kinesis Video Streams 요금](https://aws.amazon.com/kinesis/video-streams/pricing/) 및 [AWS 요금을](https://aws.amazon.com/pricing/) 참조하세요. 발신 AWS 데이터에 대한 요금이 적용됩니다. **중요** 각 조각에 포함된 코덱 프라이빗 데이터(CPD)에는 조각을 올바르게 디코딩하는 데 필요한 프레임 속도, 해상도 및 인코딩 프로파일과 같은 코덱별 초기화 정보가 포함되어 있습니다. 결과 클립의 대상 조각 간에는 CPD 변경이 지원되지 않습니다. CPD는 쿼리된 미디어를 통해 일관성을 유지해야 합니다. 그렇지 않으면 오류가 반환됩니다. **중요** 변경 사항 추적은 지원되지 않습니다. 트랙은 쿼리된 미디어 전체에서 일관성을 유지해야 합니다. 스트림의 조각이 비디오만 있음에서 오디오와 비디오를 모두 있음으로 변경되거나 AAC 오디오 트랙이 A-Law 오디오 트랙으로 변경되면 오류가 반환됩니다. ## Request Syntax ``` POST /getClip HTTP/1.1 Content-type: application/json { "ClipFragmentSelector": { "FragmentSelectorType": "{{string}}", "TimestampRange": { "EndTimestamp": {{number}}, "StartTimestamp": {{number}} } }, "StreamARN": "{{string}}", "StreamName": "{{string}}" } ``` ## URI 요청 파라미터 요청은 URI 파라미터를 사용하지 않습니다. ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ClipFragmentSelector](#API_reader_GetClip_RequestSyntax) ** 요청된 클립의 시간 범위와 타임스탬프의 소스입니다. 타입: [ClipFragmentSelector](API_reader_ClipFragmentSelector.md)객체 필수 항목 여부: 예 ** [StreamARN](#API_reader_GetClip_RequestSyntax) ** 미디어 클립을 검색할 스트림의 Amazon 리소스 이름(ARN)입니다. StreamName 또는 StreamARN을 지정해야 합니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 필수 여부: 아니요 ** [StreamName](#API_reader_GetClip_RequestSyntax) ** 미디어 클립을 검색할 스트림의 이름입니다. StreamName 또는 StreamARN을 지정해야 합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 아니요 ## 응답 구문 ``` HTTP/1.1 200 Content-Type: {{ContentType}} {{Payload}} ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 응답에 다음 HTTP 헤더가 반환됩니다. ** [ContentType](#API_reader_GetClip_ResponseSyntax) ** 요청된 클립에 있는 미디어의 콘텐츠 유형입니다. 길이 제약: 최소 길이 1. 최대 길이 128. 패턴: `^[a-zA-Z0-9_\.\-]+$` 응답은 다음 내용을 HTTP 본문으로 반환합니다. ** [Payload](#API_reader_GetClip_ResponseSyntax) ** 지정된 비디오 스트림의 미디어 클립이 포함된 기존 MP4 파일입니다. 출력에는 지정된 시작 타임스탬프의 처음 100MB 또는 처음 200개의 조각이 포함됩니다. 자세한 내용은 [Kinesis Video Streams 할당량을 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** ClientLimitExceededException ** 제한을 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오. 제한에 대한 자세한 내용은 [Kinesis Video Streams 할당량을 참조하세요](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). HTTP 상태 코드: 400 ** InvalidArgumentException ** 지정된 파라미터가 제한을 초과하거나, 지원되지 않거나, 사용할 수 없습니다. HTTP 상태 코드: 400 ** InvalidCodecPrivateDataException ** 비디오 스트림의 트랙 중 하나 이상에 있는 코덱 프라이빗 데이터는이 작업에 유효하지 않습니다. HTTP 상태 코드: 400 ** InvalidMediaFrameException ** 요청된 클립의 하나 이상의 프레임을 지정된 코덱을 기반으로 구문 분석할 수 없습니다. HTTP 상태 코드: 400 ** MissingCodecPrivateDataException ** 비디오 스트림의 트랙 중 하나 이상에서 코덱 프라이빗 데이터를 찾을 수 없습니다. HTTP 상태 코드: 400 ** NoDataRetentionException ** `GetImages` 데이터를 보존하지 않는 스트림에 대해가 요청되었습니다(즉, `DataRetentionInHours`의가 0임). HTTP 상태 코드: 400 ** NotAuthorizedException ** 상태 코드: 403, 호출자가 지정된 스트림에서 작업을 수행할 권한이 없거나 토큰이 만료되었습니다. HTTP 상태 코드: 401 ** ResourceNotFoundException ** `GetImages` Kinesis Video Streams가 지정한 스트림을 찾을 수 없는 경우에서이 오류가 발생합니다. `GetHLSStreamingSessionURL` 요청된 시간 범위 내에 조각`LIVE_REPLAY`이 없는 스트림에 대해 `ON_DEMAND` 또는 `PlaybackMode`가 있는 세션이 요청되거나 지난 30초 내에 조각이 없는 스트림에 대해 `PlaybackMode`가 있는 세션`LIVE`이 요청되면이 오류가 `GetDASHStreamingSessionURL` 발생합니다. HTTP 상태 코드: 404 ** UnsupportedStreamMediaTypeException ** 재생 세션의 첫 번째 조각에 있는 트랙의 코덱 IDs에서 미디어 유형(예: h.264 또는 h.265 비디오, AAC 또는 G.711 오디오)을 확인할 수 없습니다. 트랙 1의 코덱 ID는 여야 하며`V_MPEG/ISO/AVC`, 선택적으로 트랙 2의 코덱 ID는 여야 합니다`A_AAC`. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/GetClip)