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-2
regione.
Associati aSignalingChannel
su uno stream per archiviare i file multimediali. È possibile specificare due modalità di segnalazione:
-
Se il
StorageStatus
è disabilitato, non verrà archiviato alcun dato eStreamARN
parametro non sarà necessario. -
Se il
StorageStatus
è abilitato, i dati verranno archiviati nelStreamARN
fornito.
Importante
SeStorageStatus
è abilitato, direttopeer-to-peerle connessioni (master-viewer) non si verificano più. I peer si connettono direttamente alla sessione di archiviazione. Devi chiamare ilJoinStorageSession
L'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'input
StreamARN
oChannelARN
nelCLOUD_STORAGE_MODE
è già mappato su una risorsa Kinesis Video Stream diversa o se l'input fornitoStreamARN
oChannelARN
non è in stato Attivo, prova una delle seguenti operazioni:-
La
DescribeMediaStorageConfiguration
API per determinare a cosa è mappato lo stream dato dal canale. -
La
DescribeMappedResourceConfiguration
API per determinare il canale su cui è mappato il flusso specificato. -
La
DescribeStream
oDescribeSignalingChannel
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
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: