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.
Tópicos
Conceitos Básicos de Tags
Uma tag um rótulo atribuído a um recurso 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. Caso possua muitos recursos do mesmo tipo, você pode identificar rapidamente um recurso específico com base nas tags atribuídas 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.
Tags não são automaticamente atribuídas aos recursos. Após adicionar uma tag, você pode editar as chaves e os valores das tags ou removê-las de um recurso a qualquer momento. Caso exclua um recurso, todas as respectivas tags 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 ter 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 | Compatível com a 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 a tags:
-
Número máximo de tags por recurso –- 50
-
Em todos os recursos, cada chave de tag deve ser exclusiva e possuir 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
-
Caso seu esquema de marcação seja usado em vários serviços e recursos AWS, lembre-se de que outros serviços podem possuir restrições em caracteres permitidos. Em geral, caracteres permitidos incluem letras, números, espaços representáveis em UTF-8 e os caracteres + - = . _ : / @.
-
Chaves e 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 API |
|---|---|---|
| Adicione ou substitua uma ou mais tags | tag-resource | TagResource |
| Listar as tags para 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 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-arnresource_ARN--tagsteam=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-arnresource_ARN--tag-keystag_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-arnresource_ARN
