**Aviso de fin de soporte:** el 30 de octubre de 2026, AWS finalizará el soporte para Amazon Pinpoint. Después del 30 de octubre de 2026, ya no podrá acceder a la consola de Amazon Pinpoint ni a los recursos de Amazon Pinpoint (puntos de conexión, segmentos, campañas, recorridos y análisis). Para obtener más información, consulte [Fin de soporte de Amazon Pinpoint](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Nota: en** lo APIs que respecta a los SMS, este cambio no afecta a los mensajes de voz, a las notificaciones push móviles, a las OTP y a la validación de números de teléfono, y son compatibles con la mensajería para el usuario AWS final. Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Administración de etiquetas de recurso de Amazon Pinpoint Una *etiqueta* es una etiqueta que puede definir y asociar de forma opcional a AWS los recursos, incluidos determinados tipos de recursos de Amazon Pinpoint. Las etiquetas pueden ayudarle a clasificar y administrar recursos de distintas formas, como, por finalidad, propietario, entorno u otros criterios. Por ejemplo, puede usar etiquetas para aplicar políticas o automatización, o bien para identificar recursos que están sujetos a determinados requisitos de conformidad. Puede agregar etiquetas a los siguientes tipos de recursos de Amazon Pinpoint: + Campaigns (Campañas) + Plantillas de mensaje + Proyectos (aplicaciones) + Segmentos Un recurso puede tener hasta 50 etiquetas. Cada etiqueta está formada por una *clave de etiqueta* y un *valor de etiqueta* opcional, ambos definidos por el usuario. Un *clave de etiqueta* es una etiqueta general que actúa como una categoría para valores de etiqueta más específicos. Un *valor de etiqueta* actúa como descriptor de una clave de etiqueta. Una clave de etiqueta puede incluir hasta 128 caracteres. Un valor de etiqueta puede incluir hasta 256 caracteres. Los caracteres pueden ser letras Unicode, números, espacios en blanco o uno de los siguientes símbolos: \$1 . : / = \$1 -. Las siguientes restricciones adicionales se aplican a las etiquetas: + Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas. + Para cada recurso asociado, cada clave de etiqueta debe ser única y solo puede tener un valor. + El `aws:` prefijo está reservado para que lo usen AWS; no puede usarlo en ninguna clave de etiqueta o valor que defina. Además, las claves o valores de etiqueta que utilizan este prefijo no se pueden editar ni quitar. Las etiquetas que usan este prefijo no cuentan para la cuota de 50 etiquetas por recurso. + No puede actualizar ni eliminar un recurso en función únicamente de sus etiquetas. También debe especificar el ID de recurso o nombre de recurso de Amazon (ARN), dependiendo de la operación que use. + Puede asociar etiquetas a recursos públicos o compartidos. Sin embargo, las etiquetas solo están disponibles para tu AWS cuenta, no para ninguna otra cuenta que comparta el recurso. Además, las etiquetas solo están disponibles para los recursos que se encuentran en la AWS región especificada para su AWS cuenta. Para añadir, mostrar, actualizar y eliminar claves y valores de etiquetas de los recursos de Amazon Pinpoint, puede utilizar AWS Command Line Interface (AWS CLI), la API de Amazon Pinpoint, Grupos de recursos de AWS la API de etiquetado o un SDK. AWS Para administrar las claves y los valores de las etiquetas en todos los AWS recursos que se encuentran en una AWS región específica de su AWS cuenta (incluidos los recursos de Amazon Pinpoint), utilice la API de [Grupos de recursos de AWS etiquetado](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html). Para obtener más información acerca de los comandos de la CLI que puede usar para administrar recursos de Amazon Pinpoint, consulte la sección de Amazon Pinpoint de la [Referencia de comandos de la AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/). Para obtener más información acerca de los recursos de la API de Amazon Pinpoint, incluidos los esquemas, parámetros y métodos HTTP(S) admitidos, consulte la [Referencia de la API de Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/). # Utilizar etiquetas de Amazon Pinpoint en las políticas de IAM y las operaciones de API Una vez que comience a implementar etiquetas, podrá aplicar permisos basados en etiquetas a nivel de recursos a las políticas AWS Identity and Access Management (IAM) y las operaciones de la API. Esto incluye operaciones que admiten agregar etiquetas a los recursos cuando se crean recursos. Al usar las etiquetas de esta manera, puede implementar un control pormenorizado sobre qué grupos y usuarios de su AWS cuenta tienen permiso para crear y etiquetar recursos, y qué grupos y usuarios tienen permiso para crear, actualizar y eliminar etiquetas de manera más general. Por ejemplo, puede crear una política que permita a un usuario tener acceso completo a todos los recursos de Amazon Pinpoint en los que su nombre sea un valor en la etiqueta `Owner` del recurso: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "ModifyResourceIfOwner", "Effect": "Allow", "Action": "mobiletargeting:*", "Resource": "*", "Condition": { "StringEqualsIgnoreCase": { "aws:ResourceTag/Owner": "${aws:username}" } } } ] } ``` ------ Si define los permisos de nivel de recurso basados en etiquetas, estos entrarán en vigor inmediatamente. Esto significa que sus recursos están más seguros en cuanto se crean y que puede empezar a aplicar el uso de etiquetas de nuevos recursos rápidamente. También puede usar permisos de nivel de recurso para controlar las claves y valores de etiqueta que se pueden asociar a recursos nuevos y existentes. Para obtener más información, consulte [Control del acceso mediante etiquetas](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) en la *AWS Guía del usuario de IAM de *. # 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](https://docs.aws.amazon.com/cli/latest/userguide/) y la [API de REST de Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/). 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 Grupos de recursos de AWS API de etiquetado.](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html) ## 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](https://docs.aws.amazon.com/pinpoint/latest/apireference/tags-resource-arn.html). 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. ------ #### [ 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} ``` ------ En el ejemplo anterior, realice el siguiente procedimiento: + *MyProject*Sustitúyalo por el nombre que desee asignar al proyecto. + Sustituya *key1* y *key2* por las claves de las etiquetas que desee añadir al recurso. + Sustituya *value1* y *value2* por los valores de las etiquetas que desee añadir para las claves respectivas. 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](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/). Para agregar una etiqueta a un recurso existente, utilice el comando `tag-resource` y especifique los valores adecuados para los parámetros requeridos: ------ #### [ 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} ``` ------ En el ejemplo anterior, realice el siguiente procedimiento: + *resource-arn*Sustitúyalo por el nombre de recurso de Amazon (ARN) del recurso al que quieres añadir una etiqueta. + Sustituya *key1* y *key2* por las claves de las etiquetas que desee añadir al recurso. + Sustituya *value1* y *value2* por los valores de las etiquetas que desee añadir para las claves respectivas. # Mostrar etiquetas de los recursos de Amazon Pinpoint mediante programación Los ejemplos siguientes muestran cómo utilizar la [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) y la [API de REST de Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/) para mostrar una lista de todas las etiquetas (claves y valores) asociadas a un recurso de Amazon Pinpoint. También puedes usar cualquier AWS SDK compatible para mostrar las etiquetas asociadas a un recurso. ## Mostrar etiquetas mediante la API Para utilizar la API de REST de Amazon Pinpoint para mostrar todas las etiquetas que están asociadas a un recurso específico, envíe una solicitud GET al URI [Etiquetas](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-tags.html) e incluya el nombre de recurso de Amazon (ARN) del recurso en el URI. El ARN debe estar codificado en la URL. Por ejemplo, la siguiente solicitud recupera todas las etiquetas asociadas a una campaña específica (*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 respuesta JSON a la solicitud incluye un objeto `tags`. El objeto `tags` enumera todas las claves de etiqueta y los valores asociados a la campaña. Para mostrar todas las etiquetas asociadas a más de un recurso del mismo tipo, envíe una solicitud GET al URI adecuado para dicho tipo de recurso. Por ejemplo, la siguiente solicitud recupera información sobre todas las campañas del proyecto especificado ()*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 respuesta JSON a la solicitud muestra todas las campañas del proyecto. El objeto `tags` de cada campaña muestra todas las claves y valores de etiqueta asociados a la campaña. ## Muestre las etiquetas mediante el AWS CLI Para usar el AWS CLI para mostrar una lista de las etiquetas asociadas a un recurso específico, ejecute el `list-tags-for-resource` comando y especifique el nombre del recurso de Amazon (ARN) del recurso para el `resource-arn` parámetro, como se muestra en el siguiente ejemplo. ------ #### [ 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 ``` ------ Para mostrar una lista de todos los recursos de Amazon Pinpoint que tienen etiquetas y todas las etiquetas asociadas a cada uno de esos recursos, utilice el comando [get-resources](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetResources.html) de la API de etiquetado. Grupos de recursos de AWS Establezca el parámetro `resource-type-filters` en `mobiletargeting`, como se muestra en el siguiente ejemplo. ------ #### [ Linux, macOS, or Unix ] ``` $ aws resourcegroupstaggingapi get-resources \ --resource-type-filters "mobiletargeting" ``` ------ #### [ Windows Command Prompt ] ``` C:\> aws resourcegroupstaggingapi get-resources ^ --resource-type-filters "mobiletargeting" ``` ------ El resultado del comando es una lista de todos ARNs los recursos de Amazon Pinpoint que tienen etiquetas. En la lista se incluyen todas las claves y valores de etiqueta asociados a cada recurso. # Actualizar o sobrescribir etiquetas de recursos de Amazon Pinpoint mediante programación Existen varias formas de actualizar (sobrescribir) una etiqueta para un recurso de Amazon Pinpoint. La mejor manera de actualizar una etiqueta depende de: + El tipo de recurso para el que desea actualizar etiquetas. + Si desea actualizar una etiqueta para uno o varios recursos al mismo tiempo. + Si desea actualizar una clave de etiqueta, un valor de etiqueta, o ambos. [Para actualizar una etiqueta para un proyecto de Amazon Pinpoint o para varios recursos al mismo tiempo, utilice las operaciones de etiquetado de grupos de recursos de la API de etiquetado AWS CLI o de la API de etiquetado.Grupos de recursos de AWS](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html) En la actualidad, la API de Amazon Pinpoint no admite directamente ninguna de esas tareas. Para actualizar una etiqueta para un recurso, puede [eliminar la etiqueta actual](tags-remove.md) y [agregar una nueva etiqueta](tags-add.md) mediante la API de Amazon Pinpoint. # Quitar etiquetas de los recursos de Amazon Pinpoint mediante programación Los siguientes ejemplos muestran cómo eliminar una etiqueta (tanto la clave como el valor) de un recurso de Amazon Pinpoint mediante la [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) y la [API de REST de Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/). También puede usar cualquier AWS SDK compatible para eliminar una etiqueta de un recurso. [Para eliminar una etiqueta de 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 Grupos de recursos de AWS API de etiquetado.](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html) Para quitar solo un valor de etiqueta específico (no una clave de etiqueta) de un recurso, puede [actualizar la etiqueta para el recurso](tags-update.md). ## Quitar etiquetas mediante la API Para eliminar una etiqueta de un recurso mediante la API de REST de Amazon Pinpoint, envíe una solicitud DELETE al URI de las [etiquetas](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-tags.html). En el URI, incluya el nombre de recurso de Amazon (ARN) del recurso del que desea quitar una etiqueta, seguida del parámetro `tagKeys` y la etiqueta que se va a quitar. Por ejemplo: ``` https://endpoint/v1/tags/resource-arn?tagKeys=key ``` Donde: + *endpoint*es el punto de enlace de Amazon Pinpoint para la AWS región que aloja el recurso. + *resource-arn*es el ARN del recurso del que desea eliminar una etiqueta. + *key*es la etiqueta que desea eliminar del recurso. Todos los parámetros deben tener codificación URL. Para quitar varias claves de etiquetas y sus valores asociados de un recurso, añada el parámetro `tagKeys` y el argumento para cada una de las etiquetas adicionales que se van a quitar, separadas por un signo ampersand (&). Por ejemplo: ``` https://endpoint/v1/tags/resource-arn?tagKeys=key1&tagKeys=key2 ``` Todos los parámetros deben tener codificación URL. ## Elimine las etiquetas mediante el AWS CLI Para eliminar una etiqueta de un recurso mediante el AWS CLI, ejecute el `untag-resource` comando. Incluya el argumento y el parámetro `tag-keys`, como se muestra en el siguiente ejemplo. ------ #### [ 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 ``` ------ En el ejemplo anterior, realice los siguientes cambios: + *resource-arn*Sustitúyalo por el ARN del recurso del que desea eliminar las etiquetas. + Sustituya *key1* y *key2* por las claves de las etiquetas que desee eliminar del recurso.