Marcar recursos do Amazon ECS

Para ajudar a gerenciar os recursos do Amazon ECS, você pode, opcionalmente, atribuir seus próprios metadados a cada recurso usando etiquetas. Cada tag consiste em uma chave e um valor opcional.

Você pode usar tags para categorizar seus recursos do Amazon ECS de diferentes formas, p. ex., por finalidade, proprietário ou ambiente. Isso é útil quando você tem muitos recursos do mesmo tipo. É possível identificar rapidamente um recurso específico com base nas tags atribuídas a ele. Por exemplo, você pode definir um conjunto de tags para as instâncias de contêiner do Amazon ECS da sua conta. Isso ajuda você a rastrear o proprietário e o nível de pilha de cada instância.

Você pode usar tags para seus relatórios de custo e uso. É possível usar esses relatórios para analisar o custo e o uso de seus recursos do Amazon ECS. Para obter mais informações, consulte Relatórios de uso do Amazon ECS.

Atenção

As chaves de tag e seus valores são apresentados por várias chamadas de API diferentes. Negar acesso ao DescribeTags não nega automaticamente acesso às tags apresentadas por outras APIs. Como uma prática recomendada, sugerimos que você não inclua dados confidenciais nas suas tags.

Recomendamos que você desenvolva um conjunto de chave de tags que atenda suas necessidades para cada tipo de recurso. Você pode usar um conjunto consistente de chaves de tags para um gerenciamento mais fácil de seus recursos. É possível pesquisar e filtrar os recursos de acordo com as tags que adicionar.

As etiquetas não têm significado semântico no Amazon ECS e são interpretadas estritamente como uma string de caracteres. É possível editar chaves de tags e valores, e é possível remover as tags de um recurso a qualquer momento. É possível definir o valor de uma tag a uma string vazia, mas não pode configurar o valor de um tag como nula. Se você adicionar uma etiqueta que tenha a mesma chave de uma etiqueta existente nesse recurso, o novo valor substituirá o antigo. Se você excluir um recurso, todas as tags do recurso também serão excluídas.

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.

Como os recursos são marcados

Há várias maneiras para marcar as tarefas, serviços, definições de tarefa e clusters do Amazon ECS:

• Um usuário marca manualmente um recurso usando o AWS Management Console, a API do Amazon ECS, a AWS CLI ou um AWS SDK.

• Um usuário cria um serviço ou executa uma tarefa autônoma e seleciona a opção de tags gerenciadas pelo Amazon ECS.

  O Amazon ECS marca automaticamente todas as tarefas recém-iniciadas. Para obter mais informações, consulte Tags gerenciadas pelo Amazon ECS.

• Um usuário cria um recurso usando o console. O console marca automaticamente os recursos.

  Essas tags são retornadas nas respostas doAWS CLI, e do AWS SDK e são exibidas no console. Você não pode modificar nem excluir essas tags.

  Para obter informações sobre as tags adicionadas, consulte a coluna Tags adicionadas automaticamente pelo console na tabela Suporte à marcação para recursos do Amazon ECS.

Se você especificar tags ao criar um recurso e não for possível aplicá-las, o Amazon ECS reverterá o processo de criação. Isso garante que os recursos sejam criados com tags ou, então, não criados, e que nenhum recurso seja deixado sem tags. Ao marcar os recursos no momento da criação, você elimina a necessidade de executar scripts personalizados de marcação após a criação do recurso.

A tabela a seguir descreve os recursos do Amazon ECS compatíveis com as marcações.

Suporte à marcação para recursos do Amazon ECS
Recurso	Compatível com tags	Oferece suporte à propagação de tags	Tags adicionadas automaticamente pelo console
Tarefas do Amazon ECS	Sim	Sim, a partir da definição de tarefa.	Chave: aws:ecs:clusterName Value (Valor): cluster-name
Serviços do Amazon ECS	Sim	Sim, da definição de tarefa ou do serviço para as tarefas no serviço.	Chave: ecs:service:stackId Valor: arn:aws:cloudformation:arn
Conjuntos de tarefas do Amazon ECS	Sim	Não	N/D
Definições de tarefa do Amazon ECS	Sim	Não	Chave: ecs:taskDefinition:createdFrom Value (Valor): ecs-console-v2
Clusters do Amazon ECS	Sim	Não	Chave: aws:cloudformation:logical-id Value (Valor): ECSCluster Chave: aws:cloudformation:stack-id Value (Valor): arn:aws:cloudformation:arn Chave: aws:cloudformation:stack-name Value (Valor): ECS-Console-V2-Cluster-EXAMPLE
Instâncias externas do Amazon ECS	Sim	Não	N/D
Provedor de capacidade do Amazon ECS	Sim. Não é possível marcar provedores de capacidade FARGATE e FARGATE_SPOT predefinidos.	Não	N/D

