Uso de etiquetas en asignaciones de orígenes de eventos - AWS Lambda
Permisos necesarios para trabajar con etiquetasUso de etiquetas con la consolaUso de etiquetas con la AWS CLI

Uso de etiquetas en asignaciones de orígenes de eventos

Puede etiquetar asignaciones de orígenes de eventos para organizar y administrar sus recursos. Las etiquetas son pares de clave-valor de formato libre que se asocian a los recursos y que son compatibles con todos los Servicios de AWS. Para obtener más información sobre los casos de uso de las etiquetas, consulte Estrategias de etiquetado habituales en la Guía del editor de etiquetas y recursos de etiquetado de AWS.

Las asignaciones de orígenes de eventos están asociadas a funciones, que pueden tener sus propias etiquetas. Las asignaciones de orígenes de eventos no heredan automáticamente las etiquetas de las funciones. Puede utilizar la API de AWS Lambda para ver y actualizar etiquetas. También puede ver y actualizar las etiquetas mientras administra una asignación de orígenes de eventos específica en la consola de Lambda.

Permisos necesarios para trabajar con etiquetas

Para permitir que una identidad de AWS Identity and Access Management (IAM) (usuario, grupo o rol) lea o establezca etiquetas en un recurso, conceda los permisos correspondientes:

  • lambda:ListTags: cuando un recurso tiene etiquetas, conceda este permiso a cualquier persona que necesite llamar a ListTags en este. En el caso de las funciones etiquetadas, este permiso también es necesario para GetFunction.

  • lambda:TagResource: conceda este permiso a cualquier persona que necesite llamar a TagResource o efectuar una etiqueta en la creación.

Si lo desea, considere conceder el permiso lambda:UntagResource y permitir las llamadas UntagResource al recurso.

Para obtener más información, consulte Políticas de IAM basadas en identidad para Lambda.

Uso de etiquetas con la consola de Lambda

Puede utilizar la consola de Lambda para crear asignaciones de orígenes de eventos que tengan etiquetas, agregar etiquetas a las asignaciones de orígenes de eventos existentes y filtrar las asignaciones de orígenes de eventos por etiqueta.

Cuando agrega un desencadenador para los servicios basados en colas y transmisiones compatibles con la consola de Lambda, Lambda crea una asignación de orígenes de eventos de forma automática. Para obtener más información acerca de estos orígenes de eventos, consulte Cómo procesa Lambda registros de orígenes de eventos basados en secuencias y colas. Para crear una asignación de orígenes de eventos en la consola, necesitará los siguientes requisitos previos:

  • Una función de .

  • Un origen de eventos de un servicio afectado.

Puede agregar las etiquetas como parte de la misma interfaz de usuario que utiliza para crear o actualizar los desencadenadores.

Adición de una etiqueta al crear una asignación de orígenes de eventos

  1. Abra la página de Funciones en la consola de Lambda.

  2. Elija el nombre de su función.

  3. En Descripción general de la función, elija Agregar desencadenador.

  4. En Configuración del desencadenador, en la lista desplegable, elija el nombre del servicio del que proviene el origen de eventos.

  5. Proporcione la configuración principal del origen de eventos. Para obtener más información sobre la configuración del origen de eventos, consulte la sección del servicio relacionado en Invocar Lambda con eventos de otros servicios de AWS.

  6. En Configuración de la asignación de orígenes de eventos, seleccione Configuración adicional.

  7. En Etiquetas, elija Agregar nueva etiqueta.

  8. En el campo Clave, ingrese la clave de la etiqueta. Para obtener información sobre las restricciones de etiquetado, consulte Límites y requisitos de denominación de etiquetas en la Guía del editor de etiquetas y recursos de etiquetado de AWS.

  9. Elija Añadir.

