GetMediaForFragmentList - Amazon Kinesis Video Streams

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 supporti per un elenco di frammenti (specificati dal numero di frammento) dai dati archiviati in un flusso video Amazon Kinesis.

Nota

Devi prima chiamare ilGetDataEndpointAPI per ottenere un endpoint. Quindi invia ilGetMediaForFragmentListrichieste a questo endpoint utilizzando ilparametro —endpoint-url.

Per informazioni sui limiti di, vediLimiti per Kinesis Video Streams.

Importante

Se viene generato un errore dopo aver richiamato un'API multimediale archiviata Kinesis Video Streams, oltre al codice di stato HTTP e al corpo della risposta, include le seguenti informazioni:

  • x-amz-ErrorTypeIntestazione HTTP: contiene un tipo di errore più specifico oltre a quello fornito dal codice di stato HTTP.

  • x-amz-RequestIdIntestazione HTTP: se si desidera segnalare un problema ad AWS, il team di supporto può diagnosticare meglio il problema se viene fornito il Request Id.

Sia il codice di stato HTTP che il ErrorType header può essere utilizzato per prendere decisioni programmatiche sul fatto che gli errori siano retrattili 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 .Errorisezione in fondo a questo argomento, nonchéErrori comuni.

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

Un elenco dei numeri di frammenti per i quali recuperare i supporti. Recuperate questi valori conListFragments.

Type: Gamma di stringhe

Membri dell'array: Numero minimo di 1 elemento. Numero massimo di 1000 elementi.

Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.

Modello: ^[0-9]+$

campo obbligatorio: Sì

StreamARN

L'ARN del flusso dal quale recuperare i file multimediali del frammento. Specificare questo parametro oStreamNameParametro .

Type: Stringa

Vincoli 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]+

campo obbligatorio: No

StreamName

Il nome del flusso dal quale recuperare il supporto del frammento. Specificare questo parametro oStreamARNParametro .

Type: Stringa

Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.

Modello: [a-zA-Z0-9_.-]+

campo 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

Il tipo di contenuto del supporto richiesto.

Vincoli 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

Il payload restituito da Kinesis Video Streams è una sequenza di blocchi del flusso specificato. Per informazioni sui blocchi di, consultaPutMedia. I pezzi che Kinesis Video Streams restituisce nelGetMediaForFragmentListCome includere anche i seguenti tag Matroska (MKV):

  • AWS_KINESISVIDEO_FRAGMENT_NUMBER - Numero del frammento restituito nel blocco.

  • AWS_KINESISVIDEO_SERVER_SIDE_TIMESTAMP - Timestamp lato server del frammento.

  • AWS_KINESISVIDEO_PRODUCER_SIDE_TIMESTAMP - Timestamp lato produttore del frammento.

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'eccezione

  • AWS_KINESISVIDEO_EXCEPTION_MESSAGE - Descrizione testuale dell'eccezione

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

ClientLimitExceededException

Kinesis Video Streams ha limitato la richiesta perché hai superato un limite. Prova a effettuare la chiamata più tardi. Per informazioni sui limiti di, consultaLimiti per Kinesis Video Streams.

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 sul flusso specificato o il token è scaduto.

Codice di stato HTTP: 401

ResourceNotFoundException

GetImagesgenererà questo errore quando Kinesis Video Streams non riesce a trovare lo stream specificato.

GetHLSStreamingSessionURLeGetDASHStreamingSessionURLgenera questo errore se una sessione con unPlaybackModediON_DEMANDoLIVE_REPLAYè richiesto per uno stream che non ha frammenti nell'intervallo di tempo richiesto o se una sessione con unPlaybackModediLIVEè richiesto per uno stream che non ha frammenti negli ultimi 30 secondi.

Codice di stato HTTP: 404

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: