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.
Crée un canal de signalisation.
CreateSignalingChannel est une opération asynchrone.
Syntaxe de la requête
POST /createSignalingChannel HTTP/1.1
Content-type: application/json
{
"ChannelName": "string",
"ChannelType": "string",
"SingleMasterConfiguration": {
"MessageTtlSeconds": number
},
"Tags": [
{
"Key": "string",
"Value": "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.
- ChannelName
-
Un nom pour le canal de signalisation que vous êtes en train de créer. Il doit être unique pour chacun Compte AWS et Région AWS.
Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256.
Modèle :
[a-zA-Z0-9_.-]+Obligatoire : oui
- ChannelType
-
Un type du canal de signalisation que vous êtes en train de créer. Actuellement, le seul type de canal pris en charge est
SINGLE_MASTER.Type : String
Valeurs valides :
SINGLE_MASTER | FULL_MESHObligatoire : non
- SingleMasterConfiguration
-
Structure contenant la configuration pour le type de
SINGLE_MASTERcanal. La configuration par défaut pour la durée de diffusion du message du canal est de 60 secondes (1 minute).Type : objet SingleMasterConfiguration
Obligatoire : non
- Tags
-
Ensemble de balises (paires clé-valeur) que vous souhaitez associer à ce canal.
Type : tableau d’objets Tag
Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments.
Obligatoire : non
Syntaxe de la réponse
HTTP/1.1 200
Content-type: application/json
{
"ChannelARN": "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.
- ChannelARN
-
Le nom de ressource Amazon (ARN) de la chaîne créée.
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.
- AccessDeniedException
-
Vous ne disposez pas des autorisations requises pour effectuer cette opération.
HTTPCode de statut : 401
- AccountChannelLimitExceededException
-
Vous avez atteint la limite maximale de canaux de signalisation actifs pour cela Compte AWS dans cette région.
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
- InvalidArgumentException
-
La valeur de ce paramètre d'entrée n'est pas valide.
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 :
