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à.
# Tagging di un modello
Puoi identificare, organizzare, cercare e filtrare i modelli Amazon Rekognition utilizzando tag. Ogni tag è un'etichetta composta da una chiave e un valore definiti dall'utente. Ad esempio, per determinare la fatturazione per i modelli, contrassegna i modelli con una chiave `Cost center` e aggiungi il numero del centro di costo appropriato come valore. Per ulteriori informazioni, consulta [Tagging di risorse AWS](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html).
Usa i tag per:
+ Tenere traccia della fatturazione per un modello utilizzando i tag di allocazione dei costi. Per ulteriori informazioni, consulta [Utilizzo dei tag per l'allocazione dei costi](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html).
+ Controllare l’accesso a un modello tramite AWS Identity and Access Management (IAM). Per ulteriori informazioni, consulta [Controllo dell'accesso alle risorse AWS mediante i tag delle risorse](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).
+ Automatizzare la gestione dei modelli. Ad esempio, è possibile eseguire script di avvio o arresto automatizzati che disattivano gli ambienti di sviluppo durante le ore non lavorative per ridurre i costi. Per ulteriori informazioni, consulta [Esecuzione di un modello Amazon Rekognition Custom Labels addestrato](running-model.md).
Puoi etichettare i modelli utilizzando la console Amazon Rekognition o utilizzando il. AWS SDKs
**Topics**
+ [Tagging dei modelli (console)](#tm-tagging-model-console)
+ [Visualizzazione dei tag del modello](#tm-tagging-model-viewing-console)
+ [Tagging dei modelli (SDK)](#tm-tagging-model-sdk)
## Tagging dei modelli (console)
Puoi utilizzare la console di Rekognition per aggiungere tag ai modelli, visualizzare i tag associati a un modello e rimuovere tag.
### Aggiunta e rimozione di tag
Questa procedura spiega come aggiungere o rimuovere tag da un modello esistente. È possibile aggiungere i tag a un nuovo modello durante l'addestramento. Per ulteriori informazioni, consulta [Addestramento di un modello Amazon Rekognition Custom Labels](training-model.md).
**Per aggiungere o rimuovere tag da un modello esistente utilizzando la console**
1. Apri la console Amazon Rekognition all'indirizzo. [ https://console.aws.amazon.com/rekognition/]( https://console.aws.amazon.com/rekognition/)
1. Scegli **Avvia**.
1. Nel riquadro di navigazione selezionare **Progetti**.
1. Nella pagina **Progetti**, scegli il progetto contenente il modello a cui desideri attribuire tag.
1. Nel pannello di navigazione, sotto il progetto scelto in precedenza, scegli **Modelli**.
1. Nella sezione **Modelli**, scegli il modello a cui vuoi aggiungere un tag.
1. Nella pagina dei dettagli del modello, seleziona la scheda **Tag** .
1. Nella sezione **Tag** scegli **Gestisci tag**.
1. Nella pagina **Gestisci tag**, scegli **Aggiungi nuovo tag**.
1. Immetti una chiave e un valore.
1. In **Chiave**, immettere un nome per la chiave.
1. Per **Value (Valore)**, immetti un valore.
1. Ripeti i passaggi 9 e 10 per aggiungere altri tag.
1. (Facoltativo) Per rimuovere un tag, scegli **Rimuovi** accanto al tag da rimuovere. Se stai rimuovendo un tag salvato in precedenza, questo viene rimosso quando salvi le modifiche.
1. Per salvare le modifiche, scegliere **Salva modifiche**.
## Visualizzazione dei tag del modello
Puoi utilizzare la console di Amazon Rekognition per visualizzare i tag associati a un modello.
Per visualizzare i tag associati a *tutti i modelli all'interno di un progetto*, devi utilizzare l'SDK AWS. Per ulteriori informazioni, consulta [Elencare i tag di un modello](#listing-model-tags-sdk).
**Per visualizzare i tag associati a un modello**
1. Apri la console Amazon Rekognition all'indirizzo. [ https://console.aws.amazon.com/rekognition/]( https://console.aws.amazon.com/rekognition/)
1. Scegli **Avvia**.
1. Nel riquadro di navigazione selezionare **Progetti**.
1. Nella pagina delle risorse **Progetti**, scegli il progetto che contiene il modello di cui desideri visualizzare il tag.
1. Nel pannello di navigazione, sotto il progetto scelto in precedenza, scegli **Modelli**.
1. Nella sezione **Modelli**, scegli il modello di cui desideri visualizzare l'etichetta.
1. Nella pagina dei dettagli del modello, seleziona la scheda **Tag** . I tag sono mostrati nella sezione **Tag**.
## Tagging dei modelli (SDK)
Puoi utilizzare l'SDK per: AWS
+ Aggiungere tag a un nuovo modello
+ Aggiungere tag a un modello esistente
+ Elencare i tag associati a un modello
+ Rimuovere tag da un modello
I tag negli AWS CLI esempi seguenti hanno il seguente formato.
```
--tags '{"key1":"value1","key2":"value2"}'
```
In alternativa, puoi utilizzare questo formato.
```
--tags key1=value1,key2=value2
```
Se non hai installato il AWS CLI, consulta[Passaggio 4: configura e AWS CLI AWS SDKs](su-awscli-sdk.md).
### Aggiungere tag a un nuovo modello
È possibile aggiungere tag a un modello quando lo si crea utilizzando l'[CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion.html)operazione. Specifica uno o più tag nel parametro di input dell'array `Tags`.
```
aws rekognition create-project-version --project-arn project arn \
--version-name version_name \
--output-config '{ "S3Location": { "Bucket": "output bucket", "Prefix": "output folder" } }' \
--tags '{"key1":"value1","key2":"value2"}' \
--profile custom-labels-access
```
Per ulteriori informazioni sulla creazione e sull’addestramento di un modello, consulta [Addestramento di un modello (SDK)](training-model.md#tm-sdk).
### Aggiungere tag a un modello esistente
Per aggiungere uno o più tag a un modello esistente, utilizzate l'[TagResource](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_TagResource)operazione. Specifica l'Amazon Resource Name (ARN) del modello (`ResourceArn`) i tag (`Tags`) da aggiungere. L'esempio seguente mostra come aggiungere due tag.
```
aws rekognition tag-resource --resource-arn resource-arn \
--tags '{"key1":"value1","key2":"value2"}' \
--profile custom-labels-access
```
Puoi ottenere l'ARN di un modello chiamando. [CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion)
### Elencare i tag di un modello
Per elencare i tag allegati a un modello, utilizzate l'[ListTagsForResource](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ListTagsForResource)operazione e specificate l'ARN del modello ()`ResourceArn`. La risposta è una mappa di chiavi e valori di tag associati a un modello specificato.
```
aws rekognition list-tags-for-resource --resource-arn resource-arn \
--profile custom-labels-access
```
L'output visualizza un elenco dei tag collegati al modello.
```
{
"Tags": {
"Dept": "Engineering",
"Name": "Ana Silva Carolina",
"Role": "Developer"
}
}
```
Per vedere quali modelli di un progetto hanno un tag specifico, chiama `DescribeProjectVersions` per ottenere un elenco di modelli. Quindi chiama `ListTagsForResource` per ogni modello nella risposta da `DescribeProjectVersions`. Controlla la risposta da `ListTagsForResource` per vedere se è presente il tag richiesto.
Il seguente esempio Python 3 mostra come cercare una chiave e un valore di tag specifici in tutti i tuoi progetti. L'output include l'ARN del progetto e l'ARN del modello in cui viene trovata una chiave corrispondente.
**Per cercare un valore di tag**
1. Salva il seguente codice in un file denominato `find_tag.py`.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to find a tag value that's associated with models within
your Amazon Rekognition Custom Labels projects.
"""
import logging
import argparse
import boto3
from botocore.exceptions import ClientError
logger = logging.getLogger(__name__)
def find_tag_in_projects(rekognition_client, key, value):
"""
Finds Amazon Rekognition Custom Label models tagged with the supplied key and key value.
:param rekognition_client: An Amazon Rekognition boto3 client.
:param key: The tag key to find.
:param value: The value of the tag that you want to find.
return: A list of matching model versions (and model projects) that were found.
"""
try:
found_tags = []
found = False
projects = rekognition_client.describe_projects()
# Iterate through each project and models within a project.
for project in projects["ProjectDescriptions"]:
logger.info("Searching project: %s ...", project["ProjectArn"])
models = rekognition_client.describe_project_versions(
ProjectArn=(project["ProjectArn"])
)
for model in models["ProjectVersionDescriptions"]:
logger.info("Searching model %s", model["ProjectVersionArn"])
tags = rekognition_client.list_tags_for_resource(
ResourceArn=model["ProjectVersionArn"]
)
logger.info(
"\tSearching model: %s for tag: %s value: %s.",
model["ProjectVersionArn"],
key,
value,
)
# Check if tag exists.
if key in tags["Tags"]:
if tags["Tags"][key] == value:
found = True
logger.info(
"\t\tMATCH: Project: %s: model version %s",
project["ProjectArn"],
model["ProjectVersionArn"],
)
found_tags.append(
{
"Project": project["ProjectArn"],
"ModelVersion": model["ProjectVersionArn"],
}
)
if found is False:
logger.info("No match for Tag %s with value %s.", key, value)
return found_tags
except ClientError as err:
logger.info("Problem finding tags: %s. ", format(err))
raise
def main():
"""
Entry point for example.
"""
logging.basicConfig(level=logging.INFO,
format="%(levelname)s: %(message)s")
# Set up command line arguments.
parser = argparse.ArgumentParser(usage=argparse.SUPPRESS)
parser.add_argument("tag", help="The tag that you want to find.")
parser.add_argument("value", help="The tag value that you want to find.")
args = parser.parse_args()
key = args.tag
value = args.value
print(f"Searching your models for tag: {key} with value: {value}.")
session = boto3.Session(profile_name='custom-labels-access')
rekognition_client = session.client("rekognition")
# Get tagged models for all projects.
tagged_models = find_tag_in_projects(rekognition_client, key, value)
print("Matched models\n--------------")
if len(tagged_models) > 0:
for model in tagged_models:
print(
"Project: {project}\nModel version: {version}\n".format(
project=model["Project"], version=model["ModelVersion"]
)
)
else:
print("No matches found.")
print("Done.")
if __name__ == "__main__":
main()
```
1. Nel prompt dei comandi inserisci quanto segue. Sostituite *key* e *value* con il nome della chiave e il valore della chiave che desiderate trovare.
```
python find_tag.py key value
```
### Eliminazione di tag da un modello
Per rimuovere uno o più tag da un modello, utilizzate l'[UntagResource](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_UntagResource)operazione. Specifica l'ARN del modello (`ResourceArn`) e le chiavi del tag (`Tag-Keys`) che desideri rimuovere.
```
aws rekognition untag-resource --resource-arn resource-arn \
--tag-keys '["key1","key2"]' \
--profile custom-labels-access
```
In alternativa, puoi specificare `tag-keys` in questo formato.
```
--tag-keys key1,key2
```