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.

# UpdateSignalingChannel
<a name="API_UpdateSignalingChannel"></a>

Actualiza el canal de señalización existente. Se trata de una operación asíncrona y tarda un tiempo en completarse. 

Si el `MessageTtlSeconds` valor se actualiza (aumenta o reduce), solo se aplica a los mensajes nuevos que se envíen a través de este canal una vez que se haya actualizado. Los mensajes existentes siguen caducados según el `MessageTtlSeconds` valor anterior.

## Sintaxis de la solicitud
<a name="API_UpdateSignalingChannel_RequestSyntax"></a>

```
POST /updateSignalingChannel HTTP/1.1
Content-type: application/json

{
   "ChannelARN": "string",
   "CurrentVersion": "string",
   "SingleMasterConfiguration": { 
      "MessageTtlSeconds": number
   }
}
```

## Parámetros de solicitud del URI
<a name="API_UpdateSignalingChannel_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_UpdateSignalingChannel_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [ChannelARN](#API_UpdateSignalingChannel_RequestSyntax) **   <a name="KinesisVideo-UpdateSignalingChannel-request-ChannelARN"></a>
El nombre de recurso de Amazon (ARN) del canal de señalización que 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: sí

 ** [CurrentVersion](#API_UpdateSignalingChannel_RequestSyntax) **   <a name="KinesisVideo-UpdateSignalingChannel-request-CurrentVersion"></a>
La versión actual del canal de señalización que 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í

 ** [SingleMasterConfiguration](#API_UpdateSignalingChannel_RequestSyntax) **   <a name="KinesisVideo-UpdateSignalingChannel-request-SingleMasterConfiguration"></a>
La estructura que contiene la configuración del `SINGLE_MASTER` tipo de canal de señalización que desea actualizar. Este parámetro y los mensajes del canal time-to-live son necesarios para los canales con ese tipo de `SINGLE_MASTER` canal.  
Tipo: objeto [SingleMasterConfiguration](API_SingleMasterConfiguration.md)  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_UpdateSignalingChannel_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_UpdateSignalingChannel_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UpdateSignalingChannel_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No tiene los permisos necesarios para realizar esta operación.  
Código de estado HTTP: 401

 ** 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

 ** 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
<a name="API_UpdateSignalingChannel_SeeAlso"></a>

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/UpdateSignalingChannel) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UpdateSignalingChannel)