Quotas du service Amazon Kinesis Video Streams

Kinesis Video Streams dispose des quotas de service suivants :

Important

Les quotas de service suivants sont soit souples [s], qui peuvent être améliorés en soumettant un ticket d'assistance, soit stricts [h], qui ne peuvent pas être augmentés. Vous verrez [s] et [h] à côté du quota de service individuel dans les tableaux ci-dessous.

Quotas de API service du plan de contrôle

La section suivante décrit les quotas de service pour le plan de contrôleAPIs. TPSreprésente les transactions par seconde.

Lorsqu'une limite de demandes au niveau du compte ou au niveau des ressources est atteinte, un est émis. ClientLimitExceededException

Quotas de API service du plan de contrôle

API	Limite de compte : demande	Limite du compte : Streams	Limite au niveau du flux	Exceptions et remarques pertinentes
CreateStream	50 TPS [s]	10000 streams par compte [s] dans les régions USA Est (Virginie du Nord) et USA Ouest (Oregon). 5000 streams par compte [s] dans toutes les autres régions prises en charge. Note Cette limite peut être augmentée jusqu'à 100 000 flux (ou plus) par compte(s). Connectez-vous à AWS Management Console à l'adresse https://console.aws.amazon.com/ et soumettez une demande d'augmentation de limite de service pour que Kinesis Video Streams demande une augmentation de cette limite.		Les appareilsCLIs, l'accès SDK piloté et la console peuvent tous l'invoquer. API Un seul API appel réussit si le flux n'existe pas déjà.
DeleteEdgeConfiguration	10 TPS [h]	N/A	1 TPS [h]
DeleteStream	50 TPS [h]	N/A	5 TPS [h]
DescribeEdgeConfiguration	50 TPS [h]	N/A	5 TPS [h]
DescribeImageGenerationConfiguration	50 TPS [h]	N/A	5 TPS [h]
DescribeMappedResourceConfiguration	50 TPS [h]	N/A	5 TPS [h]
DescribeNotificationConfiguration	50 TPS [h]	N/A	5 TPS [h]
DescribeStream	300 TPS [h]	N/A	5 TPS [h]
GetDataEndpoint	300 TPS [h]	N/A	5 TPS [h]	Appelée toutes les 45 minutes pour actualiser le jeton de streaming pour la plupart des cas d'utilisation PutMedia/GetMedia. La mise en cache des points de terminaison de données est sécurisée si l'application les recharge en cas d'échec.
ListEdgeAgentConfigurations	50 TPS [h]	N/A	N/A
ListStreams	50 TPS [h]	N/A
ListTagsForStream	50 TPS [h]	N/A	5 TPS [h]
StartEdgeConfigurationUpdate	10 TPS [h]	N/A	1 TPS [h]
TagStream	50 TPS [h]	N/A	5 TPS [h]
UntagStream	50 TPS [h]	N/A	5 TPS [h]
UpdateDataRetention	50 TPS [h]	N/A	5 TPS [h]
UpdateImageGenerationConfiguration	50 TPS [h]	N/A	5 TPS [h]
UpdateNotificationConfiguration	50 TPS [h]	N/A	5 TPS [h]
UpdateStream	50 TPS [h]	N/A	5 TPS [h]

Quotas de services de médias et de médias archivés API

La section suivante décrit les quotas de service pour les médias et les médias archivésAPIs.

Lorsqu'une limite de demandes au niveau du compte ou au niveau des ressources est atteinte, un est émis. ClientLimitExceededException

Lorsqu'une limite au niveau de la connexion est atteinte, une exception ConnectionLimitExceededException est déclenchée.

Les erreurs ou accusés de réception suivants sont déclenchés lorsqu'une limite au niveau du fragment est atteinte :

• Un accusé de réception MIN_FRAGMENT_DURATION_REACHED est renvoyé pour un fragment inférieur à la durée minimale.

• Un accusé de réception MAX_FRAGMENT_DURATION_REACHED est renvoyé pour un fragment supérieur à la durée maximale.

• Un accusé de réception MAX_FRAGMENT_SIZE est renvoyé pour un fragment supérieur à la taille de données maximale.

• Une exception FragmentLimitExceeded est déclenchée si une limite de fragment est atteinte dans une opération GetMediaForFragmentList.

