Avviso di fine del supporto: il 7 ottobre 2026, AWS terminerà il supporto per AWS Proton. Dopo il 7 ottobre 2026, non potrai più accedere alla AWS Proton console o AWS Proton alle risorse. L'infrastruttura implementata rimarrà intatta. Per ulteriori informazioni, consulta [AWS Proton Service Deprecation](https://docs.aws.amazon.com/proton/latest/userguide/proton-end-of-support.html) and Migration Guide.
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à.
# AWS Proton risorse e etichettatura
AWS Proton le risorse a cui viene assegnato un Amazon Resource Name (ARN) includono modelli di ambiente e relative versioni principali e secondarie, modelli di servizio e relative versioni principali e secondarie, ambienti, servizi, istanze di servizio, componenti e repository. Puoi etichettare queste risorse per organizzarle e identificarle. È possibile utilizzare i tag per classificare le risorse in base allo scopo, al proprietario, all'ambiente o ad altri criteri. Per ulteriori informazioni, consulta [Strategie di tagging di ](https://aws.amazon.com/answers/account-management/aws-tagging-strategies/). Per tenere traccia e gestire le AWS Proton risorse, è possibile utilizzare le funzionalità di tagging descritte nelle sezioni seguenti.
## AWS etichettatura
Puoi assegnare metadati alle tue AWS risorse sotto forma di tag. Ogni tag è composto da una chiave definita dal cliente e da un valore opzionale. Con i tag è possibile a gestire, identificare, organizzare, cercare e filtrare le risorse.
**Importante**
Non aggiungere Informazioni personali di identificazione (PII) o altre informazioni riservate o sensibili nei tag. I tag sono accessibili a molti Servizi AWS, inclusa la fatturazione. I tag non sono pensati per essere utilizzati per dati privati o sensibili.
**Ogni tag è costituito da due parti.**
+ Una chiave del tag (ad esempio,`CostCenter`, `Environment`, o `Project`). Le chiavi dei tag distinguono tra maiuscole e minuscole
+ Un valore di tag (opzionale) (ad esempio `111122223333` o`Production`). Come le chiavi dei tag, i valori dei tag distinguono tra maiuscole e minuscole.
**I seguenti requisiti di base per la denominazione e l'utilizzo si applicano ai tag.**
+ Ogni risorsa può avere un massimo di 50 tag creati dall'utente.
**Nota**
I tag creati dal sistema che iniziano con il `aws:` prefisso sono riservati AWS all'uso e non rientrano in questo limite. Non è possibile modificare o eliminare un tag che inizia con il prefisso `aws:`.
+ Per ogni risorsa, ogni chiave di tag deve essere unica e ogni chiave di tag può avere un solo valore.
+ La chiave tag deve contenere un minimo di 1 e un massimo di 128 caratteri Unicode in UTF-8.
+ Il valore del tag deve essere compreso tra un minimo di 1 e un massimo di 256 caratteri Unicode in UTF-8.
+ I caratteri consentiti nei tag sono lettere, numeri, spazi rappresentabili in UTF-8 e i seguenti caratteri: \$1 \$1.:/= \$1 - @.
## AWS Proton etichettatura
Con AWS Proton, puoi utilizzare sia i tag che crei sia i tag generati AWS Proton automaticamente per te.
### AWS Proton AWS tag gestiti
Quando si crea una AWS Proton risorsa, genera AWS Proton automaticamente tag AWS gestiti per la nuova risorsa, come illustrato nel diagramma seguente. AWS i tag gestiti si propagano successivamente ad altre AWS Proton risorse basate sulla nuova risorsa. Ad esempio, i tag gestiti di un modello di ambiente si propagano alle relative versioni e i tag gestiti di un servizio si propagano alle relative istanze del servizio.
**Nota**
AWS i tag gestiti *non vengono* generati per le connessioni agli account di ambiente. Per ulteriori informazioni, consulta [Connessioni agli account di ambiente](ag-env-account-connections.md).
![\[Un diagramma che descrive la propagazione AWS gestita dei tag.\]](http://docs.aws.amazon.com/it_it/proton/latest/userguide/images/tag-diag.png)
### Propagazione dei tag alle risorse assegnate
Se le risorse assegnate, come quelle definite nei modelli di servizio e ambiente, supportano il AWS tagging, i tag gestiti si propagano come tag AWS gestiti dal cliente alle risorse assegnate. Questi tag non si propagano a una risorsa fornita che non supporta il tagging. AWS
AWS Proton applica i tag alle risorse in base AWS Proton agli account, ai modelli registrati e agli ambienti distribuiti, nonché ai servizi e alle istanze di servizio, come descritto nella tabella seguente. Puoi utilizzare i tag AWS gestiti per visualizzare e gestire le tue AWS Proton risorse, ma non puoi modificarli.
| AWS chiave tag gestita | Chiave diffusa gestita dal cliente | Description |
| --- | --- | --- |
| `aws:proton:account` | `proton:account` | L' AWS account che crea e distribuisce le risorse. AWS Proton |
| `aws:proton:template` | `proton:template` | L'ARN di un modello selezionato. |
| `aws:proton:environment` | `proton:environment` | L'ARN di un ambiente selezionato. |
| `aws:proton:service` | `proton:service` | L'ARN di un servizio selezionato. |
| `aws:proton:service-instance` | `proton:service-instance` | L'ARN di un'istanza di servizio selezionata. |
| `aws:proton:component` | `proton:component` | L'ARN di un componente selezionato. |
Di seguito è riportato un esempio di tag AWS gestito per una AWS Proton risorsa.
```
"aws:proton:template" = "arn:aws:proton:region-id:account-id:environment-template/env-template"
```
Di seguito è riportato un esempio di tag gestito dal cliente applicato a una risorsa fornita che è stata propagata da un tag AWS gestito.
```
"proton:environment:database" = "arn:aws:proton:region-id:account-id:rds/env-db"
```
Con [AWS-managed provisioning](ag-works-prov-methods.md#ag-works-prov-methods-direct), AWS Proton applica i tag propagati direttamente alle risorse assegnate.
Con il [provisioning autogestito](ag-works-prov-methods.md#ag-works-prov-methods-self), AWS Proton rende disponibili i tag propagati insieme ai file IaC renderizzati che invia nella pull request (PR) di provisioning. I tag sono forniti nella variabile della mappa delle stringhe. `proton_tags` Ti consigliamo di fare riferimento a questa variabile nella configurazione di Terraform in `default_tags` cui includere i AWS Proton tag. Questo propaga i AWS Proton tag a tutte le risorse fornite.
L'esempio seguente mostra questo metodo di propagazione dei tag in un ambiente Terraform template.
Ecco la definizione della `proton_tags` variabile:
**proton.environment.variables.tf:**
```
variable "environment" {
type = object({
inputs = map(string)
name = string
})
}
variable "proton_tags" {
type = map(string)
default = null
}
```
Ecco come vengono assegnati i valori dei tag a questa variabile:
**proton.auto.tfvars.json:**
```
{
"environment": {
"name": "dev",
"inputs": {
"ssm_parameter_value": "MyNewParamValue"
}
}
"proton_tags" : {
"proton:account" : "123456789012",
"proton:template" : "arn:aws:proton:us-east-1:123456789012:environment-template/fargate-env",
"proton:environment" : "arn:aws:proton:us-east-1:123456789012:environment/dev"
}
}
```
Ed ecco come puoi aggiungere AWS Proton tag alla tua configurazione Terraform in modo che vengano aggiunti alle risorse fornite:
```
# Configure the AWS Provider
provider "aws" {
region = var.aws_region
default_tags {
tags = var.proton_tags
}
}
```
### Tag gestiti dal cliente
Ogni AWS Proton risorsa ha una quota massima di 50 tag gestiti dai clienti. I tag gestiti dal cliente si propagano alle AWS Proton risorse secondarie allo stesso modo dei tag AWS gestiti, tranne per il fatto che non si propagano alle AWS Proton risorse esistenti o alle risorse assegnate. Se applichi un nuovo tag a una AWS Proton risorsa con risorse secondarie esistenti e desideri che le risorse secondarie esistenti vengano contrassegnate con il nuovo tag, devi etichettare ogni risorsa secondaria esistente manualmente, utilizzando la console o. AWS CLI
### Crea tag utilizzando la console e la CLI
Quando crei una AWS Proton risorsa utilizzando la console, hai la possibilità di creare tag gestiti dai clienti nella prima o nella seconda pagina della procedura di creazione, come mostrato nella seguente istantanea della console. Scegli **Aggiungi nuovo tag**, inserisci la chiave e il valore e procedi.
![\[Un'istantanea dell'interfaccia di creazione dei tag della console.\]](http://docs.aws.amazon.com/it_it/proton/latest/userguide/images/tag-create.PNG)
Dopo aver creato una nuova risorsa utilizzando la AWS Proton console, puoi visualizzarne l'elenco dei tag AWS gestiti e gestiti dai clienti dalla pagina dei dettagli.
**Crea o modifica un tag**
1. Nella [AWS Proton console](https://console.aws.amazon.com//proton/), apri una pagina di dettaglio AWS Proton delle risorse in cui puoi visualizzare un elenco di tag.
1. Scegliere **Gestisci tag**.
1. Nella pagina **Gestisci i tag**, puoi visualizzare, creare, rimuovere e modificare i tag. Non puoi modificare i tag AWS gestiti elencati in alto. Tuttavia, puoi aggiungere e modificare i tag gestiti dal cliente modificando i campi, elencati dopo i tag AWS gestiti.
Scegli **Aggiungi nuovo tag** per creare un nuovo tag.
1. Inserisci una chiave e un valore per il nuovo tag.
1. Per modificare un tag, inserisci un valore nel campo del valore del tag per una chiave selezionata.
1. Per eliminare un tag, scegli **Rimuovi** per un tag selezionato.
1. Una volta completate le modifiche, scegliete **Salva modifiche**.
### Crea tag usando il AWS Proton AWS CLI
È possibile visualizzare, creare, rimuovere e modificare i tag utilizzando AWS Proton AWS CLI.
È possibile creare o modificare un tag per una risorsa come illustrato nell'esempio seguente.
```
$ aws proton tag-resource \
--resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice" \
--tags '[{"key":"mykey1","value":"myval1"},{"key":"mykey2","value":"myval2"}]'
```
È possibile rimuovere un tag per una risorsa come illustrato nell'esempio seguente.
```
$ aws proton untag-resource \
--resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice" \
--tag-keys '["mykey1","mykey2"]'
```
È possibile elencare i tag per una risorsa come mostrato nell'esempio finale.
```
$ aws proton list-tags-for-resource \
--resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice"
```