Tagging delle regole e dei gruppi di campionamento di X-Ray

I tag sono parole o frasi che puoi utilizzare per identificare e organizzare le risorse AWS. È possibile aggiungere più tag a ciascuna risorsa. Ciascun tag include una chiave e un valore opzionale definiti dall'utente. Ad esempio, una chiave tag potrebbe esseredomaine il valore del tag potrebbe essereexample.com. Puoi cercare e filtrare le risorse in base ai tag aggiunti. Per ulteriori informazioni su come utilizzare i tag, consultaApplicazione di tagAWSrisorsenellaAWSRiferimenti generali.

Puoi utilizzare i tag per applicare le autorizzazioni basate su tag alle distribuzioni CloudFront. Per ulteriori informazioni, consultaControllo dell'accesso adAWSRisorse che utilizzano i tag delle risorse.

Nota

Editor di tageAWSGruppi di risorseal momento non supporta le risorse X-Ray. Aggiunta e gestione dei tag tramiteAWS X-Rayconsole o API.

Puoi applicare tag a risorse utilizzando la console X-Ray, l'API,AWS CLI, SDK eAWS Tools for Windows PowerShell. Per ulteriori informazioni, consulta la seguente documentazione:

• API X-Ray: vedere le seguenti operazioni nelAWS X-RayDocumentazione di riferimento API:

  • ListTagsForResource

  • Crea una regola di campionamento

  • CreateGroup

  • TagResource

  • UntagResource

• AWS CLI— VedereX-RaynellaAWS CLIRiferimento ai comandi

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

Nota

Se non è possibile aggiungere o modificare tag in una risorsa a X-Ray o non è possibile aggiungere una risorsa con tag specifici, è possibile che non si disponga delle autorizzazioni per eseguire questa operazione. Per richiedere l'accesso, contatta unAWSutente della tua azienda che haAmministratoreautorizzazioni 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 utilizzareaws:come prefisso per le chiavi; l'utilizzo di questo prefisso è esclusivo diAWSutilizzare.

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 di X-Ray o una regola di campionamento. I tag possono anche essere modificati o eliminati nella console in un secondo momento.

Le procedure seguenti descrivono come aggiungere, modificare ed eliminare tag per i gruppi e le regole di campionamento nella console X-Ray.

Argomenti

• Aggiunta di tag a un nuovo gruppo (console)
• Aggiunta di tag a una nuova regola di campionamento (console)
• Modificare o eliminare tag per un gruppo (console)
• Modificare o eliminare tag per una regola di campionamento (console)

Aggiunta di tag a un nuovo gruppo (console)

Mentre crei un nuovo gruppo a X-Ray, puoi aggiungere tag facoltativi sulCreazione di gruppo(Certificato creato).

1. Eseguire l'accesso adAWS Management Consolee aprire la console X-Ray all'indirizzohttps://console.aws.amazon.com/xray/home.

2. Nel riquadro di navigazione, espandiConfigurazionee scegliGruppi.

3. Seleziona Create group (Crea gruppo).

4. SulCreazione di gruppopage, specificare un nome e un'espressione di filtro per il gruppo. Per ulteriori informazioni su queste proprietà, consultare Configurazione dei gruppi.

5. Nello statoTag, immettere una chiave di tag e un valore di tag opzionale. Ad esempio, è anche possibile immettere una chiave del tag diStagee un valore di tag diProduction, per indicare che questo gruppo è destinato alla produzione. Quando aggiungi un tag, viene visualizzata una nuova riga per aggiungere un altro tag, se necessario. Consulta .Limitazioni applicate ai tagin questo argomento per limitazioni sui tag.

6. Una volta completata l'aggiunta di tag, scegliereCreazione di gruppo.

Aggiunta di tag a una nuova regola di campionamento (console)

Man mano che crei una nuova regola di campionamento a X-Ray, puoi aggiungere tag nellaCreazione di regole di campionamento(Certificato creato).

1. Eseguire l'accesso adAWS Management Consolee aprire la console X-Ray all'indirizzohttps://console.aws.amazon.com/xray/home.

2. Nel riquadro di navigazione, espandiConfigurazionee scegliCampionamento.

3. ScegliereCreazione di regole di campionamento.

4. SulCreazione di regole di campionamentopagina, specificare un nome, una priorità, i limiti, i criteri corrispondenti e gli attributi corrispondenti. Per ulteriori informazioni su queste proprietà, consultare Configurazione delle regole di campionamento di .

5. Nello statoTag, immettere una chiave di tag e un valore di tag opzionale. Ad esempio, è anche possibile immettere una chiave del tag diStagee un valore di tag diProduction, per indicare che questa regola di campionamento è destinata all'uso in produzione. Quando aggiungi un tag, viene visualizzata una nuova riga per aggiungere un altro tag, se necessario. Consulta .Limitazioni applicate ai tagin questo argomento per limitazioni sui tag.

6. Una volta completata l'aggiunta di tag, scegliereCreazione di regole di campionamento.

Modificare o eliminare tag per un gruppo (console)

È possibile modificare o eliminare i tag di un gruppo X-Ray sulModifica del gruppo(Certificato creato).

