Étiquetage des règles et des groupes d'échantillonnage aux rayons X - AWS X-Ray
Restrictions liées aux étiquettesGestion des tags dans la consoleGestion des balises dans le AWS CLIContrôlez l'accès aux ressources X-Ray en fonction des balises

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.

Étiquetage des règles et des groupes d'échantillonnage aux rayons X

Les balises sont des mots ou des phrases que vous pouvez utiliser pour identifier et organiser vos AWS ressources. Vous pouvez ajouter plusieurs balises à chaque ressource. Chaque balise inclut une clé et une valeur facultative que vous définissez. Par exemple, une clé de balise peut êtredomain, et la valeur de la balise peut êtreexample.com. Vous pouvez rechercher et filtrer vos ressources en fonction des balises que vous ajoutez. Pour plus d'informations sur les méthodes d'utilisation des balises, consultez la section AWS Ressources de balisage dans le manuel de référence AWS général.

Vous pouvez utiliser des balises pour appliquer des autorisations basées sur des balises aux CloudFront distributions. Pour plus d'informations, consultez la section Contrôle de l'accès aux AWS ressources à l'aide de balises de ressources.

Note

Tag Editor et AWS Resource Groups ne prennent actuellement pas en charge les ressources X-Ray. Vous pouvez ajouter et gérer des balises à l'aide de la AWS X-Ray console ou de l'API.

Vous pouvez appliquer des balises aux ressources à l'aide de la console X-Ray, de l'API AWS CLI, des SDK et AWS Tools for Windows PowerShell. Pour plus d’informations, consultez la documentation de suivante :

Note

Si vous ne pouvez pas ajouter ou modifier des balises sur une ressource X-Ray, ou si vous ne pouvez pas ajouter une ressource dotée de balises spécifiques, vous n'êtes peut-être pas autorisé à effectuer cette opération. Pour demander l'accès, contactez un AWS utilisateur de votre entreprise qui possède des autorisations d'administrateur dans X-Ray.

Restrictions liées aux étiquettes

Les restrictions suivantes s'appliquent aux balises :

  • Nombre maximal de balises par ressource – 50

  • Longueur de clé maximale – 128 caractères Unicode

  • Longueur de valeur maximale – 256 caractères Unicode

  • Caractères acceptés pour les clés et valeurs – a-z, A-Z, 0-9, espace et les caractères suivants : _ . : / = + - and @

  • Les clés et valeurs de balise sont sensibles à la casse.

  • Ne l'utilisez pas aws: comme préfixe pour les clés ; il est réservé à l' AWS usage.

Note

Vous ne pouvez ni modifier ni supprimer les balises système.

Gestion des tags dans la console

Vous pouvez ajouter des balises facultatives lorsque vous créez un groupe X-Ray ou une règle d'échantillonnage. Les balises peuvent également être modifiées ou supprimées ultérieurement dans la console.

Les procédures suivantes expliquent comment ajouter, modifier et supprimer des balises pour vos groupes et des règles d'échantillonnage dans la console X-Ray.

Ajouter des tags à un nouveau groupe (console)

Lorsque vous créez un nouveau groupe X-Ray, vous pouvez ajouter des balises facultatives sur la page Create group.

  1. Connectez-vous à la console X-Ray AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/xray/home.

  2. Dans le volet de navigation, développez Configuration, puis choisissez Groups.

  3. Choisissez Créer un groupe.

  4. Sur la page Créer un groupe, spécifiez un nom et une expression de filtre pour le groupe. Pour de plus amples informations sur ces propriétés, veuillez consulter Configuration des groupes.

  5. Dans Balises, entrez une clé de balise et, éventuellement, une valeur de balise. Par exemple, vous pouvez entrer une clé de Stage balise et une valeur de balise de Production pour indiquer que ce groupe est destiné à une utilisation en production. Lorsque vous ajoutez un tag, une nouvelle ligne apparaît pour vous permettre d'ajouter un autre tag, si nécessaire. Consultez Restrictions liées aux étiquettes cette rubrique pour connaître les restrictions relatives aux balises.

  6. Lorsque vous avez terminé d'ajouter des balises, choisissez Create group.

Ajouter des balises à une nouvelle règle d'échantillonnage (console)

Lorsque vous créez une nouvelle règle d'échantillonnage X-Ray, vous pouvez ajouter des balises sur la page Créer une règle d'échantillonnage.

  1. Connectez-vous à la console X-Ray AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/xray/home.

  2. Dans le volet de navigation, développez Configuration, puis choisissez Sampling.

  3. Choisissez Créer une règle d'échantillonnage.

  4. Sur la page Créer une règle d'échantillonnage, spécifiez un nom, une priorité, des limites, des critères de correspondance et des attributs correspondants. Pour de plus amples informations sur ces propriétés, veuillez consulter Configuration des règles d'échantillonnage.

  5. Dans Balises, entrez une clé de balise et, éventuellement, une valeur de balise. Par exemple, vous pouvez entrer une clé de Stage balise et une valeur de balise de Production pour indiquer que cette règle d'échantillonnage est destinée à une utilisation en production. Lorsque vous ajoutez un tag, une nouvelle ligne apparaît pour vous permettre d'ajouter un autre tag, si nécessaire. Consultez Restrictions liées aux étiquettes cette rubrique pour connaître les restrictions relatives aux balises.

  6. Lorsque vous avez terminé d'ajouter des balises, choisissez Créer une règle d'échantillonnage.

