# 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](https://docs.aws.amazon.com//tag-editor/latest/userguide/best-practices-and-strats.html#tag-strategies) 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, incluidas las que utilizan el modo aprovisionado de Amazon SQS.
## 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](access-control-identity-based.md).
## 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, añadir etiquetas a las asignaciones de orígenes de eventos existentes y filtrar las asignaciones de orígenes de eventos por etiqueta, incluso aquellas configuradas en el modo aprovisionado de Amazon SQS.
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](invocation-eventsourcemapping.md). 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](https://console.aws.amazon.com/lambda/home#/functions) en la consola de Lambda.
1. Elija el nombre de su función.
1. En **Descripción general de la función**, elija **Agregar desencadenador**.
1. En **Configuración del desencadenador**, en la lista desplegable, elija el nombre del servicio del que proviene el origen de eventos.
1. 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](lambda-services.md).
1. En **Configuración de la asignación de orígenes de eventos**, seleccione **Configuración adicional**.
1. En **Etiquetas**, elija **Agregar nueva etiqueta**.
1. 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](https://docs.aws.amazon.com//tag-editor/latest/userguide/best-practices-and-strats.html#id_tags_naming_best_practices) en la *Guía del editor de etiquetas y recursos de etiquetado de AWS*.
1. Elija **Agregar**.
**Adición de etiquetas a una asignación de orígenes de eventos existente**
1. Abra [Asignaciones de orígenes de eventos](https://console.aws.amazon.com/lambda/home#/event-source-mappings) en la consola de Lambda.
1. 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**.
1. En la lista de pestañas situada debajo del **panel de configuración general**, elija **Etiquetas**.
1. Elija **Manage tags** (Administrar etiquetas).
1. Elija **Add new tag** (Agregar nueva etiqueta).
1. 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](https://docs.aws.amazon.com//tag-editor/latest/userguide/best-practices-and-strats.html#id_tags_naming_best_practices) en la *Guía del editor de etiquetas y recursos de etiquetado de AWS*.
1. Seleccione **Save**.
**Filtrado de asignaciones de orígenes de eventos por etiqueta**
1. Abra [Asignaciones de orígenes de eventos](https://console.aws.amazon.com/lambda/home#/event-source-mappings) en la consola de Lambda.
1. Seleccione la barra de búsqueda.
1. En la lista desplegable, seleccione la clave de etiqueta situada debajo del subtítulo **Etiquetas**.
1. 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.
1. 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](https://docs.aws.amazon.com/lambda/latest/api/API_TagResource.html) y [UntagResource](https://docs.aws.amazon.com/lambda/latest/api/API_UntagResource.html).
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](https://docs.aws.amazon.com/lambda/latest/api/API_CreateEventSourceMapping.html). 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/create-event-source-mapping.html) 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](#esm-tags-required-permissions).
### 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](https://docs.aws.amazon.com/lambda/latest/api/API_ListTags.html).
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](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetResources.html) 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/get-resources.html#examples) en la *Referencia de comandos de la AWS CLI*.