É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 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 ouAPI.

Vous pouvez appliquer des balises aux ressources à l'aide de la console X-Ray API AWS CLI,,SDKs, 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 pas modifier ou 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 https://console.aws.amazon.com/xray/chez vous.

  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 https://console.aws.amazon.com/xray/chez vous.

  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 de 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 https://console.aws.amazon.com/xray/chez vous.

  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 https://console.aws.amazon.com/xray/chez vous.

  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 de 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 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 existant ou d'une règle d'échantillonnage, utilisez la AWS X-Ray console ou le TagResourceou UntagResourceAPIs.

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 avec le nom de votre groupe, mydomain.com avec le point de terminaison de votre service, key_name avec une clé de balise, et éventuellement, value avec une valeur de balise. Pour plus d'informations sur la création d'un groupe, consultezGroups.

    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 avec une clé de balise, et éventuellement, value avec une valeur de balise. Cette commande spécifie les valeurs du --sampling-rule paramètre sous forme de JSON fichier. Pour plus d'informations sur la création d'une règle d'échantillonnage, consultezRègles d'échantillonnage.

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

    Le contenu du JSON fichier est le suivant : file_name.json qui est spécifié par le --cli-input-json paramètre.

    {
    "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 ARN remplaçant le par le 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"}]

Répertorier 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 ARN remplaçant le par le 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 les balises d'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 ARN remplaçant le par le 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.