As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # ListFragments Retorna uma lista de [Fragment](API_reader_Fragment.md) objetos do intervalo especificado de fluxo e timestamp nos dados arquivados. A listagem de fragmentos acaba sendo consistente. Isso significa que, mesmo que o produtor receba uma confirmação de que um fragmento persiste, o resultado pode não ser retornado imediatamente de uma solicitação para. `ListFragments` No entanto, os resultados geralmente estão disponíveis em menos de um segundo. **nota** Você deve primeiro chamar a `GetDataEndpoint` API para obter um endpoint. Em seguida, envie as `ListFragments` solicitações para esse endpoint usando o parâmetro [--endpoint-url](https://docs.aws.amazon.com/cli/latest/reference/). **Importante** Se um erro for gerado após a invocação de uma API de mídia arquivada do Kinesis Video Streams, além do código de status HTTP e do corpo da resposta, ele incluirá as seguintes informações: `x-amz-ErrorType`Cabeçalho HTTP — contém um tipo de erro mais específico, além do que o código de status HTTP fornece. `x-amz-RequestId`Cabeçalho HTTP — se você quiser relatar um problema AWS, a equipe de suporte poderá diagnosticar melhor o problema se receber o ID da solicitação. Tanto o código de status HTTP quanto o ErrorType cabeçalho podem ser utilizados para tomar decisões programáticas sobre se os erros podem ser repetidos e sob quais condições, além de fornecer informações sobre quais ações o programador cliente pode precisar realizar para tentar novamente com sucesso. Para obter mais informações, consulte a seção **Erros** na parte inferior deste tópico, bem como [Erros comuns](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html). ## Sintaxe da Solicitação ``` 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}}" } ``` ## Parâmetros da solicitação de URI A solicitação não usa nenhum parâmetro de URI. ## Corpo da Solicitação A solicitação aceita os dados a seguir no formato JSON. ** [FragmentSelector](#API_reader_ListFragments_RequestSyntax) ** Descreve o intervalo do timestamp e a origem do timestamp para o intervalo de fragmentos a serem retornados. Isso só é necessário quando o `NextToken` não é passado na API. Tipo: objeto [FragmentSelector](API_reader_FragmentSelector.md) Obrigatório: não ** [MaxResults](#API_reader_ListFragments_RequestSyntax) ** O número total de fragmentos a serem devolvidos. Se o número total de fragmentos disponíveis for maior que o valor especificado em`max-results`, um [ListFragments:](#KinesisVideo-reader_ListFragments-response-NextToken) será NextToken fornecido na saída que você pode usar para retomar a paginação. O valor padrão é 100. Tipo: longo Faixa válida: valor mínimo de 1. Valor máximo de 1.000. Obrigatório: não ** [NextToken](#API_reader_ListFragments_RequestSyntax) ** Um token para especificar onde iniciar a paginação. Este é o [ListFragments: NextToken](#KinesisVideo-reader_ListFragments-response-NextToken) de uma resposta previamente truncada. Tipo: string Restrições de comprimento: tamanho mínimo de 1. O tamanho máximo é 4.096. Padrão: `[a-zA-Z0-9+/]+={0,2}` Obrigatório: não ** [StreamARN](#API_reader_ListFragments_RequestSyntax) ** O Amazon Resource Name (ARN) do stream do qual recuperar uma lista de fragmentos. Especifique esse parâmetro ou o `StreamName` parâmetro. Tipo: string Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 1.024. Padrão: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` Obrigatório: não ** [StreamName](#API_reader_ListFragments_RequestSyntax) ** O nome do fluxo do qual recuperar uma lista de fragmentos. Especifique esse parâmetro ou o `StreamARN` parâmetro. Tipo: string Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256. Padrão: `[a-zA-Z0-9_.-]+` Obrigatório: Não ## Sintaxe da resposta ``` HTTP/1.1 200 Content-type: application/json { "Fragments": [ { "FragmentLengthInMilliseconds": number, "FragmentNumber": "string", "FragmentSizeInBytes": number, "ProducerTimestamp": number, "ServerTimestamp": number } ], "NextToken": "string" } ``` ## Elementos de resposta Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200. Os dados a seguir são retornados no formato JSON pelo serviço. ** [Fragments](#API_reader_ListFragments_ResponseSyntax) ** Uma lista de [Fragment](API_reader_Fragment.md) objetos arquivados do stream que atendem aos critérios do seletor. Os resultados não estão em uma ordem específica, mesmo entre páginas. Se não houver fragmentos no fluxo que atendam aos critérios do seletor, uma lista vazia será retornada. Tipo: matriz de objetos [Fragment](API_reader_Fragment.md) ** [NextToken](#API_reader_ListFragments_ResponseSyntax) ** Se a lista retornada for truncada, a operação retornará esse token para ser usado na recuperação da próxima página de resultados. Esse valor é `null` quando não há mais resultados a serem retornados. Tipo: string Restrições de comprimento: tamanho mínimo de 1. O tamanho máximo é 4.096. Padrão: `[a-zA-Z0-9+/]+={0,2}` ## Erros Para informações sobre os erros comuns retornados pelas ações, consulte [Tipos de erro comuns](CommonErrors.md). ** ClientLimitExceededException ** O Kinesis Video Streams limitou a solicitação porque você excedeu um limite. Tente fazer a ligação mais tarde. Para obter informações sobre limites, consulte Cotas do [Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). Código de status HTTP: 400 ** InvalidArgumentException ** Um parâmetro especificado excede suas restrições, não é suportado ou não pode ser usado. Código de status HTTP: 400 ** NotAuthorizedException ** Código de status: 403, O chamador não está autorizado a realizar uma operação no stream fornecido ou o token expirou. Código de status HTTP: 401 ** ResourceNotFoundException ** `GetImages`gerará esse erro quando o Kinesis Video Streams não conseguir encontrar o stream que você especificou. `GetHLSStreamingSessionURL`e `GetDASHStreamingSessionURL` gere esse erro se uma sessão com um `PlaybackMode` de `ON_DEMAND` ou `LIVE_REPLAY` for solicitada para um fluxo que não tem fragmentos dentro do intervalo de tempo solicitado, ou se uma sessão com um `PlaybackMode` of `LIVE` for solicitada para um fluxo que não tem fragmentos nos últimos 30 segundos. Código de status HTTP: 404 ## Consulte Também Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK para C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/ListFragments)