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.
TagResource
Attache une paire clé-valeur à une ressource, telle qu'identifiée par son Amazon Resource Name ()ARN. Les ressources sont des utilisateurs, des serveurs, des rôles et d'autres entités.
Aucune réponse n'a été renvoyée à la suite de cet appel.
Syntaxe de la requête
{
"Arn": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.
La demande accepte les données suivantes au JSON format suivant.
- Arn
-
Nom de ressource Amazon (ARN) pour une AWS ressource spécifique, telle qu'un serveur, un utilisateur ou un rôle.
Type : String
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 1600.
Modèle :
arn:\S+Obligatoire : oui
- Tags
-
Paires clé-valeur assignées ARNs que vous pouvez utiliser pour regrouper et rechercher des ressources par type. Vous pouvez associer ces métadonnées à des ressources (serveurs, utilisateurs, flux de travail, etc.) pour n'importe quel usage.
Type : tableau d’objets Tag
Membres du tableau : Nombre minimum de 1 élément. Nombre maximal de 50 éléments.
Obligatoire : oui
Éléments de réponse
Si l'action aboutit, le service renvoie une réponse HTTP 200 avec un HTTP corps vide.
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- InternalServiceError
-
Cette exception est levée lorsqu'une erreur se produit dans le AWS Transfer Family service.
HTTPCode de statut : 500
- InvalidRequestException
-
Cette exception est levée lorsque le client soumet une demande mal formée.
HTTPCode de statut : 400
- ResourceNotFoundException
-
Cette exception est levée lorsqu'aucune ressource n'est trouvée par le service AWS Transfer Family.
HTTPCode de statut : 400
- ServiceUnavailableException
-
La demande a échoué car le service AWS Transfer Family n'est pas disponible.
HTTPCode de statut : 500
Exemples
Exemple
L'exemple suivant ajoute une balise à un serveur compatible avec le protocole de transfert de fichiers.
Exemple de demande
{
"Arn": "arn:aws:transfer:us-east-1:176354371281:server/s-01234567890abcdef",
"Tags": [
{
"Key": "Group",
"Value": "Europe"
}
]
}Exemple
Cet exemple illustre une utilisation de TagResource.
Exemple de réponse
HTTP 200 response with an empty HTTP body.
consultez aussi
Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :
