Marcação de domínios do Amazon OpenSearch Service

As tags permitem que você atribua informações arbitrárias a um domínio do Amazon OpenSearch Service para que você possa categorizar e filtrar essas informações. Uma tag é um par de valores-chave que você define e associa a um domínio de OpenSearch serviço. Você pode usar essas tags para rastrear custos agrupando despesas para recursos com tags semelhantes. AWS não aplica nenhum significado semântico às suas tags. Tags são interpretadas estritamente como sequências de caracteres. Todas as tags têm os elementos a seguir:

Elemento da tag	Descrição	Obrigatório
Chave de tag	A chave de tags é o nome da tag. A chave deve ser exclusiva para o domínio do OpenSearch serviço ao qual ela está vinculada. Para obter uma lista de restrições básicas a chaves e valores de tag, consulte Restrições a tags definidas pelo usuário.	Sim
Valor da tag	O valor da tag é o valor da string da tag. Os valores de tag podem ser null e não precisam ser exclusivos em um conjunto de tags. Por exemplo, você pode ter um par de chave-valor em um conjunto de tags definido como projeto/Trinity e centro-custos/Trinity. Para obter uma lista de restrições básicas a chaves e valores de tag, consulte Restrições a tags definidas pelo usuário.	Não

Cada domínio OpenSearch de serviço tem um conjunto de tags, que contém todas as tags atribuídas a esse domínio OpenSearch de serviço. AWS não atribui automaticamente nenhuma tag aos domínios OpenSearch de serviço. Um conjunto de tags pode conter entre 0 e 50 tags. Se você adicionar uma tag a um domínio que tenha a mesma chave que uma tag existente, o novo valor sobrescreverá o antigo.

Exemplos de marcação com tags

Você pode usar uma chave para definir uma categoria, e o valor da tag pode ser um item nessa categoria. Por exemplo, você pode definir uma chave de tag de project e um valor de tag deSalix, indicando que o domínio do OpenSearch serviço está atribuído ao projeto Salix. Você também pode usar tags para designar domínios de OpenSearch serviço como sendo usados para teste ou produção usando uma chave como environment=test ou. environment=production Tente usar um conjunto consistente de chaves de tag para facilitar o rastreamento de metadados associados aos domínios OpenSearch de serviço.

Você também pode usar etiquetas para organizar sua AWS fatura de forma a refletir sua própria estrutura de custos. Para fazer isso, inscreva-se para receber sua Conta da AWS fatura com os valores-chave da etiqueta incluídos. Organize então suas informações de faturamento de acordo com recursos com os mesmos valores de chave de tag para ver o custo de recursos combinados. Por exemplo, você pode marcar vários domínios de OpenSearch serviço com pares de valores-chave e, em seguida, organizar suas informações de cobrança para ver o custo total de cada domínio em vários serviços. Para obter mais informações, consulte Como usar tags de alocação de custos na documentação do AWS Billing and Cost Management.

nota

As tags são armazenados em cache para finalidade de autorização. Por esse motivo, as adições e atualizações de tags nos domínios OpenSearch de serviço podem levar alguns minutos até serem disponibilizadas.

Uso de tags (console)

O console é a maneira mais simples marcar um domínio com tags.

Para criar uma tag (console)

1. Vá para https://aws.amazon.com e escolha Fazer login no console.

2. Em Analytics, escolha Amazon OpenSearch Service.

3. Selecione o domínio ao qual você deseja adicionar tags e vá para guia Tags (Etiquetas).

4. Escolha Manage (Gerenciar) e Add new tag (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)

Você pode criar tags de recursos usando o --add-tags comando AWS CLI with the.

Sintaxe

add-tags --arn=<domain_arn> --tag-list Key=<key>,Value=<value>

Parâmetro	Descrição
--arn	Nome do recurso da Amazon para o domínio do OpenSearch serviço ao qual a tag está anexada.
--tag-list	Conjunto de pares de chave/valor separados por espaço no seguinte formato: Key=<key>,Value=<value>

Exemplo

O exemplo a seguir cria duas tags para o domínio logs:

aws opensearch add-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs --tag-list Key=service,Value=OpenSearch Key=instances,Value=m3.2xlarge

Você pode remover tags de um domínio OpenSearch de serviço usando o --remove-tags comando.

Sintaxe

remove-tags --arn=<domain_arn> --tag-keys Key=<key>,Value=<value>

Parâmetro	Descrição
--arn	Nome de recurso da Amazon (ARN) para o domínio do OpenSearch serviço ao qual a tag está anexada.
--tag-keys	Conjunto de pares de valores-chave separados por espaço que você deseja remover do domínio do Serviço. OpenSearch

Exemplo

O exemplo a seguir remove duas tags do domínio logs que foram criadas no exemplo anterior:

aws opensearch remove-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs --tag-keys service instances

Você pode visualizar as tags existentes para um domínio OpenSearch de serviço com o --list-tags comando:

Sintaxe

list-tags --arn=<domain_arn>

Parâmetro	Descrição
--arn	Nome de recurso da Amazon (ARN) para o domínio do OpenSearch serviço ao qual as tags estão anexadas.

Exemplo

O exemplo a seguir lista todas as tags de recurso para o domínio logs:

aws opensearch list-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs

Trabalhando com tags (AWS SDKs)

Os AWS SDKs (exceto os SDKs para Android e iOS) oferecem suporte a todas as ações definidas na Amazon OpenSearch Service API Reference, incluindo as AddTags operaçõesListTags, e. RemoveTags Para obter mais informações sobre como instalar e usar os AWS SDKs, consulte KitsAWS de desenvolvimento de software.

Python

Este exemplo usa o cliente Python de OpenSearchServicebaixo nível do AWS SDK para Python (Boto) para adicionar uma tag a um domínio, listar a tag anexada ao domínio e remover uma tag do domínio. É necessário fornecer valores para DOMAIN_ARN, TAG_KEY e TAG_VALUE.

import boto3
from botocore.config import Config  # import configuration

DOMAIN_ARN = ''  # ARN for the domain. i.e "arn:aws:es:us-east-1:123456789012:domain/my-domain
TAG_KEY = ''  # The name of the tag key. i.e 'Smileyface'
TAG_VALUE = ''  # The value assigned to the tag. i.e 'Practicetag'

# defines the configurations parameters such as region

my_config = Config(region_name='us-east-1')
client = boto3.client('opensearch', config=my_config)


# defines the client variable

def addTags():
    """Adds tags to the domain"""

    response = client.add_tags(ARN=DOMAIN_ARN,
                               TagList=[{'Key': TAG_KEY,
                                         'Value': TAG_VALUE}])

    print(response)


def listTags():
    """List tags that have been added to the domain"""

    response = client.list_tags(ARN=DOMAIN_ARN)
    print(response)


def removeTags():
    """Remove tags that have been added to the domain"""

    response = client.remove_tags(ARN=DOMAIN_ARN, TagKeys=[TAG_KEY])

    print('Tag removed')
    return response