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.
Vous devez disposer d'autorisations pour l'action KinesisVideo:CreateStream.
Syntaxe de la requête
POST /createStream HTTP/1.1
Content-type: application/json
{
"DataRetentionInHours": number,
"DeviceName": "string",
"KmsKeyId": "string",
"MediaType": "string",
"StreamName": "string",
"Tags": {
"string" : "string"
}
}URIParamètres de demande
La demande n'utilise aucun URI paramètre.
Corps de la requête
La demande accepte les données suivantes au JSON format suivant.
- DataRetentionInHours
-
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
DataRetentionInHoursvaleur est 0, les consommateurs peuvent toujours consommer les fragments qui restent dans la mémoire tampon de l'hôte du service, dont le temps de rétention est limité à 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 ou l'autre des limites est atteinte.Type : entier
Plage valide : Valeur minimum de 0.
Obligatoire : non
- DeviceName
-
Nom de l'appareil qui écrit dans le flux.
Note
Dans l'implémentation actuelle, Kinesis Video Streams n'utilise pas ce nom.
Type : String
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.
Modèle :
[a-zA-Z0-9_.-]+Obligatoire : non
- KmsKeyId
-
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é par défaut, gérée par Kinesis Video ()
aws/kinesisvideo, est utilisée.Pour de plus amples informations, veuillez consulter DescribeKey.
Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.
Modèle :
.+Obligatoire : non
- MediaType
-
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
. Si vous choisissez de les spécifier MediaType, reportez-vous à la section Exigences de dénominationpour 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 videJSON).Type : String
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.
Modèle :
[\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*Obligatoire : non
- StreamName
-
Nom du flux que vous êtes en train de créer.
Le nom du flux est un identifiant du flux et doit être unique pour chaque compte et chaque région.
Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256.
Modèle :
[a-zA-Z0-9_.-]+Obligatoire : oui
- Tags
-
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 sous JSON forme formatée par le service.
- StreamARN
-
Le nom de la ressource Amazon (ARN) du flux.
Type : String
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 Erreurs courantes.
- AccountStreamLimitExceededException
-
Le nombre de streams créés pour le compte est trop élevé.
HTTPCode de statut : 400
- 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.
HTTPCode de statut : 400
- DeviceStreamLimitExceededException
-
Non implémenté.
HTTPCode de statut : 400
- InvalidArgumentException
-
La valeur de ce paramètre d'entrée n'est pas valide.
HTTPCode de statut : 400
- InvalidDeviceException
-
Non implémenté.
HTTPCode de statut : 400
- ResourceInUseException
-
Lorsque l'entrée
StreamARNouChannelARNl'entréeCLOUD_STORAGE_MODEest déjà mappée à une autre ressource Kinesis Video Stream, ou si l'StreamARNentréeChannelARNfournie n'est pas active, essayez l'une des solutions suivantes :-
Le
DescribeMediaStorageConfigurationAPI pour déterminer à quoi le canal donné est mappé. -
Le
DescribeMappedResourceConfigurationAPI pour déterminer le canal auquel le flux donné est mappé. -
Le
DescribeStreamouDescribeSignalingChannelAPI pour déterminer le statut de la ressource.
HTTPCode de statut : 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.
HTTPCode de statut : 400
consultez aussi
Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :
