기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # ListFragments 아카이브된 데이터 내에서 지정된 스트림 및 타임스탬프 범위의 [Fragment](API_reader_Fragment.md) 객체 목록을 반환합니다. 조각 나열은 최종적으로 일관됩니다. 즉, 생산자가 조각이 지속되었다는 확인을 수신하더라도에 대한 요청에서 결과가 즉시 반환되지 않을 수 있습니다`ListFragments`. 그러나 결과는 일반적으로 1초 이내에 사용할 수 있습니다. **참고** 먼저 `GetDataEndpoint` API를 호출하여 엔드포인트를 가져와야 합니다. 그런 다음 [--endpoint-url 파라미터를](https://docs.aws.amazon.com/cli/latest/reference/) 사용하여이 엔드포인트에 `ListFragments` 요청을 보냅니다. **중요** 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 /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_reader_ListFragments_RequestSyntax) ** 반환할 조각 범위의 타임스탬프 범위와 타임스탬프 오리진을 설명합니다. 이는가 API에 전달되지 `NextToken` 않은 경우에만 필요합니다. 유형: [FragmentSelector](API_reader_FragmentSelector.md)객체 필수 여부: 아니요 ** [MaxResults](#API_reader_ListFragments_RequestSyntax) ** 반환할 총 조각 수입니다. 사용 가능한 총 조각 수가에 지정된 값보다 많으면 페이지 매김`max-results`을 재개하는 데 사용할 수 있는 출력에 [ListFragments:NextToken](#KinesisVideo-reader_ListFragments-response-NextToken)이 제공됩니다. 기본값은 100입니다. 타입: Long 유효한 범위: 최소값은 1입니다. 최대값은 1000입니다. 필수 여부: 아니요 ** [NextToken](#API_reader_ListFragments_RequestSyntax) ** 페이지 매김을 시작할 위치를 지정하기 위한 토큰입니다. 이는 이전에 잘린 응답의 [ListFragments:NextToken](#KinesisVideo-reader_ListFragments-response-NextToken)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 4096자입니다. 패턴: `[a-zA-Z0-9+/]+={0,2}` 필수 여부: 아니요 ** [StreamARN](#API_reader_ListFragments_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_ListFragments_RequestSyntax) ** 조각 목록을 검색할 스트림의 이름입니다. 이 파라미터 또는 `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](#API_reader_ListFragments_ResponseSyntax) ** 선택기 기준을 충족하는 스트림의 아카이브된 [Fragment](API_reader_Fragment.md) 객체 목록입니다. 페이지 간에도 결과는 특정 순서가 아닙니다. 스트림에 선택기 기준을 충족하는 조각이 없는 경우 빈 목록이 반환됩니다. 타입: [Fragment](API_reader_Fragment.md)객체 배열 ** [NextToken](#API_reader_ListFragments_ResponseSyntax) ** 반환된 목록이 잘린 경우 작업은 결과의 다음 페이지를 검색하는 데 사용할이 토큰을 반환합니다. 이 값은 반환할 결과가 더 이상 없는 `null` 경우입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 4096자입니다. 패턴: `[a-zA-Z0-9+/]+={0,2}` ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](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/ListFragments) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/ListFragments)