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à.
Aggiorna il canale di segnalazione esistente. Si tratta di un'operazione asincrona che richiede tempo per essere completata.
Se il MessageTtlSeconds
valore viene aggiornato (aumentato o ridotto), si applica solo ai nuovi messaggi inviati tramite questo canale dopo l'aggiornamento. I messaggi esistenti sono ancora scaduti in base al MessageTtlSeconds
valore precedente.
Sintassi della richiesta
POST /updateSignalingChannel HTTP/1.1
Content-type: application/json
{
"ChannelARN": "string
",
"CurrentVersion": "string
",
"SingleMasterConfiguration": {
"MessageTtlSeconds": number
}
}
Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- ChannelARN
-
L'Amazon Resource Name (ARN) del canale di segnalazione che desideri aggiornare.
▬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]+
Campo obbligatorio: sì
- CurrentVersion
-
La versione corrente del canale di segnalazione che desideri aggiornare.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello:
[a-zA-Z0-9]+
Campo obbligatorio: sì
- SingleMasterConfiguration
-
La struttura contenente la configurazione per il
SINGLE_MASTER
tipo di canale di segnalazione che si desidera aggiornare.Tipo: oggetto SingleMasterConfiguration
Campo obbligatorio: no
Sintassi della risposta
HTTP/1.1 200
Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- AccessDeniedException
-
Non hai le autorizzazioni necessarie per eseguire questa operazione.
Codice di stato HTTP: 401
- 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
StreamARN
oChannelARN
l'ingressoCLOUD_STORAGE_MODE
sono già mappati su un'altra risorsa Kinesis Video Stream, o se l'StreamARN
ingresso fornitoChannelARN
o non è nello stato Attivo, prova una delle seguenti soluzioni:-
L'
DescribeMediaStorageConfiguration
API per determinare a cosa è mappato lo stream di un determinato canale. -
L'
DescribeMappedResourceConfiguration
API per determinare il canale su cui è mappato lo stream specificato. -
L'
DescribeStream
o l'DescribeSignalingChannel
API per determinare lo stato della risorsa.
Codice di stato HTTP: 400
-
- ResourceNotFoundException
-
Amazon Kinesis Video Streams non riesce a trovare lo stream specificato.
Codice di stato HTTP: 404
- VersionMismatchException
-
La versione dello stream che hai specificato non è la versione più recente. Per ottenere la versione più recente, usa l'DescribeStreamAPI.
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: