Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # UpdateStream Actualiza los metadatos de la transmisión, como el nombre del dispositivo y el tipo de medio. Debe proporcionar el nombre de la transmisión o el nombre de recurso de Amazon (ARN) de la transmisión. Para asegurarse de que dispone de la versión más reciente de la transmisión antes de actualizarla, puede especificar la versión de la transmisión. Kinesis Video Streams asigna una versión a cada transmisión. Al actualizar una transmisión, Kinesis Video Streams asigna un nuevo número de versión. Para obtener la versión más reciente de la transmisión, utilice la `DescribeStream` API. `UpdateStream`es una operación asíncrona y tarda en completarse. ## Sintaxis de la solicitud ``` POST /updateStream HTTP/1.1 Content-type: application/json { "CurrentVersion": "{{string}}", "DeviceName": "{{string}}", "MediaType": "{{string}}", "StreamARN": "{{string}}", "StreamName": "{{string}}" } ``` ## Parámetros de solicitud del URI La solicitud no utiliza ningún parámetro de URI. ## Cuerpo de la solicitud La solicitud acepta los siguientes datos en formato JSON. ** [CurrentVersion](#API_UpdateStream_RequestSyntax) ** La versión de la transmisión cuyos metadatos desea actualizar. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64. Patrón: `[a-zA-Z0-9]+` Obligatorio: sí ** [DeviceName](#API_UpdateStream_RequestSyntax) ** El nombre del dispositivo que está grabando en la transmisión. En la implementación actual, Kinesis Video Streams no usa este nombre. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128. Patrón: `[a-zA-Z0-9_.-]+` Obligatorio: no ** [MediaType](#API_UpdateStream_RequestSyntax) ** El tipo de contenido multimedia de la transmisión. Se utiliza `MediaType` para especificar el tipo de contenido que contiene la transmisión para los consumidores de la transmisión. Para obtener más información sobre los tipos de medios, consulte [Tipos de medios](http://www.iana.org/assignments/media-types/media-types.xhtml). Si decide especificarlos`MediaType`, consulte [Requisitos de nomenclatura](https://tools.ietf.org/html/rfc6838#section-4.2). Para reproducir vídeo en la consola, debe especificar el tipo de vídeo correcto. Por ejemplo, si el vídeo de la transmisión es H.264, especifíquelo `video/h264` como. `MediaType` Tipo: cadena Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128. Patrón: `[\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*` Obligatorio: no ** [StreamARN](#API_UpdateStream_RequestSyntax) ** El ARN de la transmisión cuyos metadatos desea actualizar. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres. Patrón: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` Obligatorio: no ** [StreamName](#API_UpdateStream_RequestSyntax) ** El nombre de la transmisión cuyos metadatos desea actualizar. El nombre de la transmisión es un identificador de la transmisión y debe ser único para cada cuenta y región. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres. Patrón: `[a-zA-Z0-9_.-]+` Obligatorio: no ## Sintaxis de la respuesta ``` HTTP/1.1 200 ``` ## Elementos de respuesta Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío. ## Errores Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md). ** ClientLimitExceededException ** Kinesis Video Streams ha limitado la solicitud porque ha superado el límite de llamadas de clientes permitidas. Intente realizar la llamada más tarde. Código de estado HTTP: 400 ** InvalidArgumentException ** El valor de este parámetro de entrada no es válido. Código de estado HTTP: 400 ** NotAuthorizedException ** La persona que llama no está autorizada a realizar esta operación. Código de estado HTTP: 401 ** ResourceInUseException ** Si la entrada `StreamARN` o `ChannelARN` entrada ya `CLOUD_STORAGE_MODE` está mapeada a otro recurso de Kinesis Video Stream, o si la `StreamARN` entrada `ChannelARN` proporcionada no está en estado Activo, pruebe una de las siguientes opciones: 1. La `DescribeMediaStorageConfiguration` API para determinar a qué está asignado el canal de transmisión en cuestión. 1. La `DescribeMappedResourceConfiguration` API para determinar el canal al que está mapeada la transmisión determinada. 1. La `DescribeStream` o `DescribeSignalingChannel` API para determinar el estado del recurso. Código de estado HTTP: 400 ** ResourceNotFoundException ** Amazon Kinesis Video Streams no encuentra la transmisión que ha especificado. Código de estado HTTP: 404 ** VersionMismatchException ** La versión de transmisión que especificó no es la versión más reciente. Para obtener la versión más reciente, usa la [DescribeStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DescribeStream.html)API. Código de estado HTTP: 400 ## Véase también Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente: + [AWS Interfaz de línea de comandos 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)