1. Eseguire l'accesso adAWS Management Consolee aprire la console X-Ray all'indirizzohttps://console.aws.amazon.com/xray/home.

2. Nel riquadro di navigazione, espandiConfigurazionee scegliGruppi.

3. NellaGruppi, scegliere il nome di un gruppo.

4. SulModifica del gruppopagina, inTag, modificare le chiavi e i valori dei tag. Non è possibile disporre di chiavi tag duplicate. I valori dei tag sono facoltativi; è possibile eliminare i valori se lo si desidera. Per ulteriori informazioni su altre proprietà sulModifica del gruppopagina, vediConfigurazione dei gruppi. Consulta .Limitazioni applicate ai tagin questo argomento per limitazioni sui tag.

5. Per rimuovere un tag, scegliXa destra della targhetta.

6. Una volta completata la modifica o l'eliminazione di tag, scegliereAggiornamento del gruppo.

Modificare o eliminare tag per una regola di campionamento (console)

È possibile modificare o eliminare i tag su una regola di campionamento a X-Ray sulModifica regola di campionamento(Certificato creato).

1. Eseguire l'accesso adAWS Management Consolee aprire la console X-Ray all'indirizzohttps://console.aws.amazon.com/xray/home.

2. Nel riquadro di navigazione, espandiConfigurazionee scegliCampionamento.

3. NellaRegole di campionamento, scegliere il nome di una regola di campionamento.

4. Nello statoTag, modificare le chiavi e i valori dei tag. Non è possibile disporre di chiavi tag duplicate. I valori dei tag sono facoltativi; è possibile eliminare i valori se lo si desidera. Per ulteriori informazioni su altre proprietà sulModifica regola di campionamentopagina, vediConfigurazione delle regole di campionamento di . Consulta .Limitazioni applicate ai tagin questo argomento per limitazioni sui tag.

5. Per rimuovere un tag, scegliXa destra della targhetta.

6. Una volta completata la modifica o l'eliminazione di tag, scegliereAggiornamento della regola di campionamento.

Gestione dei tag nellaAWS CLI

È possibile aggiungere tag quando si crea un gruppo X-Ray o una regola di campionamento. È possibile utilizzare anche laAWS CLIper creare e gestire i tag. Per aggiornare i tag su un gruppo o una regola di campionamento esistente, utilizzare ilAWS X-Rayconsole oTagResourceoUntagResourceAPI.

Argomenti

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

Aggiunta di tag a un nuovo gruppo di X-Ray o a una regola di campionamento (CLI)

Per aggiungere tag opzionali durante la creazione di un nuovo gruppo di X-Ray o una regola di campionamento, utilizzare uno dei seguenti comandi.

• Per aggiungere tag a un nuovo gruppo, eseguire il comando seguente, sostituendogroup_namecon il nome del gruppo,mydomain.comcon l'endpoint del tuo servizio,nome_chiavecon un tag key e, facoltativamente,valorecon un valore del tag. Per ulteriori informazioni su come creare un gruppo, consultaGruppi.

  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, eseguire il comando seguente, sostituendonome_chiavecon un tag key e, facoltativamente,valorecon un valore del tag. Questo comando specifica i valori nella--sampling-ruleparametro come file JSON. Per ulteriori informazioni su come creare una regola di campionamento, consultaRegole di campionamento.

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

  Di seguito sono riportati i contenuti del file JSONnome_file.jsonche è specificato dal--cli-input-jsonParametro .

  {
      "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 sono riportati i contenuti dell'esempio9000-base-scorekeep.jsonfile specificato dal--cli-input-jsonParametro .

  {
      "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"
             }
            ]
  }

Aggiunta di tag a una risorsa esistente (CLI)

È anche possibile emetteretag-resourcecomando per aggiungere tag a un gruppo di X-Ray o a una regola di campionamento esistente Questo metodo potrebbe essere più semplice dell'aggiunta di tag eseguendoupdate-groupoupdate-sampling-rule.

Per aggiungere tag a un gruppo o a una regola di campionamento, eseguire il comando seguente, sostituendo l'ARN con l'ARN della risorsa e specificando le chiavi e i valori facoltativi dei tag che si desidera 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)

È anche possibile emetterelist-tags-for-resourcecomando per elencare i tag di un gruppo di X-Ray o di una regola di campionamento.

Per elencare i tag associati a un gruppo o a una regola di campionamento, eseguire 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"

Elimina i tag su una risorsa (CLI)

È anche possibile emettereuntag-resourcecomando per rimuovere tag da un gruppo X-Ray o una regola di campionamento.

Per rimuovere i tag da un gruppo o da una regola di campionamento, eseguire il comando seguente, sostituendo l'ARN con l'ARN della risorsa e specificando le chiavi dei tag che si desidera rimuovere.

È possibile rimuovere solo intere tag conuntag-resourcecomando. Per rimuovere i valori dei tag, utilizzare la console X-Ray oppure eliminare i tag e aggiungere 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 a gruppi di raggi X o regole di campionamento o passare i tag in una richiesta a X-Ray. Per controllare l'accesso basato su tag, fornire 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 ulteriori informazioni su queste chiavi di condizione, consultaControllo dell'accesso adAWSrisorse che utilizzano 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.