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

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

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

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

참고

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

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

Pattern: [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"
}

Response Elements

작업이 성공하면 서비스는 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 SDKs 다음을 참조하십시오. API