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à.
# Etichettatura delle regole e dei gruppi di campionamento a raggi X
I tag sono parole o frasi che puoi usare per identificare e organizzare le tue risorse. AWS È possibile aggiungere più tag a ciascuna risorsa. Ogni tag include una chiave e un valore opzionale definiti dall'utente. Ad esempio, una chiave di tag potrebbe essere**domain**, e il valore del tag potrebbe essere**example.com**. Puoi cercare e filtrare le tue risorse in base ai tag che aggiungi. Per ulteriori informazioni sui modi di utilizzare i tag, consulta [Etichettatura AWS delle risorse](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) nella *Guida AWS generale*.
Puoi utilizzare i tag per applicare le autorizzazioni basate sui tag alle distribuzioni. CloudFront Per ulteriori informazioni, vedere [Controllo dell'accesso alle AWS risorse utilizzando i tag delle risorse](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).
**Nota**
[Tag Editor](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) e [AWS Resource Groups](https://docs.aws.amazon.com/ARG/latest/userguide/welcome.html) attualmente non supportano le risorse X-Ray. Puoi aggiungere e gestire i tag utilizzando la AWS X-Ray console o l'API.
È possibile applicare tag alle risorse utilizzando la console X-Ray, l'API, AWS CLI SDKs, e. AWS Tools for Windows PowerShell Per ulteriori informazioni, consulta la seguente documentazione:
+ API X-Ray: vedi le seguenti operazioni nel riferimento *AWS X-Ray API*:
+ [ListTagsForResource](https://docs.aws.amazon.com/xray/latest/api/API_ListTagsForResource.html)
+ [CreateSamplingRule](https://docs.aws.amazon.com/xray/latest/api/API_CreateSamplingRule.html)
+ [CreateGroup](https://docs.aws.amazon.com/xray/latest/api/API_CreateGroup.html)
+ [TagResource](https://docs.aws.amazon.com/xray/latest/api/API_TagResource.html)
+ [UntagResource](https://docs.aws.amazon.com/xray/latest/api/API_UntagResource.html)
+ AWS CLI *— Vedi [xray](https://docs.aws.amazon.com/cli/latest/reference/xray/index.html) nel Command Reference AWS CLI *
+ SDKs [— Consulta la documentazione SDK applicabile nella pagina Documentazione AWS](https://docs.aws.amazon.com/)
**Nota**
Se non è possibile aggiungere o modificare tag su una risorsa X-Ray o non è possibile aggiungere una risorsa con tag specifici, è possibile che non si disponga delle autorizzazioni necessarie per eseguire questa operazione. Per richiedere l'accesso, contattare un AWS utente dell'azienda che dispone delle autorizzazioni di **amministratore** in X-Ray.
**Topics**
+ [Limitazioni applicate ai tag](#xray-tagging-restrictions)
+ [Gestione dei tag nella console](#xray-tagging-manage)
+ [Gestione dei tag in AWS CLI](#xray-tagging-manage-cli)
+ [Controlla l'accesso alle risorse X-Ray in base ai tag](#xray-tagging-policy)
## Limitazioni applicate ai tag
Ai tag si applicano le limitazioni seguenti.
+ Numero massimo di tag per risorsa: 50
+ lunghezza massima della chiave: 128 caratteri Unicode;
+ lunghezza massima del valore: 256 caratteri Unicode;
+ Valori validi per la chiave e il valore - a-z, A-Z, 0-9, spazi e i seguenti caratteri: \$1 . : / = \$1 - e @
+ I valori e le chiavi dei tag rispettano la distinzione tra maiuscole e minuscole.
+ Non utilizzare `aws:` come prefisso per le chiavi; è riservato all' AWS uso.
**Nota**
Non è possibile modificare o eliminare i tag di sistema.
## Gestione dei tag nella console
È possibile aggiungere tag opzionali durante la creazione di un gruppo X-Ray o di una regola di campionamento. I tag possono anche essere modificati o eliminati nella console in un secondo momento.
Le seguenti procedure spiegano come aggiungere, modificare ed eliminare i tag per i gruppi e le regole di campionamento nella console X-Ray.
**Topics**
+ [Aggiungi tag a un nuovo gruppo (console)](#xray-tagging-add-group-console)
+ [Aggiungi tag a una nuova regola di campionamento (console)](#xray-tagging-add-rule-console)
+ [Modifica o elimina i tag per un gruppo (console)](#xray-tagging-change-group-console)
+ [Modifica o elimina i tag per una regola di campionamento (console)](#xray-tagging-change-rule-console)
### Aggiungi tag a un nuovo gruppo (console)
Quando si crea un nuovo gruppo X-Ray, è possibile aggiungere tag opzionali nella pagina **Crea gruppo**.
1. [Accedi a Console di gestione AWS e apri la console X-Ray a casahttps://console.aws.amazon.com/xray/.](https://console.aws.amazon.com/xray/home)
1. Nel riquadro di navigazione, espandi **Configurazione** e scegli **Gruppi**.
1. Seleziona **Crea gruppo**.
1. Nella pagina **Crea gruppo**, specifica un nome e un'espressione di filtro per il gruppo. Per ulteriori informazioni su queste proprietà, consultare [Configurazione dei gruppi](xray-console-groups.md).
1. In **Tag**, inserisci una chiave di tag e, facoltativamente, un valore di tag. Ad esempio, potete inserire una chiave di tag e un valore di **Stage** tag di**Production**, per indicare che questo gruppo è destinato all'uso in produzione. Quando aggiungete un tag, viene visualizzata una nuova riga in cui potete aggiungere un altro tag, se necessario. Per informazioni [Limitazioni applicate ai tag](#xray-tagging-restrictions) sulle limitazioni relative ai tag, consulta questo argomento.
1. Quando hai finito di aggiungere i tag, scegli **Crea gruppo**.
### Aggiungi tag a una nuova regola di campionamento (console)
Quando create una nuova regola di campionamento a raggi X, potete aggiungere tag nella pagina **Crea regola di campionamento**.
1. [Accedi a Console di gestione AWS e apri la console X-Ray a casahttps://console.aws.amazon.com/xray/.](https://console.aws.amazon.com/xray/home)
1. Nel riquadro di navigazione, espandi **Configurazione** e scegli **Sampling**.
1. Scegliete **Crea regola di campionamento**.
1. Nella pagina **Crea regola di campionamento**, specifica un nome, una priorità, i limiti, i criteri di corrispondenza e gli attributi corrispondenti. Per ulteriori informazioni su queste proprietà, consultare [Configurazione delle regole di campionamento di](xray-console-sampling.md).
1. In **Tag**, inserisci una chiave di tag e, facoltativamente, un valore di tag. Ad esempio, potete inserire una chiave di tag e un valore di tag di **Stage****Production**, per indicare che questa regola di campionamento è destinata all'uso in produzione. Quando aggiungete un tag, viene visualizzata una nuova riga in cui potete aggiungere un altro tag, se necessario. Per informazioni [Limitazioni applicate ai tag](#xray-tagging-restrictions) sulle limitazioni relative ai tag, consulta questo argomento.
1. Quando hai finito di aggiungere i tag, scegli **Crea regola di campionamento**.
### Modifica o elimina i tag per un gruppo (console)
È possibile modificare o eliminare i tag su un gruppo X-Ray nella pagina **Modifica gruppo**.
1. [Accedi a Console di gestione AWS e apri la console X-Ray a casahttps://console.aws.amazon.com/xray/.](https://console.aws.amazon.com/xray/home)
1. Nel riquadro di navigazione, espandi **Configurazione** e scegli **Gruppi**.
1. Nella tabella **Gruppi**, scegli il nome di un gruppo.
1. Nella pagina **Modifica gruppo**, in **Tag**, modifica le chiavi e i valori dei tag. Non puoi avere chiavi di tag duplicate. I valori dei tag sono facoltativi; è possibile eliminare i valori se lo si desidera. Per ulteriori informazioni su altre proprietà nella pagina **Modifica gruppo**, vedere[Configurazione dei gruppi](xray-console-groups.md). Per informazioni [Limitazioni applicate ai tag](#xray-tagging-restrictions) sulle limitazioni relative ai tag, consulta questo argomento.
1. Per eliminare un tag, scegli **X** a destra del tag.
1. Quando hai finito di modificare o eliminare i tag, scegli **Aggiorna gruppo**.
### Modifica o elimina i tag per una regola di campionamento (console)
È possibile modificare o eliminare i tag su una regola di campionamento a raggi X nella pagina **Modifica regola di campionamento**.
1. [Accedi a Console di gestione AWS e apri la console X-Ray a casahttps://console.aws.amazon.com/xray/.](https://console.aws.amazon.com/xray/home)
1. Nel riquadro di navigazione, espandi **Configurazione** e scegli **Sampling**.
1. Nella tabella **Regole di campionamento**, scegliete il nome di una regola di campionamento.
1. In **Tag**, modificate le chiavi e i valori dei tag. Non puoi avere chiavi di tag duplicate. I valori dei tag sono facoltativi; è possibile eliminare i valori se lo si desidera. Per ulteriori informazioni su altre proprietà nella pagina **Modifica regola di campionamento**, vedere[Configurazione delle regole di campionamento di](xray-console-sampling.md). Per informazioni [Limitazioni applicate ai tag](#xray-tagging-restrictions) sulle limitazioni relative ai tag, consulta questo argomento.
1. Per eliminare un tag, scegli **X** a destra del tag.
1. Quando hai finito di modificare o eliminare i tag, scegli **Aggiorna regola di campionamento**.
## Gestione dei tag in AWS CLI
È possibile aggiungere tag quando si crea un gruppo X-Ray o una regola di campionamento. È inoltre possibile utilizzare il AWS CLI per creare e gestire i tag. Per aggiornare i tag su un gruppo o una regola di campionamento esistente, usa la AWS X-Ray console o l'opzione [TagResource](https://docs.aws.amazon.com/xray/latest/api/API_TagResource.html)o [UntagResource](https://docs.aws.amazon.com/xray/latest/api/API_UntagResource.html) APIs.
**Topics**
+ [Aggiungere tag a un nuovo gruppo X-Ray o a una nuova regola di campionamento (CLI)](#xray-tagging-cli-create)
+ [Aggiungere tag a una risorsa esistente (CLI)](#xray-tagging-cli-add)
+ [Elenca i tag su una risorsa (CLI)](#xray-tagging-cli-list)
+ [Eliminare i tag su una risorsa (CLI)](#xray-tagging-cli-delete)
### Aggiungere tag a un nuovo gruppo X-Ray o a una nuova regola di campionamento (CLI)
Per aggiungere tag opzionali durante la creazione di un nuovo gruppo di raggi X o di una nuova regola di campionamento, utilizzate uno dei seguenti comandi.
+ Per aggiungere tag a un nuovo gruppo, esegui il comando seguente, sostituendolo *group\$1name* con il nome del gruppo, *mydomain.com* con l'endpoint del servizio, *key\$1name* con una chiave di tag e, facoltativamente, *value* con un valore di tag. Per ulteriori informazioni su come creare un gruppo, consulta. [Gruppi](xray-api-configuration.md#xray-api-configuration-groups)
```
aws xray create-group \
--group-name "group_name" \
--filter-expression "service(\"mydomain.com\") {fault OR error}" \
--tags [{"Key": "key_name","Value": "value"},{"Key": "key_name","Value": "value"}]
```
Di seguito è riportato un esempio di :
```
aws xray create-group \
--group-name "AdminGroup" \
--filter-expression "service(\"mydomain.com\") {fault OR error}" \
--tags [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]
```
+ Per aggiungere tag a una nuova regola di campionamento, esegui il comando seguente, sostituendolo *key\$1name* con una chiave tag e, facoltativamente, *value* con un valore di tag. Questo comando specifica i valori del `--sampling-rule` parametro come file JSON. Per ulteriori informazioni su come creare una regola di campionamento, vedere. [Regole di campionamento](xray-api-configuration.md#xray-api-configuration-sampling)
```
aws xray create-sampling-rule \
--cli-input-json file://file_name.json
```
Di seguito è riportato il contenuto del file *file\$1name.json* JSON specificato dal `--cli-input-json` parametro.
```
{
"SamplingRule": {
"RuleName": "rule_name",
"RuleARN": "string",
"ResourceARN": "string",
"Priority": integer,
"FixedRate": double,
"ReservoirSize": integer,
"ServiceName": "string",
"ServiceType": "string",
"Host": "string",
"HTTPMethod": "string",
"URLPath": "string",
"Version": integer,
"Attributes": {"attribute_name": "value","attribute_name": "value"...}
}
"Tags": [
{
"Key":"key_name",
"Value":"value"
},
{
"Key":"key_name",
"Value":"value"
}
]
}
```
Il comando seguente è un esempio.
```
aws xray create-sampling-rule \
--cli-input-json file://9000-base-scorekeep.json
```
Di seguito è riportato il contenuto del `9000-base-scorekeep.json` file di esempio specificato dal `--cli-input-json` parametro.
```
{
"SamplingRule": {
"RuleName": "base-scorekeep",
"ResourceARN": "*",
"Priority": 9000,
"FixedRate": 0.1,
"ReservoirSize": 5,
"ServiceName": "Scorekeep",
"ServiceType": "*",
"Host": "*",
"HTTPMethod": "*",
"URLPath": "*",
"Version": 1
}
"Tags": [
{
"Key":"Stage",
"Value":"Prod"
},
{
"Key":"Department",
"Value":"QA"
}
]
}
```
### Aggiungere tag a una risorsa esistente (CLI)
È possibile eseguire il `tag-resource` comando per aggiungere tag a un gruppo X-Ray o a una regola di campionamento esistente. Questo metodo potrebbe essere più semplice dell'aggiunta di tag eseguendo o. `update-group` `update-sampling-rule`
Per aggiungere tag a un gruppo o a una regola di campionamento, esegui il comando seguente, sostituendo l'ARN con l'ARN della risorsa e specificando le chiavi e i valori opzionali dei tag che desideri aggiungere.
```
aws xray tag-resource \
--resource-arn "ARN" \
--tag-keys [{"Key":"key_name","Value":"value"}, {"Key":"key_name","Value":"value"}]
```
Di seguito è riportato un esempio di :
```
aws xray tag-resource \
--resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup" \
--tag-keys [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]
```
### Elenca i tag su una risorsa (CLI)
È possibile eseguire il `list-tags-for-resource` comando per elencare i tag di un gruppo X-Ray o di una regola di campionamento.
Per elencare i tag associati a un gruppo o a una regola di campionamento, esegui il comando seguente, sostituendo l'ARN con l'ARN della risorsa.
```
aws xray list-tags-for-resource \
--resource-arn "ARN"
```
Di seguito è riportato un esempio di :
```
aws xray list-tags-for-resource \
--resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup"
```
### Eliminare i tag su una risorsa (CLI)
È possibile eseguire il `untag-resource` comando per rimuovere i tag da un gruppo X-Ray o da una regola di campionamento.
Per rimuovere i tag da un gruppo o da una regola di campionamento, esegui il comando seguente, sostituendo l'ARN con l'ARN della risorsa e specificando le chiavi dei tag che desideri rimuovere.
È possibile rimuovere solo interi tag con il comando. `untag-resource` Per rimuovere i valori dei tag, usa la console X-Ray oppure elimina i tag e aggiungi nuovi tag con le stesse chiavi, ma valori diversi o vuoti.
```
aws xray untag-resource \
--resource-arn "ARN" \
--tag-keys ["key_name","key_name"]
```
Di seguito è riportato un esempio di :
```
aws xray untag-resource \
--resource-arn "arn:aws:xray:us-east-2:01234567890:group/group_name" \
--tag-keys ["Stage","Department"]
```
## Controlla l'accesso alle risorse X-Ray in base ai tag
È possibile allegare tag ai gruppi di raggi X o alle regole di campionamento oppure passare i tag in una richiesta a X-Ray. Per controllare l’accesso basato su tag, fornire informazioni sui tag nell’[elemento condizione](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) di una policy utilizzando le chiavi di condizione `xray:ResourceTag/key-name`, `aws:RequestTag/key-name` o `aws:TagKeys`. Per saperne di più su queste chiavi di condizione, consulta [Controllo dell'accesso alle AWS risorse utilizzando i tag delle risorse](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).
Per visualizzare una policy basata sulle identità di esempio per limitare l'accesso a una risorsa basata su tag su tale risorsa, consulta [Gestione dell'accesso ai gruppi X-Ray e alle regole di campionamento basate sui tag](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-manage-sampling-tags).