Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
CreateSignalingChannel
Crea un canale di segnalazione.
CreateSignalingChannel è un'operazione asincrona.
Sintassi della richiesta
POST /createSignalingChannel HTTP/1.1
Content-type: application/json
{
"ChannelName": "string",
"ChannelType": "string",
"SingleMasterConfiguration": {
"MessageTtlSeconds": number
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- ChannelName
-
Un nome per il canale di segnalazione che stai creando. Deve essere unico per ogni mano Account AWS . Regione AWS
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello:
[a-zA-Z0-9_.-]+Campo obbligatorio: sì
- ChannelType
-
Un tipo di canale di segnalazione che stai creando. Attualmente,
SINGLE_MASTERè l'unico tipo di canale supportato.▬Tipo: stringa
Valori validi:
SINGLE_MASTER | FULL_MESHCampo obbligatorio: no
- SingleMasterConfiguration
-
Una struttura contenente la configurazione per il tipo di
SINGLE_MASTERcanale.Tipo: oggetto SingleMasterConfiguration
Campo obbligatorio: no
- Tags
-
Un insieme di tag (coppie chiave-valore) da associare a questo canale.
Tipo: matrice di oggetti Tag
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.
Campo obbligatorio: no
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"ChannelARN": "string"
}Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- ChannelARN
-
L'Amazon Resource Name (ARN) del canale creato.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.
Modello:
arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- AccessDeniedException
-
Non disponi delle autorizzazioni necessarie per eseguire questa operazione.
Codice di stato HTTP: 401
- AccountChannelLimitExceededException
-
Hai raggiunto il limite massimo di canali di segnalazione attivi per questo scopo Account AWS in questa regione.
Codice di stato HTTP: 400
- ClientLimitExceededException
-
Kinesis Video Streams ha limitato la richiesta perché è stato superato il limite di chiamate client consentite. Prova a effettuare la chiamata più tardi.
Codice di stato HTTP: 400
- InvalidArgumentException
-
Il valore di questo parametro di input non è valido.
Codice di stato HTTP: 400
- ResourceInUseException
-
Quando l'ingresso
StreamARNoChannelARNl'ingressoCLOUD_STORAGE_MODEsono già mappati su un'altra risorsa Kinesis Video Stream, o se l'StreamARNingresso fornitoChannelARNo non è nello stato Attivo, prova una delle seguenti soluzioni:-
L'
DescribeMediaStorageConfigurationAPI per determinare a cosa è mappato lo stream di un determinato canale. -
L'
DescribeMappedResourceConfigurationAPI per determinare il canale su cui è mappato lo stream specificato. -
L'
DescribeStreamo l'DescribeSignalingChannelAPI per determinare lo stato della risorsa.
Codice di stato HTTP: 400
-
- TagsPerResourceExceededLimitException
-
Hai superato il limite di tag che puoi associare alla risorsa. Uno stream video Kinesis può supportare fino a 50 tag.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue:
