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 d’une ressource EFS de haut niveau. Vous devez fournir l’ID de la ressource dont 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
NextTokendans 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 minimale de 1 caractère. Longueur maximale de 128.
Modèle :
.+ - ResourceId
-
Spécifie la ressource EFS dont 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
-
NextTokenest présent si la charge utile de la réponse est paginée. Vous pouvez utiliserNextTokenpour 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 maximale de 128.
Modèle :
.+ - Tags
-
Tableau des balises de ressource EFS spécifiée.
Type : tableau d’objets Tag
Erreurs
- AccessPointNotFound
-
Renvoyé si la
AccessPointIdvaleur spécifiée n'existe pas dans celle du Compte AWS demandeur.- ErrorCode
-
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.
- Message
-
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404
- BadRequest
-
Renvoyé si la demande est mal formulée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.
- ErrorCode
-
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.
- Message
-
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400
- FileSystemNotFound
-
Renvoyé si la
FileSystemIdvaleur spécifiée n'existe pas dans celle du Compte AWS demandeur.- ErrorCode
-
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.
- Message
-
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP :404
- InternalServerError
-
Renvoyé si une erreur s’est produite côté serveur.
- ErrorCode
-
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.
- Message
-
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500
Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
