Quote del servizio Amazon 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 API servizio del piano di controllo

La sezione seguente descrive le quote di servizio per il piano di controllo. APIs TPSsta per transazioni al secondo.

Quando viene raggiunto un limite di richiesta a livello di account o di risorsa, viene generato un. ClientLimitExceededException

APIQuote di servizio 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 [s]	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. Nota Questo 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/ e invia un caso di aumento dei limiti di servizio per Kinesis Video Streams per richiedere un aumento di questo limite.		Tutti i dispositiviCLIs, l'accesso SDK guidato e la console possono richiamarlo. API Solo una API chiamata ha esito positivo se lo stream non esiste già.
DeleteEdgeConfiguration	10 TPS [h]	N/D	1 TPS [h]
DeleteStream	50 TPS [h]	N/D	5 TPS [h]
DescribeEdgeConfiguration	50 TPS [h]	N/D	5 TPS [h]
DescribeImageGenerationConfiguration	50 TPS [h]	N/D	5 TPS [h]
DescribeMappedResourceConfiguration	50 TPS [h]	N/D	5 TPS [h]
DescribeNotificationConfiguration	50 TPS [h]	N/D	5 TPS [h]
DescribeStream	300 TPS [h]	N/D	5 TPS [h]
GetDataEndpoint	300 TPS [h]	N/D	5 TPS [h]	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 [h]	N/D	N/D
ListStreams	50 TPS [h]	N/D
ListTagsForStream	50 TPS [h]	N/D	5 TPS [h]
StartEdgeConfigurationUpdate	10 TPS [h]	N/D	1 TPS [h]
TagStream	50 TPS [h]	N/D	5 TPS [h]
UntagStream	50 TPS [h]	N/D	5 TPS [h]
UpdateDataRetention	50 TPS [h]	N/D	5 TPS [h]
UpdateImageGenerationConfiguration	50 TPS [h]	N/D	5 TPS [h]
UpdateNotificationConfiguration	50 TPS [h]	N/D	5 TPS [h]
UpdateStream	50 TPS [h]	N/D	5 TPS [h]

Quote relative ai servizi multimediali e archiviati API

La sezione seguente descrive le quote di servizio per i media e i supporti archiviati. APIs

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'operazione GetMediaForFragmentList.

APIQuote di servizio del piano dati

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 [h]	1 [f]	12,5 MB/secondo o 100 Mbps [s] per stream	Durata minima frammento: 1 secondo [r] Durata massima del frammento: 20 secondi [h] Dimensione massima frammento: 50 MB [r] Numero massimo di brani: 3 [s] Numero massimo di frammenti inviati al secondo: 5 [h] Limite massimo di metadati per frammenti: 10 tag [h]	Una PutMedia richiesta tipica contiene dati per diversi secondi, con una conseguente riduzione TPS per stream. 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]
Sessione G etDASHStreaming URL	25 TPS [h]	N/D	N/D	N/D
etHLSStreamingSessione G URL	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]. Nota Il valore minimo per SamplingInterval è 200 millisecondi (ms), ovvero 5 immagini al secondo.
GetMedia	5 [h] TPS	3 [f]	25 MB/sec. o 200 Mbps [f]	Massimo 5 frammenti inviati al secondo [h]	Un client utente unico non dovrebbe averne bisogno più di due o tre TPS perché, una volta stabilita la connessione, l'applicazione dovrebbe leggere continuamente. Se un frammento tipico è di circa 5 MB, questo limite equivale a ~75 per flusso MBps video Kinesis. Un tale flusso avrebbe un bitrate in uscita doppio rispetto al massimo bitrate in entrata per i flussi. Nota GetMedianon viene utilizzato per HLS /playback. DASH
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 del protocollo di riproduzione video API

API	Limite a livello di sessione	Limite a livello di frammento
Playlist G etDASHManifest	5 TPS [h]	Numero massimo di frammenti per playlist: 5000 [h]
Playlist G etHLSMaster	5 TPS [h]	N/D
etHLSMediaPlaylist G	5 TPS [h]	Numero massimo di frammenti per playlist: 5000 [h]
Ottieni MP4InitFragment	5 TPS [h]	N/D
Ottenere MP4MediaFragment	20 TPS [h]	N/D
G etTSFragment	20 TPS [h]	N/D

Framment-metadati e framment-media quote

