TagResource - Amazon Elastic File System
Syntaxe de la demandeParamètres de demande URICorps de la demandeSyntaxe de la réponseEléments de réponseErreursExemplesconsultez aussi

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 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.

Tags

Un tableau des objetsTag à ajouter. Chaque objet Tag est une paire clé-valeur.

Type : tableau d’objets Tag

Obligatoire : oui

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 AWS SDK spécifiques au langage, consultez les pages suivantes :