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.
UpdateStreamStorageConfiguration
Met à jour la configuration de stockage d'un flux vidéo Kinesis existant.
Cette opération vous permet de modifier les paramètres du niveau de stockage d'un flux, ce qui vous permet d'optimiser les coûts de stockage et les performances en fonction de vos modèles d'accès.
UpdateStreamStorageConfiguration est une opération asynchrone.
Vous devez disposer d'autorisations pour l'action KinesisVideo:UpdateStreamStorageConfiguration.
Syntaxe de la demande
POST /updateStreamStorageConfiguration HTTP/1.1
Content-type: application/json
{
"CurrentVersion": "string",
"StreamARN": "string",
"StreamName": "string",
"StreamStorageConfiguration": {
"DefaultStorageTier": "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.
- CurrentVersion
-
Version du flux dont vous souhaitez modifier la configuration de stockage. Pour obtenir la version, appelez l'API
DescribeStreamou l'ListStreamsAPI.Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.
Modèle :
[a-zA-Z0-9]+Obligatoire : oui
- StreamARN
-
Le nom de ressource Amazon (ARN) du flux pour lequel vous souhaitez mettre à jour la configuration de stockage.
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 : non
- StreamName
-
Nom du flux pour lequel vous souhaitez mettre à jour la configuration de stockage.
Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256.
Modèle :
[a-zA-Z0-9_.-]+Obligatoire : non
- StreamStorageConfiguration
-
La nouvelle configuration de stockage pour le flux. Cela inclut le niveau de stockage par défaut qui détermine la manière dont les données du flux sont stockées et accessibles.
Les différents niveaux de stockage offrent différents niveaux de performance et d'optimisation des coûts pour répondre aux besoins spécifiques de votre cas d'utilisation.
Type : objet StreamStorageConfiguration
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é la demande 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
- ResourceInUseException
-
Lorsque l'entrée
StreamARNouChannelARNl'entréeCLOUD_STORAGE_MODEest déjà mappée à une autre ressource Kinesis Video Stream, ou si l'StreamARNentréeChannelARNfournie n'est pas active, essayez l'une des solutions suivantes :-
L'
DescribeMediaStorageConfigurationAPI permettant de déterminer à quoi le canal donné est mappé. -
L'
DescribeMappedResourceConfigurationAPI permettant de déterminer le canal auquel le flux donné est mappé. -
L'
DescribeSignalingChannelAPIDescribeStreamor 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
- VersionMismatchException
-
La version de diffusion que vous avez spécifiée n'est pas la dernière version. Pour obtenir la dernière version, utilisez l'DescribeStreamAPI.
Code d’état HTTP : 400
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 :