Marcar recursos na criação

Os seguintes recursos oferecem suporte à marcação na criação usando a API, SDK do Amazon ECSAWS CLI: AWS

• Tarefas do Amazon ECS

• Serviços do Amazon ECS

• Definição de tarefa do Amazon ECS

• Conjuntos de tarefas do Amazon ECS

• Clusters do Amazon ECS

• Instâncias de contêiner do Amazon ECS

• Provedores de capacidade do Amazon ECS

O Amazon ECS tem a opção de usar a autorização de marcação para a criação de recursos. Para usar o recurso, execute as seguintes etapas:

• Você deve optar pelo recurso. Para obter mais informações, consulte Autorização de marcação.

• Depois de se inscrever, os usuários devem ter permissões para as ações que criam o recurso, comoecsCreateCluster. Se as tags forem especificadas na ação de criação de recursos, AWS executará uma autorização adicional para verificar se os usuários ou funções têm permissão para criar tags. Portanto, você deve conceder permissões explícitas para usar a ecs:TagResource ação. Para obter mais informações, consulte Conceder permissão para marcar recursos na criação.

Restrições de tags

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

• Podem ser associadas no máximo 50 tags a um recurso.

• As chaves de tag não podem ser repetidas para um recurso. As chaves de tag devem ser exclusivas, e cada chave só pode ter um valor.

• As chaves podem ter até 128 caracteres em UTF-8.

• Os valores podem ter até 256 caracteres em UTF-8.

• Se vários Serviços da AWS e recursos usam seu esquema de tags, limite os tipos de caracteres que você usa. Alguns serviços podem ter restrições quanto aos caracteres permitidos. Em geral, os caracteres permitidos são letras, números, espaços e os seguintes caracteres: + - = . _ : / @.

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

• Não é possível usar 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. Você não pode editar nem excluir chaves nem valores de etiquetas com esse prefixo. Tags com esse prefixo não contam para seu tags-per-resource limite.

Tags gerenciadas pelo Amazon ECS

Quando você usa tags gerenciadas pelo Amazon ECS, o Amazon ECS marca automaticamente todas as tarefas recém-iniciadas com as informações do cluster e as tags de definição de tarefa ou de serviço adicionadas pelo usuário. Veja a seguir uma descrição das tags adicionadas:

• Tarefas autônomas: uma tag com uma Chave como aws:ecs:clusterName e um Valor definido como o nome do cluster. Todas as tags de definição de tarefa que foram adicionadas pelos usuários.

• Tarefas que fazem parte de um serviço: uma tag com uma Chave como aws:ecs:clusterName e um Valor definido como o nome do cluster. Uma tag com uma Chave como aws:ecs:serviceName e um Valor definido como o nome do serviço. Tags de um dos seguintes recursos:

  • Definições de tarefa: todas as tags de definição de tarefa que foram adicionadas pelos usuários.

  • Serviços: todas as tags de serviço que foram adicionadas pelos usuários.

As seguintes opções são necessárias para este recurso:

• É necessário que aceitar os novos formatos do nome do recurso da Amazon (ARN) e do identificador do recurso (ID). Para obter mais informações, consulte Nomes de recursos da Amazon (ARNs) e IDs.

• Ao usar as APIs para criar um serviço ou executar uma tarefa, é necessário definir enableECSManagedTags como true para run-task e create-service. Para obter mais informações, consulte create-service e run-task na Referência da API do AWS Command Line Interface.

• O Amazon ECS usa tags gerenciadas para determinar quando alguns recursos estão habilitados, por exemplo, o Auto Scaling de cluster. Recomendamos que você não modifique manualmente as tags para que o Amazon ECS possa gerenciar os recursos com eficiência.

Marcar recursos para faturamento

Você pode usar tags gerenciadas pelo Amazon ECS ou tags adicionadas pelo usuário para seu relatório de custo e uso. Para obter mais informações, consulte Relatórios de uso do Amazon ECS.

Para ver o custo dos recursos combinados, é possível organizar as informações de faturamento com base nos recursos com os mesmos valores da chave da tag. Por exemplo, é possível etiquetar vários recursos com um nome de aplicação específico, e depois organizar suas informações de faturamento para ver o custo total daquela aplicação em vários serviços. Para obter mais informações sobre como configurar um relatório de alocação de custos com etiquetas, consulte Relatório mensal de alocação de custos no Guia do usuário do AWS Billing.

