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à.
Quote di servizio Kinesis Video Streams
Kinesis Video Streams ha le seguenti quote di servizio:
Importante
Le seguenti quote di servizio sono o soft [s], che possono essere aggiornate inviando un ticket di supporto, o rigide [h], che non possono essere aumentate. Nelle tabelle seguenti verranno visualizzati [s] e [h] accanto alle quote di servizio individuali.
Quote di servizio API del piano di controllo
La sezione seguente descrive le quote di servizio per le API del piano di controllo. TPS è l'acronimo di Transations per second.
Quando viene raggiunto un limite di richieste a livello di account o di risorsa, viene generato un. ClientLimitExceededException
Quote dei servizi API del piano di controllo | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
API | Limite dell'account: Richiesta | Limite dell'account: Streams | Limite a livello di flusso | Eccezioni e note pertinenti | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CreateStream | 50 TPS | 10000 stream per account nelle regioni Stati Uniti orientali (Virginia settentrionale) e Stati Uniti occidentali (Oregon). 5000 stream per account in tutte le altre regioni supportate. NotaQuesto limite può essere aumentato fino a 100.000 (o più) flussi per account. Accedi alla AWS Management Console all'indirizzo https://console.aws.amazon.com/ |
Questa API può essere invocata da dispositivi, CLI, accessi basati su SDK e dalla console. Se il flusso non è già esistente, va a buon fine una sola chiamata API. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DeleteEdgeConfiguration | 10 TPS [r] | N/D | 1 TPS [h] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DeleteStream | 50 TPS [r] | N/D | 5 TPS [r] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DescribeEdgeConfiguration | 50 TPS [r] | N/D | 5 TPS [r] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DescribeImageGenerationConfiguration | 50 TPS [r] | N/D | 5 TPS [r] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DescribeMappedResourceConfiguration | 50 TPS [r] | N/D | 5 TPS [r] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DescribeNotificationConfiguration | 50 TPS [r] | N/D | 5 TPS [r] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DescribeStream | 300 TPS [r] | N/D | 5 TPS [r] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetDataEndpoint | 300 TPS [r] | N/D | 5 TPS [r] | Viene chiamata ogni 45 minuti per aggiornare il token di streaming per la maggior parte dei casi d'uso PutMedia /GetMedia . Il caching dei dati dell'endpoint è un'operazione sicura se l'applicazione ricarica i dati in caso di errore. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ListEdgeAgentConfigurations | 50 TPS [r] | N/D | N/D | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ListStreams | 50 TPS [r] | N/D | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ListTagsForStream | 50 TPS [r] | N/D | 5 TPS [r] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
StartEdgeConfigurationUpdate | 10 TPS [r] | N/D | 1 TPS [h] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TagStream | 50 TPS [r] | N/D | 5 TPS [r] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UntagStream | 50 TPS [r] | N/D | 5 TPS [r] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UpdateDataRetention | 50 TPS [r] | N/D | 5 TPS [r] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UpdateImageGenerationConfiguration | 50 TPS [r] | N/D | 5 TPS [r] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UpdateNotificationConfiguration | 50 TPS [r] | N/D | 5 TPS [r] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UpdateStream | 50 TPS [r] | N/D | 5 TPS [r] |
Quote dei servizi API multimediali e archiviati
La sezione seguente descrive le quote di servizio per le API multimediali e archiviate.
Quando viene raggiunto un limite di richieste a livello di account o di risorsa, viene generato un. ClientLimitExceededException
Quando viene raggiunto un limite a livello di connessione, viene generata un'eccezione ConnectionLimitExceededException
.
Quando viene raggiunto un limite a livello di frammento, vengono generati i seguenti errori o messaggi ACK:
-
Se un frammento è inferiore alla durata minima, viene restituito il messaggio ACK
MIN_FRAGMENT_DURATION_REACHED
. -
Se un frammento è superiore alla durata massima, viene restituito il messaggio ACK
MAX_FRAGMENT_DURATION_REACHED
. -
Se un frammento supera le dimensioni massime dei dati, viene restituito il messaggio ACK
MAX_FRAGMENT_SIZE
. -
Viene generata un'eccezione
FragmentLimitExceeded
se viene raggiunto un limite a livello di frammento in un'operazioneGetMediaForFragmentList
.
Quote dei servizi API Data Plane | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
API | Limite a livello di flusso | Limite a livello di connessione | Limite larghezza di banda | Limite a livello di frammento | Eccezioni e note pertinenti | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PutMedia | 5 TPS [r] | 1 [f] | 12,5 MB/secondo o 100 Mbps [s] per stream |
|
Una tipica richiesta PutMedia conterrà i dati per alcuni secondi, generando un TPS minore per flusso. Se sono presenti più connessioni simultanee che superano le quote, viene accettata l'ultima connessione. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetClip | N/D | N/D | Limite di dimensione 100 MB [h] | Numero massimo di frammenti: 200 [h] | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetDASHStreamingSessionURL | 25 TPS [h] | N/D | N/D | N/D | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetHLSStreamingSessionURL | 25 TPS [h] | N/D | N/D | N/D | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetImages | N/D | N/D | 100 MB [h] | N/D | Il numero massimo di immagini per richiesta è 100 [h]. NotaIl valore minimo per |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetMedia | 5 TPS [r] | 3 [f] | 25 MB/sec. o 200 Mbps [f] | Numero massimo di frammenti inviati al secondo: 6 [h] | Un client utente unico non dovrebbe aver bisogno di più di due o tre TPS perché dopo aver stabilito la connessione, l'applicazione dovrebbe leggere continuamente. Se un frammento tipico è di circa 5 MB, questo limite equivale a ~75 MBps per flusso video Kinesis. Un tale flusso avrebbe un bitrate in uscita doppio rispetto al massimo bitrate in entrata per i flussi. Nota
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetMediaForFragmentList | N/D | 5 [s] | 25 MB/sec. o 200 Mbps [s] | Numero massimo di frammenti: 1.000 [h] | È possibile richiamare contemporaneamente cinque applicazioni che utilizzano frammenti. GetMediaForFragmentList Eventuali altre connessioni vengono rifiutate. |
Quote dei servizi API del protocollo di riproduzione video | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
API | Limite a livello di sessione | Limite a livello di frammento | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetDash ManifestPlaylist | 5 TPS [r] | Numero massimo di frammenti per playlist: 5000 [h] | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetHLS MasterPlaylist | 5 TPS [r] | N/D | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetHLS MediaPlaylist | 5 TPS [r] | Numero massimo di frammenti per playlist: 5000 [h] | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Ottieni MP4 InitFragment | 5 TPS [r] | N/D | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Ottieni MP4 MediaFragment | 20 TPS [h] | N/D | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetTSFragment | 20 TPS [h] | N/D |
Framment-metadati e framment-media quote
Le API Kinesis Video Streams per l'accesso ai contenuti multimediali archiviati vengono limitate in base al numero di frammenti richiesti anziché al numero di chiamate API. Le API sono limitate in base alla velocità sia dal numero di metadati dei frammenti che dal numero di frammenti multimediali richiesti. I metadati dei frammenti e le quote multimediali dei frammenti vengono applicati per stream. In altre parole, le richieste di metadati o contenuti multimediali di frammento in uno stream non si applicano alle quote di un altro stream. Tuttavia, all'interno di un determinato flusso, ogni quota è condivisa tra più API. Ciò significa che, per un determinato flusso, le richieste di frammenti tra API diverse utilizzano la stessa quota. Quando viene superata la quota dei metadati dei frammenti o dei frammenti multimediali per uno stream, l'API restituisce un. ClientLimitExceededException
Le tabelle seguenti mostrano come le API utilizzano ciascuno dei due tipi di quota. Per la seconda colonna di queste tabelle, supponiamo che se uno stream ha una quota di N, ciò significa che le API hanno N punti da utilizzare da quel tipo di quota per quel flusso. L'GetClip
API appare in entrambe le tabelle.
Consumo di quote di metadati frammentati | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
API | Numero di punti di quota consumati per richiesta | Quota condivisa (N) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ListFragments | Valore del MaxResults parametro |
10000 punti di quota al secondo, per stream [h] | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetClip | Numero di frammenti nella clip risultante | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetHLSMediaPlaylist |
Valore del parametro MaxMediaPlaylistFragmentResults |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetDASHManifest |
Valore del MaxManifestFragmentResults parametro |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetImages | Valore di oltre 400 (numero massimo di immagini richieste) |
Consumo di quote multimediali frammentate | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
API | Numero di punti di quota consumati per richiesta | Quota condivisa (N) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetMediaForFragmentList | Numero di frammenti nel parametro Fragments | 500 punti di quota al secondo, per stream [h] | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetClip | Numero di frammenti nella clip risultante | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetMP4MediaFragment |
1 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetTSFragment |
1 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetImages | Numero massimo di immagini richieste |
Ad esempio, con una quota di 500 frammenti multimediali al secondo, sono supportati i seguenti pattern di chiamata per un determinato flusso:
-
5 richieste al secondo
GetClip
con 100 frammenti in ogni clip. -
100 richieste al secondo
GetClip
con 5 frammenti in ogni clip. 2 richieste al secondo per
GetClip
100 frammenti in ogni clip e 3 richieste al secondo perGetMediaForFragmentList
ogni clip.400 richieste al secondo a
GetMP4MediaFragment
e 100 richieste al secondo aGetTSFragment
.
Queste quote hanno un'importante implicazione per quanto riguarda il numero di sessioni HLS e MPEG-DASH che possono essere supportate per stream. Non c'è limite al numero di sessioni HLS e DASH che possono essere utilizzate dai lettori multimediali in un determinato momento. Pertanto, è importante che l'applicazione di riproduzione non consenta di utilizzare troppe sessioni contemporaneamente. I due esempi seguenti descrivono come determinare il numero di sessioni di riproduzione simultanee che possono essere supportate:
Esempio 1: streaming live
In uno scenario di live streaming con HLS con frammenti della durata di 1 secondo, una traccia audio e video e MaxMediaPlaylistFragmentResults
impostato su cinque, un lettore multimediale effettua in genere due chiamate al GetHLSMediaPlaylist
secondo. Una chiamata è per i metadati video più recenti e un'altra per i metadati audio corrispondenti. Le due chiamate utilizzano ciascuna cinque punti di quota di metadati frammentari. Inoltre, effettua due chiamate al secondo: una GetMP4MediaFragment
per il video più recente e l'altra per l'audio corrispondente. Ogni chiamata utilizza un token multimediale a frammento singolo, quindi vengono consumati due token in totale.
In questo scenario, possono essere supportate fino a 250 sessioni di riproduzione simultanee. Con 250 sessioni, questo scenario consuma 2.500 punti di quota di metadati di frammenti al secondo (ben al di sotto della quota di 10.000) e 500 punti di quota multimediale di frammenti al secondo.
Esempio 2: riproduzione su richiesta
In uno scenario di riproduzione su richiesta di un evento passato con MPEG-DASH, una traccia audio e video MaxManifestFragmentResults
impostata su 1.000, un lettore multimediale in genere chiama una GetDASHManifest
volta all'inizio della sessione (consumando 1.000 punti di quota di metadati dei frammenti) e chiama GetMP4MediaFragment
a una velocità massima di 5 volte al secondo (consumando 5 punti di quota multimediale per frammenti) fino al caricamento di tutti i frammenti. In questo scenario, è possibile avviare fino a 10 nuove sessioni al secondo (proprio alla quota di 10.000 frammenti di metadati al secondo) e fino a 100 sessioni possono caricare attivamente file multimediali frammentati a una velocità di 5 al secondo (proprio alla quota di 500 frammenti di file multimediali al secondo).
È possibile utilizzare ArchivedFragmentsConsumed.Metadata
e ArchivedFragmentsConsumed.Media
monitorare rispettivamente il consumo di metadati di frammenti e punti di quota dei frammenti multimediali. Per informazioni sul monitoraggio, vedere. Monitoraggio dei flussi video di Amazon Kinesis
Quote di metadati per frammenti
Le seguenti quote di servizio si applicano all'aggiunta di metadati di frammenti ai frammenti in un flusso video Kinesis:
-
Puoi anteporre a un frammento fino a 10 elementi metadati.
-
La lunghezza del nome dei metadati del frammento può essere al massimo di 128 byte.
-
La lunghezza del valore dei metadati del frammento può essere al massimo di 256 byte.
-
Il nome di metadati di un frammento non può iniziare con la stringa "».
AWS
Se un elemento metadati viene aggiunto, il metodoputFragmentMetadata
nel PIC restituisce un erroreSTATUS_INVALID_METADATA_NAME
(codice errore0x52000077
). La tua applicazione può ignorare l'errore (il PIC non aggiunge l'elemento metadati) oppure correggere l'errore.
Tag di streaming
Queste coppie chiave-valore dei metadati si applicano all'intera risorsa Kinesis Video Streams, non ai singoli frammenti contenuti in un flusso video Kinesis.
Ogni stream video Kinesis supporta fino a 50 tag.
Vedi TagStream le restrizioni sulle chiavi e sui valori dei tag stream.