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 pipeline di Amazon OpenSearch Ingestion
<a name="tag-pipeline"></a>

I tag consentono di assegnare informazioni arbitrarie a una pipeline di Amazon OpenSearch Ingestion in modo da poter classificare e filtrare tali informazioni. Un *tag* è un'etichetta di metadati che assegni o che assegni a una risorsa. AWS AWS Ciascun tag è formato da una *chiave* e da un *valore*, Per i tag assegnati da te, puoi definire la chiave e il valore. Ad esempio, potresti definire la chiave come `stage`e il valore di una risorsa come `test`.

I tag consentono di:
+ Identifica e organizza le tue risorse. AWS Molti AWS servizi supportano l'etichettatura, quindi puoi assegnare lo stesso tag a risorse di servizi diversi per indicare che le risorse sono correlate. Ad esempio, puoi assegnare lo stesso tag a una pipeline di OpenSearch Ingestion che assegni a un dominio Amazon Service. OpenSearch 
+ Tieni traccia dei costi. AWS Attivi questi tag sulla Gestione dei costi e fatturazione AWS dashboard. AWS utilizza i tag per classificare i costi e fornirti un rapporto mensile sull'allocazione dei costi. Per ulteriori informazioni, consulta la pagina sull'[utilizzo dei tag per l'allocazione dei costi](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) nella [Guida per l'utente di AWS Billing](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/).
+ Limita l'accesso alle pipeline utilizzando il controllo degli accessi basato sugli attributi. Per ulteriori informazioni, consulta [Controllo dell'accesso in base alle chiavi di tag](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-tag-keys) nella Guida per l'utente IAM.

In OpenSearch Ingestion, la risorsa principale è una pipeline. Puoi utilizzare la console di OpenSearch servizio, la AWS CLI, OpenSearch Ingestion o AWS SDKs per aggiungere APIs, gestire e rimuovere tag da una pipeline.

**Topics**
+ [Autorizzazioni richieste](#pipeline-tag-permissions)
+ [Utilizzo dei tag (console)](#tag-pipeline-console)
+ [Utilizzo dei tag (AWS CLI)](#tag-pipeline-cli)

## Autorizzazioni richieste
<a name="pipeline-tag-permissions"></a>

OpenSearch Ingestion utilizza le seguenti autorizzazioni AWS Identity and Access Management Access Analyzer (IAM) per etichettare le pipeline:
+ `osis:TagResource`
+ `osis:ListTagsForResource`
+ `osis:UntagResource`

*Per ulteriori informazioni su ciascuna autorizzazione, consulta [Azioni, risorse e chiavi di condizione per OpenSearch Ingestion](https://docs.aws.amazon.com/service-authorization/latest/reference/list_opensearchingestionservice.html) nel Service Authorization Reference.*

## Utilizzo dei tag (console)
<a name="tag-pipeline-console"></a>

La console è il modo più semplice per etichettare una pipeline.

****Per creare un tag****

1. Accedi alla console di Amazon OpenSearch Service su [https://console.aws.amazon.com/aos/osis/home](https://console.aws.amazon.com/aos/osis/home#osis/ingestion-pipelines). Ti troverai nella pagina Pipelines.

1. Seleziona la pipeline a cui desideri aggiungere i tag e vai alla scheda **Tag**.

1. Scegli **Gestisci**, quindi seleziona **Aggiungi nuovo tag**.

1. Inserire una chiave di tag e un valore facoltativo.

1. Scegli **Save** (Salva).

Per eliminare un tag, esegui la stessa procedura e scegli **Rimuovi** nella pagina **Gestisci tag**.

Per ulteriori informazioni sull'utilizzo della console per il funzionamento con i tag, consulta [Editor di tag](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/tag-editor.html) nella *Guida alle operazioni di base della Console di gestione AWS *.

## Utilizzo dei tag (AWS CLI)
<a name="tag-pipeline-cli"></a>

Per etichettare una pipeline utilizzando il AWS CLI, invia una `TagResource` richiesta: 

```
aws osis tag-resource
  --arn arn:aws:osis:us-east-1:123456789012:pipeline/my-pipeline 
  --tags Key=service,Value=osis Key=source,Value=otel
```

Rimuovi i tag da una pipeline usando il `UntagResource` comando:

```
aws osis untag-resource
  --arn arn:aws:osis:us-east-1:123456789012:pipeline/my-pipeline
  --tag-keys service
```

Visualizza i tag esistenti per una pipeline con il `ListTagsForResource` comando:

```
aws osis list-tags-for-resource
  --arn arn:aws:osis:us-east-1:123456789012:pipeline/my-pipeline
```