

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Met à jour le canal de signalisation existant. Il s'agit d'une opération asynchrone dont l'exécution prend du temps. 

Si la `MessageTtlSeconds` valeur est mise à jour (augmentée ou réduite), elle ne s'applique qu'aux nouveaux messages envoyés via ce canal après sa mise à jour. Les messages existants sont toujours expirés conformément à la `MessageTtlSeconds` valeur précédente.

## Syntaxe de la demande
<a name="API_UpdateSignalingChannel_RequestSyntax"></a>

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

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

## Paramètres de demande URI
<a name="API_UpdateSignalingChannel_RequestParameters"></a>

La demande n’utilise pas de paramètres URI.

## Corps de la demande
<a name="API_UpdateSignalingChannel_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [ChannelARN](#API_UpdateSignalingChannel_RequestSyntax) **   <a name="KinesisVideo-UpdateSignalingChannel-request-ChannelARN"></a>
Le nom de ressource Amazon (ARN) du canal de signalisation que vous souhaitez mettre à jour.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 1024.  
Modèle : `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+`   
Obligatoire : oui

 ** [CurrentVersion](#API_UpdateSignalingChannel_RequestSyntax) **   <a name="KinesisVideo-UpdateSignalingChannel-request-CurrentVersion"></a>
Version actuelle du canal de signalisation que vous souhaitez mettre à jour.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `[a-zA-Z0-9]+`   
Obligatoire : oui

 ** [SingleMasterConfiguration](#API_UpdateSignalingChannel_RequestSyntax) **   <a name="KinesisVideo-UpdateSignalingChannel-request-SingleMasterConfiguration"></a>
Structure contenant la configuration du `SINGLE_MASTER` type de canal de signalisation que vous souhaitez mettre à jour. Ce paramètre et le message du canal time-to-live sont obligatoires pour les canaux du type de `SINGLE_MASTER` canal.  
Type : objet [SingleMasterConfiguration](API_SingleMasterConfiguration.md)  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_UpdateSignalingChannel_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Eléments de réponse
<a name="API_UpdateSignalingChannel_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.

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

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md).

 ** AccessDeniedException **   
Vous ne disposez pas des autorisations requises pour effectuer cette opération.  
Code d'état HTTP : 401

 ** ClientLimitExceededException **   
Kinesis Video Streams a limité le nombre de demandes car vous avez dépassé le nombre maximal d'appels clients autorisés. Essayez de passer l'appel plus tard.  
Code d’état HTTP : 400

 ** InvalidArgumentException **   
La valeur de ce paramètre d'entrée n'est pas valide.  
Code d’état HTTP : 400

 ** ResourceInUseException **   
Lorsque l'entrée `StreamARN` ou `ChannelARN` l'entrée `CLOUD_STORAGE_MODE` est déjà mappée à une autre ressource Kinesis Video Stream, ou si l'`StreamARN`entrée `ChannelARN` fournie n'est pas active, essayez l'une des solutions suivantes :   

1. L'`DescribeMediaStorageConfiguration`API permettant de déterminer à quoi le canal donné est mappé. 

1. L'`DescribeMappedResourceConfiguration`API permettant de déterminer le canal auquel le flux donné est mappé. 

1. L'`DescribeSignalingChannel`API `DescribeStream` or pour déterminer le statut de la ressource. 
Code d’état HTTP : 400

 ** ResourceNotFoundException **   
Amazon Kinesis Video Streams ne trouve pas le flux que vous avez spécifié.  
Code d’état HTTP :404

 ** VersionMismatchException **   
La version de diffusion que vous avez spécifiée n'est pas la dernière version. Pour obtenir la dernière version, utilisez l'[DescribeStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DescribeStream.html)API.  
Code d’état HTTP : 400

## Voir aussi
<a name="API_UpdateSignalingChannel_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK pour C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UpdateSignalingChannel) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UpdateSignalingChannel) 