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
Crée un tag pour une EFS ressource. Vous pouvez créer des balises pour les systèmes de EFS fichiers et les points d'accès à l'aide de cette API opération.
Cette opération exige des autorisations pour l’action elasticfilesystem:TagResource
.
Syntaxe de la requête
POST /2015-02-01/resource-tags/ResourceId
HTTP/1.1
Content-type: application/json
{
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
]
}
URIParamètres de demande
La demande utilise les URI paramètres suivants.
- ResourceId
-
L'ID spécifiant la EFS ressource pour laquelle vous souhaitez créer une étiquette.
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 accepte les données suivantes au JSON format suivant.
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 HTTP corps vide.
Erreurs
- AccessPointNotFound
-
Renvoyé si la
AccessPointId
valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.HTTPCode de statut : 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.
HTTPCode de statut : 400
- FileSystemNotFound
-
Renvoyé si la
FileSystemId
valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.HTTPCode de statut : 404
- InternalServerError
-
Renvoyé si une erreur s’est produite côté serveur.
HTTPCode de statut : 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 son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :