Marcação de funções do Lambda - AWS Lambda

Marcação de funções do Lambda

Você pode marcar funções do Lambda para organizá-las por proprietário, projeto ou departamento. As tags são pares de chave-valor com formato livre, compatíveis com serviços da AWS, usados para filtrar recursos e adicionar detalhes aos relatórios de faturamento.

Para adicionar tags a uma função

  1. Abra a página Funções do console do Lambda.

  2. Escolha uma função.

  3. Em Tags, selecione Manage tags (Gerenciar tags).

  4. Insira um par de chave e valor. Para adicionar mais tags, selecione Add new tag (Adicionar nova tag).

    
          Marcar uma função no console do Lambda.
  5. Escolha Save (Salvar).

Você pode filtrar funções com base na presença ou no valor de uma tag usando o console do Lambda ou a API do AWS Resource Groups. As tags se aplicam no nível da função, não em versões ou aliases. As tags não fazem parte da configuração específica da versão da qual é feita um snapshot quando você publica uma versão.

Como filtrar funções com tags

  1. Abra a página Funções do console do Lambda.

  2. Clique na barra de pesquisa para ver uma lista de atributos de função e chaves de tag.

    
          Tags na barra de pesquisa de função.
  3. Selecione uma chave de tag para ver uma lista de valores que estão sendo usados na região atual.

  4. Escolha um valor para ver funções correspondentes ou selecione (all values) (todos os valores) para ver todas as funções que têm uma tag com essa chave.

    
          Filtragem por valor de tag

A barra de pesquisa também oferece suporte para a pesquisa de chaves de tag. Digite tag para ver somente uma lista de chaves de tag ou comece a digitar o nome da chave para encontrá-la na lista.

Com o AWS Billing and Cost Management, você pode usar tags para personalizar relatórios de faturamento e criar relatórios de alocação de custos. Para obter mais informações, consulte o Relatório mensal de alocação de custos e Como usar tags de alocação de custos no Guia do usuário de Gerenciamento de faturamento e custos da AWS.

Como usar tags com a AWS 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=Marketing,CostCenter=1234ABCD

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

$ aws lambda tag-resource \ --resource arn:aws:lambda:us-east-2:123456789012:function:my-function \ --tags Department=Marketing,CostCenter=1234ABCD

Para remover tags, use o comando untag-resource.

$ aws lambda untag-resource --resource function arn \ --tag-keys Department

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.

Requisitos de chave de tag e valor

Os seguintes requisitos são aplicáveis à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: + - = . _ : / @.