CreateSignalingChannel - Flusso di video Amazon Kinesis
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 ciascun Account AWS e Regione AWS.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 256 caratteri.

Pattern: [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: String

Valori validi: SINGLE_MASTER | FULL_MESH

Required: No

SingleMasterConfiguration

Una struttura contenente la configurazione per il tipo diSINGLE_MASTER canale.

Tipo: SingleMasterConfiguration oggetto

Required: No

Tags

Un set di tag (coppie chiave-valore) da collegare a questo canale.

Tipo: matrice di oggetti Tag

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.

Required: 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

il nome della risorsa Amazon (ARN) del canale appena creato.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 1024 caratteri.

Pattern: 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 per eseguire questa azione.

Codice HTTP: 401

AccountChannelLimitExceededException

Hai raggiunto il limite massimo di canali di segnalazione attivi per questaAccount AWS 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 per questo parametro di input non è valido.

Codice di stato HTTP: 400

ResourceInUseException

Quando l'ingressoStreamARN oChannelARN l'ingressoCLOUD_STORAGE_MODE sono già mappati su una risorsa Kinesis Video Stream diversa o se l'inputStreamARN fornito nonChannelARN è in stato Attivo, prova una delle seguenti operazioni:

  1. L'DescribeMediaStorageConfigurationAPI per determinare a cosa è mappato lo stream di un determinato canale.

  2. L'DescribeMappedResourceConfigurationAPI per determinare il canale su cui è mappato il flusso specificato.

  3. L'DescribeSignalingChannelAPIDescribeStream or 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 SDK AWS specifici della lingua, consulta quanto segue: