ListTagsForStream - 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.

ListTagsForStream

Renvoie une liste de balises associées au flux spécifié.

Dans la demande, vous devez spécifier le StreamName ou leStreamARN.

Syntaxe de la demande

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

{
   "NextToken": "string",
   "StreamARN": "string",
   "StreamName": "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.

NextToken

Si vous spécifiez ce paramètre et que le résultat d'un ListTagsForStream appel est tronqué, la réponse inclut un jeton que vous pouvez utiliser dans la prochaine demande pour récupérer le prochain lot de balises.

Type : String

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

Modèle : [a-zA-Z0-9+/=]*

Obligatoire : non

StreamARN

Le nom de ressource Amazon (ARN) du flux pour lequel vous souhaitez répertorier les balises.

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 répertorier les balises.

Type : String

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

Modèle : [a-zA-Z0-9_.-]+

Obligatoire : non

Syntaxe de la réponse

HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Tags": { 
      "string" : "string" 
   }
}

Eléments de réponse

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

Les données suivantes sont renvoyées au format JSON par le service.

NextToken

Si vous spécifiez ce paramètre et que le résultat d'un ListTags appel est tronqué, la réponse inclut un jeton que vous pouvez utiliser dans la prochaine demande pour récupérer le prochain ensemble de balises.

Type : String

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

Modèle : [a-zA-Z0-9+/=]*

Tags

Carte des clés de balise et des valeurs associées au flux spécifié.

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}_.:/=+\-@]*

Erreurs

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

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

InvalidResourceFormatException

Le format du StreamARN n'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

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 :