Marcando seus Recursos AWS Batch

Para ajudar no gerenciamento de recursos AWS Batch, você pode atribuir seus próprios metadados a cada recurso em forma de tags. Este tópico descreve as tags e como criá-las.

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 tags permitem categorizar seus recursos AWS por finalidade, proprietário ou ambiente, por exemplo. 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 tags para seus serviços AWS Batch para ajudá-lo a rastrear o proprietário e nível da pilha de cada serviço. Recomendamos planejar um conjunto consistente de chaves de tags para cada tipo de recurso.

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 tags não têm significado semântico atrelado a AWS Batch e são interpretadas estritamente como string de caracteres. É possível definir o valor de uma tag em uma string vazia, mas não configurar o valor de um tag como nula. Caso adicione uma tag com a mesma chave de outra existente no recurso, o novo valor substituirá o antigo.

Você pode trabalhar com tags usando AWS Management Console, AWS CLI e API de AWS Batch.

Caso esteja usando AWS Identity and Access Management (IAM), você pode controlar quais usuários em sua conta AWS têm permissão para criar, editar ou excluir tags.

Marcando seus Recursos

Você pode marcar ambientes de computação AWS Batch, tarefas, definições de tarefas, filas de tarefas, políticas de agendamento novas ou existentes.

Caso esteja usando o console AWS Batch, você pode aplicar tags a novos recursos quando estes forem criados ou a recursos existentes a qualquer momento, por meio da guia Tags na página de recursos relevante.

Caso esteja usando a API AWS Batch, AWS CLI ou SDK AWS, é possível aplicar tags a novos recursos por meio do parâmetro tags na ação API relevante ou, para recursos existentes, da ação API TagResource. Para mais informações, consulte TagResource.

Algumas ações de criação de recursos permitem especificar tags para um recurso quando o mesmo for criado. Caso as tags não possam ser aplicadas durante a criação dos recursos, haverá falha no processo de criação de recursos. Isso garante que recursos que você pretenda marcar na criação sejam criados com as tags especificadas ou não. Caso marque recursos no momento da criação, não precisará executar scripts de marcação personalizados após a criação do recurso.

A tabela a seguir descreve os recursos AWS Batch que podem ser marcados com tags e aqueles que podem ser marcados na criação.

Suporte à marcação para recursos AWS Batch
Recurso	Compatível com tags	Compatível com a propagação de tags	Compatível com o uso de tags na criação (API AWS Batch, AWS CLI e SDK AWS)
Ambientes de computação AWS Batch	Sim	Não. As tags de ambiente de computação não são propagadas para nenhum outro recurso. Tags para recursos são especificadas nas tags membros do objeto ComputerResources transmitidas na operação API CreateComputeEnvironment.	Sim
Tarefas AWS Batch	Sim	Sim	Sim
Definições de trabalho AWS Batch	Sim	Não	Sim
Filas de tarefa AWS Batch	Sim	Não	Sim
Políticas de agendamento AWS Batch	Sim	Não	Sim

Restrições de tag

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.

• Não use aws:, AWS: ou qualquer combinação de letras maiúsculas e minúsculas como um prefixo para chaves ou valores, uma vez que as mesmas são reservadas para uso AWS. Você não pode editar nem excluir chaves ou valores de tags com esse prefixo. Tags com esse prefixo não contam em limites de tags por recurso.

Trabalhando com tags usando o console

Ao utilizar o console do AWS Batch, você gerencia as tags associadas a ambientes de computação, tarefas, definições de tarefas e filas de tarefas novas ou existentes.

Adicionar tags a um recurso individual na criação

Você pode adicionar tags a ambientes de computação AWS Batch, tarefas, definições de tarefas, filas de tarefas e políticas de agendamento ao criá-las.

Adicionando e excluindo tags em um recurso individual

AWS Batch permite adicionar ou excluir tags associadas a clusters diretamente na página do recurso.

Para adicionar ou excluir uma etiqueta em um recurso individual

1. Abra o console AWS Batch em https://console.aws.amazon.com/batch/.

2. Na barra de navegação, escolha a Região a ser usada.

3. No painel de navegação, escolha um tipo de recurso (por exemplo, Filas de Tarefas).

4. Escolha um recurso específico e, em seguida, Editar Tags.

5. Adicione ou exclua tags conforme necessário.

   • Para adicionar uma tag, especifique a chave e o valor nas caixas de texto vazias ao final da lista.

   • Para excluir uma tag, escolha o botão ao lado.

6. Repita esse processo para cada tag que desejar adicionar ou excluir e escolha Editar Tags para concluir.

Trabalhar com tags usando CLI ou a API

Use os seguintes comandos AWS CLI ou operações API AWS Batch para adicionar, atualizar, listar e excluir as tags de seus recursos.

Suporte à marcação para recursos AWS Batch
Tarefa	Ação API	AWS CLI	AWS Tools for Windows PowerShell
Adicione ou sobrescreva uma ou mais tags.	TagResource	tag-resource	Add-BATResourceTag
Exclua uma ou mais tags.	UntagResource	untag-resource	Remove-BATResourceTag
Listar as tags para um recurso	ListTagsForResource	list-tags-for-resource	Get-BATResourceTag

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

Exemplo 1: marcar um recurso existente

O comando a seguir marca um recurso existente.

aws batch tag-resource --resource-arn resource_ARN --tags team=devs

Exemplo 2: desmarcar um recurso existente

O comando a seguir exclui uma tag de um recurso existente.

aws batch 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 batch list-tags-for-resource --resource-arn resource_ARN

Algumas ações de criação de recursos permitem especificar tags ao criar o recurso. As ações a seguir são compatíveis com o uso de tags na criação.

Tarefa	Ação API	AWS CLI	AWS Tools for Windows PowerShell
Criar um ambiente de computação	CreateComputeEnvironment	create-compute-environment	New-BATComputeEnvironment
Criar uma fila de tarefas	CreateJobQueue	create-job-queue	New-BATJobQueue
Criar uma política de agendamento	Criar política de agendamento	create-scheduling-policy	New-BATSchedulingPolicy
Registrar uma definição de tarefa	RegisterJobDefinition	register-job-definition	Register-BATJobDefinition
Enviar uma tarefa	SubmitJob	submit-job	Submit-BATJob