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 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 | Description | 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](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html). | 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 valores-chave em um conjunto de tags de. project/Trinity and cost-center/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](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html). | 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 de`Salix`, 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 saber mais, consulte [Como usar tags de alocação de custos](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) 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.
# Marcação de domínios (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](https://aws.amazon.com/ ), e escolha **Sign In to the Console** (Faça login no Console).
1. Em **Analytics**, escolha **Amazon OpenSearch Service**.
1. Selecione o domínio ao qual você deseja adicionar tags e vá para guia **Tags** (Etiquetas).
1. Escolha **Manage** (Gerenciar) e **Add new tag** (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 *.
# Marcação de domínios (AWS CLI)
Você pode criar tags de recursos usando o **--add-tags** comando AWS CLI with the.
**Sintaxe**
`add-tags --arn= --tag-list Key=,Value=`
****
| Parâmetro | Description |
| --- | --- |
| --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=,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= --tag-keys Key=,Value=`
****
| Parâmetro | Description |
| --- | --- |
| --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=`
****
| Parâmetro | Description |
| --- | --- |
| --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
```
# Marcação de domínios (AWS SDKs)
O AWS SDKs (exceto o Android e o iOS SDKs) suporta todas as ações definidas na [Amazon OpenSearch Service API Reference](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/Welcome.html)`AddTags`, incluindo as `RemoveTags` operações`ListTags`, e. Para obter mais informações sobre como instalar e usar o AWS SDKs, consulte [Kits AWS de desenvolvimento de software](https://aws.amazon.com/code).
## **Python**
Este exemplo usa o cliente Python de [OpenSearchService](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/opensearch.html)baixo nível AWS do 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
```