I Kinesis APIsVideo Streams per l'accesso ai contenuti multimediali archiviati sono limitati in base al numero di frammenti richiesti anziché al numero di chiamate. API APIssono limitati alla frequenza 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 stream, ogni quota è condivisa tra più stream. APIs Ciò significa che, per un determinato flusso, le richieste di frammenti tra diversi APIs consumano la stessa quota. Quando vengono superati i metadati dei frammenti o la quota multimediale dei frammenti per uno stream, restituisce a. API ClientLimitExceededException Le tabelle seguenti mostrano come vengono APIs consumati 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 APIs abbia N punti da consumare da quel tipo di quota per quel flusso. GetClipAPIViene visualizzato 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 per GetMediaForFragmentList 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 DASH sessioni HLS e MPEG - che possono essere supportate per stream. Non c'è limite al numero di DASH sessioni che HLS i lettori multimediali possono utilizzare 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 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 GetHLSMediaPlaylist al 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 e MaxManifestFragmentResults impostato 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 dei servizi di metadati di streaming

Le seguenti quote di servizio si applicano all'aggiunta di metadati di streaming a 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 viene aggiunto un elemento di metadati di questo tipo, il putFragmentMetadata metodo in PIC restituisce un STATUS_INVALID_METADATA_NAME errore (codice di errore). 0x52000077 L'applicazione può quindi ignorare l'errore (PICnon aggiunge l'elemento di metadati) o rispondere all'errore.

Quote di produzione SDK

La tabella seguente contiene le quote correnti per i valori in. SDK Per ulteriori informazioni, consulta Caricamento su Kinesis Video Streams.

Nota

Prima di impostare questi valori, è necessario convalidare gli input. SDKNon convalida questi limiti e si verifica un errore di runtime se i limiti vengono superati.

Valore	Limite	Note
Numero massimo di flussi	128	Il numero massimo di flussi che un oggetto producer può creare. Si tratta di un limite flessibile, per il quale puoi richiedere un aumento. Garantisce che il produttore non crei accidentalmente stream in modo ricorsivo.
Lunghezza massima del nome del dispositivo	128 caratteri
Numero massimo di tag	50 per flusso
Lunghezza massima del nome del flusso	256 caratteri
Dimensione minima di storage	10 MiB = 10 * 1024 * 1024 byte
Dimensione massima di storage	10 GiB = 10 * 1024 * 1024 * 1024 byte
Lunghezza massima del percorso della directory root	4,096 caratteri
Lunghezza massima delle informazioni di autorizzazione	10,000 byte
Lunghezza URI massima della stringa	10,000 caratteri
Lunghezza massima del nome del tag	128 caratteri
Lunghezza massima del valore del tag	1,024 caratteri
Periodo minimo del token di sicurezza	30 secondi
Periodo di tolleranza del token di sicurezza	40 minuti	Se la durata specificata è più lunga, è limitata a questo valore.
Periodo di conservazione	0 o superiore a un'ora	Il valore 0 indica nessuna conservazione.
Durata minima del cluster	1 secondo	Il valore è specificato in unità da 100 ns, che è lo SDK standard.
Durata massima del cluster	30 secondi	Il valore è specificato in unità da 100 ns, che è lo SDK standard. Il backend API può imporre una durata del cluster più breve.
Dimensione massima del frammento	50 MB	Per ulteriori informazioni, consulta Quote del servizio Amazon Kinesis Video Streams.
Durata massima del frammento	20 secondi	Per ulteriori informazioni, consulta Quote del servizio Amazon Kinesis Video Streams.
Durata massima della connessione	45 minuti	Il back-end chiude la connessione dopo questo intervallo di tempo. Il token SDK ruota e stabilisce una nuova connessione entro questo periodo.
Lunghezza massima ACK del segmento	1,024 caratteri	Lunghezza massima del segmento della conferma inviata alla funzione ACK parser.
Lunghezza massima della stringa del tipo di contenuto	128 caratteri
Lunghezza massima della stringa dell'ID codec	32 caratteri
Lunghezza massima della stringa del nome della traccia	32 caratteri
Lunghezza massima dei dati privati del codec	1 MiB = 1 * 1024 * 1024 byte
Lunghezza minima del valore di scala del timecode	100 ns	Il valore minimo della scala del codice temporale per rappresentare i timestamp del frame nel cluster risultante. MKV Il valore è specificato in incrementi di 100 ns, che è lo standard. SDK
Lunghezza massima del valore di scala del timecode	1 secondo	Il valore massimo della scala del codice temporale per rappresentare i timestamp del frame nel cluster risultante. MKV Il valore è specificato in incrementi di 100 ns, che è lo standard. SDK
Numero minimo degli elementi di visualizzazione dei contenuti	10
Durata minima del buffer	20 secondi	Il valore è specificato in incrementi di 100 ns, che è lo SDK standard.
Lunghezza massima della versione di aggiornamento	128 caratteri
Lunghezza massima ARN	1024 caratteri
Lunghezza massima della sequenza dei frammenti	128 caratteri
Periodo massimo di conservazione	10 anni