Quotas de API service du plan de données

API	Limite au niveau du flux	Limite au niveau de la connexion	Limite de bande passante	Limite au niveau du fragment	Exceptions et remarques pertinentes
PutMedia	5 TPS [h]	1 [s]	12,5 Mo/seconde, ou 100 Mbps [s] par flux	Durée minimale d'un fragment : 1 seconde [h] Durée maximale du fragment : 20 secondes [h] Taille maximale d'un fragment : 50 Mo [h] Nombre maximal de pistes : 3 [s] Nombre maximum de fragments envoyés par seconde : 5 [h] Limite maximale de métadonnées de fragments : 10 balises [h]	Une PutMedia demande typique contient des données pendant plusieurs secondes, ce qui se traduit par une réduction TPS par flux. Si plusieurs connexions simultanées dépassent les quotas, la dernière connexion est acceptée.
GetClip	N/A	N/A	Limite de taille de 100 Mo [h]	Nombre maximal de fragments : 200 [h]
etDASHStreamingSéance G URL	25 TPS [h]	N/A	N/A	N/A
etHLSStreamingSéance G URL	25 TPS [h]	N/A	N/A	N/A
GetImages	N/A	N/A	100 Mo [h]	N/A	Le nombre maximum d'images par demande est de 100 [h]. Note La valeur minimale pour SamplingInterval est de 200 millisecondes (ms), soit 5 images par seconde.
GetMedia	5 TPS [h]	3 [s]	25 Mo/s ou 200 Mbits [s]	Maximum de 5 fragments envoyés par seconde [h]	Un client consommateur unique ne devrait pas en avoir besoin de plus de deux ou trois, TPS car une fois la connexion établie, l'application doit lire en continu. Si la taille d'un fragment typique est d'environ 5 Mo, cette limite correspond à environ 75 MBps Mo par flux vidéo Kinesis. Un tel flux aurait un débit binaire sortant égal à 2 fois le débit binaire entrant maximal des flux. Note GetMedian'est pas utilisé pour la DASH lecture deHLS//.
GetMediaForFragmentList	N/A	5 [s]	25 Mo/s ou 200 Mbits [s]	Nombre maximal de fragments : 1000 [h]	Cinq applications consommatrices basées sur des fragments peuvent être invoquées simultanément. GetMediaForFragmentList Les autres connexions sont rejetées.

Quotas de API service du protocole de lecture vidéo

API	Limite au niveau de la session	Limite au niveau du fragment
etDASHManifestPlaylist G	5 TPS [h]	Nombre maximum de fragments par playlist : 5000 [h]
etHLSMasterPlaylist G	5 TPS [h]	N/A
etHLSMediaPlaylist G	5 TPS [h]	Nombre maximum de fragments par playlist : 5000 [h]
Obtenez MP4InitFragment	5 TPS [h]	N/A
Obtenez MP4MediaFragment	20 TPS [h]	N/A
G etTSFragment	20 TPS [h]	N/A

Quotas de métadonnées et de médias fragmentés

Les Kinesis Video APIsStreams permettant d'accéder aux médias archivés sont limités en fonction du nombre de fragments demandés plutôt que du nombre d'appels. API APIssont limités en débit à la fois par le nombre de métadonnées des fragments et par le nombre de fragments multimédias demandés. Les métadonnées des fragments et les quotas de fragments multimédias sont appliqués par flux. En d'autres termes, les demandes de métadonnées fragmentées ou de contenu multimédia dans un flux ne s'appliquent pas aux quotas d'un autre flux. Cependant, au sein d'un flux donné, chaque quota est partagé entre plusieursAPIs. Cela signifie que, pour un flux donné, les demandes de fragments provenant de différents types APIs consomment le même quota. Lorsque les métadonnées du fragment ou le quota multimédia du fragment pour un flux sont dépassés, la API valeur renvoyée ClientLimitExceededException a. Les tableaux suivants montrent comment APIs ils consomment chacun des deux types de quotas. Pour la deuxième colonne de ces tableaux, supposons que si un flux a un quota de N, cela signifie qu'il APIs a N points à consommer pour ce type de quota pour ce flux. GetClipAPIIl apparaît dans les deux tableaux.

Consommation de quotas de métadonnées fragmentées

