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. # Marquage dans AMS Accelerate Identification La plupart des fonctionnalités d'Accelerate (application de correctifs, sauvegarde, surveillance) utilisent des *balises* et des *profils de configuration* pour décider quelles ressources gérer, quelles actions appliquer et quand les appliquer. Les tags sont des libellés que vous appliquez aux ressources. Les profils de configuration contiennent des règles basées sur ces balises. Chaque fonctionnalité Accelerate a ses propres exigences en matière de balisage. Certaines fonctionnalités nécessitent l'utilisation de balises spécifiques, tandis que d'autres vous permettent d'utiliser les vôtres. Pour plus d'informations sur les balises requises, consultez[Tags gérés par le client dans Accelerate](acc-tag-req.md). Pour plus d'informations sur les tags qui peuvent être définis comme des clients, voir [Tags fournis par le client dans Accelerate](acc-tag-cust-provided.md) **Contents** + [Balises](acc-tag-intro.md) + [ ## Qu'est-ce qu'une balise ? ](acc-tag-intro.md#acc-tag-what-is) + [ ## Comment fonctionne le balisage ](acc-tag-intro.md#acc-tag-how-works) + [Tags gérés par le client](acc-tag-req.md) + [Surveillance](acc-tag-req-mon.md) + [Configuration des EC2 instances](acc-tag-req-ins-config.md) + [Sauvegardes](acc-tag-req-backup.md) + [ # Accélérez la gestion des balises ](acc-tag-infra.md) + [Balises fournies par le client](acc-tag-cust-provided.md) + [Outils de gestion des balises](acc-tag-tools.md) + [Étiqueteur de ressources](acc-resource-tagger.md) + [ ## Qu'est-ce que Resource Tagger ? ](acc-resource-tagger.md#acc-rt-what-is) + [ ## Comment fonctionne Resource Tagger ](acc-resource-tagger.md#acc-rt-how-works) + [Profils de configuration](acc-tag-tools-profiles.md) + [ ## Syntaxe et structure ](acc-tag-tools-profiles.md#acc-rt-config-doc-format) + [Cas d’utilisation](acc-rt-using.md) + [ ## Afficher les balises appliquées par Resource Tagger ](acc-rt-using.md#acc-rt-using-view-tags) + [ ## Utilisation de Resource Tagger pour créer des balises ](acc-rt-using.md#acc-tag-how-works-rt) + [ ## Empêcher le Resource Tagger de modifier les ressources ](acc-rt-using.md#acc-rt-preventing-rt-changes) + [ ## Exemple de profil de configuration ](acc-rt-using.md#acc-rt-using-ex-config-doc) + [ ## Fusion de la configuration par défaut ](acc-rt-using.md#acc-rt-using-merge-default-config) + [ ## Désactivation de la configuration par défaut ](acc-rt-using.md#acc-rt-using-disable-default-config) + [ ## Suppression des balises appliquées par Resource Tagger ](acc-rt-using.md#acc-rt-remove-tags) + [ ## Afficher ou modifier la configuration du Resource Tagger ](acc-rt-using.md#acc-rt-make-changes) + [ ## Déploiement des modifications de configuration ](acc-rt-using.md#acc-rt-deploy-changes) + [ ## Configuration de Terraform pour ignorer les balises Resource Tagger ](acc-rt-using.md#acc-rt-ignore-tags) + [ ## Afficher le nombre de ressources gérées par Resource Tagger ](acc-rt-using.md#acc-rt-number-of-resources) + [CloudFormation](acc-tag-how-works-cfn.md) + [Cas d’utilisation](acc-tag-tools-cf-ex.md) + [Tag EC2](acc-tag-cf-ex-tag-ec2.md) + [Mots-clés ASG](acc-tag-cf-ex-tag-asg.md) + [Déployer le profil de configuration](acc-tag-cf-ex-deploy-config.md) + [Terraform](acc-tag-tools-terraform.md) # Balises dans AMS Accelerate Balises **Contents** + [ ## Qu'est-ce qu'une balise ? ](#acc-tag-what-is) + [ ## Comment fonctionne le balisage ](#acc-tag-how-works) + [ # Tags gérés par le client dans Accelerate ](acc-tag-req.md) + [ # Surveillance dans Accelerate ](acc-tag-req-mon.md) + [ # Configuration des balises pour les EC2 instances dans Accelerate ](acc-tag-req-ins-config.md) + [ # Gestion des balises pour les sauvegardes dans Accelerate ](acc-tag-req-backup.md) + [ # Accélérez la gestion des balises ](acc-tag-infra.md) + [ # Tags fournis par le client dans Accelerate ](acc-tag-cust-provided.md) ## Qu'est-ce qu'une balise ? Une étiquette est une étiquette que vous attribuez à une AWS ressource. Chaque balise est constituée d'une clé et d'une valeur facultative que vous définissez toutes deux. Vous utilisez des balises pour classer vos AWS ressources de différentes manières, par exemple par objectif, propriétaire ou environnement. Par exemple, vous pouvez définir un ensemble de balises pour les EC2 instances Amazon de votre compte, ce qui vous permet de suivre le propriétaire et le niveau de pile de chaque instance. Les tags n'ont aucune signification sémantique pour Amazon EC2 et sont interprétés strictement comme des chaînes de caractères. Pour en savoir plus, consultez la section [AWS Ressources relatives au balisage](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html). ## Comment fonctionne le balisage Il existe plusieurs manières d'appliquer des balises à vos ressources. Vous pouvez étiqueter les ressources directement dans la console de chaque AWS service lorsque vous créez la ressource, utiliser l'[éditeur de AWS balises](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) pour ajouter, supprimer ou modifier des balises pour plusieurs ressources, ou utiliser des outils de provisionnement tels que le [tag de CloudFormation ressource](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html). AMS Accelerate fournit également le tagger de ressources AMS Accelerate que vous utilisez pour définir les règles d'un gestionnaire de cycle de vie des balises automatisé. Pour plus d'informations sur l'utilisation de Resource Tagger dans AMS Accelerate, consultez[Accélérez Resource Tagger](acc-resource-tagger.md). AMS Accelerate fournit également des balises fournies par le client pour ajouter et supprimer des balises personnalisées à vos ressources AMS. Pour plus d'informations sur les balises fournies par le client, consultez. [Tags fournis par le client dans Accelerate](acc-tag-cust-provided.md) # Tags gérés par le client dans Accelerate Tags gérés par le client Certaines balises sont nécessaires pour déclencher diverses actions AMS Accelerate. **Contents** + [ # Surveillance dans Accelerate ](acc-tag-req-mon.md) + [ # Configuration des balises pour les EC2 instances dans Accelerate ](acc-tag-req-ins-config.md) + [ # Gestion des balises pour les sauvegardes dans Accelerate ](acc-tag-req-backup.md) # Surveillance dans Accelerate Surveillance AMS Accelerate surveille l'état, la disponibilité et la fiabilité des ressources prises en charge. Pour plus d'informations sur cette offre de service, consultez[Surveillance et gestion des événements dans AMS Accelerate](acc-mon-event-mgmt.md). AMS Accelerate intègre régulièrement des dispositifs complémentaires Services AWS à la surveillance de base. Si vous utilisez la configuration par défaut du Resource Tagger, ces mises à jour sont automatiquement déployées sur vos comptes et les modifications sont répercutées sur les ressources prises en charge. Pour accepter que vos EC2 instances Amazon soient gérées par AMS Accelerate, vous devez appliquer la balise suivante via le profil de personnalisation dans AppConfig ; pour plus d'informations, consultez [Étape 3 : Création d'une configuration et d'un profil de configuration](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html). Appliquez la balise suivante à vos ressources : | Clé | Valeur | | --- | --- | | ams:rt:ams-managed | true | Par exemple, vous pouvez créer un document de configuration personnalisé comme celui-ci pour appliquer les balises à toutes vos ressources prises en charge par AMS EC2  : ``` { "AWS::EC2::Instance": { "AllEC2": { "Enabled": true, "Filter": { "Platform": "*" }, "Tags": [ { "Key": "ams:rt:ams-managed", "Value": "true" } ] } } } ``` **Important** N'oubliez pas de déployer vos modifications de configuration une fois que vous les avez apportées. Dans SSM AppConfig, vous devez déployer une nouvelle version de la configuration après l'avoir créée. Les services autres qu'Amazon EC2 bénéficieront d'une surveillance de base par défaut. Pour *refuser que* vos ressources soient surveillées par AMS Accelerate, vous pouvez utiliser le profil de configuration de personnalisation pour exclure des ressources spécifiques ou Services AWS. Cela vous permet de contrôler les ressources qui doivent être dotées de balises de surveillance pour déployer les définitions d'alarme de base. Consultez [Cas d'utilisation de Resource Tagger dans AMS Accelerate](acc-rt-using.md). **Utilisation de Resource Tagger** La configuration du tagger de ressources AMS Accelerate dans votre compte permet de garantir que les balises suivantes sont déployées automatiquement, si vous appliquez cette balise (**ams:rt:ams-managed**). **Les balises suivantes seront appliquées à vos ressources prises en charge à des fins de surveillance de base.** | Clé | Valeur | Règle | | --- | --- | --- | | ams : rt : ams-monitoring-policy | surveillée par AMS | S'applique à toutes les EC2 ressources prises en charge par AMS | | ams : rt : ams-monitoring-policy-platform | ams-monitored-linux | S'applique à toutes les EC2 instances Amazon exécutant le système d'exploitation Linux | | ams : rt : ams-monitoring-policy-platform | ams-monitored-windows | S'applique à toutes les EC2 instances Amazon exécutant le système d'exploitation Windows | **Pour les autres services pris en charge** Appliquez les balises suivantes à vos ressources, conformément aux règles établies : | Clé | Valeur | Règle | | --- | --- | --- | | ams : rt : ams-monitoring-policy | surveillée par AMS | S'applique à toutes les ressources prises en charge par la surveillance AMS Accelerate. | | ams : rt : ams-monitoring-with-kms | ams-monitored-with-kms | OpenSearch Domaine avec KMS | | ams : rt : ams-monitoring-with-master | ams-monitored-with-master | OpenSearch Domaine avec nœud principal dédié | **Si vous n'utilisez pas Resource Tagger** Consultez [Accélérez les tags sans Resource Tagger](acc-mem-tags-no-rt.md) pour obtenir de l'aide sur l'application des balises de surveillance appropriées à l'aide de méthodes autres que l'utilisation d'AMS Resource Tagger. # Configuration des balises pour les EC2 instances dans Accelerate Configuration des EC2 instances AMS Accelerate gère les agents sur vos EC2 instances Amazon, tels que l'agent SSM et l' CloudWatch agent. Pour plus d'informations sur cette offre de service, voir [Configuration d'instance automatisée dans AMS Accelerate](acc-inst-auto-config.md) Pour accepter que vos EC2 instances Amazon soient gérées par AMS Accelerate, vous devez appliquer la balise suivante à vos EC2 instances Amazon : | Clé | Valeur | | --- | --- | | ams:rt:ams-managed | true | # Gestion des balises pour les sauvegardes dans Accelerate Sauvegardes AMS Accelerate gère la sauvegarde des ressources prises en charge. Pour plus d'informations sur cette offre de service, consultez[Gestion de la continuité dans AMS Accelerate](acc-backup.md). La gestion des sauvegardes AMS Accelerate utilise des balises pour identifier les ressources qui doivent être automatiquement sauvegardées (et fournit également des fonctionnalités de sauvegarde manuelle). Vous pouvez utiliser n'importe quelle combinaison clé:valeur de balise pour associer vos ressources à des plans de sauvegarde. Pour activer les sauvegardes automatisées à l'aide du **ams-default-backup-plan** AWS Backup plan, vous devez appliquer la balise suivante à vos ressources prises en charge : | Clé | Valeur | | --- | --- | | ams:rt:backup-orchestrator | true | **Note** Lors de l'intégration, AMS Accelerate étiquette toutes les ressources avec **ams:rt : backup-orchestrator-onboarding** avec la valeur **true** pour les instantanés à court intervalle et à courte durée de conservation. Ceci est géré par le plan **ams-onboarding-backup-plan**de sauvegarde. Pour plus d'informations sur les AWS Backup forfaits gérés par AMS Accelerate, consultez. [Sélectionnez un plan de sauvegarde AMS](acc-backup-select-plan.md) # Accélérez la gestion des balises Lors de l'intégration à AMS Accelerate, plusieurs AWS ressources sont déployées sur votre compte. Pour que vous puissiez les identifier, ces ressources sont étiquetées avec les balises suivantes : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/managedservices/latest/accelerate-guide/acc-tag-infra.html) **Note** Ces balises sont appliquées à l'aide de balises CloudFormation au niveau de la pile et reposent sur la CloudFormation propagation des balises vers les ressources créées. Pour plus d'informations, consultez la section [Resource tag](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html). # Tags fournis par le client dans Accelerate Balises fournies par le client **Que sont les tags fournis par le client ?** Les balises fournies par le client sont une fonctionnalité du service AMS Accelerate utilisée pour spécifier les règles régissant la manière dont les ressources AMS sont étiquetées dans votre compte. Grâce aux balises fournies par le client, vous pouvez ajouter des balises personnalisées définies par l'utilisateur aux ressources AMS déployées sur vos comptes. La fonctionnalité de balises fournies par le client est automatiquement ajoutée aux comptes demandés lorsque vous en faites la demande à votre responsable de prestation de services cloud (CSDM) à l'aide d'un service automatisé. Notez que vous ne pouvez pas remplacer les [balises AMS](https://docs.aws.amazon.com/managedservices/latest/accelerate-guide/acc-tag-infra.html). Les balises AMS commencent par « ams : ». Vous pouvez définir vos propres [balises](https://docs.aws.amazon.com/managedservices/latest/accelerate-guide/acc-tag-intro.html) (étiquettes) et spécifier les fonctionnalités de ces balises pour toutes vos [ressources AMS Accelerate](https://docs.aws.amazon.com/managedservices/latest/accelerate-guide/acc-resource-inventory.html). Vous pouvez fournir ces balises avant d'intégrer AMS afin que les balises AMS et vos balises personnalisées soient appliquées pendant le processus d'intégration. Vous pouvez également fournir des tags après l'intégration. **Comment puis-je ajouter des tags fournis par le client ?** Pour demander l'ajout de ces balises à vos ressources, [contactez votre CSDM](https://docs.aws.amazon.com/managedservices/latest/accelerate-guide/acc-contact-escalate.html). Ces balises seront appliquées aux ressources AMS de votre compte. **Quelle est la portée des tags ?** Cette fonctionnalité n'est actuellement disponible que pour les clients Accelerate et dans les régions AWS commerciales. Vous pouvez ajouter des tags à tous les comptes que vous possédez ou à une liste spécifique de comptes. **Note** Ces balises s'appliquent uniquement aux ressources AMS et n'affectent pas vos propres ressources. # Outils de gestion des balises pour Accelerate Outils de gestion des balises **Table des matières** + [Accélérez Resource Tagger](acc-resource-tagger.md) + [Utilisation CloudFormation pour créer des balises pour AMS Accelerate](acc-tag-how-works-cfn.md) + [Utiliser Terraform pour créer des balises pour AMS Accelerate](acc-tag-tools-terraform.md) # Accélérez Resource Tagger Étiqueteur de ressources Avec Resource Tagger, vous pouvez définir des règles régissant la manière dont les AWS ressources sont étiquetées dans votre compte. Lors de l'intégration d'un compte, AMS Accelerate déploie votre politique de balisage pour garantir que les ressources de vos comptes gérés sont étiquetées. **Contents** + [ ## Qu'est-ce que Resource Tagger ? ](#acc-rt-what-is) + [ ## Comment fonctionne Resource Tagger ](#acc-rt-how-works) + [ # Profils de configuration de Resource Tagger dans AMS Accelerate ](acc-tag-tools-profiles.md) + [ ## Syntaxe et structure ](acc-tag-tools-profiles.md#acc-rt-config-doc-format) + [ # Cas d'utilisation de Resource Tagger dans AMS Accelerate ](acc-rt-using.md) + [ ## Afficher les balises appliquées par Resource Tagger ](acc-rt-using.md#acc-rt-using-view-tags) + [ ## Utilisation de Resource Tagger pour créer des balises ](acc-rt-using.md#acc-tag-how-works-rt) + [ ## Empêcher le Resource Tagger de modifier les ressources ](acc-rt-using.md#acc-rt-preventing-rt-changes) + [ ## Exemple de profil de configuration ](acc-rt-using.md#acc-rt-using-ex-config-doc) + [ ## Fusion de la configuration par défaut ](acc-rt-using.md#acc-rt-using-merge-default-config) + [ ## Désactivation de la configuration par défaut ](acc-rt-using.md#acc-rt-using-disable-default-config) + [ ## Suppression des balises appliquées par Resource Tagger ](acc-rt-using.md#acc-rt-remove-tags) + [ ## Afficher ou modifier la configuration du Resource Tagger ](acc-rt-using.md#acc-rt-make-changes) + [ ## Déploiement des modifications de configuration ](acc-rt-using.md#acc-rt-deploy-changes) + [ ## Configuration de Terraform pour ignorer les balises Resource Tagger ](acc-rt-using.md#acc-rt-ignore-tags) + [ ## Afficher le nombre de ressources gérées par Resource Tagger ](acc-rt-using.md#acc-rt-number-of-resources) ## Qu'est-ce que Resource Tagger ? Resource Tagger est un service AMS Accelerate qui vous permet de définir des règles régissant la manière dont les AWS ressources sont étiquetées dans votre compte. Il vise à vous fournir une visibilité complète sur la manière dont vos balises sont appliquées à vos AWS ressources. Resource Tagger crée, met à jour et supprime automatiquement les balises sur les AWS ressources prises en charge, en fonction des règles de balisage que vous spécifiez dans vos profils de configuration. Par exemple, vous pouvez spécifier une règle qui applique une balise à un ensemble d' EC2 instances Amazon, indiquant qu'elles doivent être gérées par AMS Accelerate, ce qui entraîne la surveillance ou la sauvegarde des instances. Vous pouvez utiliser de telles balises pour identifier le statut de conformité des AWS ressources en fonction de la politique définie dans vos profils AWS AppConfig de configuration. Pour de plus amples informations, veuillez consulter [AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/what-is-appconfig.html). AMS Accelerate fournit une configuration de balisage géré par défaut afin que vous puissiez faire surveiller vos ressources par AMS Accelerate. Vous définissez les ressources qui doivent être gérées par AMS Accelerate, et les règles de balisage géré garantissent que les ressources dotées des balises appropriées sont surveillées par AMS Accelerate. Avec Resource Tagger, si vous le souhaitez, vous pouvez remplacer ou désactiver les balises gérées par AMS Accelerate par défaut, fournir vos propres règles de balisage pour répondre à vos politiques et utiliser d'autres mécanismes, tels que Terraform, pour éviter la dérive. Vous pouvez définir les exceptions à l'échelle, en fonction de vos opérations. Par exemple, vous pouvez définir une politique visant à appliquer des balises à toutes les EC2 instances Amazon dotées de plateformes prises en charge (telles que Windows et Linux) et à exclure du balisage une instance IDs spécifique. **Important** Resource Tagger contrôle tous les tags de votre compte dotés du préfixe **ams:rt :**. Toutes les balises commençant par ce préfixe sont supprimées sauf si elles sont présentes dans les règles de configuration de Resource Tagger. En résumé, toute balise commençant par **ams:rt :** sur les ressources prises en charge est considérée comme appartenant à Resource Tagger. Si vous balisez manuellement quelque chose avec, par exemple, **ams:rt :**, cette balise sera automatiquement supprimée si elle n'est pas spécifiée dans l'un des profils de configuration du Resource Tagger. ## Comment fonctionne Resource Tagger Lorsque votre compte est intégré à AMS Accelerate, deux documents de configuration JSON sont déployés sur votre compte dans. AWS AppConfig Les deux documents, appelés *profils de configuration*, sont des **AMSManagedbalises**, appelées **profil de configuration par défaut** et **CustomerManagedTags****profil de configuration de personnalisation**. Vous utilisez le profil de configuration personnalisé pour définir vos propres politiques et règles pour vos comptes, et celles-ci ne sont pas remplacées par AMS Accelerate. Les deux profils se trouvent dans l'application **AMSResourceTagger** et dans l'**AMSInfrastructure**environnement. Toutes les balises appliquées par le baliseur de ressources ont le **préfixe de clé ams:rt** :. **Profil de configuration de personnalisation** : Le profil de configuration de personnalisation est initialement vide au moment de l'intégration du compte ; toutefois, toutes les règles placées dans le document de profil sont appliquées, en plus des règles du profil de configuration par défaut. Toute configuration du profil de configuration de personnalisation est entièrement gérée par vous et n'est pas remplacée par AMS Accelerate, sauf à votre demande. Vous pouvez spécifier les règles de balisage personnalisées que vous souhaitez dans le profil de configuration personnalisé pour les AWS ressources prises en charge, et vous pouvez également spécifier des modifications à la configuration par défaut gérée par AMS Accelerate ici, voir. [Cas d'utilisation de Resource Tagger dans AMS Accelerate](acc-rt-using.md) **Important** Si vous mettez à jour ce profil, le Resource Tagger applique automatiquement les modifications à toutes les ressources pertinentes de votre. Compte AWS Les modifications sont appliquées automatiquement, mais leur prise en compte peut prendre jusqu'à 60 minutes. Vous pouvez mettre à jour ce profil à l'aide des outils AWS Management Console AWS CLI/SDK ou par le biais de ceux-ci. Pour plus d'informations sur la mise à jour d'un profil de configuration personnalisé, consultez le guide de AWS AppConfig l'utilisateur : [Qu'est-ce que c'est AWS AppConfig ?](https://docs.aws.amazon.com/appconfig/latest/userguide/what-is-appconfig.html) **Profil de configuration par défaut** : Le document de profil de configuration par défaut est interne à AMS Accelerate et contient les règles par défaut fournies par AMS Accelerate que vous ne pouvez ni modifier ni supprimer définitivement. Ce profil peut être mis à jour à tout moment par AMS Accelerate et mis à votre disposition pour examen ; toutes les modifications que vous y avez apportées sont automatiquement supprimées. Si vous souhaitez modifier ou désactiver l'une des règles de configuration par défaut, vous utilisez le profil de configuration de personnalisation, voir[Cas d'utilisation de Resource Tagger dans AMS Accelerate](acc-rt-using.md). # Profils de configuration de Resource Tagger dans AMS Accelerate Profils de configuration Les profils de configuration permettent de garantir que les balises sont appliquées uniformément aux ressources tout au long de leur durée de vie. ## Syntaxe et structure Un profil de configuration est un objet JSON dont la structure est la suivante : ``` { "Options": { "ReadOnly": false }, "ResourceType": { "ConfigurationID": { "Enabled": true, "Filter": { ... }, "Tags": [ ... ] }, "ConfigurationID": { ... } }, "ResourceType": { ... } } ``` **Options** : (facultatif) Spécifiez les options relatives à la façon dont vous souhaitez qu' ResourceTagger elles se comportent. L'omission du bloc revient à définir les valeurs par défaut de toutes les options. Voir ci-dessous les paramètres **des options** disponibles : + **ReadOnly**: (facultatif, la valeur par défaut est false) : Spécifie le ReadOnly mode pour Resource Tagger. Définissez cette valeur ReadOnly sur true pour désactiver la création ou la suppression de balises par Resource Tagger sur les ressources AWS. Pour de plus amples informations, veuillez consulter [Empêcher le Resource Tagger de modifier les ressources](acc-rt-using.md#acc-rt-preventing-rt-changes). **ResourceType**: Cette clé doit être l'une des chaînes prises en charge suivantes et représente toutes les configurations liées au type de ressource indiqué : + AWS::AutoScaling::AutoScalingGroupe + AWS::DynamoDB::Table + AWS::EC2::Instance + AWS::EC2::NatGateway + AWS : EC2 : : VPNConnection + AWS::EFS::FileSystem + AWS::EKS::Cluster + AWS::ElasticLoadBalancing::LoadBalancer + AWS::ElasticLoadBalancingV2::LoadBalancer + AWS::Elasticsearch::Domain + AWS::FSx::FileSystem + AWS::OpenSearch::Domain + AWS : :RDS : : DBCluster + AWS : :RDS : : DBInstance + AWS::Redshift::Cluster + AWS::S3::Bucket + AWS::Synthetics::Canary **ConfigurationID** : cette clé doit être unique dans le document de profil et nommer de manière unique le bloc de configuration suivant. Si deux blocs de configuration d'un même **ResourceType**bloc ont le même **identifiant de configuration**, celui qui apparaît en dernier dans le profil prend effet. Si vous spécifiez dans votre profil de personnalisation un **ID de configuration** identique à celui spécifié dans le document par défaut, le bloc de configuration défini dans le profil de personnalisation prend effet. **Important** Le **ConfigurationID** doit ***not***chevaucher le profil AMS Accelerate ; par exemple, il ne doit pas être **AMSMonitoringLinux** ou **AMSMonitoringWindows**, sinon il désactive la configuration correspondante du profil de configuration **AMSManagedTags**. **Activé** (facultatif, la valeur par défaut **est true**) : indique si le bloc de configuration prend effet. Définissez ce paramètre sur **false** pour désactiver un bloc de configuration. Un bloc de configuration désactivé n'a aucun effet. **Filtre** : Spécifie les ressources auxquelles s'applique la configuration. Chaque objet de filtre peut comporter l'un des champs suivants (mais un seul) : + **AWS::AutoScaling::AutoScalingGroupe** : + **AutoScalingGroupName**: nom du groupe Autoscaling. Ce champ prend en charge la correspondance par caractères génériques. + **AWS::DynamoDB::Table**: + **TableName**: nom de la table DynamoDB. Ce champ prend en charge la correspondance par caractères génériques. + **AWS::EC2::Instance**: + **AvailabilityZone**: le filtre correspond à une EC2 instance dans la zone de disponibilité spécifiée. Ce champ prend en charge la correspondance par caractères génériques, donc **\$1a** correspond à us-east-1a, ap-northeast-1a, etc. + **InstanceId**: le filtre fait correspondre une EC2 instance à l'ID d'instance spécifié. **Ce champ prend en charge la correspondance par caractères génériques. Ainsi, **i-00000\$1** correspondrait à toute instance dont l'ID d'instance commence par i-00000.** + **Plateforme** : le filtre fait correspondre une EC2 instance à la plate-forme spécifiée. Les valeurs valides sont **Windows**, **Linux** ou le caractère générique **\$1** (pour correspondre à n'importe quelle plateforme). + **AWS::EC2::NatGateway**: + **NatGatewayId**: ID de la passerelle NAT. Ce champ prend en charge la correspondance par caractères génériques. + **État** : état de la passerelle NAT (en attente \$1 échec \$1 disponible \$1 suppression \$1 supprimé ou caractère générique « \$1 ») + **VpcId**: ID du VPC dans lequel réside la passerelle NAT. Ce champ prend en charge la correspondance par caractères génériques. + **SubnetId**: ID du sous-réseau dans lequel réside la passerelle NAT. Ce champ prend en charge la correspondance par caractères génériques + **AWS : EC2 : : VPNConnection** : + **VpnConnectionId**: ID de la connexion. Ce champ prend en charge la correspondance par caractères génériques. + **AWS::EFS::FileSystem**: + **FileSystemId**: ID du système de fichiers EFS. Ce champ prend en charge la correspondance par caractères génériques. + **AWS::EKS::Cluster**: + **ClusterName**: nom du cluster. Ce champ prend en charge la correspondance par caractères génériques. + **AWS::ElasticLoadBalancing::LoadBalancer (Classic Load Balancer**) : + **LoadBalancerName**: Le LoadBalancer nom. Ce champ prend en charge la correspondance par caractères génériques. + **Schéma** : Il peut être « connecté à Internet », « interne » ou « \$1 » générique. + **VPCId**: le champ VPCId dans lequel l'équilibreur de charge est déployé peut être un caractère générique « \$1 ». + **AWS::ElasticLoadBalancingV2::LoadBalancer (Application Load Balancer (ALB**)) : + **LoadBalancerArn**: le nom de la ressource LoadBalancer Amazon (ARN). + **DNSName**: Le DNSName de LoadBalancer. Ce champ prend en charge la correspondance par caractères génériques. + **LoadBalancerName**: Le LoadBalancer nom. Ce champ prend en charge la correspondance par caractères génériques. + **AWS::Elasticsearch::Domain**: + **DomainId**: celui DomainId de la ElasticSearch ressource. Ce champ prend en charge la correspondance par caractères génériques. + **DomainName**: celui DomainName de la ElasticSearch ressource. Ce champ prend en charge la correspondance par caractères génériques. + **HasMasterNode**: valeur booléenne vraie ou fausse. Correspond si le domaine possède un nœud maître dédié. + **HasKmsKey**Valeur booléenne vraie ou fausse. Correspond si le domaine possède une clé KMS pour le chiffrement au repos. + **AWS::FSx::FileSystem**: + **FileSystemId**: ID du système de FSx fichiers. Ce champ prend en charge la correspondance par caractères génériques. + **AWS::OpenSearch::Domain**: + **DomainId**: celui DomainId de la OpenSearch ressource. Ce champ prend en charge la correspondance par caractères génériques. + **DomainName**: celui DomainName de la OpenSearch ressource. Ce champ prend en charge la correspondance par caractères génériques. + **HasMasterNode**: booléen ; si le domaine possède un nœud maître dédié, cela peut être défini sur true. + **HasKmsKey**: si le domaine possède une clé KMS pour le chiffrement au repos, cela peut être défini sur true. + **AWS : :RDS : : : DBCluster** + **DBClusterIdentifiant** : le filtre fait correspondre un identifiant de cluster RDS à l'identifiant spécifié. Ce champ ne prend pas en charge la correspondance par caractères génériques, un identifiant de cluster doit donc être spécifié. + **Moteur** : moteur utilisé par l'instance RDS. Ce champ prend en charge la correspondance par caractères génériques. + **EngineVersion**: La version du moteur. Ce champ prend en charge la correspondance par caractères génériques. + **AWS : :RDS : : : DBInstance** + **DBInstanceIdentifiant** : le filtre fait correspondre une instance RDS à l'ID d'instance spécifié. Ce champ ne prend pas en charge la correspondance par caractères génériques, un identifiant d'instance doit donc être spécifié. + **Moteur** : moteur utilisé par l'instance RDS. Ce champ prend en charge la correspondance par caractères génériques. + **EngineVersion**: La version du moteur. Ce champ prend en charge la correspondance par caractères génériques. + **AWS::Redshift::Cluster**: + **ClusterIdentifier**: L'identifiant du cluster. Ce champ prend en charge la correspondance par caractères génériques. + **AWS::S3::Bucket**: + **BucketName**: nom du compartiment S3. Ce champ prend en charge la correspondance par caractères génériques. + **AWS::Synthetics::Canary**: + **CanaryName**: Le nom du canari Synthetics. **Autres propriétés du filtre :** + **Tag** : Le filtre s'applique à toutes les ressources auxquelles le tag donné est déjà appliqué. La valeur de cette propriété doit être un objet JSON avec les champs suivants : + **Clé** : doit être une chaîne exacte et indique que les ressources doivent avoir une balise avec cette clé exacte. + **Valeur** : Spécifie la valeur correspondante pour la balise. Supporte les caractères génériques, de sorte qu'une valeur de **Sample** correspond à toute valeur se terminant par la chaîne **Sample**. + **Fn : :AND** : tableau JSON d'objets JSON. Chaque objet suit les mêmes règles que le bloc de configuration du **filtre**. Cela indique que le filtre correspond à toute ressource correspondant à tous les sous-filtres. + **Fn : :OR** : tableau JSON d'objets JSON. Chaque objet suit les mêmes règles que le bloc de configuration du **filtre**. Cela indique que le filtre correspond à toute ressource correspondant à l'un des sous-filtres. + **Fn : :NOT** : un objet JSON qui suit les mêmes règles que le bloc de configuration du **filtre**. Cela indique que le filtre ne correspond explicitement à aucune ressource correspondant au sous-filtre. Utilisez-le pour spécifier les exclusions de vos règles de balisage. **Balises** : balises à appliquer aux ressources correspondantes. (Voir [Dénomination des balises et conventions d'utilisation](https://docs.aws.amazon.com/mediaconnect/latest/ug/tagging-restrictions.html).) Ce champ est un tableau de paires clé-valeur : + **Clé** : clé de la balise à appliquer. + **Valeur** : valeur de la balise à appliquer. **Note** Les balises appliquées par Resource Tagger ont toujours des clés qui commencent par **ams:rt :**. Si vous ne spécifiez pas ce préfixe dans votre profil, Resource Tagger l'insère pour vous. C'est ainsi que Resource Tagger distingue les balises qu'elle possède et gère des balises utilisées par d'autres outils à d'autres fins. # Cas d'utilisation de Resource Tagger dans AMS Accelerate Cas d’utilisation Cette section répertorie les actions fréquemment effectuées avec Resource Tagger. ## Afficher les balises appliquées par Resource Tagger Toutes les balises appliquées par Resource Tagger ont le **préfixe de clé ams:rt** :. **Par exemple, la définition de balise suivante génère une balise avec la clé **AMS:RT:SampleKey et la valeur SampleValue**.** Toutes les balises portant ce préfixe sont considérées comme faisant partie de Resource Tagger. ``` { "Key": "sampleKey", "Value": "sampleValue" } ``` **Important** Si vous créez manuellement votre propre tag avec le préfixe **ams:rt :**, il est considéré comme géré par Resource Tagger. Cela signifie que si la ressource est gérée par Resource Tagger, mais que les profils de configuration n'indiquent pas que la balise doit être appliquée, Resource Tagger supprime votre balise ajoutée manuellement. Si vous balisez manuellement des ressources gérées par Resource Tagger, n'utilisez pas le préfixe **ams:rt :** pour les clés de balise. ## Utilisation de Resource Tagger pour créer des balises Le tagger de ressources AMS Accelerate est un composant qui est déployé dans votre compte lors de l'intégration d'AMS Accelerate. Resource Tagger dispose d'un ensemble de règles configurables qui définissent la manière dont vos ressources doivent être étiquetées, puis il applique ces règles, en ajoutant et en supprimant automatiquement des balises sur les ressources pour garantir leur conformité à vos règles. Si vous souhaitez utiliser le Resource Tagger pour étiqueter vos ressources, consultez[Accélérez Resource Tagger](acc-resource-tagger.md). **Voici un exemple d'extrait de configuration de Resource Tagger qui ajoute la balise **ams:rt:ams-managed** avec la valeur true à toutes les instances Amazon.** EC2 La balise **ams:rt:ams-managed** vous permet de faire surveiller vos ressources par AMS Accelerate. ``` { "AWS::EC2::Instance": { "SampleConfigurationBlock": { "Enabled": true, "Filter": { "Platform": "*" }, "Tags": [ { "Key": "ams:rt:ams-managed", "Value": "true" } ] } } } ``` **Avertissement** Soyez prudent lorsque vous spécifiez le nom de votre nouvelle configuration (`SampleConfigurationBlock`dans l'exemple fourni) car vous risquez de remplacer par inadvertance la configuration gérée par AMS par le même nom. ## Empêcher le Resource Tagger de modifier les ressources Le Resource Tagger peut être configuré sur un mode lecture seule qui l'empêche d'ajouter ou de supprimer des balises sur vos ressources. Cela est utile si vous souhaitez fournir votre propre mécanisme de balisage. En mode lecture seule, Resource Tagger examine toujours les règles de balisage spécifiées dans les profils de configuration gérés et clients, et recherche les ressources qui ne respectent pas ces règles de balisage. Toutes les ressources non conformes sont signalées. AWS Config Celui AWS Config Rules que vous pouvez rechercher a le `AMSResourceTagger-` préfixe. Par exemple, la `AMSResourceTagger-EC2Instance` AWS Config règle évalue si des balises appropriées sont créées pour les `AWS::EC2::Instance` ressources en fonction du profil de configuration. Resource Tagger s'arrête à ce stade et n'apporte aucune modification à vos ressources (il n'ajoute ni ne supprime de balises). Vous pouvez activer le mode lecture seule en modifiant le profil de configuration client pour inclure la **ReadOnly**clé dans le bloc **Options**. Par exemple, l'extrait de profil de configuration suivant montre à quoi cela pourrait ressembler : ``` { "Options": { "ReadOnly": true }, "AWS::EC2::Instance": { [... the rest of your configuration ...] } } ``` Resource Tagger réagira à cette nouvelle configuration dès la fin du déploiement et cessera d'ajouter et de supprimer des balises sur les ressources. **Note** Pour réactiver la modification des balises, remplacez la **ReadOnly**valeur par **false** ou supprimez complètement la clé, car la valeur par défaut est **false**. Pour en savoir plus sur le paramètre **Options**[Syntaxe et structure](acc-tag-tools-profiles.md#acc-rt-config-doc-format), reportez-vous à la section suivante. ## Exemple de profil de configuration L'exemple de document de profil suivant indique que toutes les EC2 instances Windows faisant partie d'une CloudFormation pile stack-\$1 doivent être gérées par AMS Accelerate ; il exclut toutefois explicitement une EC2 instance particulière portant l'ID i-00000000000000001. ``` { "AWS::EC2::Instance": { "AMSMonitoringWindows": { "Enabled": true, "Filter": { "Fn::AND": [ { "Platform": "Windows" }, { "Tag": { "Key": "aws:cloudformation:stack-name", "Value": "stack-*" } }, { "Fn::NOT": { "InstanceId": "i-00000000000000001" } } ] }, "Tags": [ { "Key": "ams:rt:ams-managed", "Value": "true" } ] } } } ``` **Avertissement** Soyez prudent lorsque vous spécifiez le nom de votre nouvelle configuration (`SampleConfigurationBlock`dans l'exemple fourni) car vous risquez de remplacer par inadvertance la configuration gérée par AMS par le même nom. ## Fusion de la configuration par défaut Le profil de configuration par défaut est fourni par AMS Accelerate au moment de l'enregistrement du compte. Ce profil fournit des règles par défaut qui sont déployées dans votre compte. Bien que vous ne puissiez pas modifier le profil de configuration par défaut, vous pouvez remplacer les paramètres par défaut en spécifiant un bloc de configuration dans votre profil de configuration personnalisé avec le même **identifiant de configuration que le bloc de configuration** par défaut. Dans ce cas, votre bloc de configuration remplace le bloc de configuration par défaut. Par exemple, considérez le document de configuration par défaut suivant : ``` { "AWS::EC2::Instance": { "AMSManagedBlock1": { "Enabled": true, "Filter": { "Platform": "Windows" }, "Tags": [{ "Key": "my-tag", "Value": "SampleValueA" }] } } } ``` Pour modifier la valeur de balise appliquée ici de `SampleValueA` à `SampleValueB` et appliquer la balise à toutes les instances, et pas uniquement aux instances Windows, vous devez fournir le profil de configuration de personnalisation suivant : ``` { "AWS::EC2::Instance": { "AMSManagedBlock1": { "Enabled": true, "Filter": { "Platform": "*" }, "Tags": [{ "Key": "my-tag", "Value": "SampleValueB" }] } } } ``` **Important** N'oubliez pas de déployer vos modifications de configuration une fois que vous les avez apportées. Pour de plus amples informations, veuillez consulter [Déploiement des modifications de configuration](#acc-rt-deploy-changes). Dans SSM AppConfig, vous devez déployer une nouvelle version de la configuration après l'avoir créée. ## Désactivation de la configuration par défaut **Vous pouvez désactiver une règle de configuration par défaut en ajoutant un bloc de configuration avec le même **identifiant de configuration** à votre profil de configuration personnalisé et en attribuant au champ **Enabled** la valeur false.** Par exemple, si la configuration suivante était présente dans le profil de configuration par défaut : ``` { "AWS::EC2::Instance": { "AMSManagedBlock1": { "Enabled": true, "Filter": { "Platform": "Windows" }, "Tags": [{ "Key": "my-tag", "Value": "SampleValueA" }] } } } ``` Vous pouvez désactiver cette règle de balisage en incluant les éléments suivants dans votre profil de configuration de personnalisation : ``` { "AWS::EC2::Instance": { "AMSManagedBlock1": { "Enabled": false } } } ``` **Important** N'oubliez pas de déployer vos modifications de configuration une fois que vous les avez apportées ; pour plus d'informations, consultez[Déploiement des modifications de configuration](#acc-rt-deploy-changes). Dans SSM AppConfig, vous devez déployer une nouvelle version de la configuration après l'avoir créée. ## Suppression des balises appliquées par Resource Tagger Toutes les balises préfixées par **ams:rt** sont supprimées par Resource Tagger si elles n'existent pas dans les profils de configuration ou, si elles existent, si le filtre ne correspond pas. Cela signifie que vous pouvez supprimer les balises appliquées par Resource Tagger en effectuant l'une des opérations suivantes : + Modification de la section de configuration de personnalisation qui définit le tag. + Ajout d'une exception pour les ressources spécifiques afin qu'elles ne correspondent plus au filtre. Par exemple : si une instance **Linux** possède les balises suivantes : ``` "Tags": [{ "Key": "ams:rt:MyOwnTag", "Value": true },{ "Key": "myTag", "Value": true }] ``` Et vous déployez le profil de configuration de Resource Tagger suivant : ``` { "AWS::EC2::Instance": { "AMSMonitoringWindows": { "Enabled": true, "Filter": { "Platform": "Windows" }, "Tags": [{ "Key": "ams:rt:ams-managed", "Value": "true" }] } } } ``` Resource Tagger réagit aux nouvelles modifications de configuration et la seule balise de l'instance devient : ``` "Tags": [{ "Key": "myTag", "Value": true }] ``` **Avertissement** Soyez prudent lorsque vous spécifiez le nom de votre nouvelle configuration (`SampleConfigurationBlock`dans l'exemple fourni) car vous risquez de remplacer par inadvertance la configuration gérée par AMS par le même nom. **Important** N'oubliez pas de déployer vos modifications de configuration une fois que vous les avez apportées ; pour plus d'informations, consultez[Déploiement des modifications de configuration](#acc-rt-deploy-changes). Dans SSM AppConfig, vous devez déployer une nouvelle version de la configuration après l'avoir créée. ## Afficher ou modifier la configuration du Resource Tagger Les deux profils de configuration JSON, **AMSManagedTags** et **CustomerManagedTags**, déployés sur votre compte dans [AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/what-is-appconfig.html) lors de l'intégration et du stockage dans l'application AMSResource Tagger, ainsi que dans l'**AMSInfrastructure**environnement, peuvent être consultés via AppConfig l'[GetConfiguration](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_GetConfiguration.html)API. Voici un exemple de cet GetConfiguration appel : ``` aws appconfig get-configuration --application AMSResourceTagger --environment AMSInfrastructure --configuration AMSManagedTags --client-id ANY_STRING outfile.json ``` **Application** : unité AppConfig logique fournissant des fonctionnalités, pour le Resource Tagger, il s'agit de AMSResource Tagger. + **Environnement** : AMSInfrastructure. + **Configuration** : pour afficher les définitions de balises par défaut d'AMS Accelerate, la valeur est AMSManaged Tags, tandis que pour afficher les définitions des balises client, la valeur est CustomerManagedTags. + **ID client : identifiant** unique de l'instance d'application, il peut s'agir de n'importe quelle chaîne. + Les définitions des balises peuvent ensuite être consultées dans le fichier de sortie spécifié, dans ce cas, outfile.json. Les définitions des alarmes peuvent ensuite être consultées dans le fichier de sortie spécifié, dans ce cas, outfile.json. Vous pouvez voir quelle version de configuration est déployée sur votre compte en consultant les déploiements antérieurs dans l'**AMSInfrastructure**environnement. ****Pour contourner les règles relatives aux balises, procédez comme suit : Toutes les règles de balise existantes peuvent être remplacées en mettant à jour le profil de personnalisation avec CloudFormation [Déploiement d'un profil de configuration avec CloudFormation for Accelerate](acc-tag-cf-ex-deploy-config.md) ou directement à l'aide de l'API AppConfig d'[https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateHostedConfigurationVersion.html](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateHostedConfigurationVersion.html)utilisation. L'utilisation du même **identifiant de configuration** comme règle de balise de configuration par défaut remplace la règle par défaut et applique la règle personnalisée à sa place. Pour déployer les modifications apportées au **CustomerManagedTags**document : Après avoir apporté des modifications au profil de configuration de personnalisation, vous devez déployer les modifications correspondantes. Pour déployer les nouvelles modifications, AppConfig l'[StartDeployment](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_StartDeployment.html)API doit être exécutée à l'aide de la AWS AppConfig console ou de la CLI. ## Déploiement des modifications de configuration Une fois la personnalisation terminée, ces modifications doivent être déployées via l' AWS AppConfig [ StartDeployment](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_StartDeployment.html)API. Les instructions suivantes indiquent comment effectuer un déploiement à l'aide du AWS CLI. Vous pouvez également utiliser le AWS Management Console pour effectuer ces modifications. Pour plus d'informations, voir [Étape 5 : Déploiement d'une configuration](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-deploying.html). ``` aws appconfig start-deployment --application-id --environment-id --deployment-strategy-id --configuration-profile-id --configuration-version 1 ``` + **ID** de l'application : ID de l'application AMSResource Tagger. Obtenez-le avec l'appel [ ListApplications](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_ListApplications.html)d'API. + **ID d'environnement** : ID d'environnement ; obtenez-le avec l'appel [ ListEnvironments](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_ListEnvironments.html)d'API. + **ID de stratégie** de déploiement : ID de stratégie de déploiement ; obtenez-le avec l'appel [ ListDeploymentStrategies](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_ListDeploymentStrategies.html)d'API. + **ID du profil** de configuration : ID du profil de configuration de CustomerManagedTags ; obtenez-le avec l'appel [ ListConfigurationProfiles](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_ListConfigurationProfiles.html)d'API. + **Version de configuration** : version du profil de configuration que vous souhaitez déployer. **Important** Resource Tagger applique les balises comme indiqué dans les profils de configuration. Toutes les modifications manuelles que vous apportez (avec le AWS Management Console CloudWatch CLI/SDK) aux balises de ressources sont automatiquement annulées. Assurez-vous donc que vos modifications sont définies via Resource Tagger. Pour savoir quelles balises sont créées par le Resource Tagger, recherchez les clés de balise préfixées par. `ams:rt:` Limitez l'accès au déploiement [StartDeployment](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_StartDeployment.html)et aux actions de l'[StopDeployment](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_StopDeployment.html)API aux utilisateurs de confiance qui comprennent les responsabilités et les conséquences du déploiement d'une nouvelle configuration sur vos cibles. Pour en savoir plus sur l'utilisation AWS AppConfig des fonctionnalités pour créer et déployer une configuration, consultez la documentation sur [Travailler avec AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-working.html). ## Configuration de Terraform pour ignorer les balises Resource Tagger Si vous utilisez Terraform pour approvisionner vos ressources et que vous souhaitez utiliser Resource Tagger pour étiqueter vos ressources, les balises Resource Tagger peuvent être identifiées comme dérivées par Terraform. Vous pouvez configurer Terraform pour ignorer toutes les balises Resource Tagger à l'aide du bloc de configuration du **cycle** de vie ou du bloc de configuration global **ignore\$1tags**. [Pour plus d'informations, consultez la documentation Terraform sur le balisage des ressources lors du balisage des ressources.](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/guides/resource-tagging) L'exemple suivant montre comment créer une configuration globale pour ignorer toutes les balises commençant par le préfixe `ams:rt:` de balise Resource Tagger : ``` provider "aws" { # ... potentially other configuration ... ignore_tags { key_prefixes = ["ams:rt:"] } } ``` ## Afficher le nombre de ressources gérées par Resource Tagger Resource Tagger envoie des métriques toutes les heures à Amazon CloudWatch, dans l'espace de `AMS/ResourceTagger` noms. Les métriques sont émises uniquement pour les types de ressources pris en charge par Resource Tagger. | Nom de la métrique | Dimensions | Description | | --- | --- | --- | | ResourceCount | Composant, ResourceType | Nombre de ressources (du type de ressource spécifié) déployées dans cette région. Unités : nombre | | ResourcesMissingManagedTags | Composant, ResourceType | Nombre de ressources (du type de ressource spécifié) qui nécessitent des balises gérées, selon les profils de configuration, mais qui n'ont pas encore été étiquetées par Resource Tagger. Unités : nombre | | UnmanagedResources | Composant, ResourceType | Nombre de ressources (du type de ressource spécifié) auxquelles aucune balise gérée n'est appliquée par Resource Tagger. Généralement, ces ressources ne correspondent à aucun bloc de configuration Resource Tagger ou sont explicitement exclues des blocs de configuration. Unités : nombre | | MatchingResourceCount | Composant ResourceType, ConfigClauseName | Nombre de ressources (du type de ressource spécifié) correspondant au bloc de configuration Resource Tagger. Pour qu'une ressource corresponde au bloc de configuration, le bloc doit être activé et la ressource doit correspondre au filtre du bloc. Unités : nombre | Ces statistiques sont également consultables sous forme de graphiques, dans le tableau de bord **AMS-Resource-Tagger-Reporting-Dashboard**. Pour voir le tableau de bord, depuis la console de CloudWatch gestion Amazon, sélectionnez **AMS-Resource-Tagger-Reporting-Dashboard**. Par défaut, les graphiques de ce tableau de bord affichent les données de la période de 12 heures précédente. AMS Accelerate déploie des CloudWatch alarmes sur votre compte pour détecter les augmentations significatives du nombre de ressources non gérées, par exemple les ressources exclues de la gestion par AMS Resource Tagger. AMS Operations étudiera les augmentations des ressources non gérées qui dépassent : soit trois ressources du même type, soit une augmentation de 50 % par rapport à toutes les ressources du même type. Si le changement ne semble pas être délibéré, AMS Operations peut vous contacter pour examiner le changement. # Utilisation CloudFormation pour créer des balises pour AMS Accelerate CloudFormation Vous pouvez les utiliser CloudFormation pour appliquer des balises au niveau de la pile (voir CloudFormation la documentation, [balise de ressource](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html)) ou au niveau des ressources individuelles (par exemple, voir [Marquage de vos EC2 ressources Amazon](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html)). **Important** Certains composants du service AMS Accelerate nécessitent des balises avec le **préfixe ams:rt :**. Resource Tagger pense être propriétaire de ces balises et les supprimera si aucune règle de configuration de Resource Tagger ne les autorise. Vous devez toujours déployer un profil de configuration Resource Tagger pour ces balises, même si vous utilisez CloudFormation Terraform. # CloudFormation Cas d'utilisation d'AMS Accelerate Cas d’utilisation Cette section répertorie les actions fréquemment effectuées avec CloudFormation. **Topics** + [ # Marquer une EC2 instance avec CloudFormation for Accelerate ](acc-tag-cf-ex-tag-ec2.md) + [ # Marquer un AutoScaling groupe (ASG) avec CloudFormation for Accelerate ](acc-tag-cf-ex-tag-asg.md) + [ # Déploiement d'un profil de configuration avec CloudFormation for Accelerate ](acc-tag-cf-ex-deploy-config.md) # Marquer une EC2 instance avec CloudFormation for Accelerate Tag EC2 Voici un exemple de la façon dont vous pouvez appliquer la balise **ams:rt:ams-managed** avec la valeur true **à** une instance Amazon gérée par. EC2 CloudFormation La balise **ams:rt:ams-managed** vous permet de faire surveiller vos ressources par AMS Accelerate. ``` Type: AWS::EC2::Instance Properties: InstanceType: "t3.micro" # ...other properties... Tags: - Key: "ams:rt:ams-managed" Value: "true" ``` # Marquer un AutoScaling groupe (ASG) avec CloudFormation for Accelerate Mots-clés ASG Voici un exemple de la façon dont vous pouvez appliquer la balise **ams:rt:ams-managed** avec la valeur true à **un** groupe Auto Scaling géré par. CloudFormation Notez que le groupe Auto Scaling propagera ses balises aux EC2 instances Amazon qu'il a créées. La balise **ams:rt:ams-managed** vous permet de faire surveiller vos ressources par AMS Accelerate. ``` Type: AWS::AutoScaling::AutoScalingGroup Properties: AutoScalingGroupName: "SampleASG" # ...other properties... Tags: - Key: "ams:rt:ams-managed" Value: "true" ``` # Déploiement d'un profil de configuration avec CloudFormation for Accelerate Déployer le profil de configuration Si vous souhaitez déployer votre profil de `CustomerManagedTags` configuration à l'aide des modèles suivants CloudFormation, vous pouvez utiliser les CloudFormation modèles suivants. Entrez la configuration JSON souhaitée dans le `AMSResourceTaggerConfigurationVersion.Content` champ. Lorsque vous déployez les modèles dans une CloudFormation pile ou un ensemble de piles, le déploiement de la `AMSResourceTaggerDeployment ` ressource échoue si vous n'avez pas suivi le format JSON requis pour la configuration. Voir [Syntaxe et structure](acc-tag-tools-profiles.md#acc-rt-config-doc-format) pour plus de détails sur le format attendu. Pour obtenir de l'aide sur le déploiement de ces modèles sous forme de CloudFormation pile ou d'ensemble de piles, consultez la AWS CloudFormation documentation correspondante ci-dessous : + [Création d'une pile sur la AWS CloudFormation console](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html) + [Création d'une pile avec AWS CLI](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-cli-creating-stack.html) + [Création d'un ensemble de piles](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-getting-started-create.html) **Note** Si vous déployez une version de configuration à l'aide de l'un de ces modèles, puis que vous supprimez ensuite l'ensemble CloudFormation de piles ou de piles, la version de configuration du modèle restera la version actuellement déployée et aucun déploiement supplémentaire ne sera effectué. Si vous souhaitez revenir à une configuration par défaut, vous devez soit déployer manuellement une configuration vide (c'est-à-dire simplement`{}`), soit mettre à jour votre pile avec une configuration vide, plutôt que de supprimer la pile. **JSON** ``` { "Description": "Custom configuration for the AMS Resource Tagger.", "Resources": { "AMSResourceTaggerConfigurationVersion": { "Type": "AWS::AppConfig::HostedConfigurationVersion", "Properties": { "ApplicationId": { "Fn::ImportValue": "AMS-ResourceTagger-Configuration-ApplicationId" }, "ConfigurationProfileId": { "Fn::ImportValue": "AMS-ResourceTagger-Configuration-CustomerManagedTags-ProfileID" }, "Content": "{\"Options\": {\"ReadOnly\": false}}", "ContentType": "application/json" } }, "AMSResourceTaggerDeployment": { "Type": "AWS::AppConfig::Deployment", "Properties": { "ApplicationId": { "Fn::ImportValue": "AMS-ResourceTagger-Configuration-ApplicationId" }, "ConfigurationProfileId": { "Fn::ImportValue": "AMS-ResourceTagger-Configuration-CustomerManagedTags-ProfileID" }, "ConfigurationVersion": { "Ref": "AMSResourceTaggerConfigurationVersion" }, "DeploymentStrategyId": { "Fn::ImportValue": "AMS-ResourceTagger-Configuration-Deployment-StrategyID" }, "EnvironmentId": { "Fn::ImportValue": "AMS-ResourceTagger-Configuration-EnvironmentId" } } } } } ``` **YAML** ``` Description: Custom configuration for the AMS Resource Tagger. Resources: AMSResourceTaggerConfigurationVersion: Type: AWS::AppConfig::HostedConfigurationVersion Properties: ApplicationId: !ImportValue AMS-ResourceTagger-Configuration-ApplicationId ConfigurationProfileId: !ImportValue AMS-ResourceTagger-Configuration-CustomerManagedTags-ProfileID Content: | { "Options": { "ReadOnly": false } } ContentType: application/json AMSResourceTaggerDeployment: Type: AWS::AppConfig::Deployment Properties: ApplicationId: !ImportValue AMS-ResourceTagger-Configuration-ApplicationId ConfigurationProfileId: !ImportValue AMS-ResourceTagger-Configuration-CustomerManagedTags-ProfileID ConfigurationVersion: !Ref AMSResourceTaggerConfigurationVersion DeploymentStrategyId: !ImportValue AMS-ResourceTagger-Configuration-Deployment-StrategyID EnvironmentId: !ImportValue AMS-ResourceTagger-Configuration-EnvironmentId ``` # Utiliser Terraform pour créer des balises pour AMS Accelerate Terraform Si vous ne souhaitez pas utiliser AMS Accelerate Resource Tagger, vous pouvez appliquer vos propres balises à l'aide de Terraform. Toutefois, si vous ne souhaitez pas utiliser le Resource Tagger en raison de sa dérive par rapport à vos définitions Terraform, il existe un moyen d'utiliser le Resource Tagger et d'ignorer la dérive qu'il provoque ; voir. [Configuration de Terraform pour ignorer les balises Resource Tagger](acc-rt-using.md#acc-rt-ignore-tags) **Important** Certains composants du service AMS Accelerate nécessitent des balises avec le **préfixe ams:rt :**. Resource Tagger pense être propriétaire de ces balises et les supprime si aucune règle de configuration de Resource Tagger ne les autorise. Vous devez déployer un profil de configuration Resource Tagger pour ces balises, même si vous utilisez CloudFormation Terraform. Voici un exemple de la manière dont vous pouvez appliquer la balise **ams:rt:ams-managed avec la valeur true **à** une instance Amazon gérée par** Terraform. EC2 La balise **ams:rt:ams-managed** vous permet de faire surveiller vos ressources par AMS Accelerate. ``` resource "aws_instance" "sample_linux_instance" { # ...ami and other properties... instance_type = "t3.micro" tags = { "ams:rt:ams-managed" = "true" } } ``` Voici un exemple de la façon dont vous pouvez appliquer la balise **ams:rt:ams-managed avec la valeur true à **un** groupe Auto Scaling géré par** Terraform. Notez que le groupe Auto Scaling propage ses balises aux EC2 instances Amazon qu'il a créées. La balise **ams:rt:ams-managed** vous permet de faire surveiller vos ressources par AMS Accelerate. ``` resource "aws_autoscaling_group" "sample_asg" { # ...other properties... name = "terraform-sample" tags = { "ams:rt:ams-managed" = "true" } } ``` Pour une description de la gestion des balises de ressources créées par Terraform, consultez. [Configuration de Terraform pour ignorer les balises Resource Tagger](acc-rt-using.md#acc-rt-ignore-tags)