ListFragments - Amazon Kinesis Video Streams
Request SyntaxURI 요청 파라미터요청 본문응답 구문응답 요소Errors참고

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

ListFragments

아카이브된 데이터 내에서 지정된 스트림 및 타임스탬프 범위의 Fragment 객체 목록을 반환합니다.

리스팅 프래그먼트는 결국 일관성을 유지합니다. 즉, 제작자가 프래그먼트가 지속된다는 승인을 받더라도 요청에서 결과가 즉시 반환되지 않을 수 있습니다. ListFragments 하지만 일반적으로 1초 이내에 결과를 확인할 수 있습니다.

참고

먼저 GetDataEndpoint API를 호출하여 엔드포인트를 가져와야 합니다. 그런 다음 ListFragments --endpoint-url 파라미터를 사용하여 이 엔드포인트로 요청을 전송합니다.

중요

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

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

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

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

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

Request Syntax

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

{
   "FragmentSelector": { 
      "FragmentSelectorType": "string",
      "TimestampRange": { 
         "EndTimestamp": number,
         "StartTimestamp": number
      }
   },
   "MaxResults": number,
   "NextToken": "string",
   "StreamARN": "string",
   "StreamName": "string"
}

URI 요청 파라미터

요청은 URI 파라미터를 사용하지 않습니다.

요청 본문

요청은 JSON 형식으로 다음 데이터를 받습니다.

FragmentSelector

반환할 프래그먼트 범위의 타임스탬프 범위와 타임스탬프 출처를 설명합니다.

참고

이는 API에 NextToken 전달되지 않은 경우에만 필요합니다.

유형: FragmentSelector객체

필수 항목 여부: 아니요

MaxResults

반환할 총 프래그먼트 수입니다. 사용 가능한 총 조각 수가 에 지정된 값보다 많으면 페이지 매김을 재개하는 데 사용할 수 있는 ListFragmentsNextTokena:가 출력에 제공됩니다. max-results

기본 값은 100입니다.

타입: Long

유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

필수 여부: 아니요

NextToken

페이지 매김을 시작할 위치를 지정하기 위한 토큰입니다. 다음은 이전에 잘린 ListFragmentsNextToken응답의 :입니다.

유형: 문자열

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

패턴: [a-zA-Z0-9+/]+={0,2}

Required: No

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입니다.

패턴: [a-zA-Z0-9_.-]+

필수 여부: 아니요

응답 구문

HTTP/1.1 200
Content-type: application/json

{
   "Fragments": [ 
      { 
         "FragmentLengthInMilliseconds": number,
         "FragmentNumber": "string",
         "FragmentSizeInBytes": number,
         "ProducerTimestamp": number,
         "ServerTimestamp": number
      }
   ],
   "NextToken": "string"
}

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

Fragments

선택 기준을 충족하는 스트림의 아카이브된 Fragment 객체 목록. 결과는 특정 순서가 없으며, 여러 페이지에 걸쳐 표시되더라도 마찬가지입니다.

스트림에 셀렉터 기준을 충족하는 프래그먼트가 없는 경우 빈 목록이 반환됩니다.

유형: Fragment객체 어레이

NextToken

반환된 목록이 잘린 경우 작업은 이 토큰을 반환하여 다음 결과 페이지를 검색하는 데 사용합니다. 이 값은 null 반환할 결과가 더 이상 없는 경우입니다.

유형: 문자열

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

패턴: [a-zA-Z0-9+/]+={0,2}

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 SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.