Adición de etiquetas a una asignación de orígenes de eventos existente

  1. Abra Asignaciones de orígenes de eventos en la consola de Lambda.

  2. En la lista de recursos, elija el UUID de la asignación de orígenes de eventos correspondiente a su función y el ARN del origen de eventos.

  3. En la lista de pestañas situada debajo del panel de configuración general, elija Etiquetas.

  4. Elija Manage tags (Administrar etiquetas).

  5. Elija Add new tag (Agregar nueva etiqueta).

  6. En el campo Clave, ingrese la clave de la etiqueta. Para obtener información sobre las restricciones de etiquetado, consulte Límites y requisitos de denominación de etiquetas en la Guía del editor de etiquetas y recursos de etiquetado de AWS.

  7. Seleccione Save (Guardar).

Filtrado de asignaciones de orígenes de eventos por etiqueta

  1. Abra Asignaciones de orígenes de eventos en la consola de Lambda.

  2. Seleccione la barra de búsqueda.

  3. En la lista desplegable, seleccione la clave de etiqueta situada debajo del subtítulo Etiquetas.

  4. Seleccione Usar: "etiqueta-nombre" para ver todas las asignaciones de orígenes de eventos etiquetadas con esta clave o elija un operador para filtrar aún más por valor.

  5. Seleccione el valor de la etiqueta para filtrarla por una combinación de clave y valor de la etiqueta.

El cuadro de búsqueda también permite buscar claves de etiqueta. Escriba el nombre de una clave para encontrarla en la lista.

Uso de etiquetas con la AWS CLI

Puede agregar y eliminar etiquetas en los recursos de Lambda existentes, incluidas las asignaciones de orígenes de eventos, con la API de Lambda. También puede agregar etiquetas al crear una asignación de orígenes de eventos, lo que le permite mantener un recurso etiquetado durante todo su ciclo de vida.

Actualización de etiquetas con las API de etiquetas de Lambda

Puede agregar y eliminar etiquetas para los recursos de Lambda compatibles mediante las operaciones de API TagResource y UntagResource.

También puede llamar a estas operaciones mediante la AWS CLI. Para agregar etiquetas a un recurso existente, utilice el comando tag-resource. En este ejemplo se agregan dos etiquetas, una con la clave Department y otra con la clave CostCenter.

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

Para eliminar etiquetas, utilice el comando untag-resource. En este ejemplo, se elimina la etiqueta con la clave Department.

aws lambda untag-resource --resource arn:aws:lambda:us-east-1:123456789012:resource-type:resource-identifier \
--tag-keys Department

Adición de etiquetas al crear una asignación de orígenes de eventos

Para crear una nueva asignación de orígenes de eventos de Lambda, utilice la operación de la API CreateEventSourceMapping. Especifique el parámetro Tags. Puede llamar a esta operación con el comando create-event-source-mapping de la AWS CLI y la opción --tags. Para obtener más información sobre el comando de la CLI, consulte create-event-source-mapping en la Referencia de comandos de la AWS CLI.

Antes de usar el parámetro Tags con CreateEventSourceMapping, asegúrese de que su rol tenga permiso para etiquetar los recursos junto con los permisos habituales necesarios para esta operación. Para obtener más información sobre permisos de etiquetado, consulte Permisos necesarios para trabajar con etiquetas.

Visualización de etiquetas con las API de etiquetas de Lambda

Para ver las etiquetas que se aplican a un recurso de Lambda específico, utilice la operación de la API ListTags. Para obtener más información, consulte ListTags.

Puede llamar a esta operación con el comando list-tags de la AWS CLI si proporciona un ARN (nombre de recurso de Amazon).

aws lambda list-tags --resource arn:aws:lambda:us-east-1:123456789012:resource-type:resource-identifier

Filtrado de recursos por etiqueta

Puede utilizar la operación de la API de AWS Resource Groups Tagging API GetResources para filtrar los recursos por etiquetas. La operación GetResources recibe hasta 10 filtros y cada uno contiene una clave de etiqueta y hasta 10 valores de etiqueta. Usted proporciona GetResources con un ResourceType para filtrar por tipos de recurso específicos.

Puede llamar a esta operación mediante el comando get-resources de la AWS CLI. Para ver ejemplos de uso de get-resources, consulte get-resources en la Referencia de comandos de la AWS CLI.