Etiquetado de recursos en AWS Device Farm

AWS Device Farm funciona con la API de etiquetado de grupos de recursos de AWS. Esta API le permite administrar los recursos de su cuenta de AWS con etiquetas. Puede agregar etiquetas a recursos, como proyectos y ejecuciones de prueba.

Puede usar etiquetas para:

• Organizar su factura de AWS de manera que refleje su propia estructura de costos. Para ello, regístrese para obtener una factura de su cuenta de AWS que incluya valores de clave de etiquetas. A continuación, para ver los costos de los recursos combinados, organice la información de facturación de acuerdo con los recursos con los mismos valores de clave de etiquetas. Por ejemplo, puede etiquetar varios recursos con un nombre de aplicación y luego organizar su información de facturación para ver el costo total de la aplicación en distintos servicios. Para obtener más información, consulte Asignación y etiquetado de costos en Acerca de la administración de facturación y costos de AWS.

• Controlar el acceso a través de políticas de IAM. Para ello, cree una política que permita el acceso a un recurso o conjunto de recursos mediante una condición de valor de etiqueta.

• Identificar y administrar ejecuciones que tienen ciertas propiedades como etiquetas, como la ramificación que se usó para las pruebas.

Para obtener más información sobre el etiquetado de recursos, consulte el documento técnico Prácticas recomendadas de etiquetado.

Etiquetado de recursos

La API de etiquetado de grupos de recursos de AWS le permite agregar, quitar o modificar etiquetas en los recursos. Para obtener más información, consulte la referencia de API de etiquetado de grupos de recursos de AWS.

Para etiquetar un recurso, utilice la operación TagResources operación desde el punto de enlace de resourcegroupstaggingapi. Esta operación usa una lista de ARN de los servicios compatibles y una lista de pares clave-valor. El valor es opcional. Una cadena vacía indica que no debe haber ningún valor para esa etiqueta. Por ejemplo, el siguiente ejemplo de Python etiqueta una serie de ARN de proyecto con la etiqueta build-config con el valor release:

import boto3

client = boto3.client('resourcegroupstaggingapi')

client.tag_resources(ResourceARNList=["arn:aws:devicefarm:us-west-2:111122223333:project:123e4567-e89b-12d3-a456-426655440000",
                                      "arn:aws:devicefarm:us-west-2:111122223333:project:123e4567-e89b-12d3-a456-426655441111",
                                      "arn:aws:devicefarm:us-west-2:111122223333:project:123e4567-e89b-12d3-a456-426655442222"]
                     Tags={"build-config":"release", "git-commit":"8fe28cb"})

Un valor de etiqueta no es obligatorio. Para establecer una etiqueta sin valor, utilice una cadena vacía ("") al especificar un valor. Una etiqueta solo puede tener un valor. Cualquier valor anterior que una etiqueta tenga para un recurso se sobrescribirá con el nuevo valor.

Buscar recursos por etiquetas

Para buscar recursos por sus etiquetas, utilice la operación GetResources desde el punto de enlace resourcegrouptaggingapi. Esta operación usa una serie de filtros, ninguno de los cuales es necesario, y devuelve los recursos que coinciden con los criterios dados. Sin filtros, se devuelven todos los recursos etiquetados. La operación GetResources le permite filtrar recursos basados en

• Valor de etiqueta

• Tipo de recurso (por ejemplo, devicefarm:run)

Para obtener más información, consulte la referencia de API de etiquetado de grupos de recursos de AWS.

En el siguiente ejemplo se buscan sesiones de prueba del explorador de de escritorio en Device Farm (recursos devicefarm:testgrid-session) con la etiqueta stack que tiene el valor production:

import boto3
client = boto3.client('resourcegroupstaggingapi')
sessions = client.get_resources(ResourceTypeFilters=['devicefarm:testgrid-session'],
                                TagFilters=[
                                  {"Key":"stack","Values":["production"]}
                                ])

Eliminación de etiquetas de recursos

Para quitar una etiqueta, utilice la operación UntagResources, especificando una lista de recursos y las etiquetas que quiere quitar:

import boto3
client = boto3.client('resourcegroupstaggingapi')
client.UntagResources(ResourceARNList=["arn:aws:devicefarm:us-west-2:111122223333:project:123e4567-e89b-12d3-a456-426655440000"], TagKeys=["RunCI"])