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 et de l'API REST Amazon Pinpoint. 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.AWS Resource Groups

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

$ aws pinpoint create-app \
  --create-application-request '{
    "Name":"MyProject",
    "tags": {
      "key1":"value1",
      "key2":"value2"
    } 
  }'

Dans l'exemple précédent, procédez comme suit :

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.

Pour ajouter une balise à une ressource existante, utilisez la commande tag-resource et spécifiez les valeurs appropriées pour les paramètres requis :

$ 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 :