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.
Crée une balise pour une ressource EFS. Vous pouvez créer des balises pour les systèmes de fichiers EFS et les points d’accès à l’aide de cette opération d’API.
Cette opération exige des autorisations pour l’action elasticfilesystem:TagResource
.
Syntaxe de la demande
POST /2015-02-01/resource-tags/ResourceId
HTTP/1.1
Content-type: application/json
{
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
]
}
Paramètres de demande URI
La demande utilise les paramètres URI suivants.
- ResourceId
-
L’ID indiquant la ressource EFS pour laquelle vous souhaitez créer une balise.
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
Cette demande accepte les données suivantes au format JSON.
Syntaxe de la réponse
HTTP/1.1 200
Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
Erreurs
- AccessPointNotFound
-
Renvoyé si la
AccessPointId
valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.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.
Code d’état HTTP : 400
- FileSystemNotFound
-
Renvoyé si la
FileSystemId
valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.Code d’état HTTP : 404
- InternalServerError
-
Renvoyé si une erreur s’est produite côté serveur.
Code d’état HTTP : 500
Exemples
Créer des balises sur un système de fichiers
La requête suivante crée trois balises ("key1"
,"key2"
, et "key3"
) sur le système de fichiers spécifié.
Exemple de demande
POST /2015-02-01/tag-resource/fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"Tags": [
{
"Key": "key1",
"Value": "value1"
},
{
"Key": "key2",
"Value": "value2"
},
{
"Key": "key3",
"Value": "value3"
}
]
}
Exemple de réponse
HTTP/1.1 204 no content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
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 :