As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Marcação de pipelines de OpenSearch ingestão da Amazon
<a name="tag-pipeline"></a>

As tags permitem que você atribua informações arbitrárias a um pipeline de OpenSearch ingestão da Amazon para que você possa categorizar e filtrar essas informações. Uma *tag* é um rótulo de metadados que você atribui ou AWS atribui a um AWS recurso. Cada tag consiste em uma *chave* e um *valor*. Em tags atribuídas por você, você mesmo define a chave e o valor. Por exemplo, você pode definir a chave como `stage` e o valor de um atributo como `test`.

As tags ajudam a:
+ Identifique e organize seus AWS recursos. Muitos AWS serviços oferecem suporte à marcação, então você pode atribuir a mesma tag a recursos de serviços diferentes para indicar que os recursos estão relacionados. Por exemplo, você pode atribuir a mesma tag a um pipeline OpenSearch de ingestão que você atribui a um domínio do Amazon OpenSearch Service.
+ Acompanhe seus AWS custos. Você ativa essas tags no Gerenciamento de Faturamento e Custos da AWS painel. AWS usa as tags para categorizar seus custos e entregar um relatório mensal de alocação de custos para você. Para saber mais, consulte [ Usar tags de alocação de custos ](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) no [Guia do usuário do AWS Billing](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/).
+ Restrinja o acesso aos pipelines usando controle de acesso baseado em atributos. Para saber mais, consulte [Controlar o acesso baseado em chaves de tag](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-tag-keys) no Guia do Usuário do IAM.

No OpenSearch Ingestion, o recurso principal é um pipeline. Você pode usar o console OpenSearch de serviço, a AWS CLI, o OpenSearch Ingestion APIs ou o AWS SDKs para adicionar, gerenciar e remover tags de um pipeline.

**Topics**
+ [Permissões obrigatórias](#pipeline-tag-permissions)
+ [Uso de tags (console)](#tag-pipeline-console)
+ [Uso de tags (AWS CLI)](#tag-pipeline-cli)

## Permissões obrigatórias
<a name="pipeline-tag-permissions"></a>

OpenSearch A ingestão usa as seguintes permissões AWS Identity and Access Management Access Analyzer (IAM) para marcar pipelines:
+ `osis:TagResource`
+ `osis:ListTagsForResource`
+ `osis:UntagResource`

Para obter mais informações sobre cada permissão, consulte [Ações, recursos e chaves de condição para OpenSearch ingestão](https://docs.aws.amazon.com/service-authorization/latest/reference/list_opensearchingestionservice.html) na *Referência de autorização de serviço*.

## Uso de tags (console)
<a name="tag-pipeline-console"></a>

O console é a maneira mais simples marcar um pipeline com tags.

****Como criar uma tag****

1. Faça login no console do Amazon OpenSearch Service em [https://console.aws.amazon.com/aos/osis/home](https://console.aws.amazon.com/aos/osis/home#osis/ingestion-pipelines). Você estará na página Pipelines.

1. Selecione o pipeline ao qual você deseja adicionar tags e vá para guia **Tags**.

1. Escolha **Gerenciar** e **Adicionar nova tag**.

1. Insira uma chave de tag e um valor opcional.

1. Escolha **Salvar**.

Para excluir uma tag, siga as mesmas etapas e escolha **Remover** na página **Gerenciar tags**.

Para saber mais sobre como usar o console para trabalhar com tags, consulte [Editor de tags](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/tag-editor.html) no *Guia de conceitos básicos do Console de Gerenciamento da AWS *.

## Uso de tags (AWS CLI)
<a name="tag-pipeline-cli"></a>

Para marcar um pipeline usando o AWS CLI, envie uma `TagResource` solicitação: 

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

Remova as tags de um pipeline usando o comando `UntagResource`:

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

É possível exibir as tags existentes para um pipeline com o comando `ListTagsForResource`:

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