API	Nombre de points de quota consommés par demande	Quota partagé (N)
ListFragments	Valeur du MaxResults paramètre	10000 points de quota par seconde, par stream [h]
GetClip	Nombre de fragments dans le clip obtenu
GetHLSMediaPlaylist	Valeur du MaxMediaPlaylistFragmentResults paramètre
GetDASHManifest	Valeur du MaxManifestFragmentResults paramètre
GetImages	Valeur de 400 + nombre maximum d'images demandées

Fragmenter la consommation de quotas de médias

API	Nombre de points de quota consommés par demande	Quota partagé (N)
GetMediaForFragmentList	Nombre de fragments dans le paramètre Fragments	500 points de quota par seconde, par stream [h]
GetClip	Nombre de fragments dans le clip obtenu
GetMP4MediaFragment	1
GetTSFragment	1
GetImages	Nombre maximum d'images demandées

Par exemple, avec un quota de 500 fragments de média par seconde, les modèles d'appel suivants sont pris en charge pour un flux donné :

• 5 requêtes par seconde GetClip avec 100 fragments dans chaque clip.

• 100 requêtes par seconde GetClip avec 5 fragments dans chaque clip.

• 2 requêtes par seconde pour GetClip 100 fragments par clip et 3 requêtes par seconde pour GetMediaForFragmentList chaque clip.

• 400 demandes par seconde vers GetMP4MediaFragment et 100 demandes par seconde versGetTSFragment.

Ces quotas ont une incidence importante sur le nombre de DASH sessions HLS et MPEG - qui peuvent être prises en charge par stream. Il n'y a aucune limite quant au nombre de HLS DASH sessions que les lecteurs multimédias peuvent utiliser à un moment donné. Il est donc important que l'application de lecture n'autorise pas l'utilisation simultanée d'un trop grand nombre de sessions. Les deux exemples suivants décrivent comment déterminer le nombre de sessions de lecture simultanées pouvant être prises en charge :

Exemple 1 : diffusion en direct

Dans un scénario de diffusion en direct HLS avec des fragments d'une durée d'une seconde, une piste audio et vidéo, et une valeur MaxMediaPlaylistFragmentResults définie sur cinq, un lecteur multimédia effectue généralement deux appels GetHLSMediaPlaylist par seconde. Un appel porte sur les dernières métadonnées vidéo et un autre sur les métadonnées audio correspondantes. Les deux appels consomment chacun cinq points de quota de métadonnées de fragments. Il effectue également deux appels GetMP4MediaFragment par seconde : un appel pour la dernière vidéo et un autre pour le son correspondant. Chaque appel consomme un jeton multimédia fragmenté, donc deux jetons sont consommés au total.

Dans ce scénario, jusqu'à 250 sessions de lecture simultanées peuvent être prises en charge. Avec 250 sessions, ce scénario consomme 2 500 points de quota de métadonnées de fragments par seconde (bien en deçà du quota de 10 000) et 500 points de quota de fragments de média par seconde.

Exemple 2 : lecture à la demande

Dans le scénario de lecture à la demande d'un événement passé avec MPEG -DASH, une piste audio et vidéo MaxManifestFragmentResults définie sur 1 000, un lecteur multimédia appelle généralement une GetDASHManifest fois au début de la session (consommation de 1 000 points de quota de métadonnées de fragments) et il appelle jusqu'GetMP4MediaFragmentà 5 fois par seconde (consommation de 5 points de quota de fragments de contenu multimédia) jusqu'à ce que tous les fragments soient chargés. Dans ce scénario, jusqu'à 10 nouvelles sessions peuvent être démarrées par seconde (juste au quota de 10 000 fragments de métadonnées par seconde), et jusqu'à 100 sessions peuvent charger activement des fragments de média à un rythme de 5 par seconde (juste au quota de 500 fragments de média par seconde).

Vous pouvez utiliser ArchivedFragmentsConsumed.Metadata et ArchivedFragmentsConsumed.Media surveiller la consommation de métadonnées de fragments et de points de quota de fragments de média, respectivement. Pour plus d'informations sur la surveillance, consultezSurveillance d'Amazon Kinesis Video Streams.

Quotas du service de métadonnées en streaming

Les quotas de service suivants s'appliquent à l'ajout de métadonnées de streaming à un flux vidéo Kinesis :

