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](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/how-it-works.html). 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](#API_CreateStream_RequestSyntax) ** 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](#API_CreateStream_RequestSyntax) ** O nome do dispositivo que está gravando no stream. 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](#API_CreateStream_RequestSyntax) ** 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](https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters). Tipo: String Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048. Padrão: `.+` Obrigatório: não ** [MediaType](#API_CreateStream_RequestSyntax) ** 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 os tipos de mídia, consulte [Tipos de mídia](http://www.iana.org/assignments/media-types/media-types.xhtml). Se você optar por especificar o`MediaType`, consulte [Requisitos de nomenclatura](https://tools.ietf.org/html/rfc6838#section-4.2) 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](#API_CreateStream_RequestSyntax) ** 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_.-]+` Obrigatório: Sim ** [StreamStorageConfiguration](#API_CreateStream_RequestSyntax) ** 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](API_StreamStorageConfiguration.md) Obrigatório: não ** [Tags](#API_CreateStream_RequestSyntax) ** 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 comprimento máximo é 128. Padrão da chave: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` Restrições de comprimento do valor: comprimento mínimo de 0. O comprimento máximo é 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](#API_CreateStream_ResponseSyntax) ** O Nome de recurso da Amazon (ARN) do fluxo do . Tipo: string Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 1.024. Padrão: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` ## Erros Para informações sobre os erros comuns retornados pelas ações, consulte [Tipos de erro comuns](CommonErrors.md). ** 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 onde o stream determinado canal é mapeado. 1. A `DescribeMappedResourceConfiguration` API para determinar o canal para o qual o determinado fluxo é mapeado. 1. 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 das linguagens específicas AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/CreateStream)