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à.
# Tagging di risorse di connessione
Un *tag* è un'etichetta di attributo personalizzata che l'utente o AWS assegna a una AWS risorsa. Ogni AWS tag è composto da due parti:
+ Una *chiave del tag* (ad esempio, `CostCenter`, `Environment` o `Project`). Le chiavi dei tag distinguono tra maiuscole e minuscole
+ Un campo facoltativo noto come *valore del tag* (ad esempio, `111122223333`, `Production` o un nome di team). Non specificare il valore del tag equivale a utilizzare una stringa vuota. Come le chiavi tag, i valori dei tag fanno distinzione tra maiuscole e minuscole.
Tutti questi sono noti come *coppie chiave-valore*.
È possibile utilizzare la console o l'interfaccia a riga di comando per aggiungere tag alle risorse.
Puoi taggare i seguenti tipi di risorse in AWS CodeConnections:
+ Connessioni
+ Host
Questi passaggi presuppongono che tu abbia già installato una versione recente di AWS CLI o aggiornata alla versione corrente. Per ulteriori informazioni, consulta [Installazione dell’ AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) nella *Guida per l’utente dell’AWS Command Line Interface *.
Oltre a identificare, organizzare e tracciare la risorsa con i tag, puoi utilizzare i tag nelle policy AWS Identity and Access Management (IAM) per controllare chi può visualizzare e interagire con la tua risorsa. Per esempi di policy di accesso basate su tag, consulta [Utilizzo dei tag per controllare l'accesso alle risorse AWS CodeConnections](connections-tag-based-access-control.md).
**Topics**
+ [Assegnazione di tag alle risorse (console)](#connections-tag-console)
+ [Risorse tag ( CLI)](#connections-tag-cli)
## Assegnazione di tag alle risorse (console)
È possibile utilizzare la console per aggiungere, aggiornare o rimuovere i tag in una risorsa di connessione.
**Topics**
+ [Aggiunta dei tag a una risorsa di connessione (console)](#connections-tag-console-add)
+ [Visualizzazione dei tag per una risorsa di connessione (console)](#connections-tag-console-view)
+ [Modifica dei tag per una risorsa di connessione (console)](#connections-tag-console-edit)
+ [Rimozione dei tag da una risorsa di connessione (console)](#connections-tag-console-remove)
### Aggiunta dei tag a una risorsa di connessione (console)
È possibile utilizzare la console per aggiungere i tag a una connessione o un host esistente.
**Nota**
Quando create una connessione per un provider installato come GitHub Enterprise Server e viene creata anche una risorsa host per voi, i tag durante la creazione vengono aggiunti solo alla connessione. Ciò consente di taggare un host separatamente se si desidera riutilizzarlo per una nuova connessione. Se desideri aggiungere tag all'host, segui la procedura descritta di seguito.
****Per aggiungere tag per una connessione****
1. Accedere alla console. Nel riquadro di navigazione scegliere **Impostazioni**.
1. In **Settings (Impostazioni)**, scegliere **Connections (Connessioni)**. Scegliere la scheda **Connessioni**.
1. Scegliere la connessione da modificare. Viene visualizzata la pagina Impostazioni connessione.
1. In **Connection tags (Tag di connessione)**, scegliere **Edit (Modifica)**. Viene visualizzata la pagina **Edit Connection tags (Modifica dei tag di connessione)**.
1. Nei campi **Key (Chiave)** e **Value (Valore)**, immettere una coppia di chiavi per ogni set di tag che si desidera aggiungere. Il campo **Value (Valore)** è facoltativo. Ad esempio, in **Key (Chiave)**, immettere **Project**. In **Valore**, immetti **ProjectA**.
1. (Facoltativo) Scegliere **Add tag (Aggiungi tag)** per aggiungere ulteriori righe e inserire più tag.
1. Seleziona **Invia**. I tag sono elencati nelle impostazioni della connessione.
****Per aggiungere tag per un host****
1. Accedere alla console. Nel riquadro di navigazione scegliere **Impostazioni**.
1. In **Settings (Impostazioni)**, scegliere **Connections (Connessioni)**. Seleziona la scheda **Hosts (Host)**.
1. Scegli l'host che desideri modificare. Viene visualizzata la pagina Host settings (Impostazioni host).
1. In **Host tags (Tag host)**, scegliere **Edit (Modifica)**. Viene visualizzata la pagina **Host tags (Tag host)**.
1. Nei campi **Key (Chiave)** e **Value (Valore)**, immettere una coppia di chiavi per ogni set di tag che si desidera aggiungere. Il campo **Value (Valore)** è facoltativo. Ad esempio, in **Key (Chiave)**, immettere **Project**. In **Valore**, immetti **ProjectA**.
1. (Facoltativo) Scegli **Add tag (Aggiungi tag)** per aggiungere ulteriori righe e inserisci più tag per un host.
1. Seleziona **Invia**. I tag sono elencati nelle impostazioni dell'host.
### Visualizzazione dei tag per una risorsa di connessione (console)
È possibile utilizzare la console per visualizzare i tag delle risorse esistenti.
**Per visualizzare i tag per una connessione**
1. Accedere alla console. Nel riquadro di navigazione scegliere **Impostazioni**.
1. In **Settings (Impostazioni)**, scegliere **Connections (Connessioni)**. Scegliere la scheda **Connessioni**.
1. Scegliere la connessione da visualizzare. Viene visualizzata la pagina Impostazioni connessione.
1. In **Connection tags (Tag connessioni)**, visualizzare i tag per la connessione nelle colonne **Key (Chiave)** e **Value (Valore)**.
**Per visualizzare i tag per un host**
1. Accedere alla console. Nel riquadro di navigazione scegliere **Impostazioni**.
1. In **Settings (Impostazioni)**, scegliere **Connections (Connessioni)**. Seleziona la scheda **Hosts (Host)**.
1. Scegliere l'host che si desidera visualizzare.
1. In **Host tags (Tag host)**, visualizzare i tag per l'host nelle colonne **Key (Chiave)** e **Value (Valore)**.
### Modifica dei tag per una risorsa di connessione (console)
È possibile utilizzare la console per modificare i tag che sono stati aggiunti alle risorse di connessione.
**Per modificare i tag per una connessione**
1. Accedere alla console. Nel riquadro di navigazione scegliere **Impostazioni**.
1. In **Settings (Impostazioni)**, scegliere **Connections (Connessioni)**. Scegliere la scheda **Connessioni**.
1. Scegliere la connessione da modificare. Viene visualizzata la pagina Impostazioni connessione.
1. In **Connection tags (Tag di connessione)**, scegliere **Edit (Modifica)**. Viene visualizzata la pagina **Connection tags (Tag di connessione)**.
1. Nei campi **Key (Chiave)** e **Value (Valore)**, aggiornare i valori di ogni campo in base alle esigenze. Ad esempio, per la chiave **Project**, in **Value (Valore)**, modificare **ProjectA** in **ProjectB**.
1. Seleziona **Invia**.
**Per modificare i tag per un host**
1. Accedere alla console. Nel riquadro di navigazione scegliere **Impostazioni**.
1. In **Settings (Impostazioni)**, scegliere **Connections (Connessioni)**. Seleziona la scheda **Hosts (Host)**.
1. Scegli l'host che desideri modificare. Viene visualizzata la pagina Host settings (Impostazioni host).
1. In **Host tags (Tag host)**, scegliere **Edit (Modifica)**. Viene visualizzata la pagina **Host tags (Tag host)**.
1. Nei campi **Key (Chiave)** e **Value (Valore)**, aggiornare i valori di ogni campo in base alle esigenze. Ad esempio, per la chiave **Project**, in **Value (Valore)**, modificare **ProjectA** in **ProjectB**.
1. Seleziona **Invia**.
### Rimozione dei tag da una risorsa di connessione (console)
Puoi utilizzare la console per rimuovere i tag dalle risorse di connessione. Quando rimuovi i tag dalla risorsa associata, questi vengono eliminati.
**Per rimuovere i tag per una connessione**
1. Accedere alla console. Nel riquadro di navigazione scegliere **Impostazioni**.
1. In **Settings (Impostazioni)**, scegliere **Connections (Connessioni)**. Scegliere la scheda **Connessioni**.
1. Scegliere la connessione da modificare. Viene visualizzata la pagina Impostazioni connessione.
1. In **Connection tags (Tag di connessione)**, scegliere **Edit (Modifica)**. Viene visualizzata la pagina **Connection tags (Tag di connessione)**.
1. Accanto alla chiave e al valori di ciascun tag che desideri eliminare, scegli **Remove tag (Rimuovi tag)**.
1. Seleziona **Invia**.
**Per rimuovere i tag per un host**
1. Accedere alla console. Nel riquadro di navigazione scegliere **Impostazioni**.
1. In **Settings (Impostazioni)**, scegliere **Connections (Connessioni)**. Seleziona la scheda **Hosts (Host)**.
1. Scegli l'host che desideri modificare. Viene visualizzata la pagina Host settings (Impostazioni host).
1. In **Host tags (Tag host)**, scegliere **Edit (Modifica)**. Viene visualizzata la pagina **Host tags (Tag host)**.
1. Accanto alla chiave e al valori di ciascun tag che desideri eliminare, scegli **Remove tag (Rimuovi tag)**.
1. Seleziona **Invia**.
## Risorse tag ( CLI)
È possibile utilizzare la CLI per visualizzare, aggiungere, aggiornare o rimuovere i tag in una risorsa di connessione.
**Topics**
+ [Aggiunta dei tag a una risorsa di connessione (CLI)](#connections-tag-add)
+ [Visualizzazione dei tag per una risorsa di connessione (CLI)](#connections-tag-view)
+ [Modifica dei tag per una risorsa di connessione (CLI)](#connections-tag-edit)
+ [Rimozione dei tag da una risorsa di connessione (CLI)](#connections-tag-delete)
### Aggiunta dei tag a una risorsa di connessione (CLI)
Puoi usarla AWS CLI per etichettare le risorse nelle connessioni.
Al terminale o alla riga di comando, eseguire il comando **tag-resource**, specificando l'Amazon Resource Name (ARN) della risorsa in cui aggiungere i tag e la chiave e il valore del tag che si desidera aggiungere. È possibile aggiungere più di un tag.
****Per aggiungere tag per una connessione****
1. Ottenere l'ARN per la risorsa. Utilizzare il comando **list-connections** mostrato in [Elenco delle connessioni](connections-list.md) per ottenere la connessione ARN.
1. In un terminale o nella riga di comando, eseguire il comando **tag-resource**.
Ad esempio, utilizzate il comando seguente per etichettare una connessione con due tag, una chiave di tag denominata {{Project}} con il valore del tag di {{ProjectA}} e una chiave di tag denominata {{ReadOnly}} con il valore del tag di{{true}}.
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key={{Project}},Value={{ProjectA}} Key={{IscontainerBased}},Value={{true}}
```
In caso di successo, questo comando non restituisce alcun risultato.
****Per aggiungere tag per un host****
1. Ottenere l'ARN per la risorsa. Utilizzare il comando **list-hosts** mostrato in [Elenca gli host](connections-host-list.md) per ottenere l'ARN dell'host.
1. In un terminale o nella riga di comando, eseguire il comando **tag-resource**.
Ad esempio, utilizzate il comando seguente per etichettare un host con due tag, una chiave di tag denominata {{Project}} con il valore del tag di {{ProjectA}} e una chiave di tag denominata {{IscontainerBased}} con il valore del tag di{{true}}.
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:host/My-Host-28aef605 --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true
```
In caso di successo, questo comando non restituisce alcun risultato.
### Visualizzazione dei tag per una risorsa di connessione (CLI)
È possibile utilizzare il AWS CLI per visualizzare i AWS tag per una risorsa di connessioni. Se non sono stati aggiunti tag, l'elenco restituito è vuoto. Utilizzare il comando **list-tags-for-resource** per visualizzare i tag che sono stati aggiunti a una connessione o a un host.
****Per visualizzare i tag per una connessione****
1. Ottenere l'ARN per la risorsa. Utilizzare il comando **list-connections** mostrato in [Elenco delle connessioni](connections-list.md) per ottenere la connessione ARN.
1. In un terminale o nella riga di comando, eseguire il comando **list-tags-for-resource**. Ad esempio, utilizzare il comando seguente per visualizzare un elenco di chiavi di tag e valori di tag per una connessione.
```
aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f
```
Questo comando restituisce i tag associati alla risorsa. In questo esempio vengono illustrate due coppie chiave-valore restituite per una connessione.
```
{
"Tags": [
{
"Key": "Project",
"Value": "ProjectA"
},
{
"Key": "ReadOnly",
"Value": "true"
}
]
}
```
****Per visualizzare i tag per un host****
1. Ottenere l'ARN per la risorsa. Utilizzare il comando **list-hosts** mostrato in [Elenca gli host](connections-host-list.md) per ottenere l'ARN dell'host.
1. In un terminale o nella riga di comando, eseguire il comando **list-tags-for-resource**. Ad esempio, utilizzare il comando seguente per visualizzare un elenco di chiavi di tag e valori di tag per un host.
```
aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:host/My-Host-28aef605
```
Questo comando restituisce i tag associati alla risorsa. Questo esempio mostra due coppie chiave-valore restituite per un host.
```
{
"Tags": [
{
"Key": "IscontainerBased",
"Value": "true"
},
{
"Key": "Project",
"Value": "ProjectA"
}
]
}
```
### Modifica dei tag per una risorsa di connessione (CLI)
È possibile utilizzare il AWS CLI per modificare un tag per una risorsa. È possibile modificare il valore di una chiave esistente o aggiungere un'altra chiave.
Al terminale o nella riga di comando, eseguire il comando **tag-resource** specificando l'ARN (Amazon Resource Name) della risorsa in cui si desidera aggiornare un tag e specificare la chiave e il valore di tag da aggiornare.
Quando si modificano i tag, tutte le chiavi di tag non specificate verranno mantenute, mentre qualsiasi elemento con la stessa chiave ma un nuovo valore verrà aggiornato. Le nuove chiavi aggiunte con il comando modifica vengono aggiunte come una nuova coppia chiave-valore.
****Per modificare i tag per una connessione****
1. Ottenere l'ARN per la risorsa. Utilizzare il comando **list-connections** mostrato in [Elenco delle connessioni](connections-list.md) per ottenere la connessione ARN.
1. In un terminale o nella riga di comando, eseguire il comando **tag-resource**.
In questo esempio, il valore della chiave `Project` viene modificato in `ProjectB`.
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key=Project,Value=ProjectB
```
In caso di successo, questo comando non restituisce alcun risultato. Per verificare i tag associati alla connessione, esegui il comando **list-tags-for-resource**.
****Per modificare i tag per un host****
1. Ottenere l'ARN per la risorsa. Utilizzare il comando **list-hosts** mostrato in [Elenca gli host](connections-host-list.md) per ottenere l'ARN dell'host.
1. In un terminale o nella riga di comando, eseguire il comando **tag-resource**.
In questo esempio, il valore della chiave `Project` viene modificato in `ProjectB`.
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:host/My-Host-28aef605 --tags Key=Project,Value=ProjectB
```
In caso di successo, questo comando non restituisce alcun risultato. Per verificare i tag associati all'host, esegui il comando **list-tags-for-resource**.
### Rimozione dei tag da una risorsa di connessione (CLI)
Segui questi passaggi per utilizzare AWS CLI per rimuovere un tag da una risorsa. Quando rimuovi i tag dalla risorsa associata, questi vengono eliminati.
**Nota**
Se si elimina una risorsa di connessione, tutte le associazioni di tag vengono rimosse dalla risorsa eliminata. Non è necessario rimuovere i tag prima di eliminare una risorsa di connessione.
Al terminale o nella riga di comando, eseguire il comando **untag-resource** specificando l'ARN della risorsa in cui si desidera rimuovere i tag e la chiave del tag che si desidera rimuovere. Ad esempio, per rimuovere più tag su una connessione con le chiavi dei tag {{Project}} e{{ReadOnly}}, usa il seguente comando.
```
aws codestar-connections untag-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tag-keys {{Project}} {{ReadOnly}}
```
In caso di successo, questo comando non restituisce alcun risultato. Per verificare i tag associati alla risorsa, eseguire il comando **list-tags-for-resource**. L'output mostra che tutti i tag sono stati rimossi.
```
{
"Tags": []
}
```