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 Puoi 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 esseredomain, e il valore del tag potrebbe essereexample.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 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.

Nota

Tag Editor e AWS Resource Groups attualmente non supportano le risorse X-Ray. Puoi aggiungere e gestire i tag utilizzando la AWS X-Ray console o l'API.

Puoi applicare tag alle risorse utilizzando la console X-Ray, l'API AWS CLI, gli SDK 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

  • CreateSamplingRule

  • CreateGroup

  • TagResource

  • UntagResource

• AWS CLI — Vedi xray nel Command Reference AWS CLI

• SDK: consulta la documentazione relativa all’SDK applicabile nella pagina Documentazione di AWS

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.

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: _ . : / = + - 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'uso. AWS

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.

Argomenti

• Aggiungi tag a un nuovo gruppo (console)
• Aggiungi tag a una nuova regola di campionamento (console)
• Modifica o elimina i tag per un gruppo (console)
• Modifica o elimina i tag per una regola di campionamento (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. Accedere AWS Management Console e aprire la console X-Ray all'indirizzo https://console.aws.amazon.com/xray/home.

2. Nel riquadro di navigazione, espandi Configurazione e scegli Gruppi.

3. Seleziona Crea gruppo.

4. Nella pagina Crea gruppo, specifica un nome e un'espressione di filtro per il gruppo. Per ulteriori informazioni su queste proprietà, consultare Configura i gruppi.

5. 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 diProduction, 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 sulle limitazioni relative ai tag, consulta questo argomento.

6. 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. Accedere AWS Management Console e aprire la console X-Ray all'indirizzo https://console.aws.amazon.com/xray/home.

2. Nel riquadro di navigazione, espandi Configurazione e scegli Sampling.

3. Scegliete Crea regola di campionamento.

4. 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 Configura le regole di campionamento.

5. 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 StageProduction, 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 sulle limitazioni relative ai tag, consulta questo argomento.

6. 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. Accedere AWS Management Console e aprire la console X-Ray all'indirizzo https://console.aws.amazon.com/xray/home.

2. Nel riquadro di navigazione, espandi Configurazione e scegli Gruppi.

3. Nella tabella Gruppi, scegli il nome di un gruppo.

4. 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 opzionali; puoi eliminarli se lo desideri. Per ulteriori informazioni su altre proprietà nella pagina Modifica gruppo, vedereConfigura i gruppi. Per informazioni Limitazioni applicate ai tag sulle limitazioni relative ai tag, consulta questo argomento.

5. Per eliminare un tag, scegli X a destra del tag.

6. 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. Accedere AWS Management Console e aprire la console X-Ray all'indirizzo https://console.aws.amazon.com/xray/home.

2. Nel riquadro di navigazione, espandi Configurazione e scegli Sampling.

3. Nella tabella Regole di campionamento, scegliete il nome di una regola di campionamento.

4. In Tag, modificate le chiavi e i valori dei tag. Non puoi avere chiavi di tag duplicate. I valori dei tag sono opzionali; puoi eliminarli se lo desideri. Per ulteriori informazioni su altre proprietà nella pagina Modifica regola di campionamento, vedereConfigura le regole di campionamento. Per informazioni Limitazioni applicate ai tag sulle limitazioni relative ai tag, consulta questo argomento.

5. Per eliminare un tag, scegli X a destra del tag.

6. 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 TagResourceo le UntagResourceAPI.

Argomenti

• Aggiungere tag a un nuovo gruppo X-Ray o a una nuova regola di campionamento (CLI)
• Aggiungere tag a una risorsa esistente (CLI)
• Elenca i tag su una risorsa (CLI)
• Eliminare i tag su una risorsa (CLI)

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, sostituendo group_name con il nome del tuo gruppo, mydomain.com con l'endpoint del tuo servizio, key_name con una chiave di tag e, facoltativamente, value con un valore di tag. Per ulteriori informazioni su come creare un gruppo, consulta. Configurazione delle impostazioni di campionamento, gruppi e crittografia con l'API X-Ray

  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.

  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, sostituendo key_name con una chiave di 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. Configurazione delle impostazioni di campionamento, gruppi e crittografia con l'API X-Ray

  aws xray create-sampling-rule \
     --cli-input-json file://file_name.json

  Di seguito sono riportati i contenuti del file JSON file_name.json specificato dal parametro. --cli-input-json

  {
      "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 file di esempio 9000-base-scorekeep.json specificato dal parametro. --cli-input-json

  {
      "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.

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.

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.

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, fornisci informazioni sui tag nell'elemento condizione 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.

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.