Gérer les tags d’un objet

Les tags sont des étiquettes qui vous permettent de classer et d’identifier vos ressources.

Vous pouvez ajouter des tags à un objet contenu dans un bucket, obtenir des informations sur les tags d’un objet et supprimer les tags d’un objet.

Vous pouvez ajouter jusqu’à 50 tags à un objet.

Ces fonctionnalités ne sont pas disponibles depuis Cockpit. Cette documentation décrit uniquement les procédures à l’aide d’AWS CLI.

Taguer un objet

Lorsque vous utilisez cette commande, la liste de tags spécifiée remplace entièrement tous les tags existants de l’objet.

Pour ajouter un ou plusieurs tags à un objet, utilisez la commande put-object-tagging suivant cette syntaxe :

Exemple de requête
$ aws s3api put-object-tagging \
    --profile YOUR_PROFILE \
    --bucket BUCKET \
    --key OBJECT \
    --version-id qAfAAsAAuA00kclkg0A0AAuAAjaAtA. \
    --tagging '{"TagSet": [{"Key": "string", "Value": "string"}, {"Key": "string", "Value": "string"}]}' \
    --endpoint https://oos.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

  • (optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Utiliser et configurer AWS CLI.

  • bucket : Le nom du bucket dans lequel se trouve l’objet.

  • key : Le nom de l’objet dans le bucket.

  • (optionnel) version-id : L’ID d’une version précédente ou de la version actuelle de l’objet.

  • tagging : Les tags que vous voulez ajouter à un objet spécifique.

    • TagSet : La liste de tags. Cet élément contient l’élément suivant que vous devez spécifier pour chaque tag :

      • key : La clé du tag.

      • (optionnel) value : La valeur du tag.

        • Les clés doivent être uniques et contenir entre 1 et 128 caractères.

        • Les valeurs doivent contenir entre 0 et 256 caractères.

        • Les caractères autorisés sont a-z, A-Z, 0-9 et +=,.@-_.

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

Si vous n’avez jamais activé le versioning du bucket, l’action ne renvoie aucun élément.

Si vous avez activé le versioning du bucket au moins une fois, même si vous le désactivez par la suite, la commande put-object-tagging renvoie l’élément suivant :

  • VersionId : L’ID de la version de l’objet.

Exemple de résultat
{
    "VersionId": "39383336323431353039353434383939393939395247303031202031382e32353637333831302e35"
}

Les tags sont ajoutés à l’objet spécifié.

Obtenir des informations sur les tags d’un objet

Pour obtenir des informations sur les tags d’un objet, utilisez la commande get-object-tagging suivant cette syntaxe :

Exemple de requête
$ aws s3api get-object-tagging \
    --profile YOUR_PROFILE \
    --bucket BUCKET \
    --key OBJECT \
    --version-id qAfAAsAAuA00kclkg0A0AAuAAjaAtA. \
    --endpoint https://oos.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

  • (optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Utiliser et configurer AWS CLI.

  • bucket : Le nom du bucket dans lequel se trouve l’objet.

  • key : Le nom de l’objet dans le bucket.

  • (optionnel) version-id : L’ID d’une version précédente ou de la version actuelle de l’objet.

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

La commande get-object-tagging renvoie les éléments suivants :

  • VersionId : L’ID de la version de l’objet, si vous avez activé le versioning du bucket au moins une fois, même si vous le désactivez par la suite.

  • TagSet : Les tags associés à l’objet.

    • Value : La valeur du tag.

    • Key : La clé du tag.

Exemple de résultat
{
    "VersionId": "39383336323431353039353434383939393939395247303031202031382e32353637333831302e35",
    "TagSet": [
        {
            "Value": "VALUE",
            "Key": "KEY"
        }
    ]
}

Supprimer tous les tags d’un objet

Pour supprimer tous les tags d’un objet, utilisez la commande delete-object-tagging suivant cette syntaxe :

Exemple de requête
$ aws s3api delete-object-tagging \
    --profile YOUR_PROFILE \
    --bucket BUCKET \
    --key OBJECT \
    --version-id qAfAAsAAuA00kclkg0A0AAuAAjaAtA. \
    --endpoint https://oos.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

  • (optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Utiliser et configurer AWS CLI.

  • bucket : Le nom du bucket dans lequel se trouve l’objet.

  • key : Le nom de l’objet dans le bucket.

  • (optionnel) version-id : L’ID d’une version précédente ou de la version actuelle de l’objet.

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

Si vous n’avez jamais activé le versioning du bucket, l’action ne renvoie aucun élément.

Si vous avez activé le versioning du bucket au moins une fois, même si vous le désactivez par la suite, la commande delete-object-tagging renvoie l’élément suivant :

  • VersionId : L’ID de la version de l’objet.

Exemple de résultat
{
    "VersionId": "39383336323431353039353434383939393939395247303031202031382e32353637333831302e35"
}

Les tags de l’objet sont supprimés.

Page connexe

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.