ListTagsForResource - Amazon Elastic File System
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.

ListTagsForResource

Répertorie toutes les balises pour une ressource EFS de haut niveau. Vous devez fournir l'ID de la ressource pour laquelle vous souhaitez récupérer les balises.

Cette opération exige des autorisations pour l'action elasticfilesystem:DescribeAccessPoints.

Syntaxe de la demande

GET /2015-02-01/resource-tags/ResourceId?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

MaxResults

(Facultatif) Spécifie le nombre maximum d'objets de balises à renvoyer dans la réponse. La valeur par défaut est 100.

Plage valide : valeur minimum de 1.

NextToken

(Facultatif) Vous pouvez utiliser NextToken dans une requête ultérieure pour récupérer la page suivante de descriptions des points d'accès si la charge utile de la réponse a été paginée.

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

Modèle : .+

ResourceId

Spécifie la ressource EFS pour laquelle vous souhaitez récupérer des balises. Vous pouvez récupérer des balises pour les systèmes de fichiers EFS et les points d'accès à l'aide de ce point de terminaison d'API.

Contraintes de longueur : Longueur maximum de 128.

Modèle : ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$

Obligatoire : oui

Corps de la demande

La demande n’a pas de corps de requête.

Syntaxe de la réponse

HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "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

NextToken est présent si la charge utile de la réponse est paginée. Vous pouvez utiliser NextToken pour une demande ultérieure pour obtenir la page suivante de descriptions de points d'accès.

Type : chaîne

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

Modèle : .+

Tags

Tableau des balises pour la ressource EFS spécifiée.

Type : tableau d’objets Tag

Erreurs

AccessPointNotFound

Renvoyé si la valeur AccessPointId spécifiée n'existe pas dans celle du demandeur Compte AWS.

Code d’état HTTP : 404

BadRequest

Renvoyé si la demande est mal formée ou contient une erreur telle qu'une valeur de paramètre non valide ou un paramètre obligatoire manquant.

Code d’état HTTP : 400

FileSystemNotFound

Renvoyé si la valeur FileSystemId spécifiée n'existe pas dans celle du demandeur Compte AWS.

Code d’état HTTP : 404

InternalServerError

Renvoyé si une erreur s'est produite côté serveur.

Code d’état HTTP : 500

consultez aussi

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :