UpdateMediaStorageConfiguration - Flusso di video Amazon Kinesis

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à.

UpdateMediaStorageConfiguration

Importante

Questa API è correlata aIngestione WebRTCed è disponibile solo inus-west-2regione.

Associati aSignalingChannelsu uno stream per archiviare i file multimediali. È possibile specificare due modalità di segnalazione:

  • Se ilStorageStatusè disabilitato, non verrà archiviato alcun dato eStreamARNparametro non sarà necessario.

  • Se ilStorageStatusè abilitato, i dati verranno archiviati nelStreamARNfornito.

Importante

SeStorageStatusè abilitato, direttopeer-to-peerle connessioni (master-viewer) non si verificano più. I peer si connettono direttamente alla sessione di archiviazione. Devi chiamare ilJoinStorageSessionL'API per attivare un'offerta SDP invia e stabilisce una connessione tra un peer e la sessione di archiviazione.

Sintassi della richiesta

POST /updateMediaStorageConfiguration HTTP/1.1 Content-type: application/json { "ChannelARN": "string", "MediaStorageConfiguration": { "Status": "string", "StreamARN": "string" } }

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.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 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ì

MediaStorageConfiguration

Una struttura che incapsula o contiene le proprietà di configurazione dell'archiviazione multimediale.

Tipo: MediaStorageConfiguration oggetto

Campo obbligatorio: sì

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 disponi delle autorizzazioni necessarie per eseguire questa operazione.

Codice di stato HTTP: 401

ClientLimitExceededException

Kinesis Video Streams ha limitato la richiesta perché hai superato il limite di chiamate client consentite. Prova a fare la chiamata più tardi.

Codice di stato HTTP: 400

InvalidArgumentException

Il valore per questo parametro di input non è valido.

Codice di stato HTTP: 400

NoDataRetentionException

La conservazione dei dati Stream in ore è pari a zero.

Codice di stato HTTP: 400

ResourceInUseException

Quando l'inputStreamARNoChannelARNnelCLOUD_STORAGE_MODEè già mappato su una risorsa Kinesis Video Stream diversa o se l'input fornitoStreamARNoChannelARNnon è in stato Attivo, prova una delle seguenti operazioni:

  1. LaDescribeMediaStorageConfigurationAPI per determinare a cosa è mappato lo stream dato dal canale.

  2. LaDescribeMappedResourceConfigurationAPI per determinare il canale su cui è mappato il flusso specificato.

  3. LaDescribeStreamoDescribeSignalingChannelAPI 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

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: