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.
UntagResource
Détache une paire clé-valeur d'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'est renvoyée suite à cet appel.
Syntaxe de la requête
{
"Arn": "string",
"TagKeys": [ "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
-
La valeur de la ressource dont la balise sera supprimée. Un Amazon Resource Name (ARN) est l'identifiant d'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
- TagKeys
-
TagKeys sont des paires clé-valeur attribuées ARNs qui peuvent être utilisées pour regrouper et rechercher des ressources par type. Ces métadonnées peuvent être associées à des ressources pour n'importe quel usage.
Type : tableau de chaînes
Membres du tableau : Nombre minimum de 1 élément. Nombre maximal de 50 éléments.
Contraintes de longueur : longueur minimale de 0. Longueur maximale de 128.
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 supprime une balise d'un serveur compatible avec le protocole de transfert de fichiers.
Exemple de demande
{
"Arn": "arn:aws:transfer:us-east-1:176354371281:server/s-01234567890abcdef",
"TagKeys": "Europe" ]
}Exemple
Cet exemple illustre une utilisation de UntagResource.
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 :
