**Avis de fin de support :** le 30 octobre 2026, le support d'Amazon Pinpoint AWS prendra fin. Après le 30 octobre 2026, vous ne pourrez plus accéder à la console Amazon Pinpoint ni aux ressources Amazon Pinpoint (points de terminaison, segments, campagnes, parcours et analytique). Pour plus d’informations, consultez [Fin de la prise en charge d’Amazon Pinpoint](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Remarque :** en ce qui APIs concerne les SMS, la voix, le push mobile, l'OTP et la validation des numéros de téléphone ne sont pas concernés par cette modification et sont pris en charge par AWS la messagerie utilisateur final. 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. # Gérer les balises de ressources Amazon Pinpoint Une *balise* est une étiquette que vous pouvez éventuellement définir et associer à AWS des ressources, notamment à certains types de ressources Amazon Pinpoint. Les balises peuvent vous aider à classer et à gérer ces types de ressources de différentes façons, notamment par objectif, par propriétaire, par environnement ou selon d'autres critères. Par exemple, vous pouvez utiliser des balises pour appliquer des stratégies ou une automatisation, ou pour identifier les ressources qui sont soumises à certaines exigences en matière de conformité. Vous pouvez ajouter des balises aux types de ressources Amazon Pinpoint suivants : + Campagnes + Modèles de messages + Projets (applications) + Segments Une ressource peut avoir jusqu'à 50 balises. Chaque balise est constituée d'une *clé de balise* obligatoire et d'une *valeur de balise* facultative que vous définissez. Une *clé de balise* est une étiquette générale qui fait office de catégorie pour des valeurs de balise plus spécifiques. Une *valeur de balise* tient lieu de descripteur pour une clé de balise. Une clé de balise peut contenir jusqu'à 128 caractères. Une valeur de balise peut contenir jusqu'à 256 caractères. Les caractères peuvent être des lettres Unicode, des chiffres un espace ou l'une des symboles suivants : \$1 . : / = \$1 -. Les restrictions supplémentaires suivantes s'appliquent aux balises : + Les clés et les valeurs des balises distinguent les majuscules et minuscules. + Pour chaque ressource associée, chaque clé de balise doit être unique et ne peut avoir qu'une seule valeur. + Le `aws:` préfixe est réservé à l'usage de AWS ; vous ne pouvez pas l'utiliser dans les clés de balise ou les valeurs que vous définissez. De plus, vous ne pouvez pas modifier ou supprimer des noms ou des valeurs de balise ayant ce préfixe. Les balises qui utilisent ce préfixe ne sont pas comptabilisées dans le quota de 50 balises par ressource. + Vous ne pouvez pas mettre à jour ou supprimer une ressource uniquement en fonction de ses balises. Vous devez également spécifier l'Amazon Resource Name (ARN) ou l'ID de ressource selon l'opération que vous utilisez. + Vous pouvez associer des balises à des ressources publiques ou partagées. Toutefois, les balises ne sont disponibles que pour votre AWS compte, et non pour les autres comptes partageant la ressource. En outre, les balises ne sont disponibles que pour les ressources situées dans la AWS région spécifiée pour votre AWS compte. Pour ajouter, afficher, mettre à jour et supprimer des clés et des valeurs de balise dans les ressources Amazon Pinpoint, vous pouvez utiliser le AWS Command Line Interface (AWS CLI), l'API Amazon Pinpoint, Groupes de ressources AWS l'API de balisage ou un SDK. AWS Pour gérer les clés de balise et les valeurs de toutes les AWS ressources situées dans une AWS région spécifique pour votre AWS compte (y compris les ressources Amazon Pinpoint), utilisez l'API de [Groupes de ressources AWS balisage](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html). Pour plus d'informations sur les commandes de l'interface de ligne de commande que vous pouvez utiliser pour gérer les ressources Amazon Pinpoint, consultez la section Amazon Pinpoint du document [Référence de commande AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/). Pour plus d'informations sur les ressources de l'API Amazon Pinpoint, y compris sur les méthodes HTTP(S), les paramètres et les schémas pris en charge, consultez la [Référence de l'API Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/). # Utiliser les balises Amazon Pinpoint dans les politiques IAM et les opérations d'API Une fois que vous avez commencé à implémenter des balises, vous pouvez appliquer des autorisations basées sur des balises au niveau des ressources aux politiques Gestion des identités et des accès AWS (IAM) et aux opérations d'API. Cela inclut les opérations qui prennent en charge l'ajout de balises aux ressources lors de la création de ressources. En utilisant les balises de cette manière, vous pouvez contrôler de manière précise quels groupes et utilisateurs de votre AWS compte sont autorisés à créer et à étiqueter des ressources, et quels groupes et utilisateurs sont autorisés à créer, mettre à jour et supprimer des balises de manière plus générale. Par exemple, vous pouvez créer une stratégie qui permet à un utilisateur d'avoir un accès complet à toutes les ressources Amazon Pinpoint dont le nom est une valeur dans la balise `Owner` de la ressource : ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "ModifyResourceIfOwner", "Effect": "Allow", "Action": "mobiletargeting:*", "Resource": "*", "Condition": { "StringEqualsIgnoreCase": { "aws:ResourceTag/Owner": "${aws:username}" } } } ] } ``` ------ Si vous définissez des autorisations au niveau des ressources basées sur des balises, les autorisations prennent effet immédiatement. Vos ressources sont ainsi plus sécurisées dès leur création et vous pouvez rapidement commencer à appliquer l'utilisation des balises pour les nouvelles ressources. Vous pouvez également utiliser des autorisations au niveau des ressources afin de contrôler les clés et les valeurs de balise qui peuvent être associés à des ressources nouvelles et existantes. Pour plus d'informations, consultez [Contrôle de l'accès à l'aide de balises](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) dans le *Guide de l'utilisateur AWS IAM*. # Ajoutez des balises aux ressources Amazon Pinpoint par programmation Les exemples suivants montrent comment ajouter une balise à une ressource Amazon Pinpoint à l'aide de l'[AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) et de [l'API REST Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/). Vous pouvez également utiliser n'importe quel AWS SDK compatible pour ajouter une balise à une ressource. [Pour ajouter une balise à plusieurs ressources Amazon Pinpoint en une seule opération, utilisez les opérations de balisage des groupes de ressources de l'API AWS CLI ou de l'API de balisage.Groupes de ressources AWS](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html) ## Ajoutez des balises à l'aide de l'API Pour créer une nouvelle ressource et y ajouter une balise à l'aide de l'API REST d'Amazon Pinpoint, envoyez une requête POST à l'URI de ressource approprié. Dans le corps de la demande, incluez le paramètre et les valeurs `tags`. L'exemple suivant montre comment définir une balise lorsque vous créez un nouveau projet. ``` POST /v1/apps HTTP/1.1 Host: pinpoint.us-east-1.amazonaws.com Content-Type: application/x-www-form-urlencoded Accept: application/json Cache-Control: no-cache { "Name":"MyProject", "tags":{ "key1":"value1" } } ``` Pour ajouter une balise à une ressource existante, envoyez une requête POST à l'URI [Tags](https://docs.aws.amazon.com/pinpoint/latest/apireference/tags-resource-arn.html). Incluez l'ARN (Amazon Resource Name) de la ressource dans l'URI. L'ARN doit être codé par URL. Dans le corps de la requête, incluez le paramètre et les valeurs `tags`, comme indiqué dans l'exemple suivant. ``` POST /v1/tags/resource-arn HTTP/1.1 Host: pinpoint.us-east-1.amazonaws.com Content-Type: application/json Accept: application/json Cache-Control: no-cache { "tags":{ "key1":"value1" } } ``` ## Ajoutez des balises à l'aide du AWS CLI Pour créer une nouvelle ressource et y ajouter une étiquette à l'aide de AWS CLI, utilisez la `create` commande appropriée pour la ressource. Incluez le paramètre et les valeurs `tags`. L'exemple suivant montre comment définir des balises lorsque vous créez un nouveau projet. ------ #### [ Linux, macOS, or Unix ] ``` $ aws pinpoint create-app \ --create-application-request '{ "Name":"MyProject", "tags": { "key1":"value1", "key2":"value2" } }' ``` ------ #### [ Windows Command prompt ] ``` C:\> aws pinpoint create-app ^ --create-application-request Name=MyProject,tags={key1=value1,key2=value2} ``` ------ Dans l'exemple précédent, procédez comme suit : + *MyProject*Remplacez-le par le nom que vous souhaitez attribuer au projet. + Remplacez *key1* et *key2* par les clés des balises que vous souhaitez ajouter à la ressource. + Remplacez *value1* et *value2* par les valeurs des balises que vous souhaitez ajouter pour les clés respectives. Pour plus d'informations sur les commandes que vous pouvez utiliser pour créer une ressource Amazon Pinpoint, consultez [Référence des commandes AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/). Pour ajouter une balise à une ressource existante, utilisez la commande `tag-resource` et spécifiez les valeurs appropriées pour les paramètres requis : ------ #### [ Linux, macOS, or Unix ] ``` $ aws pinpoint tag-resource \ --resource-arn resource-arn \ --tags-model '{ "tags": { "key1":"value1", "key2":"value2" } }' ``` ------ #### [ Windows Command Prompt ] ``` C:\> aws pinpoint tag-resource ^ --resource-arn resource-arn ^ --tags-model tags={key1=value1,key2=value2} ``` ------ Dans l'exemple précédent, procédez comme suit : + *resource-arn*Remplacez-le par le Amazon Resource Name (ARN) de la ressource à laquelle vous souhaitez ajouter une balise. + Remplacez *key1* et *key2* par les clés des balises que vous souhaitez ajouter à la ressource. + Remplacez *value1* et *value2* par les valeurs des balises que vous souhaitez ajouter pour les clés respectives. # Afficher les balises pour les ressources Amazon Pinpoint de manière programmatique Les exemples suivants montrent comment utiliser l'[AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) et [l'API REST Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/) pour afficher une liste de toutes les balises (clés et valeurs) associées à une ressources Amazon Pinpoint. Vous pouvez également utiliser n'importe quel AWS SDK compatible pour afficher les balises associées à une ressource. ## Afficher les tags à l'aide de l'API Pour utiliser l'API REST Amazon Pinpoint afficher toutes les balises qui sont associées à une ressource spécifique, envoyez une demande GET à l'URI [Tags](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-tags.html) en incluant l'Amazon Resource Name (ARN) de la ressource dans l'URI. L'ARN doit être codé par URL. Par exemple, la demande suivante récupère tous les tags associés à une campagne spécifiée (*resource-arn*) : ``` GET /v1/tags/resource-arn HTTP/1.1 Host: pinpoint.us-east-1.amazonaws.com Content-Type: application/json Accept: application/json Cache-Control: no-cache ``` La réponse JSON à la demande inclut un objet `tags`. L’objet `tags` répertorie toutes les clés et valeurs de balise associées à la campagne. Pour afficher toutes les balises qui sont associées à plusieurs ressources du même type, envoyez une demande GET à l'URI approprié pour ce type de ressource. Par exemple, la demande suivante permet de récupérer des informations sur toutes les campagnes du projet spécifié (*application-id*) : ``` GET /v1/apps/application-id/campaigns HTTP/1.1 Host: pinpoint.us-east-1.amazonaws.com Content-Type: application/json Accept: application/json Cache-Control: no-cache ``` La réponse JSON à la demande répertorie toutes les campagnes du projet. L'objet `tags` de chaque campagne répertorie toutes les clés et les valeurs de balise qui sont associées à la campagne. ## Afficher les balises à l'aide du AWS CLI AWS CLI Pour afficher la liste des balises associées à une ressource spécifique, exécutez la `list-tags-for-resource` commande et spécifiez le nom de ressource Amazon (ARN) de la ressource pour le `resource-arn` paramètre, comme indiqué dans l'exemple suivant. ------ #### [ Linux, macOS, or Unix ] ``` $ aws pinpoint list-tags-for-resource \ --resource-arn resource-arn ``` ------ #### [ Windows Command Prompt ] ``` C:\> aws pinpoint list-tags-for-resource ^ --resource-arn resource-arn ``` ------ Pour afficher la liste de toutes les ressources Amazon Pinpoint dotées de balises, ainsi que de toutes les balises associées à chacune de ces ressources, utilisez la commande [get-resources de l'API](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetResources.html) de balisage. Groupes de ressources AWS Définissez le paramètre `resource-type-filters` sur `mobiletargeting`, comme illustré dans l'exemple suivant. ------ #### [ Linux, macOS, or Unix ] ``` $ aws resourcegroupstaggingapi get-resources \ --resource-type-filters "mobiletargeting" ``` ------ #### [ Windows Command Prompt ] ``` C:\> aws resourcegroupstaggingapi get-resources ^ --resource-type-filters "mobiletargeting" ``` ------ Le résultat de la commande est une liste de toutes ARNs les ressources Amazon Pinpoint dotées de balises. La liste inclut toutes les clés et les valeurs de balise qui sont associées à chaque ressource. # Mettre à jour ou remplacer les balises pour les ressources Amazon Pinpoint par programmation Il existe plusieurs façons de mettre à jour (remplacer) une balise pour une ressource Amazon Pinpoint. La meilleure façon de mettre à jour une balise dépend : + Du type de ressource pour lequel vous souhaitez mettre à jour les balises. + Si vous voulez mettre à jour une balise pour une seule ressource ou pour plusieurs ressources en même temps. + De si vous voulez mettre à jour une clé de balise, une valeur de balise, ou les deux. [Pour mettre à jour une balise pour un projet Amazon Pinpoint ou pour plusieurs ressources en même temps, utilisez les opérations de balisage des groupes de ressources de l'API AWS CLI ou de l'API de balisage.Groupes de ressources AWS](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html) L'API Amazon Pinpoint ne fournit actuellement aucune prise en charge directe pour l'une ou l'autre de ces tâches. Pour mettre à jour une balise pour une ressource, vous pouvez [supprimer la balise actuelle](tags-remove.md) et [ajouter une nouvelle balise](tags-add.md) à l'aide de l'API Amazon Pinpoint. # Supprimer les balises des ressources Amazon Pinpoint par programmation Les exemples suivants montrent comment supprimer une balise (la clé et la valeur) d'une ressource Amazon Pinpoint à l'aide de l'[AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) et [l'API REST Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/). Vous pouvez également utiliser n'importe quel AWS SDK compatible pour supprimer une balise d'une ressource. [Pour supprimer une balise de plusieurs ressources Amazon Pinpoint en une seule opération, utilisez les opérations de balisage des groupes de ressources de l'API AWS CLI ou de l'API de balisage.Groupes de ressources AWS](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html) Pour supprimer uniquement une valeur de balise spécifique, pas une clé de balise, d'une ressource, [mettez à jour les balises de la ressource](tags-update.md). ## Supprimer les tags à l'aide de l'API Pour supprimer une balise d'une ressource à l'aide de l'API REST Amazon Pinpoint, envoyez une demande DELETE à l'URI des [balises](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-tags.html). Pour l'URI, incluez l'Amazon Resource Name (ARN) de la ressource dont vous souhaitez supprimer une balise, suivi du paramètre `tagKeys` et de la balise à supprimer. Par exemple : ``` https://endpoint/v1/tags/resource-arn?tagKeys=key ``` Où : + *endpoint*est le point de terminaison Amazon Pinpoint pour la AWS région qui héberge la ressource. + *resource-arn*est l'ARN de la ressource dont vous souhaitez supprimer une balise. + *key*est le tag que vous souhaitez supprimer de la ressource. Tous les paramètres doivent être codés par URL. Pour supprimer plusieurs clés de balises et leurs valeurs associées d'une ressource, ajoutez le paramètre et l'argument `tagKeys` pour chaque balise à supprimer, séparés par une esperluette (&). Par exemple : ``` https://endpoint/v1/tags/resource-arn?tagKeys=key1&tagKeys=key2 ``` Tous les paramètres doivent être codés par URL. ## Supprimez les tags à l'aide du AWS CLI Pour supprimer une balise d'une ressource à l'aide de AWS CLI, exécutez la `untag-resource` commande. Indiquez le paramètre et l'argument `tag-keys`, comme le montre l'exemple suivant. ------ #### [ Linux, macOS, or Unix ] ``` $ aws pinpoint untag-resource \ --resource-arn resource-arn \ --tag-keys key1 key2 ``` ------ #### [ Windows Command Prompt ] ``` C:\> aws pinpoint untag-resource ^ --resource-arn resource-arn ^ --tag-keys key1 key2 ``` ------ Dans l’exemple précédent, apportez les modifications suivantes : + *resource-arn*Remplacez-le par l'ARN de la ressource dont vous souhaitez supprimer les balises. + Remplacez *key1* et *key2* par les clés des balises que vous souhaitez supprimer de la ressource.