As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Cotas do serviço Amazon Kinesis Video Streams
O Kinesis Video Streams tem as seguintes cotas de serviço:
**Importante**
**As cotas de serviço a seguir são flexíveis, que podem ser atualizadas com o envio de um ticket de suporte, ou rígidas **[h]**, que não podem ser aumentadas.** Você verá [s] e [h] ao lado da cota de serviço individual nas tabelas abaixo.
## Controle as cotas de serviço da API do plano
A seção a seguir descreve as cotas de serviço para o plano APIs de controle. TPS significa *transações por segundo*.
Quando um limite de solicitações no nível da conta ou do recurso é atingido, um é lançado. `ClientLimitExceededException`
| solicitações de | Limite da conta: Solicitação | Limite da conta: Streams | Limite do nível de streaming | Exceções e notas relevantes |
| --- | --- | --- | --- | --- |
| CreateStream | 50 TPS [s] | 10.000 streams por conta (s) em todas as regiões suportadas. Esse limite pode ser aumentado para até 100.000 (ou mais) streamings por conta [s]. Faça login no Console de gerenciamento da AWS at [https://console.aws.amazon.com/](https://console.aws.amazon.com/) e solicite um aumento desse limite. | | Dispositivos CLIs, acesso orientado por SDK e o console podem invocar essa API. Somente uma chamada de API é bem-sucedida se o streaming ainda não existir. |
| 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] | Chamado a cada 45 minutos para atualizar o token de streaming para a maioria dos casos de uso de PutMedia/GetMedia. A captura de endpoints de dados será segura se o aplicativo recarregá-los em caso de falha. |
| 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] | |
| UpdateStreamStorageConfiguration | 50 TPS [h] | N/D | 5 TPS [h] | |
| DescribeStreamStorageConfiguration | 50 TPS [h] | N/D | 5 TPS [h] | |
## Cotas de serviços de API de mídia e mídia arquivada
A seção a seguir descreve as cotas de serviço para mídia e mídia arquivada. APIs
Quando um limite de solicitações no nível da conta ou do recurso é atingido, um é lançado. `ClientLimitExceededException`
Quando um limite de nível de conexão é atingido, é lançada uma `ConnectionLimitExceededException`.
Os seguintes erros ou confirmações são lançados quando um limite de fragmento é atingido:
+ Um ACK `MIN_FRAGMENT_DURATION_REACHED` é retornado para um fragmento abaixo da duração mínima.
+ Uma confirmação `MAX_FRAGMENT_DURATION_REACHED` é retornado para um fragmento acima da duração máxima.
+ Uma confirmação `MAX_FRAGMENT_SIZE` é retornada para um fragmento acima do tamanho máximo de dados.
+ Uma exceção `FragmentLimitExceeded` é lançada se o limite de um fragmento for atingido em uma operação `GetMediaForFragmentList`.
**Cotas de serviço da API de plano de dados**
| solicitações de | Limite do nível de streaming | Limite de nível de conexão | Limite de largura de banda | Limite de nível de fragmento | Exceções e notas relevantes |
| --- | --- | --- | --- | --- | --- |
| PutMedia | 5 TPS [h] | 1 [h] | 12,5 MB/segundo ou 100 Mbps [s] por stream | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/kinesisvideostreams/latest/dg/limits.html) | [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)as solicitações são conexões de streaming e de longa duração. Você não precisa abrir uma nova conexão para cada parte dos dados porque você pode enviar vários fragmentos em uma única conexão persistente. Se você tentar mais de uma PutMedia conexão simultânea, o Kinesis Video Streams limitará as conexões mais recentes com uma mensagem de erro. ConnectionLimitExceededException |
| GetClip | N/D | N/D | Limite de tamanho de 100 MB [h] | Número máximo de fragmentos: 200 [h] | |
| Obtenha o URL DASHStreaming da sessão | 25 FPS [h] | N/D | N/D | N/D | |
| Obtenha o URL HLSStreaming da sessão | 25 FPS [h] | N/D | N/D | N/D | |
| GetImages | N/D | N/D | 100 MB [h] | N/D | O número máximo de imagens por solicitação é 100 [h]. O valor mínimo `SamplingInterval` é de 200 milissegundos (ms), ou seja, 5 imagens por segundo. |
| GetMedia | 5 TPS [h] | 3 [h] | 25 MB/s ou 200 Mbps [s] | Máximo de 5 fragmentos enviados por segundo [h] | [GetMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_GetMedia.html)as solicitações são conexões de streaming e de longa duração. Você não precisa abrir uma nova conexão para cada parte dos dados porque você pode enviar vários fragmentos em uma única conexão persistente. Se você tentar mais de três GetMedia conexões simultâneas, o Kinesis Video Streams limitará as conexões mais recentes com uma mensagem de erro. ConnectionLimitExceededException Se um fragmento típico tiver aproximadamente 5 MB, esse limite significa aproximadamente 75 por stream de vídeo do MBps Kinesis. Esse streaming teria uma taxa de bits de saída de 2 vezes a taxa de bits de entrada máxima dos streamings. `GetMedia`não é usado para HLS/DASH reprodução. |
| GetMediaForFragmentList | N/D | 5 [s] | 25 MB/s ou 200 Mbps [s] | Número máximo de fragmentos: 1.000 [h] | Cinco aplicativos de consumo baseados em fragmentos podem ser invocados simultaneamente. GetMediaForFragmentList Outras conexões de são rejeitadas. |
**Cotas de serviço da API de protocolo de reprodução de vídeo**
| solicitações de | Limite de nível de sessão | Limite de nível de fragmento |
| --- | --- | --- |
| Obtenha a DASHManifest playlist | 5 TPS [h] | Número máximo de fragmentos por playlist: 5.000 [h] |
| Obtenha a HLSMaster playlist | 5 TPS [h] | N/D |
| Obtenha a HLSMedia playlist | 5 TPS [h] | Número máximo de fragmentos por playlist: 5.000 [h] |
| Obtenha MP4 InitFragment | 5 TPS [h] | N/D |
| Obtenha MP4 MediaFragment | 20 FPS [h] | N/D |
| Obtenha TSFragment | 20 FPS [h] | N/D |
## Cotas de fragmentação de metadados e de mídia fragmentada
Os Kinesis [APIs Video Streams para acessar](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_Reference.html) mídias arquivadas são limitados com base no número de fragmentos solicitados e não no número de chamadas de API. APIs são limitados pela taxa tanto pelo número de metadados de fragmentos quanto pelo número de mídias de fragmentos solicitadas. Os metadados do fragmento e as cotas de mídia do fragmento são aplicados por fluxo. Em outras palavras, as solicitações de metadados ou mídias de fragmentos em um stream não se aplicam às cotas de outro stream. No entanto, em um determinado fluxo, cada cota é compartilhada entre vários APIs. Isso significa que, para um determinado stream, as solicitações de fragmentos em diferentes APIs consomem a mesma cota. Quando os metadados do fragmento ou a cota de mídia do fragmento de um stream são excedidos, a API retorna a. `ClientLimitExceededException` As tabelas a seguir mostram como eles APIs consomem de cada um dos dois tipos de cota. Para a segunda coluna dessas tabelas, suponha que, se um fluxo tiver uma cota N, isso significa que ele APIs tem N pontos para consumir desse tipo de cota para esse fluxo. A `GetClip` API aparece nas duas tabelas.
**Consumo da cota de metadados fragmentados**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/kinesisvideostreams/latest/dg/limits.html)
**Consumo da cota de mídia fragmentada**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/kinesisvideostreams/latest/dg/limits.html)
Por exemplo, com uma cota de 500 fragmentos de mídia por segundo, os seguintes padrões de chamada para um determinado stream são suportados:
+ 5 solicitações por segundo `GetClip` com 100 fragmentos em cada clipe.
+ 100 solicitações por segundo `GetClip` com 5 fragmentos em cada clipe.
+ 2 solicitações por segundo para `GetClip` 100 fragmentos em cada clipe e 3 solicitações por segundo para `GetMediaForFragmentList` cada clipe.
+ 400 solicitações por segundo para `GetMP4MediaFragment` e 100 solicitações por segundo para`GetTSFragment`.
Essas cotas têm uma implicação importante em relação ao número de sessões HLS e MPEG-DASH que podem ser suportadas por stream. Não há limite para o número de sessões HLS e DASH que podem ser usadas pelos reprodutores de mídia em um determinado momento. Portanto, é importante que o aplicativo de reprodução não permita que muitas sessões sejam usadas simultaneamente. Os dois exemplos a seguir descrevem como determinar o número de sessões de reprodução simultâneas que podem ser suportadas:
*Exemplo 1: transmissão ao vivo*
Em um cenário de transmissão ao vivo com HLS com fragmentos de 1 segundo de duração, uma faixa de áudio e vídeo e `MaxMediaPlaylistFragmentResults` configurada para cinco, um reprodutor de mídia normalmente faz duas chamadas `GetHLSMediaPlaylist` por segundo. Uma chamada é para os metadados de vídeo mais recentes e outra para os metadados de áudio correspondentes. As duas chamadas consomem cinco pontos de cota de metadados de fragmentos cada. Ele também faz duas chamadas `GetMP4MediaFragment` por segundo: uma chamada para o vídeo mais recente e outra para o áudio correspondente. Cada chamada consome um único fragmento de token de mídia, portanto, dois tokens são consumidos no total.
Nesse cenário, até 250 sessões de reprodução simultâneas podem ser suportadas. Com 250 sessões, esse cenário consome 2.500 pontos de cota de metadados de fragmento por segundo (bem abaixo da cota de 10.000) e 500 pontos de cota de mídia de fragmentos por segundo.
*Exemplo 2: reprodução sob demanda*
Em um cenário de reprodução sob demanda de um evento passado com MPEG-DASH, uma faixa de áudio e vídeo `MaxManifestFragmentResults` definida como 1.000, um media player normalmente liga uma `GetDASHManifest` vez no início da sessão (consumindo 1.000 pontos de cota de metadados de fragmento) e chama a uma taxa de até 5 vezes por segundo (consumindo 5 pontos de cota de mídia de fragmento) até que todos os fragmentos sejam carregados. `GetMP4MediaFragment` Nesse cenário, até 10 novas sessões podem ser iniciadas por segundo (diretamente na cota de 10.000 fragmentos de metadados por segundo) e até 100 sessões podem carregar ativamente a mídia fragmentada a uma taxa de 5 por segundo (diretamente na cota de 500 fragmentos de mídia por segundo).
Você pode usar `ArchivedFragmentsConsumed.Metadata` e `ArchivedFragmentsConsumed.Media` monitorar o consumo de metadados de fragmentos e pontos de cota de mídia fragmentada, respectivamente. Para obter informações sobre monitoramento, consulte[Monitoramento dos Amazon Kinesis Video Streams](monitoring.md).
## Cotas do serviço de metadados de streaming
As cotas de serviço a seguir se aplicam à adição de metadados de streaming a um stream de vídeo do Kinesis:
+ É possível colocar até 10 itens de metadados no início de um fragmento.
+ O *nome* de metadados do fragmento pode ter até 128 bytes.
+ O *valor* de metadados do fragmento pode ter até 256 bytes.
+ O *nome* de um metadado de fragmento não pode começar com a string "”`AWS`. Se um item de metadados assim é adicionado, o método `putFragmentMetadata` no PIC retornará um erro `STATUS_INVALID_METADATA_NAME` (código de erro `0x52000077`). O aplicativo pode, então, ignorar o erro (o PIC não adiciona o item de metadados) ou responder ao erro.
## Cotas do Producer SDK
A tabela a seguir contém as cotas atuais para valores no SDK. Consulte [Faça o upload para o Kinesis Video Streams](producer-sdk.md) para obter mais informações.
**nota**
Antes de definir esses valores, você deve validar suas entradas. O SDK não valida esses limites, e ocorrerá um erro em tempo de execução se os limites forem excedidos.
| Valor | Limite | Observações |
| --- | --- | --- |
| Contagem máxima de streamings | 128 | O número máximo de streamings que um objeto de produtor pode criar. Trata-se de um limite flexível (você pode solicitar um aumento). Isso garante que o produtor não crie fluxos de forma recursiva acidentalmente. |
| Tamanho máximo de nome de dispositivo | 128 caracteres | |
| Contagem máxima de tag | 50 por streaming | |
| Tamanho máximo de nome de streaming | 256 caracteres | |
| Tamanho mínimo de armazenamento | 10 MiB = 10 \$1 1024 \$1 1024 bytes | |
| Tamanho máximo de armazenamento | 10 GiB = 10 \$1 1024 \$1 1024 \$1 1024 bytes | |
| Tamanho máximo de caminho de diretório raiz | 4,096 caracteres | |
| Tamanho máximo de informações de autenticação | 10,000 bytes | |
| Tamanho máximo de string de URI | 10 mil caracteres | |
| Tamanho máximo de nome de tag | 128 caracteres | |
| Tamanho máximo de valor de tag | 1,024 caracteres | |
| Período mínimo de token de segurança | 30 segundos | |
| Período de carência de token de segurança | 40 minutos | Se a duração especificada for maior, ela será limitada a esse valor. |
| Período de retenção | 0 ou superior a uma hora | 0 indica que não há retenção. |
| Duração mínima de cluster | 1 segundo | O valor é especificado em unidades de 100 ns, o que é o padrão do SDK. |
| Duração máxima de cluster | 30 segundos | O valor é especificado em unidades de 100 ns, o que é o padrão do SDK. A API de back-end pode impor uma duração menor do cluster. |
| Tamanho máximo de fragmento | 50 MB | Para obter mais informações, consulte [Cotas do serviço Amazon Kinesis Video Streams](#limits). |
| Duração máxima de fragmento | 20 segundos | Para obter mais informações, consulte [Cotas do serviço Amazon Kinesis Video Streams](#limits). |
| Duração máxima de conexão | 45 minutos | O back-end encerra a conexão após esse período. O SDK gira o token e estabelece uma nova conexão nesse tempo. |
| Tamanho máximo de segmento de ACK | 1,024 caracteres | Tamanho máximo de segmento da confirmação enviada para a função de analisador de ACK. |
| Tamanho máximo da string de tipo de conteúdo. | 128 caracteres | |
| Tamanho máximo de string de ID do codec | 32 caracteres | |
| Tamanho máximo de string de nome do controle | 32 caracteres | |
| Tamanho máximo de dados privados do codec | 1 MiB = 1 \$1 1024 \$1 1024 bytes | |
| Tamanho mínimo de valor de escala de código de hora | 100 ns | O valor mínimo de escala de código de hora para representar os time stamps dos quadros no cluster do MKV resultante. O valor é especificado em incrementos de 100 ns, o que é o padrão do SDK. |
| Tamanho máximo de valor de escala de código de hora | 1 segundo | O valor máximo de escala de código de hora para representar os time stamps dos quadros no cluster do MKV resultante. O valor é especificado em incrementos de 100 ns, o que é o padrão do SDK. |
| Contagem mínima de itens de exibição do conteúdo | 10 | |
| Duração mínima de buffer | 20 segundos | O valor é especificado em incrementos de 100 ns, o que é o padrão do SDK. |
| Tamanho máximo de versão de atualização | 128 caracteres | |
| Tamanho máximo de ARN | 1024 caracteres | |
| Tamanho máximo de sequência de fragmento | 128 caracteres | |
| Período máximo de retenção | 10 anos | |