Uso de tags nos pipelines de Ingestão do Amazon OpenSearch

As tags permitem atribuir informações arbitrárias a um pipeline de Ingestão do Amazon OpenSearch para que você possa categorizar e filtrar por essas informações. Uma tag é um rótulo de metadados que você ou a AWS atribui a um recurso da AWS. Cada tag consiste em uma chave e um valor. Para tags atribuídas por você, é possível definir a chave e o valor. Por exemplo, talvez você defina a chave como stage e o valor de recurso como test.

As tags ajudam você a fazer o seguinte:

• Identificar e organizar seus recursos da AWS. Muitos serviços da AWS oferecem suporte à marcação para que você possa atribuir a mesma tag a recursos de diferentes serviços para indicar que os recursos estão relacionados. Por exemplo, é possível atribuir a mesma tag a um pipeline de Ingestão do OpenSearch que você atribui a um domínio do Amazon OpenSearch Service.

• Monitorar seus custos da AWS. Você pode ativar essas tags no painel do AWS Billing and Cost Management. A AWS usa as tags para categorizar seus custos e entregar um relatório mensal de alocação de custos para você. Para obter mais informações, consulte Usar tags de alocação de custos no Guia do usuário do AWS Billing.

• Restrinja o acesso aos pipelines usando controle de acesso baseado em atributos. Para obter mais informações, consulte Controlar o acesso baseado em chaves de tag no Guia do Usuário do IAM.

Na Ingestão do OpenSearch, o principal recurso é um pipeline. Você pode usar o console do OpenSearch Service, o CLI AWS, APIs de Ingestão do OpenSearch ou os SDKs da AWS para adicionar, gerenciar e remover tags de um pipeline.

Permissões obrigatórias

A Ingestão do OpenSearch usa as seguintes permissões do (IAM) AWS Identity and Access Management Access Analyzer para aplicar tags em pipelines:

• osis:TagResource

• osis:ListTagsForResource

• osis:UntagResource

Para mais informações sobre cada permissão, consulte Ações, recursos e chaves de condição para a Ingestão do OpenSearch na Referência de autorização do serviço.

Uso de tags (console)

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/home.

2. No painel de navegação à esquerda, escolha Ingestão.

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

4. Escolha Gerenciar e Adicionar nova tag.

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

6. Escolha Salvar.

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

Para obter mais informações sobre como usar o console para trabalhar com tags, consulte Editor de tags no Guia de conceitos básicos do Console de GerenciamentoAWS.

Uso de tags (AWS CLI)

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

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