Quotas de service API du plan de contrôle Quotas de service d'API pour les médias et les médias archivés Quotas de métadonnées et de médias fragmentés Quotas du service de métadonnées en streaming Quotas du SDK pour les producteurs

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 service API du plan de contrôle

La section suivante décrit les quotas de service pour le plan de contrôle APIs. TPS est l'abréviation de transactions par seconde.

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

« Hello, World! »	Limite de compte : demande	Limite du compte : Streams	Limite au niveau du flux	Exceptions et remarques pertinentes
CreateStream	50 TPS [s]	10 000 streams par compte [s] dans toutes les régions prises en charge. Note Cette limite peut être augmentée jusqu'à 100 000 flux (ou plus) par compte(s). Connectez-vous à l' AWS Management Console adresse https://console.aws.amazon.com/ et demandez une augmentation de cette limite.		Les appareils CLIs, l'accès piloté par le SDK et la console peuvent tous invoquer cette API. Un seul appel d'API réussit si le flux n'existe pas encore.
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 service d'API pour les médias et les médias archivés

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

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 service d'API de plan de données

« Hello, World! »	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 demande `PutMedia` typique contient des données pour plusieurs secondes, ce qui se traduit par une valeur de TPS plus faible 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]
Obtenir l'URL de DASHStreaming la session	25 TPS [h]	N/A	N/A	N/A
Obtenir l'URL de HLSStreaming la session	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 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 `GetMedia`n'est pas utilisé pour la lecture HLS/DASH.
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 service API du protocole de lecture vidéo

« Hello, World! »	Limite au niveau de la session	Limite au niveau du fragment
Obtenir une DASHManifest playlist	5 TPS [h]	Nombre maximum de fragments par playlist : 5 000 [h]
Obtenir une HLSMaster playlist	5 TPS [h]	N/A
Obtenir une HLSMedia playlist	5 TPS [h]	Nombre maximum de fragments par playlist : 5 000 [h]
Obtenez MP4 InitFragment	5 TPS [h]	N/A
Obtenez MP4 MediaFragment	20 TPS [h]	N/A
Obtenez TSFragment	20 TPS [h]	N/A

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

Les Kinesis Video APIs Streams 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 d'API. APIs sont 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 plusieurs APIs. 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, l'API renvoie unClientLimitExceededException. 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. L'GetClipAPI apparaît dans les deux tableaux.

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

« Hello, World! »	Nombre de points de quota consommés par demande	Quota partagé (N)
`ListFragments`	Valeur du `MaxResults` paramètre	10 000 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

Consommation de quotas de médias fragmentés

« Hello, World! »	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 contenu multimé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 dans chaque 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 sessions HLS et MPEG-DASH qui peuvent être prises en charge par flux. Il n'y a pas de limite au nombre de sessions HLS et DASH pouvant être utilisées par les lecteurs multimédias à 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 avec HLS avec des fragments d'une durée d'une seconde, une piste audio et vidéo, et MaxMediaPlaylistFragmentResults réglé 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 seul fragment de jeton multimédia, 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 un scénario de lecture à la demande d'un événement passé avec MPEG-DASH, une piste audio et vidéo MaxManifestFragmentResults réglée 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 méthode putFragmentMetadata du PIC renvoie une erreur STATUS_INVALID_METADATA_NAME (code d'erreur 0x52000077). Votre application peut alors ignorer l'erreur (le PIC n'ajoute pas l'élément de métadonnées), ou répondre à l'erreur.

Quotas du SDK pour les producteurs

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

Note

Avant de définir ces valeurs, vous devez valider vos entrées. Le kit SDK ne valide pas ces limites et une erreur d'exécution se produit en cas de dépassement des limites.

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 max. de chaîne d'URI	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 le standard du kit SDK.
Durée de cluster max.	30 secondes	La valeur est spécifiée en unités de 100 ns, ce qui est le standard du kit SDK. L'API principale 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. Le kit SDK effectue une rotation du jeton et établit une nouvelle connexion au cours de cette période.
Longueur max. de segment ACK	1,024 caractères	Longueur max. de segment de la confirmation envoyée à la fonction d'analyseur ACK.
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	La valeur minimale d'échelle de code horaire pour représenter les horodatages des images dans le cluster MKV obtenu. Cette valeur est spécifiée sous forme d'incréments de 100 ns, ce qui est le standard du kit SDK.
Longueur max. de valeur d'échelle de code horaire	1 seconde	La valeur maximale d'échelle de code horaire pour représenter les horodatages des images dans le cluster MKV obtenu. Cette valeur est spécifiée sous forme d'incréments de 100 ns, ce qui est le standard du kit SDK.
Nombre min. d'éléments d'affichage de contenu	10
Durée min. de mise en tampon	20 secondes	Cette valeur est spécifiée sous forme d'incréments de 100 ns, ce qui est le standard du kit SDK.
Longueur max. de version de mise à jour	128 caractères
Longueur max. de nom ARN	1024 caractères
Longueur max. de séquence de fragment	128 caractères
Période de conservation maximale	10 Ans

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Configuration système requise

Configuré un compte .