Modifier ou supprimer les balises d'un groupe (console)

Vous pouvez modifier ou supprimer les balises d'un groupe X-Ray sur la page Modifier le groupe.

  1. Connectez-vous à la console X-Ray AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/xray/home.

  2. Dans le volet de navigation, développez Configuration, puis choisissez Groups.

  3. Dans le tableau Groupes, choisissez le nom d'un groupe.

  4. Sur la page Modifier le groupe, dans Balises, modifiez les clés et les valeurs des balises. Vous ne pouvez pas avoir de clés de tag dupliquées. Les valeurs des balises sont facultatives ; vous pouvez supprimer des valeurs si vous le souhaitez. Pour plus d'informations sur les autres propriétés sur la page Modifier un groupe, consultezConfiguration des groupes. Consultez Restrictions liées aux étiquettes cette rubrique pour connaître les restrictions relatives aux balises.

  5. Pour supprimer un tag, choisissez X à droite du tag.

  6. Lorsque vous avez terminé de modifier ou de supprimer des balises, choisissez Mettre à jour le groupe.

Modifier ou supprimer des balises pour une règle d'échantillonnage (console)

Vous pouvez modifier ou supprimer les balises d'une règle d'échantillonnage X-Ray sur la page Modifier la règle d'échantillonnage.

  1. Connectez-vous à la console X-Ray AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/xray/home.

  2. Dans le volet de navigation, développez Configuration, puis choisissez Sampling.

  3. Dans le tableau Règles d'échantillonnage, choisissez le nom d'une règle d'échantillonnage.

  4. Dans Balises, modifiez les clés et les valeurs des balises. Vous ne pouvez pas avoir de clés de tag dupliquées. Les valeurs des balises sont facultatives ; vous pouvez supprimer des valeurs si vous le souhaitez. Pour plus d'informations sur les autres propriétés sur la page Modifier la règle d'échantillonnage, consultezConfiguration des règles d'échantillonnage. Consultez Restrictions liées aux étiquettes cette rubrique pour connaître les restrictions relatives aux balises.

  5. Pour supprimer un tag, choisissez X à droite du tag.

  6. Lorsque vous avez terminé de modifier ou de supprimer des balises, choisissez Mettre à jour la règle d'échantillonnage.

Gestion des balises dans le AWS CLI

Vous pouvez ajouter des balises lorsque vous créez un groupe X-Ray ou une règle d'échantillonnage. Vous pouvez également utiliser le AWS CLI pour créer et gérer des balises. Pour mettre à jour les balises d'un groupe ou d'une règle d'échantillonnage existant, utilisez la AWS X-Ray console TagResourceou les UntagResourceAPI or.

Ajouter des balises à un nouveau groupe X-Ray ou à une nouvelle règle d'échantillonnage (CLI)

