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 suddividere le risorse in categorie in base allo scopo, al proprietario, all'ambiente o ad altri criteri. Per ulteriori informazioni, consulta Strategie di tagging di
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 destinati ad essere utilizzati per dati privati o sensibili.
Ogni tag è costituito da due parti.
-
Una chiave del tag (ad esempio,
CostCenter
,Environment
, oProject
). Le chiavi dei tag prevedono una distinzione tra lettere maiuscole e minuscole. -
Un valore di tag (opzionale) (ad esempio,
111122223333
oProduction
). Analogamente alle chiavi dei tag, i valori dei tag prevedono una distinzione tra lettere 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 prefissoaws:
. -
Per ciascuna risorsa, ogni chiave del tag deve essere univoca e ogni chiave del tag può avere un solo valore.
-
Il tag della chiave deve essere composto da 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: * _.:/= + - @.
AWS Proton etichettatura
Con AWS Proton, puoi utilizzare sia i tag che crei sia i tag generati AWS Proton automaticamente per te.
AWS ProtonAWS 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.

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 | Descrizione |
---|---|---|
|
|
L' AWS account che crea e distribuisce le risorse. AWS Proton |
|
|
L'ARN di un modello selezionato. |
|
|
L'ARN di un ambiente selezionato. |
|
|
L'ARN di un servizio selezionato. |
|
|
L'ARN di un'istanza di servizio selezionata. |
|
|
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, AWS Proton applica i tag propagati direttamente alle risorse assegnate.
Con il provisioning autogestito, 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.
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
-
Nella AWS Proton console
, apri una pagina di dettaglio AWS Proton delle risorse in cui puoi visualizzare un elenco di tag. -
Scegliere Gestisci tag.
-
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.
-
Inserisci una chiave e un valore per il nuovo tag.
-
Per modificare un tag, inserisci un valore nel campo del valore del tag per una chiave selezionata.
-
Per eliminare un tag, scegli Rimuovi per un tag selezionato.
-
Una volta completate le modifiche, scegliete Salva modifiche.
Crea tag usando il AWS ProtonAWS 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
"