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.
# UpdateStream
Met à jour les métadonnées du flux, telles que le nom de l'appareil et le type de média.
Vous devez fournir le nom du flux ou l'Amazon Resource Name (ARN) du flux.
Pour vous assurer que vous disposez de la dernière version du flux avant de le mettre à jour, vous pouvez spécifier la version du flux. Kinesis Video Streams attribue une version à chaque flux. Lorsque vous mettez à jour un flux, Kinesis Video Streams attribue un nouveau numéro de version. Pour obtenir la dernière version du stream, utilisez l'`DescribeStream`API.
`UpdateStream`est une opération asynchrone dont l'exécution prend du temps.
## Syntaxe de la demande
```
POST /updateStream HTTP/1.1
Content-type: application/json
{
"CurrentVersion": "{{string}}",
"DeviceName": "{{string}}",
"MediaType": "{{string}}",
"StreamARN": "{{string}}",
"StreamName": "{{string}}"
}
```
## Paramètres de demande URI
La demande n’utilise pas de paramètres URI.
## Corps de la demande
Cette demande accepte les données suivantes au format JSON.
** [CurrentVersion](#API_UpdateStream_RequestSyntax) **
Version du flux dont vous souhaitez mettre à jour les métadonnées.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.
Modèle : `[a-zA-Z0-9]+`
Obligatoire : oui
** [DeviceName](#API_UpdateStream_RequestSyntax) **
Nom de l'appareil qui écrit dans le flux.
Dans l'implémentation actuelle, Kinesis Video Streams n'utilise pas ce nom.
Type : Chaîne
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.
Modèle : `[a-zA-Z0-9_.-]+`
Obligatoire : non
** [MediaType](#API_UpdateStream_RequestSyntax) **
Type de média du flux. `MediaType`À utiliser pour spécifier le type de contenu que le flux contient pour les consommateurs du flux. Pour plus d'informations sur les types de médias, consultez la section [Types de médias](http://www.iana.org/assignments/media-types/media-types.xhtml). Si vous choisissez de les spécifier`MediaType`, consultez la section [Exigences en matière de dénomination](https://tools.ietf.org/html/rfc6838#section-4.2).
Pour lire une vidéo sur la console, vous devez spécifier le type de vidéo correct. Par exemple, si la vidéo du flux est au format H.264, spécifiez `video/h264` comme. `MediaType`
Type : Chaîne
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.
Modèle : `[\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*`
Obligatoire : non
** [StreamARN](#API_UpdateStream_RequestSyntax) **
L'ARN du flux dont vous souhaitez mettre à jour les métadonnées.
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 : non
** [StreamName](#API_UpdateStream_RequestSyntax) **
Le nom du flux dont vous souhaitez mettre à jour les métadonnées.
Le nom du flux est un identifiant du flux et doit être unique pour chaque compte et chaque région.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256.
Modèle : `[a-zA-Z0-9_.-]+`
Obligatoire : non
## Syntaxe de la réponse
```
HTTP/1.1 200
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md).
** 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
** NotAuthorizedException **
L'appelant n'est pas autorisé à effectuer cette opération.
Code d'état HTTP : 401
** 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
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/UpdateStream)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UpdateStream)
+ [AWS SDK pour C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UpdateStream)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UpdateStream)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UpdateStream)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UpdateStream)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UpdateStream)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UpdateStream)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UpdateStream)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UpdateStream)