Puede etiquetar configuraciones de firma de código 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.
Puede utilizar la API de AWS Lambda para ver y actualizar etiquetas. También puede ver y actualizar las etiquetas mientras administra una configuración de firma de código específica en la consola de Lambda.
Secciones
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
ListTagsen este. En el caso de las funciones etiquetadas, este permiso también es necesario paraGetFunction. -
lambda:TagResource: conceda este permiso a cualquier persona que necesite llamar a
TagResourceo 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 configuraciones de firma de código que tengan etiquetas, agregar etiquetas a configuraciones de firma de código existentes y filtrar configuraciones de firma de código por etiqueta.
Adición de una etiqueta al crear una configuración de firma de código
Abra Configuraciones de la firma de código
en la consola de Lambda. En el encabezado del panel de contenido, seleccione Crear la configuración.
-
En la sección de la parte superior del panel de contenido, defina la configuración de firma de código. Para obtener más información sobre cómo definir las configuraciones de firma de código, consulte Uso de la firma de código para verificar la integridad del código con Lambda.
En la sección Etiquetas, elija Agregar nueva etiqueta.
-
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.
Seleccione Crear configuración.
Adición de una etiqueta a una configuración de firma de código existente
Abra Configuraciones de la firma de código
en la consola de Lambda. Elija el nombre de la configuración de firma de código.
En las pestañas situadas debajo del panel Detalle, seleccione Etiquetas.
Elija Manage tags (Administrar etiquetas).
Elija Add new tag (Agregar nueva etiqueta).
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.
Seleccione Save (Guardar).
Filtrado de las configuraciones de firma de código por etiqueta
Abra Configuraciones de la firma de código
en la consola de Lambda. Seleccione la barra de búsqueda.
En la lista desplegable, seleccione la etiqueta situada debajo del subtítulo Etiquetas.
Seleccione Usar: "nombre-etiqueta" para ver todas las configuraciones de firma de código etiquetadas con esta clave o elija un operador para filtrar aún más por valor.
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 configuraciones de firma de código, con la API de Lambda. También puede agregar etiquetas al crear una configuración de firma de código, 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\ --tagsDepartment=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 --resourcearn:aws:lambda:us-east-1:123456789012:resource-type:resource-identifier\ --tag-keysDepartment
Adición de etiquetas al crear una configuración de firma de código
Para crear una nueva configuración de firma de código de Lambda con etiquetas, utilice la operación de la API CreateCodeSigningConfig. Especifique el parámetro Tags. Puede llamar a esta operación con el comando create-code-signing-config de la AWS CLI y la opción --tags. Para obtener más información sobre el comando de la CLI, consulte create-code-signing-config
Antes de usar el parámetro Tags con CreateCodeSigningConfig, 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 --resourcearn: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
