**Avviso di fine del supporto:** il 30 ottobre 2026, AWS terminerà il supporto per Amazon Pinpoint. Dopo il 30 ottobre 2026, non potrai più accedere alla console Amazon Pinpoint o alle risorse Amazon Pinpoint (endpoint, segmenti, campagne, percorsi e analisi). Per ulteriori informazioni, consulta [Fine del supporto di Amazon Pinpoint](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Nota: per quanto** APIs riguarda gli SMS, i comandi vocali, i messaggi push su dispositivi mobili, l'OTP e la convalida del numero di telefono non sono interessati da questa modifica e sono supportati da End User Messaging. AWS Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Gestione dei tag delle risorse di Amazon Pinpoint Un *tag* è un'etichetta che puoi definire e associare facoltativamente a AWS risorse, inclusi determinati tipi di risorse Amazon Pinpoint. I tag consentono di categorizzare e gestire le risorse in diversi modi, ad esempio in base allo scopo, al proprietario, all'ambiente o ad altri criteri. Ad esempio, è possibile utilizzare i tag per applicare le policy o l'automazione, nonché per identificare le risorse che sono soggette a determinati requisiti di conformità. Puoi aggiungere tag ai seguenti tipi di risorse Amazon Pinpoint: + Campagne + Modelli dei messaggi + Progetti (applicazioni) + Segmenti Una risorsa può avere fino a 50 tag. Ogni tag è composto da una *chiave di tag* obbligatoria e da un *valore di tag* opzionale, entrambi definibili dall'utente. Una *chiave di tag* è un'etichetta generale che funge da categoria per più valori di tag specifici. Un *valore di tag* funge da descrittore di una chiave di tag. Una chiave di tag può contenere fino a un massimo di 128 caratteri. Un valore di tag può contenere fino a un massimo di 256 caratteri. I caratteri possono essere lettere Unicode, numeri, spazi o uno dei seguenti simboli: \$1 . : / = \$1 -. Ai tag si applicano le seguenti ulteriori limitazioni: + I valori e le chiavi dei tag rispettano la distinzione tra maiuscole e minuscole. + Per ogni risorsa associata, ciascuna chiave di tag deve essere univoca e avere un solo valore. + Il `aws:` prefisso è riservato all'uso di AWS; non puoi utilizzarlo in nessuna chiave o valore di tag che definisci. Inoltre, non è possibile modificare o rimuovere chiavi o valori di tag che utilizzano questo prefisso. I tag che utilizzano questo prefisso non vengono conteggiati per la quota di 50 tag per ogni risorsa. + Non è possibile aggiornare o eliminare una risorsa solo in base ai suoi tag. Inoltre, è necessario specificare l'ARN (Amazon Resource Name) o l'ID della risorsa, a seconda dell'operazione utilizzata. + È possibile associare i tag a risorse pubbliche o condivise. Tuttavia, i tag sono disponibili solo per il tuo AWS account, non per altri account che condividono la risorsa. Inoltre, i tag sono disponibili solo per le risorse che si trovano nella AWS regione specificata per il tuo AWS account. Per aggiungere, visualizzare, aggiornare e rimuovere chiavi e valori di tag dalle risorse Amazon Pinpoint, puoi utilizzare AWS Command Line Interface (AWS CLI), l'API Amazon Pinpoint, l'API Tagging o un SDK. AWS Resource Groups AWS Per gestire le chiavi e i valori dei tag in tutte le AWS risorse che si trovano in una AWS regione specifica per il tuo AWS account (incluse le risorse Amazon Pinpoint), utilizza l'API [AWS Resource Groups Tagging](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html). Per ulteriori informazioni sui comandi CLI che è possibile utilizzare per gestire le risorse Amazon Pinpoint, consulta la sezione relativa ad Amazon Pinpoint della [documentazione di riferimento dei comandi della AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/). Per ulteriori informazioni sulle risorse nell'API Amazon Pinpoint, compresi i metodi HTTP(S), i parametri e gli schemi supportati, consulta la [documentazione di riferimento dell'API Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/). # Usa i tag Amazon Pinpoint nelle politiche IAM e nelle operazioni API Dopo aver iniziato a implementare i tag, puoi applicare autorizzazioni basate su tag a livello di risorsa alle policy AWS Identity and Access Management (IAM) e alle operazioni API. Ciò include le operazioni che supportano l'aggiunta di tag alle risorse al momento della loro creazione. Utilizzando i tag in questo modo, puoi implementare un controllo granulare su quali gruppi e utenti del tuo AWS account sono autorizzati a creare e taggare risorse e quali gruppi e utenti sono autorizzati a creare, aggiornare e rimuovere tag in generale. Ad esempio, è possibile creare una policy che consenta a un utente di avere accesso completo a tutte le risorse Amazon Pinpoint il cui nome è un valore nel tag `Owner` della risorsa: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "ModifyResourceIfOwner", "Effect": "Allow", "Action": "mobiletargeting:*", "Resource": "*", "Condition": { "StringEqualsIgnoreCase": { "aws:ResourceTag/Owner": "${aws:username}" } } } ] } ``` ------ Se vengono definite autorizzazioni a livello di risorsa basate su tag, le autorizzazioni diventano subito effettive. Ciò significa che le risorse sono più sicure non appena vengono create e che è possibile avviare rapidamente l'applicazione di tag alle nuove risorse. È inoltre possibile utilizzare le autorizzazioni a livello di risorsa per controllare quali chiavi e valori di tag possono essere associati a risorse nuove ed esistenti. Per ulteriori informazioni, consulta [Controllo dell'accesso alle risorse AWS mediante i tag](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) nella *Guida per l'utente di AWS *. # Aggiungi tag alle risorse di Amazon Pinpoint in modo programmatico Nei seguenti esempi viene illustrato come aggiungere un tag a una risorsa Amazon Pinpoint utilizzando la [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) e la [REST API Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/). Puoi anche utilizzare qualsiasi AWS SDK supportato per aggiungere un tag a una risorsa. [Per aggiungere un tag a più risorse Amazon Pinpoint in un'unica operazione, utilizza le operazioni di etichettatura dei gruppi di risorse AWS CLI o l'AWS Resource Groups API di tagging.](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html) ## Aggiungi tag utilizzando l'API Per creare una nuova risorsa e aggiungere un tag utilizzando la REST API Amazon Pinpoint, invia una richiesta POST all'URI di risorsa appropriato. Includi il parametro `tags` e i valori nel corpo della richiesta. L'esempio seguente mostra come specificare un tag quando si crea un nuovo progetto. ``` 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" } } ``` Per aggiungere un tag a una risorsa esistente, invia una richiesta POST all'URI [Tag](https://docs.aws.amazon.com/pinpoint/latest/apireference/tags-resource-arn.html). Includi l'Amazon Resource Name (ARN) della risorsa nell'URI. L'ARN deve essere codificato in formato URL. Nel corpo della richiesta, includi il parametro `tags` e i valori, come mostrato nel seguente esempio. ``` 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" } } ``` ## Aggiungi tag utilizzando il AWS CLI Per creare una nuova risorsa e aggiungervi un tag utilizzando AWS CLI, utilizzate il `create` comando appropriato per la risorsa. Includi il parametro `tags` e i valori. L'esempio seguente mostra come specificare i tag quando si crea un nuovo progetto. ------ #### [ 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} ``` ------ Nell'esempio precedente, procedere nel modo seguente: + Sostituiscila *MyProject* con il nome che vuoi dare al progetto. + Sostituisci *key1* e *key2* con le chiavi dei tag che vuoi aggiungere alla risorsa. + Sostituisci *value1* e *value2* con i valori dei tag che desideri aggiungere per le rispettive chiavi. Per informazioni sui comandi utilizzabili per creare una risorsa Amazon Pinpoint, consulta la [documentazione di riferimento dei comandi della AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/). Per aggiungere un tag a una risorsa esistente, utilizzare il comando `tag-resource` e specificare i valori appropriati per i parametri richiesti: ------ #### [ 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} ``` ------ Nell'esempio precedente, procedere nel modo seguente: + Sostituisci *resource-arn* con l'Amazon Resource Name (ARN) della risorsa a cui desideri aggiungere un tag. + Sostituisci *key1* e *key2* con le chiavi dei tag che desideri aggiungere alla risorsa. + Sostituisci *value1* e *value2* con i valori dei tag che desideri aggiungere per le rispettive chiavi. # Visualizza i tag per le risorse Amazon Pinpoint in modo programmatico I seguenti esempi mostrano come utilizzare la [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) e la [REST API Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/) per visualizzare l'elenco di tutti i tag (chiavi e valori) associati a una risorsa Amazon Pinpoint. Puoi anche utilizzare qualsiasi AWS SDK supportato per visualizzare i tag associati a una risorsa. ## Visualizza i tag utilizzando l'API Per utilizzare la REST API Amazon Pinpoint per visualizzare tutti i tag associati a una risorsa specifica, inviare una richiesta GET all'URI [Tags](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-tags.html) e includere il nome della risorsa Amazon (ARN) della risorsa nell'URI. L'ARN deve essere codificato in formato URL. Ad esempio, la seguente richiesta recupera tutti i tag associati a una campagna specificata (*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 risposta JSON alla richiesta include un oggetto `tags`. L'oggetto `tags` elenca tutte le chiavi e i valori di tag associati alla campagna. Per visualizzare tutti i tag associati a più di una risorsa dello stesso tipo, inviare una richiesta GET all'URI appropriato per quel tipo di risorsa. Ad esempio, la richiesta seguente recupera informazioni su tutte le campagne del progetto specificato ()*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 risposta JSON alla richiesta elenca tutte le campagne nel progetto. L'oggetto `tags` di ciascuna campagna elenca tutte le chiavi e i valori di tag associati alla campagna. ## Visualizza i tag utilizzando il AWS CLI Per utilizzare il AWS CLI per visualizzare un elenco dei tag associati a una risorsa specifica, esegui il `list-tags-for-resource` comando e specifica l'Amazon Resource Name (ARN) della risorsa per il `resource-arn` parametro, come mostrato nell'esempio seguente. ------ #### [ 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 ``` ------ Per visualizzare un elenco di tutte le risorse Amazon Pinpoint con tag e tutti i tag associati a ciascuna di tali risorse, utilizza il comando [get-resources dell'API](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetResources.html) Tagging. AWS Resource Groups Imposta il parametro `resource-type-filters` su `mobiletargeting`, come mostrato nell'esempio seguente. ------ #### [ Linux, macOS, or Unix ] ``` $ aws resourcegroupstaggingapi get-resources \ --resource-type-filters "mobiletargeting" ``` ------ #### [ Windows Command Prompt ] ``` C:\> aws resourcegroupstaggingapi get-resources ^ --resource-type-filters "mobiletargeting" ``` ------ L'output del comando è un elenco di tutte ARNs le risorse Amazon Pinpoint con tag. L'elenco include tutte le chiavi e valori di tag che sono associati a ogni risorsa. # Aggiorna o sovrascrivi i tag per le risorse Amazon Pinpoint a livello di codice Sono disponibili diversi modi per aggiornare (sovrascrivere) un tag di una risorsa Amazon Pinpoint. Il modo migliore per aggiornare un tag dipende da: + Il tipo di risorsa di cui si desidera aggiornare i tag. + Se si desidera aggiornare un tag per una o più risorse contemporaneamente. + Se si desidera aggiornare una chiave di tag, un valore di tag o entrambi. [Per aggiornare un tag per un progetto Amazon Pinpoint o per più risorse contemporaneamente, utilizza le operazioni di tagging dei gruppi di risorse dell' AWS CLI API Tagging.AWS Resource Groups](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html) L'API Amazon Pinpoint attualmente non fornisce supporto diretto per nessuna di queste attività. Per aggiornare un tag per una risorsa, è possibile [rimuovere il tag attuale](tags-remove.md) e [aggiungere un nuovo tag](tags-add.md) tramite l'API Amazon Pinpoint. # Rimuovi i tag dalle risorse di Amazon Pinpoint in modo programmatico Negli esempi seguenti viene illustrato come rimuovere un tag (sia la chiave che il valore) da una risorsa Amazon Pinpoint utilizzando la [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) e la [REST API Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/). Puoi anche utilizzare qualsiasi AWS SDK supportato per rimuovere un tag da una risorsa. [Per rimuovere un tag da più risorse Amazon Pinpoint in un'unica operazione, utilizza le operazioni di etichettatura dei gruppi di risorse AWS CLI o l'AWS Resource Groups API di tagging.](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html) Per rimuovere da una risorsa solo un determinato valore di tag (non la chiave di tag), [aggiornare i tag per la risorsa](tags-update.md). ## Rimuovi i tag utilizzando l'API Per rimuovere un tag da una risorsa mediante la REST API Amazon Pinpoint, invia una richiesta DELETE all'URI [Tags](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-tags.html). Nell'URI, includere l'Amazon Resource Name (ARN) della risorsa da cui si desidera rimuovere un tag, seguita dal parametro `tagKeys` e dal tag da rimuovere. Esempio: ``` https://endpoint/v1/tags/resource-arn?tagKeys=key ``` Dove: + *endpoint*è l'endpoint Amazon Pinpoint per la AWS regione che ospita la risorsa. + *resource-arn*è l'ARN della risorsa da cui si desidera rimuovere un tag. + *key*è il tag che si desidera rimuovere dalla risorsa. Tutti i parametri devono essere codificati URL. Per rimuovere da una risorsa più chiavi di tag e i relativi valori associati, aggiungere il parametro e l'argomento `tagKeys` per ogni ulteriore tag da rimuovere, separati da una e commerciale (&). Esempio: ``` https://endpoint/v1/tags/resource-arn?tagKeys=key1&tagKeys=key2 ``` Tutti i parametri devono essere codificati URL. ## Rimuovi i tag utilizzando il AWS CLI Per rimuovere un tag da una risorsa utilizzando il AWS CLI, esegui il `untag-resource` comando. Includi il parametro `tag-keys`, come mostrato nell'esempio seguente. ------ #### [ 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 ``` ------ In questo esempio, apporta le modifiche seguenti: + Sostituisci *resource-arn* con l'ARN della risorsa da cui desideri rimuovere i tag. + Sostituisci *key1* e *key2* con le chiavi dei tag che desideri rimuovere dalla risorsa.