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.

Gérer les tags d’un objet avec AWS CLI

Taguer un objet

Avant de commencer : Installez et configurez AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

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 en 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 Installer 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.
Si l’attribut version-id commence par un tiret ("-"), vous devez le spécifier en suivant cette syntaxe :

--version-id=-qAfAAsAAuA00kclkg0A0AAuAAjaAtA.

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. Pour en savoir plus, voir Installer et configurer AWS CLI.

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 en 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 Installer 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.
Si l’attribut version-id commence par un tiret ("-"), vous devez le spécifier en suivant cette syntaxe :

--version-id=-qAfAAsAAuA00kclkg0A0AAuAAjaAtA.
endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête. Pour en savoir plus, voir Installer et configurer AWS CLI.

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 en 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 Installer 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.
Si l’attribut version-id commence par un tiret ("-"), vous devez le spécifier en suivant cette syntaxe :

--version-id=-qAfAAsAAuA00kclkg0A0AAuAAjaAtA.
endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête. Pour en savoir plus, voir Installer et configurer AWS CLI.

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.

Pages connexes

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.