Atribuição de tag a domínios do Amazon Elasticsearch Service - Amazon Elasticsearch Service

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á.

Atribuição de tag a domínios do Amazon Elasticsearch Service

Você pode usar tags do Amazon ES para adicionar metadados aos domínios do Amazon ES. A 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
Chave de tag A chave de tags é o nome obrigatório da tag. As chaves de tag devem ser exclusivas ao domínio do Amazon ES ao qual elas são anexadas. Para obter uma lista de restrições básicas a chaves e valores de tag, consulte Restrições a tags definidas pelo usuário.
Valor de tag O valor da tag é um valor de string opcional 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.

Cada domínio do Amazon ES tem um conjunto que contém todas as tags atribuídas a ele. O Amazon ES não define automaticamente nenhuma tag nos domínios do AWS.Amazon ES Um conjunto de tags pode conter até 50 tags ou estar vazio. Se você adicionar uma tag a um recurso do Amazon ES que tenha a mesma chave que uma tag existente no recurso, o novo valor substituirá o antigo.

Você pode usar essas tags para monitorar custos agrupando despesas de recursos marcados com tags semelhantes. Uma tag do domínio do Amazon ES é um par de nome/valor que você define e associa a um domínio do Amazon ES. O nome é referido como chave. É possível usar tags para atribuir informações arbitrárias a um domínio do Amazon ES. Uma chave de tag pode ser usada, por exemplo, para definir uma categoria, e o valor da tag pode ser um item nessa categoria. Por exemplo, você pode definir uma chave de tag como "projeto" e um valor de tag como "Salix", indicando que o domínio do Amazon ES é atribuído ao projeto Salix. As tags também podem ser usadas para designar domínios do Amazon ES como sendo usados para testes ou produção, usando uma chave como environment=test ou environment=production. Recomendamos que você use um conjunto consistente de chaves de tags para facilitar o monitoramento de metadados associados aos domínios do Amazon ES.

Também é possível usar tags para organizar sua conta AWS para refletir sua própria estrutura de custo. Para isso, inscreva-se para obter sua conta da AWS com os valores de chave de tag 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 atribuir tags a vários domínios do Amazon ES com pares de chave/valor e em seguida organizar suas informações de faturamento para ver o custo total para 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 isso, as adições e atualizações de tag em domínios do Amazon ES podem demorar alguns minutos para ser disponibilizadas.

Uso de tags (console)

Use o procedimento a seguir para criar uma tag de recurso.

Para criar uma tag (console)

  1. Acesse https://aws.amazon.com e escolha Sign In to the Console.

  2. Em Analytics, escolha Elasticsearch Service.

  3. No painel de navegação, escolha o domínio do Amazon ES.

  4. No painel do domínio, escolha Manage tags.

  5. Na coluna Key (Chave), digite a chave da tag.

  6. (Opcional) Na coluna Value (Valor), digite o valor da tag.

  7. Selecione Enviar.

Para excluir uma tag (console)

Use o procedimento a seguir para excluir uma tag de recurso.

  1. Acesse https://aws.amazon.com e escolha Sign In to the Console.

  2. Em Analytics, escolha Elasticsearch Service.

  3. No painel de navegação, escolha o domínio do Amazon ES.

  4. No painel do domínio, escolha Manage tags.

  5. Ao lado da tag que você deseja excluir, escolha Remove.

  6. Selecione Enviar.

Para obter mais informações sobre como usar o console para trabalhar com tags, consulte Working with Tag Editor no AWS Management Console Getting Started Guide.

Uso de tags (AWS CLI)

Você pode criar tags de recurso na AWS CLI com o comando --add-tags.

Sintaxe

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

Parâmetro Descrição
--arn Nome de recurso da Amazon para o domínio do Amazon ES 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 es add-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs --tag-list Key=service,Value=Elasticsearch Key=instances,Value=m3.2xlarge

Você pode remover as tags de um domínio do Amazon ES usando o comando remove-tags.

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 Amazon ES ao qual a tag está anexada.
--tag-keys Conjunto de pares de chave/valor separados por espaço que você deseja remover domínio do Amazon ES.

Exemplo

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

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

Você pode visualizar as tags para um domínio do Amazon ES com o comando list-tags:

Sintaxe

list-tags --arn=<domain_arn>

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

Exemplo

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

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

Trabalhar com tags (AWS SDKs)

O AWS SDKs (exceto SDKs Android e iOS) é compatível com todas as ações definidas em Referência sobre a API de configuração do Amazon ES, incluindo as operações , AddTags e ListTags.RemoveTags Para obter mais informações sobre como instalar e usar o AWS SDKs, consulte Kits de desenvolvimento de software da AWS.