GetMediaForFragmentList - Flusso di video Amazon Kinesis
Sintassi della richiestaURIParametri della richiestaCorpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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 il per GetDataEndpoint API ottenere un endpoint. Quindi invia le GetMediaForFragmentList richieste a questo endpoint utilizzando il parametro --endpoint-url.

Per i limiti, consulta le quote di Kinesis Video Streams.

Importante

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

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

  • x-amz-RequestIdHTTPheader: 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 HTTP stato che l' ErrorType intestazione possono essere utilizzati per prendere decisioni programmatiche sulla possibilità di riprovare gli errori e in quali condizioni, oltre a fornire informazioni sulle azioni che il programmatore del client potrebbe dover intraprendere per riprovare con successo.

Per ulteriori informazioni, consultate la sezione Errori nella parte inferiore di questo argomento, nonché Errori comuni.

Sintassi della richiesta

POST /getMediaForFragmentList HTTP/1.1
Content-type: application/json

{
   "Fragments": [ "string" ],
   "StreamARN": "string",
   "StreamName": "string"
}

URIParametri della richiesta

La richiesta non utilizza alcun URI parametro.

Corpo della richiesta

La richiesta accetta i seguenti dati nel JSON formato.

Fragments

Un elenco del numero di frammenti per i quali recuperare i file multimediali. Recuperate questi valori con. ListFragments

Tipo: matrice 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]+$

Campo obbligatorio: sì

StreamARN

L'Amazon Resource Name (ARN) dello stream da cui recuperare i frammenti multimediali. Specificate questo parametro o il StreamName parametro.

Tipo: stringa

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

Campo obbligatorio: no

StreamName

Il nome dello stream da cui recuperare i frammenti multimediali. Specificate questo parametro o il StreamARN parametro.

Tipo: stringa

Limitazioni 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'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.

La risposta restituisce le seguenti HTTP intestazioni.

ContentType

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 HTTP corpo.

Payload

Il payload restituito da Kinesis Video Streams è una sequenza di blocchi del flusso specificato. Per informazioni sui blocchi, consulta. PutMedia I blocchi che Kinesis Video Streams restituisce nella chiamata includono anche i seguenti tag GetMediaForFragmentList Matroska () aggiuntivi: MKV

  • AWS_ _ KINESISVIDEO FRAGMENT _ NUMBER - Numero di frammento restituito nel blocco.

  • AWS_ _ KINESISVIDEO _ SERVER SIDE _ TIMESTAMP - Timestamp del frammento sul lato server.

  • 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 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, consulta la sezione Quote di Kinesis Video Streams.

HTTPCodice di stato: 400

InvalidArgumentException

Un parametro specificato supera le restrizioni, non è supportato o non può essere utilizzato.

HTTPCodice di stato: 400

NotAuthorizedException

Codice di stato: 403, il chiamante non è autorizzato a eseguire un'operazione sullo stream specificato o il token è scaduto.

HTTPCodice di stato: 401

ResourceNotFoundException

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

GetHLSStreamingSessionURLe 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.

HTTPCodice di stato: 404

Vedi anche

Per ulteriori informazioni sull'utilizzo di questo API codice in una delle lingue specifiche AWS SDKs, consulta quanto segue: