Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Etichettatura delle risorse di AWS Device Farm
<a name="tagging"></a>

AWS Device Farm funziona con l'API AWS Resource Groups Tagging. Questa API consente di gestire le risorse nel tuo account AWS con *tag*. È possibile aggiungere tag alle risorse, ad esempio progetti ed esecuzioni di test. 

È possibile usare i tag per:
+ organizzare le fatture AWS in modo che riflettano la tua struttura dei costi. Per eseguire questa operazione, registrati per far sì che la fattura del tuo account AWS includa i valori di chiave di tag. Per visualizzare il costo delle risorse combinate, puoi organizzare le informazioni di fatturazione in base alle risorse con gli stessi valori di chiave di tag. Puoi ad esempio applicare tag a numerose risorse con un nome di applicazione specifico, quindi organizzare le informazioni di fatturazione per visualizzare il costo totale dell'applicazione in più servizi. Per ulteriori informazioni, consultare l'argomento relativo a [tagging e allocazione dei costi](https://docs.aws.amazon.com//awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) nelle *informazioni relative a AWS Billing and Cost Management*. 
+ Controlla l'accesso tramite i criteri IAM. A tale scopo, crea una policy che consenta l'accesso a una risorsa o a un set di risorse utilizzando una condizione del valore del tag.
+ Identifica e gestisci le esecuzioni con determinate proprietà come tag, ad esempio il ramo utilizzato per il test. 

 Per ulteriori informazioni sulle risorse di tagging, vedere il white paper [Best practice relative al tagging](https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf). 

**Topics**
+ [Applicazione di tag alle risorse](#tagging-resources)
+ [Ricerca di risorse per tag](#tagging-looking-up-resources)
+ [Rimozione dei tag dalle risorse](#tagging-removing-tags)

## Applicazione di tag alle risorse
<a name="tagging-resources"></a>

L'API per l'applicazione di tag a gruppi di risorse AWS consente di aggiungere, rimuovere o modificare i tag sulle risorse. Per ulteriori informazioni, consulta la [Documentazione di riferimento delle API di tagging dei gruppi di risorse](https://docs.aws.amazon.com//resourcegroupstagging/latest/APIReference/Welcome.html). 

Per applicare tag a una risorsa, utilizzare l'operazione [https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_TagResources.html](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_TagResources.html) dall'endpoint `resourcegroupstaggingapi`. Questa operazione richiede un elenco dei ARNs servizi supportati e un elenco di coppie chiave-valore. Il valore è facoltativo. Una stringa vuota indica che non dovrebbe esserci alcun valore per quel tag. Ad esempio, il seguente esempio di Python etichetta una serie di progetti ARNs con il tag `build-config` con il valore: `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"})
```

Il valore del tag non è obbligatorio. Per impostare un tag senza valore, utilizzare una stringa vuota (`""`) quando si specifica un valore. Un tag può avere un solo valore. Qualsiasi valore precedente che un tag ha per una risorsa verrà sovrascritto con il nuovo valore. 

## Ricerca di risorse per tag
<a name="tagging-looking-up-resources"></a>

Per eseguire la ricerca delle risorse in base ai tag, utilizzare l'operazione `GetResources` dall'endpoint `resourcegrouptaggingapi`. Questa operazione utilizza una serie di filtri, nessuno dei quali è necessario, e restituisce le risorse che corrispondono ai criteri specificati. Senza filtri, vengono restituite tutte le risorse a cui sono applicati tag. L'operazione `GetResources` consente di filtrare le risorse in base a
+ Valore di tag
+ Tipo di risorsa (ad esempio, `devicefarm:run`)

Per ulteriori informazioni, consulta la [Documentazione di riferimento delle API di tagging dei gruppi di risorse](https://docs.aws.amazon.com//resourcegroupstagging/latest/APIReference/Welcome.html).

L'esempio seguente cerca le sessioni (`devicefarm:testgrid-session`risorse) di test del browser desktop Device Farm con il tag `stack` che ha il valore`production`:

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

## Rimozione dei tag dalle risorse
<a name="tagging-removing-tags"></a>

Per rimuovere un tag, utilizzare l'operazione `UntagResources`, specificando un elenco di risorse e i tag da rimuovere:

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