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. # CreateStream Crée un nouveau flux vidéo Kinesis. Lorsque vous créez un flux, Kinesis Video Streams lui attribue un numéro de version. Lorsque vous modifiez les métadonnées du flux, Kinesis Video Streams met à jour la version. `CreateStream` est une opération asynchrone. Pour plus d'informations sur le fonctionnement du service, veuillez consulter la rubrique [Fonctionnement](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/how-it-works.html). Vous devez disposer d'autorisations pour l'action `KinesisVideo:CreateStream`. ## Syntaxe de la demande ``` POST /createStream HTTP/1.1 Content-type: application/json { "DataRetentionInHours": number, "DeviceName": "string", "KmsKeyId": "string", "MediaType": "string", "StreamName": "string", "StreamStorageConfiguration": { "DefaultStorageTier": "string" }, "Tags": { "string" : "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. ** [DataRetentionInHours](#API_CreateStream_RequestSyntax) ** Le nombre d'heures pendant lesquelles vous souhaitez conserver les données dans le flux. Kinesis Video Streams conserve les données dans un magasin de données associé au flux. La valeur par défaut est 0, indiquant que le flux ne conserve pas les données. Le minimum est d'une heure. Lorsque la `DataRetentionInHours` valeur est 0, les consommateurs peuvent toujours consommer les fragments qui restent dans la mémoire tampon de l'hôte du service, dont la durée de rétention est limitée à 5 minutes et la limite de mémoire de rétention à 200 Mo. Les fragments sont retirés de la mémoire tampon lorsque l'une des limites est atteinte. Type : Integer Plage valide : Valeur minimum de 0. Obligatoire : non ** [DeviceName](#API_CreateStream_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 ** [KmsKeyId](#API_CreateStream_RequestSyntax) ** L'ID de la clé AWS Key Management Service (AWS KMS) que vous souhaitez que Kinesis Video Streams utilise pour chiffrer les données du flux. Si aucun identifiant de clé n'est spécifié, la clé gérée par Kinesis Video () `aws/kinesisvideo` par défaut est utilisée. Pour de plus amples informations, veuillez consulter [DescribeKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters). Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048. Modèle : `.+` Obligatoire : non ** [MediaType](#API_CreateStream_RequestSyntax) ** Type de média du flux. Les consommateurs du flux peuvent utiliser ces informations lors du traitement 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`, reportez-vous à la section [Exigences de dénomination](https://tools.ietf.org/html/rfc6838#section-4.2) pour les directives. Les exemples de valeurs valides incluent « video/h264" and "video/h264,audio/aac ». Ce paramètre est facultatif ; la valeur par défaut est `null` (ou vide en JSON). Type : Chaîne Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128. Modèle : `[\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*` Obligatoire : non ** [StreamName](#API_CreateStream_RequestSyntax) ** Nom du flux que vous créez. 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 : oui ** [StreamStorageConfiguration](#API_CreateStream_RequestSyntax) ** Configuration du stockage du flux, y compris le niveau de stockage par défaut pour les données du flux. Cette configuration détermine la manière dont les données de flux sont stockées et accessibles, avec différents niveaux offrant différents niveaux de performance et d'optimisation des coûts. Si ce n'est pas spécifié, le flux utilisera la configuration de stockage par défaut avec le niveau HOT pour des performances optimales. Type : objet [StreamStorageConfiguration](API_StreamStorageConfiguration.md) Obligatoire : non ** [Tags](#API_CreateStream_RequestSyntax) ** Liste de balises à associer au flux spécifié. Chaque balise est une paire clé-valeur (la valeur est facultative). Type : mappage chaîne/chaîne Entrées cartographiques : nombre maximum de 50 éléments. Contraintes de longueur de clé : longueur minimale de 1. Longueur maximale de 128. Modèle de clé :`^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` Contraintes de longueur de valeur : longueur minimale de 0. Longueur maximale de 256. Modèle de valeur : `[\p{L}\p{Z}\p{N}_.:/=+\-@]*` Obligatoire : non ## Syntaxe de la réponse ``` HTTP/1.1 200 Content-type: application/json { "StreamARN": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [StreamARN](#API_CreateStream_ResponseSyntax) ** L'Amazon Resource Name (ARN) du flux. 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]+` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md). ** AccountStreamLimitExceededException ** Le nombre de streams créés pour le compte est trop élevé. Code d’état HTTP : 400 ** ClientLimitExceededException ** Kinesis Video Streams a limité la demande 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 ** DeviceStreamLimitExceededException ** Non implémenté. Code d’état HTTP : 400 ** InvalidArgumentException ** La valeur de ce paramètre d'entrée n'est pas valide. Code d’état HTTP : 400 ** InvalidDeviceException ** Non implémenté. 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 ** TagsPerResourceExceededLimitException ** Vous avez dépassé le nombre limite de balises que vous pouvez associer à la ressource. Un flux vidéo Kinesis peut prendre en charge jusqu'à 50 balises. 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/CreateStream) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/CreateStream)