CreateStream - Amazon Kinesis Video Streams
Sintaxe da SolicitaçãoParâmetros da solicitação de URICorpo da SolicitaçãoSintaxe da RespostaElementos de RespostaErrosConsulte Também

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á.

CreateStream

Cria um novo stream de vídeo do Kinesis.

Quando você cria um novo fluxo, o Kinesis Video Streams atribui a ele um número de versão. Quando você altera os metadados do fluxo, o Kinesis Video Streams atualiza a versão.

CreateStream é uma operação de natureza assíncrona.

Para saber mais sobre como o serviço funciona, consulte Como funciona.

Você deve ter permissões para a ação KinesisVideo:CreateStream.

Sintaxe da Solicitação

POST /createStream HTTP/1.1
Content-type: application/json

{
   "DataRetentionInHours": number,
   "DeviceName": "string",
   "KmsKeyId": "string",
   "MediaType": "string",
   "StreamName": "string",
   "StreamStorageConfiguration": { 
      "DefaultStorageTier": "string"
   },
   "Tags": { 
      "string" : "string" 
   }
}

Parâmetros da solicitação de URI

A solicitação não usa nenhum parâmetro de URI.

Corpo da Solicitação

A solicitação aceita os dados a seguir no formato JSON.

DataRetentionInHours

O número de horas em que você deseja reter os dados no fluxo. O Kinesis Video Streams retém os dados em um armazenamento de dados associado ao fluxo.

O valor padrão é 0, indicando que o fluxo não persiste dados. O mínimo é de 1 hora.

Quando o DataRetentionInHours valor é 0, os consumidores ainda podem consumir os fragmentos que permanecem no buffer do host do serviço, que tem um limite de tempo de retenção de 5 minutos e um limite de memória de retenção de 200 MB. Os fragmentos são removidos do buffer quando um dos limites é atingido.

Tipo: inteiro

Intervalo válido: valor mínimo de 0.

Obrigatório: não

DeviceName

O nome do dispositivo que está gravando no stream.

nota

Na implementação atual, o Kinesis Video Streams não usa esse nome.

Tipo: String

Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.

Padrão: [a-zA-Z0-9_.-]+

Obrigatório: não

KmsKeyId

O ID da chave AWS Key Management Service (AWS KMS) que você deseja que o Kinesis Video Streams use para criptografar os dados do stream.

Se nenhum ID de chave for especificado, a chave padrão gerenciada pelo Kinesis Video () aws/kinesisvideo será usada.

Para obter mais informações, consulte DescribeKey.

Tipo: String

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.

Padrão: .+

Obrigatório: não

MediaType

O tipo de mídia do stream. Os consumidores do fluxo podem usar essas informações ao processar o fluxo. Para obter mais informações sobre tipos de mídia, consulte Tipos de mídia. Se você optar por especificar oMediaType, consulte Requisitos de nomenclatura para obter diretrizes.

Exemplos de valores válidos incluem "video/h264" and "video/h264,audio/aac”.

Esse parâmetro é opcional; o valor padrão é null (ou vazio em JSON).

Tipo: String

Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.

Padrão: [\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*

Obrigatório: não

StreamName

Um nome para o stream que você está criando.

O nome do stream é um identificador do stream e deve ser exclusivo para cada conta e região.

Tipo: String

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.

Padrão: [a-zA-Z0-9_.-]+

Exigido: Sim

StreamStorageConfiguration

A configuração do armazenamento do fluxo, incluindo o nível de armazenamento padrão para dados do fluxo. Essa configuração determina como os dados do stream são armazenados e acessados, com diferentes níveis oferecendo níveis variados de desempenho e otimização de custos.

Se não for especificado, o stream usará a configuração de armazenamento padrão com o nível HOT para um desempenho ideal.

Tipo: objeto StreamStorageConfiguration

Obrigatório: não

Tags

Uma lista de tags a serem associadas ao fluxo especificado. Cada tag é um par de valores-chave (o valor é opcional).

Tipo: mapa de string para string

Entradas do mapa: número máximo de 50 itens.

Restrições de Tamanho de Chave: tamanho mínimo de 1. O tamanho máximo é 128.

Padrão da chave: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$

Restrições de comprimento do valor: comprimento mínimo de 0. Tamanho máximo de 256.

Padrão de valor: [\p{L}\p{Z}\p{N}_.:/=+\-@]*

Obrigatório: não

Sintaxe da Resposta

HTTP/1.1 200
Content-type: application/json

{
   "StreamARN": "string"
}

Elementos de Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

StreamARN

O Nome de recurso da Amazon (ARN) do fluxo do .

Tipo: String

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.024.

Padrão: arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+

Erros

Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.

AccountStreamLimitExceededException

O número de streams criados para a conta é muito alto.

Código de status HTTP: 400

ClientLimitExceededException

O Kinesis Video Streams limitou a solicitação porque você excedeu o limite permitido de chamadas de clientes. Tente fazer a ligação mais tarde.

Código de status HTTP: 400

DeviceStreamLimitExceededException

Não implementado.

Código de status HTTP: 400

InvalidArgumentException

O valor desse parâmetro de entrada é inválido.

Código de status HTTP: 400

InvalidDeviceException

Não implementado.

Código de status HTTP: 400

ResourceInUseException

Quando a entrada StreamARN ou ChannelARN a entrada já estiverem mapeadas para um recurso diferente do Kinesis Video Stream, ou se a StreamARN entrada ChannelARN fornecida não estiver no status Ativo, tente uma das seguintes opções: CLOUD_STORAGE_MODE

  1. A DescribeMediaStorageConfiguration API para determinar para qual stream determinado canal é mapeado.

  2. A DescribeMappedResourceConfiguration API para determinar o canal para o qual o determinado fluxo é mapeado.

  3. A DescribeSignalingChannel API DescribeStream ou para determinar o status do recurso.

Código de status HTTP: 400

TagsPerResourceExceededLimitException

Você excedeu o limite de tags que você pode associar ao recurso. Um stream de vídeo do Kinesis pode suportar até 50 tags.

Código de Status HTTP: 400

Consulte Também

Para obter mais informações sobre como usar essa API em uma linguagem específica AWS SDKs, consulte o seguinte: