CreateSignalingChannel - Amazon Kinesis Video Streams
Sintassi della richiestaParametri della richiesta URI:Corpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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 univoco per ciascunAccount AWSeRegione AWS.

Type: Stringa

Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.

Modello: [a-zA-Z0-9_.-]+

: campo obbligatorio Sì

ChannelType

Tipo di canale di segnalazione che stai creando. Attualmente,SINGLE_MASTERè l'unico tipo di canale supportato.

Type: Stringa

Valori validi: SINGLE_MASTER | FULL_MESH

: campo obbligatorio No

SingleMasterConfiguration

Una struttura contenente la configurazione perSINGLE_MASTERTipo di canale.

Tipo: SingleMasterConfiguration oggetto

: campo obbligatorio No

Tags

Un set di tag (coppie chiave-valore) che desideri associare a questo canale.

Type: Serie di matriciTagoggetti

Membri dell'array: Numero minimo di 0 item. 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.

Type: Stringa

Vincoli 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 dei canali di segnalazione attivi per questoAccount AWSin questa regione.

Codice di stato HTTP: 400

ClientLimitExceededException

Kinesis Video Streams ha limitato la richiesta perché hai superato il limite delle 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

La risorsa di non è attualmente disponibile per questa operazione. Non è possibile creare nuove risorse con lo stesso nome delle risorse esistenti. Inoltre, le risorse non possono essere aggiornate o eliminate a meno che non si trovino in unACTIVEstato.

Se viene restituita questa eccezione, non utilizzarla per determinare se la risorsa richiesta esiste già. Invece, si consiglia di utilizzare l'API di descrizione specifica delle risorse, ad esempioDescribeStreamper flussi video.

Codice di stato HTTP: 400

TagsPerResourceExceededLimitException

Hai superato il limite di tag che è possibile associare alla risorsa. Lo streaming 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 SDK AWS specifici della lingua, consulta quanto segue: