Taggen von AWS Device Farm-Ressourcen

AWS Device Farm funktioniert mitAWSTagging-API für Ressourcengruppen. Mit dieser API können Sie Ressourcen in Ihrem AWS-Konto mit Tags verwalten. Sie können Ressourcen, wie Projekte und Testläufe, Tags hinzufügen.

Sie können Tags verwenden, um:

• Organisieren Sie Ihre AWS-Kontorechnung, um Ihre eigene Kostenstruktur darzustellen. Dazu müssen Sie sich registrieren, um Ihre AWS-Kontorechnung mit Tag-Schlüsselwerten zu erhalten. Um dann die Kosten kombinierter Ressourcen anzuzeigen, organisieren Sie Ihre Fakturierungsinformationen nach Ressourcen mit gleichen Tag-Schlüsselwerten. Beispielsweise können Sie mehrere Ressourcen mit einem Anwendungsnamen markieren und dann Ihre Fakturierungsinformationen so organisieren, dass Sie die Gesamtkosten dieser Anwendung über mehrere Services hinweg sehen können. Weitere Informationen finden Sie unter Cost Allocation and Tagging in About AWS Billing and Cost Management.

• Steuern Sie den Zugriff über IAM-Richtlinien. Erstellen Sie dazu eine Richtlinie, die den Zugriff auf eine Ressource oder einen Satz von Ressourcen mithilfe einer Tag-Wertbedingung ermöglicht.

• Identifizieren und verwalten Sie Durchläufe, die bestimmte Eigenschaften haben, als Tags, z. B. den Zweig, der zum Testen verwendet wird.

Weitere Informationen zum Markieren von Ressourcen finden Sie im Whitepaper Bewährte Tagging-Methoden.

Markieren von Ressourcen

Mit der AWS Resource Group Tagging API können Sie Ressourcen Tags hinzufügen, sie entfernen oder ändern. Weitere Informationen finden Sie in der API-Referenz der AWS-Ressourcengruppen-Markierung.

Verwenden Sie zum Taggen einer Ressource den Vorgang TagResources vom resourcegroupstaggingapi-Endpunkt aus. Dieser Vorgang generiert eine Liste von ARNs aus unterstützten Diensten und eine Liste von Schlüssel-Wert-Paaren. Der -Wert ist optional. Eine leere Zeichenfolge gibt an, dass für dieses Tag kein Wert vorhanden sein sollte. Im folgenden Python-Beispiel wird eine Reihe von Projekt-ARNs mit dem Tag build-config und dem Wert release versehen:

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"})

Ein Tag-Wert ist nicht erforderlich. Um ein Tag ohne Wert festzulegen, verwenden Sie eine leere Zeichenfolge ("") für die Wertangabe. Ein Tag kann nur einen Wert haben. Jeder vorherige Wert, den ein Tag für eine Ressource hat, wird mit dem neuen Wert überschrieben.

Ressourcen nach Tag nachschlagen

Verwenden Sie den GetResources-Vorgang vom resourcegrouptaggingapi-Endpunkt aus, um Ressourcen anhand ihrer Tags zu suchen. Dieser Vorgang verwendet eine Reihe von Filtern, von denen keiner erforderlich ist, und gibt die Ressourcen zurück, die den angegebenen Kriterien entsprechen. Ohne Filter werden alle getaggten Ressourcen zurückgegeben. Der GetResources-Vorgang ermöglicht das Filtern von Ressourcen basierend auf

• Tag-Wert

• Ressourcentyp (z. B. devicefarm:run)

Weitere Informationen finden Sie in der API-Referenz der AWS-Ressourcengruppen-Markierung.

Das folgende Beispiel sucht nach Device Farm-Desktop-Browser-Testsitzungen (devicefarm:testgrid-sessionRessourcen) mit dem Tagstackdie den Wert habenproduction:

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

Entfernen von Tags von Ressourcen

Verwenden Sie zum Entfernen eines Tags den UntagResources-Vorgang und geben Sie eine Liste der Ressourcen und die zu entfernenden Tags an:

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