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à.
ListFragments
Restituisce un elenco diFragmentoggetti del flusso e dell'intervallo di timestamp specificati all'interno dei dati archiviati.
La lista dei frammenti è consistente finale. Ciò significa che, anche se il produttore riceve un riconoscimento che un frammento è persistente, il risultato potrebbe non essere restituito immediatamente da una richiesta aListFragments. Tuttavia, i risultati sono generalmente disponibili in meno di un secondo.
Devi prima chiamare ilGetDataEndpointAPI per ottenere un endpoint. Quindi invia ilListFragmentsrichieste a questo endpoint utilizzando ilParametro —endpoint-url.
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 /listFragments HTTP/1.1
Content-type: application/json
{
"FragmentSelector": {
"FragmentSelectorType": "string",
"TimestampRange": {
"EndTimestamp": number,
"StartTimestamp": number
}
},
"MaxResults": number,
"NextToken": "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.
- FragmentSelector
-
Descrive l'intervallo di timestamp e l'origine del timestamp per l'intervallo di frammenti da restituire.
Tipo: FragmentSelector oggetto
: campo obbligatorio No
- MaxResults
-
Il numero totale di frammenti da restituire. Se il numero totale di frammenti disponibili supera il valore specificato in
max-results, poi aLista frammenti: Next Tokenviene fornito nell'output che è possibile utilizzare per riprendere l'impaginazione.Type: Lungo
Intervallo valido: Valore minimo di 1. Valore massimo pari a 1000.
: campo obbligatorio No
- NextToken
-
Un token che permette di specificare dove iniziare la paginazione. Questo è ilLista frammenti: Next TokenDa una risposta troncata in precedenza.
Type: Stringa
Vincoli di lunghezza: Lunghezza minima pari a 1. Lunghezza massima di 4096.
Modello:
[a-zA-Z0-9+/]+={0,2}: campo obbligatorio No
- StreamARN
-
L'Amazon Resource Name (ARN) del flusso dal quale recuperare un elenco di frammenti. Specificare questo parametro o il
StreamNameParametro .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 un elenco di frammenti. Specificare questo parametro o il
StreamARNParametro .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: application/json
{
"Fragments": [
{
"FragmentLengthInMilliseconds": number,
"FragmentNumber": "string",
"FragmentSizeInBytes": number,
"ProducerTimestamp": number,
"ServerTimestamp": number
}
],
"NextToken": "string"
}Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- Fragments
-
Un elenco di archiviatiFragmentoggetti del flusso che soddisfano i criteri di selezione. I risultati non sono in ordine specifico, nemmeno su tutte le pagine.
Type: Matrice diFragmentoggetti
- NextToken
-
Se l'elenco restituito viene troncato, l'operazione restituisce questo token da utilizzare per recuperare la pagina di risultati successiva. Questo valore è
nullQuando non ci sono più risultati da restituire.Type: Stringa
Vincoli di lunghezza: Lunghezza minima pari a 1. Lunghezza massima di 4096.
Modello:
[a-zA-Z0-9+/]+={0,2}
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, consulta il documentoLimiti 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 obbligatorio: 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:
