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

UpdateMediaStorageConfiguration

SignalingChannelAssocia un file a uno stream per archiviare i file multimediali. È possibile specificare due modalità di segnalazione:

  • Se StorageStatus è abilitata, i dati verranno archiviati nell'StreamARNapposito spazio. Affinché WebRTC Ingestion funzioni, lo stream deve avere la conservazione dei dati abilitata.

  • Se StorageStatus è disabilitato, non verrà memorizzato alcun dato e il StreamARN parametro non sarà necessario.

Importante

Se StorageStatus è abilitato, le connessioni dirette peer-to-peer (master-viewer) non si verificano più. I peer si connettono direttamente alla sessione di archiviazione. È necessario chiamare l'JoinStorageSessionAPI per attivare l'invio di un'offerta SDP e stabilire 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: 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ì

MediaStorageConfiguration

Una struttura che incapsula o contiene le proprietà di configurazione dello storage multimediale.

Tipo: oggetto MediaStorageConfiguration

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 disponete delle 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

NoDataRetentionException

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

Codice di stato HTTP: 400

ResourceInUseException

Quando l'ingresso StreamARN o ChannelARN l'ingresso CLOUD_STORAGE_MODE sono già mappati su un'altra risorsa Kinesis Video Stream, o se l'StreamARNingresso fornito ChannelARN o non è nello stato Attivo, prova una delle seguenti soluzioni:

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

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

  3. L'DescribeStreamo l'DescribeSignalingChannelAPI 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 una delle lingue specifiche, consulta quanto segue AWS SDKs: