

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Aggiorna il canale di segnalazione esistente. Si tratta di un'operazione asincrona che richiede tempo per essere completata. 

Se il `MessageTtlSeconds` valore viene aggiornato (aumentato o ridotto), si applica solo ai nuovi messaggi inviati tramite questo canale dopo l'aggiornamento. I messaggi esistenti sono ancora scaduti in base al `MessageTtlSeconds` valore precedente.

## Sintassi della richiesta
<a name="API_UpdateSignalingChannel_RequestSyntax"></a>

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

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

## Parametri della richiesta URI:
<a name="API_UpdateSignalingChannel_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_UpdateSignalingChannel_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [ChannelARN](#API_UpdateSignalingChannel_RequestSyntax) **   <a name="KinesisVideo-UpdateSignalingChannel-request-ChannelARN"></a>
L'Amazon Resource Name (ARN) del canale di segnalazione che desideri aggiornare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.  
Modello: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+`   
Obbligatorio: sì

 ** [CurrentVersion](#API_UpdateSignalingChannel_RequestSyntax) **   <a name="KinesisVideo-UpdateSignalingChannel-request-CurrentVersion"></a>
La versione corrente del canale di segnalazione che desideri aggiornare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `[a-zA-Z0-9]+`   
Obbligatorio: sì

 ** [SingleMasterConfiguration](#API_UpdateSignalingChannel_RequestSyntax) **   <a name="KinesisVideo-UpdateSignalingChannel-request-SingleMasterConfiguration"></a>
La struttura contenente la configurazione per il `SINGLE_MASTER` tipo di canale di segnalazione che si desidera aggiornare. Questo parametro e il messaggio del canale time-to-live sono obbligatori per i canali con lo stesso tipo di `SINGLE_MASTER` canale.  
Tipo: oggetto [SingleMasterConfiguration](API_SingleMasterConfiguration.md)  
Obbligatorio: no

## Sintassi della risposta
<a name="API_UpdateSignalingChannel_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_UpdateSignalingChannel_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).

 ** AccessDeniedException **   
Non hai le autorizzazioni necessarie per eseguire questa operazione.  
Codice di stato HTTP: 401

 ** ClientLimitExceededException **   
Kinesis Video Streams ha limitato la richiesta perché è stato superato il limite di chiamate client consentite. Prova a effettuare la chiamata più tardi.  
Codice di stato HTTP: 400

 ** InvalidArgumentException **   
Il valore di questo parametro di input non è valido.  
Codice di stato HTTP: 400

 ** ResourceInUseException **   
Quando l'ingresso `StreamARN` o `ChannelARN` l'ingresso `CLOUD_STORAGE_MODE` sono già mappati su un'altra risorsa Kinesis Video Stream, o se l'`StreamARN`ingresso fornito `ChannelARN` o non è nello stato Attivo, prova una delle seguenti soluzioni:   

1. L'`DescribeMediaStorageConfiguration`API per determinare a cosa è mappato lo stream di un determinato canale. 

1. L'`DescribeMappedResourceConfiguration`API per determinare il canale su cui è mappato lo stream specificato. 

1. L'`DescribeStream`o l'`DescribeSignalingChannel`API per determinare lo stato della risorsa. 
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
Amazon Kinesis Video Streams non riesce a trovare lo stream specificato.  
Codice di stato HTTP: 404

 ** VersionMismatchException **   
La versione dello stream che hai specificato non è la versione più recente. Per ottenere la versione più recente, usa l'[DescribeStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DescribeStream.html)API.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_UpdateSignalingChannel_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UpdateSignalingChannel) 