Além disso, você pode ativar a divisão de dados de alocação de custos para obter dados de uso de CPU e memória em nível de tarefa em seus relatórios de custo e uso. Para obter mais informações, consulte Relatórios de custo e uso em nível de tarefa.

nota

Se você ativou os relatórios, pode levar até 24 horas até que os dados do mês atual estejam disponíveis para visualização.

Trabalhar com tags usando o console

Usando o console do Amazon ECS, você pode gerenciar as tags associadas a tarefas, serviços, definições de tarefa, clusters ou instâncias de contêiner novas ou existentes.

Quando você selecionar uma página específica do recurso no console do Amazon ECS, ela exibirá uma lista destes recursos. Por exemplo, se você selecionar Clusters no painel de navegação, o console exibirá uma lista dos clusters do Amazon ECS. Ao selecionar um recurso de uma dessas listas (por exemplo, um cluster específico), que seja compatível com as etiquetas, você poderá vê-las e gerenciá-las na guia Tags (Etiquetas).

Atenção

Como uma prática recomendada, sugerimos que você não inclua dados confidenciais nas suas tags.

Adição de etiquetas a um recurso individual durante a inicialização

Você pode usar os seguintes recursos para especificar tags ao criar o recurso.

Tarefa	Console
Execute uma ou mais tarefas.	Execução de uma tarefa autônoma usando o console do Amazon ECS
Crie um serviço.	Criar um serviço usando o console
Crie um conjunto de tarefas.	Implantação externa
Registre uma definição de tarefa.	Criação de uma definição de tarefa usando o console
Crie um cluster.	Criação de um cluster para o tipo de lançamento Fargate e External usando o console

Gerenciar tags de recursos individuais usando o console

O Amazon ECS permite adicionar ou excluir etiquetas associadas a seus clusters, serviços, tarefas e definições de tarefa diretamente na página do recurso.

Atenção

Não adicione informações de identificação pessoal (PII) nem outras informações confidenciais ou sigilosas em tags. As tags são acessíveis a muitos serviços da AWS, incluindo faturamento. As tags não devem ser usadas para dados privados ou confidenciais.

Para modificar uma tag de um recurso individual

1. Abra o console em https://console.aws.amazon.com/ecs/v2.

2. Na barra de navegação, selecione a Região da AWS a ser usada.

3. No painel de navegação, selecione um tipo de recurso (por exemplo, Clusters).

4. Selecione o recurso na lista de recursos, escolha a guia Tags e, em seguida, escolha Manage tags (Gerenciar tags).

5. Configure suas tags.

   [Adicionar uma etiqueta] Escolha Add tag (Adicionar etiqueta) e faça o seguinte:

   • Em Key (Chave), insira o nome da chave.

   • Em Value (Valor), insira o valor da chave.

   [Remover uma tag] Escolha Remover à direita da chave e do valor da tag.

6. Escolha Salvar.

Trabalhar com tags usando a CLI ou a API

Use o seguinte para adicionar, atualizar, listar e excluir as tags para seus recursos. A documentação correspondente traz exemplos.

Atenção

Não adicione informações de identificação pessoal (PII) nem outras informações confidenciais ou sigilosas em tags. As tags são acessíveis a muitos Serviços da AWS, incluindo faturamento. As tags não devem ser usadas para dados privados ou confidenciais.

Suporte à marcação para recursos do Amazon ECS
Tarefa	AWS CLI	Ação de API
Adicione ou sobrescreva uma ou mais tags.	tag-resource	TagResource
Exclua uma ou mais tags.	untag-resource	UntagResource

Você pode usar algumas ações de criação de recursos para especificar tags ao criar o recurso. As ações a seguir são compatíveis com o uso de tags na criação.

Você deve ter a ecsTagResource permissão. Para obter mais informações, consulte Conceder permissão para marcar recursos na criação.

Tarefa	AWS CLI	AWS Tools for Windows PowerShell	Ação API
Execute uma ou mais tarefas.	run-task	Start-ECSTask	RunTask
Crie um serviço.	create-service	New-ECSService	CreateService
Crie um conjunto de tarefas.	create-task-set	Novo ECS TaskSet	CreateTaskSet
Registre uma definição de tarefa.	register-task-definition	Registre-se - ECS TaskDefinition	RegisterTaskDefinition
Crie um cluster.	create-cluster	New-ECSCluster	CreateCluster