UpdateMediaStorageConfiguration - Amazon Kinesis Video Streams
Syntaxe de la demandeParamètres de demande URICorps de la demandeSyntaxe de la réponseEléments de réponseErreursconsultez aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

UpdateMediaStorageConfiguration

Associe a SignalingChannel à un flux pour stocker le contenu multimédia. Il existe deux modes de signalisation que vous pouvez définir :

  • Si cette option StorageStatus est activée, les données seront stockées dans le fichier StreamARN fourni. Pour que l'ingestion du WebRTC fonctionne, la conservation des données doit être activée dans le flux.

  • Si StorageStatus cette option est désactivée, aucune donnée ne sera stockée et le StreamARN paramètre ne sera pas nécessaire.

Important

Si cette option StorageStatus est activée, les connexions directes peer-to-peer (maître-visualiseur) ne se produisent plus. Les pairs se connectent directement à la session de stockage. Vous devez appeler l'JoinStorageSessionAPI pour déclencher l'envoi d'une offre SDP et établir une connexion entre un homologue et la session de stockage.

Syntaxe de la demande

POST /updateMediaStorageConfiguration HTTP/1.1
Content-type: application/json

{
   "ChannelARN": "string",
   "MediaStorageConfiguration": { 
      "Status": "string",
      "StreamARN": "string"
   }
}

Paramètres de demande URI

La demande n’utilise pas de paramètres URI.

Corps de la demande

Cette demande accepte les données suivantes au format JSON.

ChannelARN

Le nom de ressource Amazon (ARN) du canal.

Type : String

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 1024.

Modèle : arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+

Obligatoire : oui

MediaStorageConfiguration

Structure qui encapsule ou contient les propriétés de configuration du stockage multimédia.

Type : objet MediaStorageConfiguration

Obligatoire : oui

Syntaxe de la réponse

HTTP/1.1 200

Eléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

AccessDeniedException

Vous ne disposez pas des autorisations requises pour effectuer cette opération.

Code d'état HTTP : 401

ClientLimitExceededException

Kinesis Video Streams a limité le nombre de demandes car vous avez dépassé le nombre maximal d'appels clients autorisés. Essayez de passer l'appel plus tard.

Code d’état HTTP : 400

InvalidArgumentException

La valeur de ce paramètre d'entrée n'est pas valide.

Code d’état HTTP : 400

NoDataRetentionException

La durée de conservation des données Stream en heures est égale à zéro.

Code d’état HTTP : 400

ResourceInUseException

Lorsque l'entrée StreamARN ou ChannelARN l'entrée CLOUD_STORAGE_MODE est déjà mappée à une autre ressource Kinesis Video Stream, ou si l'StreamARNentrée ChannelARN fournie n'est pas active, essayez l'une des solutions suivantes :

  1. L'DescribeMediaStorageConfigurationAPI permettant de déterminer à quoi le canal donné est mappé.

  2. L'DescribeMappedResourceConfigurationAPI permettant de déterminer le canal auquel le flux donné est mappé.

  3. L'DescribeSignalingChannelAPI DescribeStream or pour déterminer le statut de la ressource.

Code d’état HTTP : 400

ResourceNotFoundException

Amazon Kinesis Video Streams ne trouve pas le flux que vous avez spécifié.

Code d’état HTTP : 404

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :