Agregar etiquetas a los recursos de Amazon Pinpoint mediante programación

En los ejemplos siguientes se muestra cómo agregar una etiqueta a un recurso de Amazon Pinpoint mediante la AWS CLI y la API de REST de Amazon Pinpoint. También puedes usar cualquier AWS SDK compatible para añadir una etiqueta a un recurso.

Para añadir una etiqueta a varios recursos de Amazon Pinpoint en una sola operación, utilice las operaciones de etiquetado de grupos de recursos de la API de etiquetado AWS CLI o la AWS Resource Groups API de etiquetado.

Agregar etiquetas mediante la API

Para crear un recurso nuevo y agregarle una etiqueta mediante la API de REST de Amazon Pinpoint, envíe una solicitud POST al URI de recurso apropiado. En el cuerpo de la solicitud, incluya el parámetro tags y los valores. En el siguiente ejemplo se muestra cómo especificar una etiqueta al crear un nuevo proyecto.

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"
   }
}

Para agregar una etiqueta a un recurso existente, envíe una solicitud POST al URI de Etiquetas. Incluya el nombre de recurso de Amazon (ARN) del recurso en el URI. El ARN debe estar codificado en la URL. En el cuerpo de la solicitud, incluya el parámetro tags y los valores, tal y como se muestra en el siguiente ejemplo.

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"
   }
}

Añada etiquetas mediante la AWS CLI

Para crear un nuevo recurso y añadirle una etiqueta mediante el AWS CLI, utilice el create comando correspondiente al recurso. Incluya el parámetro tags y los valores. En el siguiente ejemplo se muestra cómo especificar etiquetas al crear un nuevo proyecto.

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

En el ejemplo anterior, realice el siguiente procedimiento:

Para obtener información acerca de los comandos que puede usar para crear un recurso de Amazon Pinpoint, consulte la Referencia de comandos de la AWS CLI.

Para agregar una etiqueta a un recurso existente, utilice el comando tag-resource y especifique los valores adecuados para los parámetros requeridos:

$ aws pinpoint tag-resource \
  --resource-arn resource-arn \
  --tags-model '{
    "tags": {
      "key1":"value1",
      "key2":"value2"
    }
  }'

En el ejemplo anterior, realice el siguiente procedimiento: