CreateStream - Amazon Kinesis Video Streams
Sintaxe da SolicitaçãoURIParâmetros de solicitaçãoCorpo 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",
   "Tags": { 
      "string" : "string" 
   }
}

URIParâmetros de solicitação

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

Corpo da Solicitação

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

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: número 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 emJSON).

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

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 de 200.

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

StreamARN

O nome do recurso Amazon (ARN) do stream.

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.

HTTPCódigo de status: 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.

HTTPCódigo de status: 400

DeviceStreamLimitExceededException

Não implementado.

HTTPCódigo de status: 400

InvalidArgumentException

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

HTTPCódigo de status: 400

InvalidDeviceException

Não implementado.

HTTPCódigo de status: 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. O DescribeMediaStorageConfiguration API para determinar para qual fluxo determinado canal está mapeado.

  2. O DescribeMappedResourceConfiguration API para determinar o canal para o qual o fluxo fornecido é mapeado.

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

HTTPCódigo de status: 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.

HTTPCódigo de status: 400

Consulte também

Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte: