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á. # UpdateStream Atualiza os metadados do stream, como o nome do dispositivo e o tipo de mídia. Você deve fornecer o nome do stream ou o Amazon Resource Name (ARN) do stream. Para garantir que você tenha a versão mais recente do stream antes de atualizá-lo, você pode especificar a versão do stream. O Kinesis Video Streams atribui uma versão a cada stream. Quando você atualiza um stream, o Kinesis Video Streams atribui um novo número de versão. Para obter a versão mais recente do stream, use a `DescribeStream` API. `UpdateStream`é uma operação assíncrona e leva tempo para ser concluída. ## Sintaxe da Solicitação ``` POST /updateStream HTTP/1.1 Content-type: application/json { "CurrentVersion": "{{string}}", "DeviceName": "{{string}}", "MediaType": "{{string}}", "StreamARN": "{{string}}", "StreamName": "{{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. ** [CurrentVersion](#API_UpdateStream_RequestSyntax) ** A versão do stream cujos metadados você deseja atualizar. Tipo: string Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64. Padrão: `[a-zA-Z0-9]+` Obrigatório: Sim ** [DeviceName](#API_UpdateStream_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 ** [MediaType](#API_UpdateStream_RequestSyntax) ** O tipo de mídia do stream. Use `MediaType` para especificar o tipo de conteúdo que o stream contém para os consumidores do stream. 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 reproduzir vídeo no console, você deve especificar o tipo de vídeo correto. Por exemplo, se o vídeo no stream for H.264, especifique como o. `video/h264` `MediaType` 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 ** [StreamARN](#API_UpdateStream_RequestSyntax) ** O ARN do stream cujos metadados você deseja atualizar. 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]+` Obrigatório: não ** [StreamName](#API_UpdateStream_RequestSyntax) ** O nome do stream cujos metadados você deseja atualizar. 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: Não ## Sintaxe da resposta ``` HTTP/1.1 200 ``` ## Elementos de Resposta Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio. ## Erros Para informações sobre os erros comuns retornados pelas ações, consulte [Tipos de erro comuns](CommonErrors.md). ** 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 ** InvalidArgumentException ** O valor desse parâmetro de entrada é inválido. Código de status HTTP: 400 ** NotAuthorizedException ** O chamador não está autorizado a realizar essa operação. Código de status HTTP: 401 ** 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 ** ResourceNotFoundException ** O Amazon Kinesis Video Streams não consegue encontrar o stream que você especificou. Código de status HTTP: 404 ** VersionMismatchException ** A versão do stream que você especificou não é a versão mais recente. Para obter a versão mais recente, use a [DescribeStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DescribeStream.html)API. 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/UpdateStream) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK para C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UpdateStream)