Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # GetMediaForFragmentList Ottiene i file multimediali per un elenco di frammenti (specificato in base al numero di frammento) dai dati archiviati in un flusso video di Amazon Kinesis. **Nota** Devi prima chiamare l'`GetDataEndpoint`API per ottenere un endpoint. Quindi invia le `GetMediaForFragmentList` richieste a questo endpoint utilizzando il parametro [--endpoint-url](https://docs.aws.amazon.com/cli/latest/reference/). Per i limiti, consulta le [quote di Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). **Importante** Se viene generato un errore dopo aver richiamato un'API multimediale archiviata di Kinesis Video Streams, oltre al codice di stato HTTP e al corpo della risposta, include le seguenti informazioni: `x-amz-ErrorType`Intestazione HTTP: contiene un tipo di errore più specifico oltre a quello fornito dal codice di stato HTTP. `x-amz-RequestId`Intestazione HTTP: se desideri segnalare un problema AWS, il team di supporto può diagnosticare meglio il problema se gli viene fornito il Request Id. Sia il codice di stato HTTP che l' ErrorType intestazione possono essere utilizzati per prendere decisioni programmatiche sulla possibilità di correggere gli errori e in quali condizioni, oltre a fornire informazioni sulle azioni che il programmatore client potrebbe dover intraprendere per riprovare con successo. [Per ulteriori informazioni, consulta la sezione **Errori** nella parte inferiore di questo argomento, oltre a Errori comuni.](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html) ## Sintassi della richiesta ``` POST /getMediaForFragmentList HTTP/1.1 Content-type: application/json { "Fragments": [ "{{string}}" ], "StreamARN": "{{string}}", "StreamName": "{{string}}" } ``` ## Parametri della richiesta URI: La richiesta non utilizza parametri URI. ## Corpo della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [Fragments](#API_reader_GetMediaForFragmentList_RequestSyntax) ** Un elenco del numero di frammenti per i quali recuperare i file multimediali. Recuperate questi valori con. [ListFragments](API_reader_ListFragments.md) Tipo: array di stringhe Membri dell’array: numero minimo di 1 elemento. Numero massimo di 1.000 elementi. Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri. Modello: `^[0-9]+$` Obbligatorio: sì ** [StreamARN](#API_reader_GetMediaForFragmentList_RequestSyntax) ** L'Amazon Resource Name (ARN) dello stream da cui recuperare i frammenti multimediali. Specificate questo parametro o il parametro. `StreamName` Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri. Modello: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` Obbligatorio: no ** [StreamName](#API_reader_GetMediaForFragmentList_RequestSyntax) ** Il nome dello stream da cui recuperare i frammenti multimediali. Specificate questo parametro o il `StreamARN` parametro. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri. Modello: `[a-zA-Z0-9_.-]+` Obbligatorio: no ## Sintassi della risposta ``` HTTP/1.1 200 Content-Type: {{ContentType}} {{Payload}} ``` ## Elementi di risposta Se l'operazione riesce, il servizio restituisce una risposta HTTP 200. La risposta restituisce le seguenti intestazioni HTTP. ** [ContentType](#API_reader_GetMediaForFragmentList_ResponseSyntax) ** Il tipo di contenuto del supporto richiesto. Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri. Modello: `^[a-zA-Z0-9_\.\-]+$` La risposta restituisce quanto segue come corpo HTTP. ** [Payload](#API_reader_GetMediaForFragmentList_ResponseSyntax) ** Il payload restituito da Kinesis Video Streams è una sequenza di blocchi del flusso specificato. Per informazioni sui blocchi, consulta. [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html) I blocchi che Kinesis Video Streams restituisce nella chiamata includono anche i seguenti tag `GetMediaForFragmentList` Matroska (MKV) aggiuntivi: + AWS\_KINESISVIDEO\_FRAGMENT\_NUMBER - Numero di frammento restituito nel blocco. + AWS\_KINESISVIDEO\_SERVER\_SIDE\_TIMESTAMP - Timestamp sul lato server del frammento. + AWS\_KINESISVIDEO\_PRODUCER\_SIDE\_TIMESTAMP - Timestamp del frammento sul lato del produttore. Se si verifica un'eccezione, verranno inclusi i seguenti tag: + AWS\_KINESISVIDEO\_FRAGMENT\_NUMBER - Il numero del frammento che ha generato l'eccezione. + AWS\_KINESISVIDEO\_EXCEPTION\_ERROR\_CODE - Il codice intero dell'errore. + AWS\_KINESISVIDEO\_EXCEPTION\_MESSAGE - Una descrizione testuale dell'eccezione. ## Errori Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md). ** ClientLimitExceededException ** Kinesis Video Streams ha limitato la richiesta perché hai superato un limite. Prova a effettuare la chiamata più tardi. Per informazioni sui limiti, consulta la sezione [Quote di Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). Codice di stato HTTP: 400 ** InvalidArgumentException ** Un parametro specificato supera le restrizioni, non è supportato o non può essere utilizzato. Codice di stato HTTP: 400 ** NotAuthorizedException ** Codice di stato: 403, il chiamante non è autorizzato a eseguire un'operazione sullo stream specificato o il token è scaduto. Codice di stato HTTP: 401 ** ResourceNotFoundException ** `GetImages`genererà questo errore quando Kinesis Video Streams non riesce a trovare lo stream specificato. `GetHLSStreamingSessionURL`e `GetDASHStreamingSessionURL` genera questo errore se `LIVE_REPLAY` viene richiesta una sessione con un `PlaybackMode` of `ON_DEMAND` o per uno stream che non contiene frammenti nell'intervallo di tempo richiesto, o se `LIVE` viene richiesta una sessione con un `PlaybackMode` of per uno stream che non contiene frammenti negli ultimi 30 secondi. Codice di stato HTTP: 404 ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK per C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList)