View a markdown version of this page

Exemples d'API de balisage de groupes de ressources utilisant AWS CLI - AWS Command Line Interface
Actions

Cette documentation ne concerne AWS CLI que la version 1 du.

Nous avons annoncé la fin prochaine du support pour la AWS CLI version 1. La AWS CLI version 1 est désormais en mode maintenance. Nous vous recommandons de migrer vers la AWS CLI version 2. Pour les dates, des détails supplémentaires et des informations sur la manière de migrer, consultez l'annonce. Pour la documentation relative à la version 2 du AWS CLI, consultez le Guide de l'utilisateur de la version 2.

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.

Exemples d'API de balisage de groupes de ressources utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de l'API AWS Command Line Interface with Resource Groups Tagging.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser get-resources.

AWS CLI

Pour obtenir une liste de ressources balisées

L’exemple get-resources suivant affiche une liste des ressources du compte qui sont balisées avec le nom et la valeur de clé spécifiés.

aws resourcegroupstaggingapi get-resources \
    --tag-filters Key=Environment,Values=Production \
    --tags-per-page 100

Sortie :

{
    "ResourceTagMappingList": [
        {
            "ResourceARN": " arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0",
            "Tags": [
                {
                    "Key": "Environment",
                    "Value": "Production"
                }
            ]
        }
    ]
}

Pour plus d'informations, consultez la référence GetResources de l'API de balisage des groupes de ressources.

  • Pour plus de détails sur l'API, consultez GetResources la section Référence des AWS CLI commandes.

L’exemple de code suivant montre comment utiliser get-tag-keys.

AWS CLI

Pour obtenir la liste de toutes les clés de balises

L’exemple get-tag-keys suivant récupère la liste de tous les noms de clé de balise utilisés par les ressources du compte.

aws resourcegroupstaggingapi get-tag-keys

Sortie :

{
    "TagKeys": [
        "Environment",
        "CostCenter",
        "Department"
    ]
}

Pour plus d'informations, consultez la référence GetTagKeys de l'API de balisage des groupes de ressources.

  • Pour plus de détails sur l'API, consultez GetTagKeys la section Référence des AWS CLI commandes.

L’exemple de code suivant montre comment utiliser get-tag-values.

AWS CLI

Pour obtenir la liste de toutes les valeurs de balises

L’exemple get-tag-values suivant affiche toutes les valeurs utilisées pour la clé spécifiée pour toutes les ressources.

aws resourcegroupstaggingapi get-tag-values \
    --key=Environment

Sortie :

{
    "TagValues": [
        "Alpha",
        "Gamma",
        "Production"
    ]
}

Pour plus d'informations, consultez la référence GetTagValues de l'API de balisage des groupes de ressources.

  • Pour plus de détails sur l'API, consultez GetTagValues la section Référence des AWS CLI commandes.

L’exemple de code suivant montre comment utiliser tag-resources.

AWS CLI

Pour attacher une balise à une ressource

L’exemple tag-resources suivant balise la ressource spécifiée avec un nom et une valeur de clé.

aws resourcegroupstaggingapi tag-resources \
    --resource-arn-list arn:aws:s3:::MyProductionBucket \
    --tags Environment=Production,CostCenter=1234

Sortie :

{
    "FailedResourcesMap": {}
}

Pour plus d'informations, consultez la référence TagResources de l'API de balisage des groupes de ressources.

  • Pour plus de détails sur l'API, consultez TagResources la section Référence des AWS CLI commandes.

L’exemple de code suivant montre comment utiliser untag-resources.

AWS CLI

Pour supprimer une balise d’une ressource

L’exemple untag-resources suivant supprime les clés de balise spécifiées et leurs valeurs associées provenant de la ressource spécifiée.

aws resourcegroupstaggingapi untag-resources \
    --resource-arn-list arn:aws:s3:::amzn-s3-demo-bucket \
    --tag-keys Environment CostCenter

Sortie :

{
    "FailedResourcesMap": {}
}

Pour plus d'informations, consultez la référence UntagResources de l'API de balisage des groupes de ressources.

  • Pour plus de détails sur l'API, consultez UntagResources la section Référence des AWS CLI commandes.