Marcação de recursos do Amazon EMR no EKS

Para ajudar no gerenciamento de recursos do Amazon EMR no EKS, você pode atribuir seus próprios metadados a cada recurso usando etiquetas. Este tópico fornece uma visão geral da função das etiquetas e mostra como você pode criá-las.

Conceitos básicos de tags

Uma etiqueta é um rótulo atribuído a um recurso da AWS. Cada tag consiste em uma chave e um valor opcional, ambos definidos por você.

As etiquetas possibilitam categorizar os recursos da AWS por atributos como finalidade, proprietário ou ambiente. Quando você tem muitos recursos do mesmo tipo; é possível identificar rapidamente um recurso específico com base nas tags que você atribuiu a ele. Por exemplo, é possível definir um conjunto de etiquetas para os clusters do Amazon EMR no EKS para ajudar a rastrear o proprietário e o nível da pilha de cada cluster. Recomendamos planejar um conjunto consistente de chaves de etiquetas para cada tipo de recurso. Você pode pesquisar e filtrar os recursos de acordo com as tags que adicionar.

Além disso, as tags não são automaticamente atribuídas aos recursos. Depois de adicionar uma tag, você pode editar as chaves e os valores das tags ou remover tags de um recurso a qualquer momento. Se você excluir um recurso, todas as tags do recurso também serão excluídas.

As etiquetas não têm significado semântico para o Amazon EMR no EKS e são interpretadas estritamente como uma string de caracteres.

Um valor de tag pode ser uma string vazia, mas não nula. Uma chave de etiqueta não pode ser uma string vazia. Se você adicionar uma etiqueta que tenha a mesma chave de uma etiqueta existente nesse recurso, o novo valor substituirá o antigo.

Se você estiver usando o AWS Identity and Access Management (IAM), poderá controlar quais usuários na sua conta da AWS têm permissão para gerenciar etiquetas.

Para obter exemplos de políticas de controle de acesso por etiquetas, consulte Políticas para controle de acesso baseado em etiquetas.

Marcar com tag os recursos do

Você pode etiquetar clusters virtuais e execuções de trabalhos novos ou existentes que estão em estados ativos. Os estados ativos para execuções de trabalhos incluem: PENDING, SUBMITTED, RUNNING e CANCEL_PENDING. Os estados ativos para clusters virtuais incluem: RUNNING, TERMINATING e ARRESTED. Para obter mais informações, consulte Estados de execução de trabalho e Estados de um cluster virtual.

Quando um cluster virtual é encerrado, as etiquetas são limpas e não ficam mais acessíveis.

Se você estiver usando a API do Amazon EMR no EKS, a AWS CLI ou um AWS SDK, poderá aplicar etiquetas a novos recursos usando o parâmetro de etiquetas na ação da API relevante. Você também pode aplicar etiquetas aos recursos usando a ação da API TagResource.

Você pode usar algumas ações de criação de recursos para especificar etiquetas para um recurso quando ele for criado. Nesse caso, se as etiquetas não puderem ser aplicadas enquanto o recurso estiver sendo criado, ele não será criado. Esse mecanismo garante que os recursos que você pretende etiquetar na criação sejam criados com as etiquetas especificadas ou não sejam criados. Se você etiquetar os recursos no momento da criação, não precisará executar os scripts de marcação personalizados após a criação do recurso.

A tabela a seguir descreve os recursos do Amazon EMR no EKS que podem ser etiquetados.

Recurso	Compatível com tags	Oferece suporte à propagação de tags	Oferece suporte à marcação na criação (API do Amazon EMR no EKS, AWS CLI e AWS SDK)	API para criação (etiquetas podem ser adicionadas durante a criação)
Cluster virtual	Sim	Não. As etiquetas associadas a um cluster virtual não se propagam para execuções de trabalhos enviadas a esse cluster virtual.	Sim	CreateVirtualCluster
Execuções de trabalhos	Sim	Não	Sim	StartJobRun

Restrições de tags

As restrições básicas a seguir se aplicam às tags:

• Número máximo de tags por recurso: 50

• Em todos os recursos, cada chave de etiqueta deve ser exclusiva e pode ter apenas um valor.

• Comprimento máximo da chave: 128 caracteres Unicode em UTF-8

• Comprimento máximo do valor: 256 caracteres Unicode em UTF-8

• Se seu esquema de marcação for usado em vários serviços e recursos da AWS, lembre-se de que outros serviços podem ter restrições nos caracteres permitidos. Em geral, os caracteres permitidos são: letras, números, espaços representáveis em UTF-8 e os seguintes caracteres: + - = . _ : / @.

• As chaves e os valores de tags diferenciam maiúsculas de minúsculas.

• Um valor de tag pode ser uma string vazia, mas não nula. Uma chave de etiqueta não pode ser uma string vazia.

• Não use aws:, AWS: ou qualquer combinação de letras maiúsculas e minúsculas como prefixo para chaves ou valores. Esses são reservados para uso pela AWS.

Trabalho com etiquetas usando a AWS CLI e a API do Amazon EMR no EKS

Use os comandos apresentados a seguir da AWS CLI ou as operações da API do Amazon EMR no EKS para adicionar, atualizar, listar e excluir as etiquetas dos seus recursos.

Tarefa	AWS CLI	Ação de API
Adicione ou substitua uma ou mais tags	tag-resource	TagResource
Listar as tags de um recurso	list-tags-for-resource	ListTagsForResource
Exclua uma ou mais tags	untag-resource	UntagResource

Os exemplos a seguir mostram como marcar ou desmarcar recursos usando a AWS CLI.

Exemplo 1: etiquetar um cluster virtual existente

O comando a seguir realiza a marcação de um cluster virtual existente.

aws emr-containers tag-resource --resource-arn resource_ARN --tags team=devs

Exemplo 2: remover a etiqueta de um cluster virtual existente

O comando a seguir exclui uma etiqueta de um cluster virtual existente.

aws emr-containers untag-resource --resource-arn resource_ARN --tag-keys tag_key

Exemplo 3: listar etiquetas para um recurso

O comando a seguir lista as tags associadas a um recurso existente.

aws emr-containers list-tags-for-resource --resource-arn resource_ARN