Pour ajouter des balises facultatives lors de la création d'un nouveau groupe X-Ray ou d'une nouvelle règle d'échantillonnage, utilisez l'une des commandes suivantes.

  • Pour ajouter des balises à un nouveau groupe, exécutez la commande suivante en remplaçant group_name par le nom de votre groupe, mydomain.com par le point de terminaison de votre service, key_name par une clé de balise et, éventuellement, value par une valeur de balise. Pour plus d'informations sur la création d'un groupe, consultezConfiguration des paramètres d'échantillonnage, de groupes et de chiffrement avec l'API X-Ray.

    aws xray create-group \
   --group-name "group_name" \
   --filter-expression "service(\"mydomain.com\") {fault OR error}" \
   --tags [{"Key": "key_name","Value": "value"},{"Key": "key_name","Value": "value"}]

    Voici un exemple.

    aws xray create-group \
   --group-name "AdminGroup" \
   --filter-expression "service(\"mydomain.com\") {fault OR error}" \
   --tags [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]

  • Pour ajouter des balises à une nouvelle règle d'échantillonnage, exécutez la commande suivante en remplaçant key_name par une clé de balise, et éventuellement value par une valeur de balise. Cette commande spécifie les valeurs du --sampling-rule paramètre sous forme de fichier JSON. Pour plus d'informations sur la création d'une règle d'échantillonnage, consultezConfiguration des paramètres d'échantillonnage, de groupes et de chiffrement avec l'API X-Ray.

    aws xray create-sampling-rule \
   --cli-input-json file://file_name.json

    Voici le contenu du fichier JSON file_name.json spécifié par le paramètre. --cli-input-json

    {
    "SamplingRule": {
        "RuleName": "rule_name",
        "RuleARN": "string",
        "ResourceARN": "string",
        "Priority": integer,
        "FixedRate": double,
        "ReservoirSize": integer,
        "ServiceName": "string",
        "ServiceType": "string",
        "Host": "string",
        "HTTPMethod": "string",
        "URLPath": "string",
        "Version": integer,
        "Attributes": {"attribute_name": "value","attribute_name": "value"...}
    }
    "Tags": [
           {
               "Key":"key_name",
               "Value":"value"
           },
           {
               "Key":"key_name",
               "Value":"value"
           }
          ]
}

    Voici un exemple de commande.

    aws xray create-sampling-rule \
   --cli-input-json file://9000-base-scorekeep.json

    Le contenu du 9000-base-scorekeep.json fichier d'exemple spécifié par le --cli-input-json paramètre est le suivant.

    {
    "SamplingRule": {
        "RuleName": "base-scorekeep",
        "ResourceARN": "*",
        "Priority": 9000,
        "FixedRate": 0.1,
        "ReservoirSize": 5,
        "ServiceName": "Scorekeep",
        "ServiceType": "*",
        "Host": "*",
        "HTTPMethod": "*",
        "URLPath": "*",
        "Version": 1
    }
    "Tags": [
           {
               "Key":"Stage",
               "Value":"Prod"
           },
           {
               "Key":"Department",
               "Value":"QA"
           }
          ]
}

Ajouter des balises à une ressource existante (CLI)

Vous pouvez exécuter la tag-resource commande pour ajouter des balises à un groupe X-Ray existant ou à une règle d'échantillonnage. Cette méthode peut être plus simple que d'ajouter des balises en exécutant update-group ouupdate-sampling-rule.

Pour ajouter des balises à un groupe ou à une règle d'échantillonnage, exécutez la commande suivante en remplaçant l'ARN par l'ARN de la ressource et en spécifiant les clés et les valeurs facultatives des balises que vous souhaitez ajouter.

aws xray tag-resource \
   --resource-arn "ARN" \
   --tag-keys [{"Key":"key_name","Value":"value"}, {"Key":"key_name","Value":"value"}]

Voici un exemple.

aws xray tag-resource \
   --resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup" \
   --tag-keys [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]

Lister les balises d'une ressource (CLI)

Vous pouvez exécuter la list-tags-for-resource commande pour répertorier les balises d'un groupe X-Ray ou d'une règle d'échantillonnage.

Pour répertorier les balises associées à un groupe ou à une règle d'échantillonnage, exécutez la commande suivante en remplaçant l'ARN par l'ARN de la ressource.

aws xray list-tags-for-resource \
   --resource-arn "ARN"

Voici un exemple.

aws xray list-tags-for-resource \
   --resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup"

Supprimer des balises sur une ressource (CLI)

Vous pouvez exécuter la untag-resource commande pour supprimer des balises d'un groupe X-Ray ou d'une règle d'échantillonnage.

Pour supprimer des balises d'un groupe ou d'une règle d'échantillonnage, exécutez la commande suivante en remplaçant l'ARN par l'ARN de la ressource et en spécifiant les clés des balises que vous souhaitez supprimer.

Vous ne pouvez supprimer que des balises entières à l'aide de la untag-resource commande. Pour supprimer des valeurs de balises, utilisez la console X-Ray ou supprimez des balises et ajoutez de nouvelles balises avec les mêmes clés, mais des valeurs différentes ou vides.

aws xray untag-resource \
   --resource-arn "ARN" \
   --tag-keys ["key_name","key_name"]

Voici un exemple.

aws xray untag-resource \
   --resource-arn "arn:aws:xray:us-east-2:01234567890:group/group_name" \
   --tag-keys ["Stage","Department"]

Contrôlez l'accès aux ressources X-Ray en fonction des balises

Vous pouvez associer des tags à des groupes X-Ray ou à des règles d'échantillonnage, ou transmettre des tags dans une demande à X-Ray. Pour contrôler l’accès basé sur des étiquettes, vous devez fournir les informations d’étiquette dans l’élément de condition d’une politique utilisant les clés de condition xray:ResourceTag/key-name, aws:RequestTag/key-name ou aws:TagKeys. Pour en savoir plus sur ces clés de condition, consultez la section Contrôle de l'accès aux AWS ressources à l'aide de balises de ressources.

Pour visualiser un exemple de politique basée sur l'identité permettant de limiter l'accès à une ressource en fonction des balises de cette ressource, consultez Gestion de l'accès aux groupes X-Ray et des règles d'échantillonnage en fonction des balises.