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.
TagStream
Ajoute une ou plusieurs balises à un flux. Une balise est une paire clé-valeur (la valeur est facultative) que vous pouvez définir et attribuer aux AWS ressources. Si vous spécifiez une balise qui existe déjà, la valeur de la balise est remplacée par la valeur que vous spécifiez dans la requête. Pour plus d'informations, consultez la section Utilisation des balises de répartition des coûts dans le Guide de l'utilisateur de AWS Billing and Cost Management and Cost Management.
Vous devez fournir le StreamName ou leStreamARN.
Cette opération nécessite une autorisation pour l’action KinesisVideo:TagStream.
Un flux vidéo Kinesis peut prendre en charge jusqu'à 50 balises.
Syntaxe de la demande
POST /tagStream HTTP/1.1
Content-type: application/json
{
"StreamARN": "string",
"StreamName": "string",
"Tags": {
"string" : "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.
- StreamARN
-
Le nom de ressource Amazon (ARN) de la ressource à laquelle vous souhaitez ajouter le ou les tags.
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
-
Le nom du flux auquel vous souhaitez ajouter le ou les tags.
Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256.
Modèle :
[a-zA-Z0-9_.-]+Obligatoire : non
- Tags
-
Liste de balises à associer au flux spécifié. Chaque balise est une paire clé-valeur (la valeur est facultative).
Type : mappage chaîne/chaîne
Entrées cartographiques : nombre maximum de 50 éléments.
Contraintes de longueur de clé : longueur minimale de 1. Longueur maximale de 128.
Modèle de clé :
^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$Contraintes de longueur de valeur : longueur minimale de 0. Longueur maximale de 256.
Modèle de valeur :
[\p{L}\p{Z}\p{N}_.:/=+\-@]*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.
- 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
- InvalidResourceFormatException
-
Le format du
StreamARNn'est pas valide.Code d’état HTTP : 400
- NotAuthorizedException
-
L'appelant n'est pas autorisé à effectuer cette opération.
Code d'état HTTP : 401
- ResourceNotFoundException
-
Amazon Kinesis Video Streams ne trouve pas le flux que vous avez spécifié.
Code d’état HTTP : 404
- TagsPerResourceExceededLimitException
-
Vous avez dépassé le nombre limite de balises que vous pouvez associer à la ressource. Un flux vidéo Kinesis peut prendre en charge jusqu'à 50 balises.
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 :