View a markdown version of this page

Propagação de tags - AWS Lambda
Configurar a propagação de tagsExemplosComportamento da propagação de tags

Propagação de tags

Com a propagação de tags, você pode especificar um conjunto de tags na configuração do provedor de capacidade e o Lambda aplica automaticamente essas tags a todos os recursos gerenciados que forem criados, incluindo instâncias do Amazon EC2, volumes do Amazon EBS e ENIs. Isso garante tags consistentes para alocação de custos, políticas de controle de serviço (SCPs) e requisitos de conformidade sem exigir intervenção manual ou automação personalizada.

Configurar a propagação de tags

Especifique a configuração de PropagateTags ao criar ou atualizar um provedor de capacidade usando as APIs CreateCapacityProvider ou UpdateCapacityProvider.

Parâmetros do PropagateTags:

  • Modo (obrigatório): o modo de propagação de tags:

    • Explicit: propagar as tags especificadas em ExplicitTags para os recursos gerenciados.

    • None: desabilitar a propagação de tags. Nenhuma tag personalizada é aplicada aos recursos gerenciados, exceto as tags do sistema aplicadas por padrão.

  • ExplicitTags (obrigatório quando o Modo é Explicit): um mapa de pares de valores-chave a serem aplicados aos recursos gerenciados. Você pode especificar até 40 tags.

Importante

A propagação de tags se aplica somente aos novos recursos gerenciados provisionados após a aplicação da configuração. Os recursos atuais não são marcados com tags de modo retroativo.

Exemplos

Criar um provedor de capacidade com propagação de tags (AWSCLI):

aws lambda create-capacity-provider \
  --capacity-provider-name my-capacity-provider \
  --vpc-config SubnetIds=subnet-12345,subnet-67890,SecurityGroupIds=sg-12345 \
  --permissions-config CapacityProviderOperatorRoleArn=arn:aws:iam::123456789012:role/MyOperatorRole \
  --propagate-tags '{"Mode": "Explicit", "ExplicitTags": {"CostCenter": "12345", "Environment": "Production"}}'

Atualizar um provedor de capacidade existente para permitir a propagação de tags:

aws lambda update-capacity-provider \
  --capacity-provider-name my-capacity-provider \
  --propagate-tags '{"Mode": "Explicit", "ExplicitTags": {"CostCenter": "12345", "Environment": "Production"}}'

Desabilitar a propagação de tags:

aws lambda update-capacity-provider \
  --capacity-provider-name my-capacity-provider \
  --propagate-tags '{"Mode": "None"}'

Comportamento da propagação de tags

  • As alterações na configuração PropagateTags afetam somente os recursos provisionados após a atualização. Os recursos lançados anteriormente retêm suas tags originais.

  • As tags de propagação de tags são separadas do parâmetro Tags no próprio provedor de capacidade. As tags do provedor de capacidade identificam o recurso do provedor de capacidade e as tags propagadas são aplicadas aos recursos gerenciados que o provedor de capacidade inicia.

  • As tags propagadas contam para os limites de tags de recursos da AWS nos recursos de destino.