• Vous pouvez ajouter jusqu'à 10 éléments de métadonnées à un fragment.

• La longueur d'un nom de métadonnées de fragment ne doit pas dépasser 128 octets.

• La longueur d'une valeur de métadonnées de fragment ne doit pas dépasser 256 octets.

• Le nom des métadonnées d'un fragment ne peut pas commencer par la chaîne « AWS ». Si un tel élément de métadonnées est ajouté, la putFragmentMetadata méthode indiquée dans le PIC renvoie une STATUS_INVALID_METADATA_NAME erreur (code d'erreur0x52000077). Votre application peut alors soit ignorer l'erreur (PICelle n'ajoute pas l'élément de métadonnées), soit répondre à l'erreur.

SDKQuotas de producteurs

Le tableau suivant contient les quotas actuels pour les valeurs duSDK. Pour plus d’informations, consultez Transférer vers Kinesis Video Streams.

Note

Avant de définir ces valeurs, vous devez valider vos entrées. Ces limites SDK ne sont pas validées et une erreur d'exécution se produit si les limites sont dépassées.

Valeur	Limite	Remarques
Nombre max. de flux	128	Nombre maximal de flux qu'un objet producteur peut créer. Il s'agit d'une limite flexible (vous pouvez demander une augmentation). Cela garantit que le producteur ne crée pas accidentellement des flux de manière récursive.
Longueur max. du nom de l'appareil	128 caractères
Nombre max. de balises	50 par flux
Longueur max. de nom de flux	256 caractères
Taille de stockage min.	10 Mio = 10 * 1024 * 1024 octets
Taille de stockage max.	10 Gio = 10 * 1024 * 1024 * 1024 octets
Longueur max. du chemin du répertoire racine	4,096 caractères
Longueur max. des infos d'authentification	10 000 octets
Longueur de URI chaîne maximale	10 000 caractères
Longueur max. de nom de balise	128 caractères
Longueur max. de valeur de balise	1,024 caractères
Période min. de jeton de sécurité	30 secondes
Période de grâce de jeton de sécurité	40 minutes	Si la durée spécifiée est plus longue, elle est limitée à cette valeur.
Période de conservation	0 ou supérieure à une heure	0 indique l'absence de conservation.
Durée de cluster min.	1 seconde	La valeur est spécifiée en unités de 100 ns, ce qui est la SDK norme.
Durée de cluster max.	30 secondes	La valeur est spécifiée en unités de 100 ns, ce qui est la SDK norme. Le backend API peut imposer une durée de cluster plus courte.
Taille de fragment max.	50 Mo	Pour de plus amples informations, veuillez consulter Quotas du service Amazon Kinesis Video Streams.
Durée de fragment max.	20 secondes	Pour de plus amples informations, veuillez consulter Quotas du service Amazon Kinesis Video Streams.
Durée de connexion max.	45 minutes	Le backend ferme la connexion après cette période. Fait SDK pivoter le jeton et établit une nouvelle connexion dans ce délai.
Longueur maximale ACK du segment	1,024 caractères	Longueur de segment maximale de l'accusé de réception envoyé à la fonction d'ACKanalyse.
Longueur max. de chaîne de type de contenu	128 caractères
Longueur max. de chaîne d'ID de codec	32 caractères
Longueur max. de chaîne de nom de piste	32 caractères
Longueur max. des données privées codec	1 Mio = 1 * 1024 * 1024 octets
Longueur min. de valeur d'échelle de code horaire	100 ns	Valeur d'échelle de code temporel minimale pour représenter les horodatages des images dans le cluster résultant. MKV La valeur est spécifiée par incréments de 100 ns, ce qui est la SDK norme.
Longueur max. de valeur d'échelle de code horaire	1 seconde	La valeur d'échelle maximale du code temporel représentant les horodatages des images dans le cluster obtenu. MKV La valeur est spécifiée par incréments de 100 ns, ce qui est la SDK norme.
Nombre min. d'éléments d'affichage de contenu	10
Durée min. de mise en tampon	20 secondes	La valeur est spécifiée par incréments de 100 ns, ce qui est la SDK norme.
Longueur max. de version de mise à jour	128 caractères
ARNLongueur maximale	1024 caractères
Longueur max. de séquence de fragment	128 caractères
Période de conservation maximale	10 Ans