AWS Lambda
Guia do desenvolvedor

Marcação de funções do Lambda

Funções do Lambda podem abranger vários aplicativos ao longo de regiões distintas. Para simplificar o processo de rastreamento da frequência e do custo de cada chamada de função, você pode usar tags. Tags são pares de chave-valor que você anexa aos recursos da AWS para melhor organizá-los. Elas são particularmente úteis quando você tem muitos recursos do mesmo tipo, que no caso do AWS Lambda é uma função. Ao usar tags, clientes com centenas de funções do Lambda podem facilmente acessar e analisar um conjunto específico ao filtrar os que contêm a mesma tag. Duas das principais vantagens ao marcar suas funções dos Lambda com tags são:

  • Agrupamento e filtragem: Ao aplicar tags, você pode usar o console ou a CLI do Lambda para isolar uma lista de funções do Lambda contidas em um aplicativo ou departamento de faturamento específico. Para obter mais informações, consulte Filtragem de funções do Lambda marcadas.

  • Alocação de custos: Como o suporte do Lambda para a atribuição de tags é integrada ao Faturamento da AWS, é possível detalhar contas em categorias dinâmicas e mapear funções à centros de custos específicos. Por exemplo, se você atribuir tags à todas as funções do Lambda com uma chave "Departamento", todos os custos do AWS Lambda podem ser detalhados por departamento. Então, você pode fornecer um valor de departamento individual, como "Departamento 1" ou "Departamento 2", para direcionar o custo de invocação da função ao centro de custo apropriado. A alocação de custos é apresentada através de relatórios de faturamento detalhados, facilitando a categorização e o rastreamento de seus custos da AWS.

Marcação de funções do Lambda para faturamento

Você pode usar tags para organizar sua conta AWS e refletir sua própria estrutura de custos. Para fazer isso, você pode adicionar chaves de tag cujos valores serão incluídos no relatório de alocação de custos. Para obter mais informações sobre a configuração de um relatório de alocação de custos que inclua as chaves de tag que você seleciona para inclusão como itens de linha no relatório, consulte O relatório de alocação de custos mensais em Sobre o faturamento de conta da AWS.

Para ver o custo dos recursos combinados, você pode organizar as informações de faturamento com base nas funções com os mesmos valores da chave de tags. Por exemplo, você pode marcar várias funções do Lambda com um nome de aplicativo específico e, então, organizar suas informações de faturamento para ver o custo total daquele aplicativo ao longo de vários serviços. Para obter mais informações, consulte Como usar tags de alocação de custos no Guia do usuário do Gerenciamento de custos e faturamento da AWS.

No AWS Lambda, o único recurso que pode ser marcado com tags é uma função. Não é possível marcar um alias ou uma versão específica de uma função. Qualquer invocação de um alias de uma função ou versão será cobrada como uma invocação da função original.

Aplicação de tags em funções do Lambda usando o console

Você pode adicionar tags à sua função na seção Tags da guia configuration.

Para remover tags de uma função existente, abra a função, escolha a seção Tags e, em seguida, escolha o botão Remove ao lado do par chave-valor.

Aplicação de tags em funções do Lambda usando a CLI

Quando você cria uma função do Lambda, é possível incluir tags com a opção --tags.

$ aws lambda create-function --function-name my-function --handler index.js --runtime nodejs12.x \ --role arn:aws:iam::123456789012:role/lambda-role \ --tags "DEPARTMENT=Department A"

Para adicionar tags a uma função existente, use o comando tag-resource.

$ aws lambda tag-resource \ --resource function arn \ --tags "DEPARTMENT=Department A"

Para remover tags, use o comando untag-resource.

$ aws lambda untag-resource --resource function arn \ --tagkeys DEPARTMENT

Filtragem de funções do Lambda marcadas

Assim que você tiver agrupado suas funções do Lambda usando tags, você pode aproveitar as capacidades de filtragem fornecidas pelo console do Lambda ou pela AWS CLI para visualizá-las com base em suas necessidades específicas.

Filtragem de funções do Lambda usando o console

O console do Lambda contém um campo de pesquisa que permite filtrar a lista de funções com base em um conjunto específico de atributos de função, incluindo Tags. Suponha que você tenha duas funções chamadas MyFunction e MyFunction2 que têm uma chave de Tags chamada Department. Para visualizar essas funções, escolha o campo de pesquisa e observe a filtragem automática que inclui uma lista das chaves de Tags:

Escolha a chave Department. O Lambda retornará qualquer função que contenha essa chave.

Agora, suponha que o valor de chave da tag MyFunction seja "Department A" e o valor da chave de MyFunction2 seja "Department B". Você pode restringir sua pesquisa, escolhendo o valor de chave Department, neste caso, Department A, conforme mostrado abaixo.

Isso retornará apenas MyFunction.

Você pode restringir ainda mais sua pesquisa, incluindo os outros Function attributes aceitos, incluindo Description, Function name ou Runtime.

nota

Há um limite de no máximo 50 tags por função do Lambda. Ao excluir uma função do Lambda, as tags associadas também são excluídas.

Filtragem de funções do Lambda usando a CLI

Se você deseja visualizar as tags que são aplicadas à uma função do Lambda específica, você pode usar os seguintes comandos de API do Lambda:

  • ListTags – você fornece o ARN (nome de recurso da Amazon) de sua função do Lambda para visualizar uma lista das tags associadas a essa função:

    $ aws lambda list-tags --resource function arn
  • GetFunction – você fornece o nome de sua função do Lambda para visualizar uma lista das tags associadas a essa função:

    $ aws lambda get-function --function-name my-function

Você também pode usar a API GetResources do serviço de atribuição de tags da AWS para filtrar seus recursos com tags. A API GetResources aceita até 10 filtros, cada filtro contendo uma chave de tags e até 10 valores de tag. Você fornece GetResources com um 'ResourceType' para filtrar por tipos de recursos específicos. Para obter mais informações sobre o serviço de atribuição de tags da AWS, consulte Como trabalhar com grupos de recursos.

Restrições de tag

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

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

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

  • Valor máximo da chave: 256 caracteres Unicode em UTF-8

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

  • Não use o prefixo aws: no nome nem no valor das suas tags, pois ele é reservado para uso da AWS. Você não pode editar nem excluir nomes ou valores de tag com esse prefixo. As tags com esse prefixo não contam para as tags por limite de recurso.

  • Se seu esquema de tags for usado em vários serviços e recursos, lembre-se de que outros serviços podem ter restrições quanto a caracteres permitidos. No geral, os caracteres permitidos são letras, espaços e números representáveis em UTF-8, além dos seguintes caracteres especiais: + - = . _ : / @.