Assegnazione di tag ai modelli (console)Visualizzazione dei tag del modello Modelli di etichettatura (SDK)

Assegnazione di tag a un modello

Puoi identificare, organizzare, cercare e filtrare i modelli Amazon Rekognition utilizzando i tag. Ogni tag è un'etichetta composta da una chiave e da un valore definiti dall'utente. Ad esempio, per determinare la fatturazione dei modelli, contrassegna i modelli con unaCost center chiave e aggiungi il numero del centro di costo appropriato come valore. Per ulteriori informazioni, consulta Tagging delle risorse AWS.

Eseguire i tag per:

Tieni 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.
Controlla l'accesso a un modello utilizzando Identity and Access Management (IAM). Per ulteriori informazioni, consulta Controllo dell'accesso alleAWS risorse mediante i tag delle risorse.
Automatizza la gestione dei modelli. Ad esempio, è possibile eseguire script di avvio o arresto automatici che disattivano i modelli di sviluppo durante gli orari non lavorativi per ridurre i costi. Per ulteriori informazioni, consulta Esecuzione di un modello Amazon Rekognition Custom Labels addestrato.

Puoi etichettare i modelli utilizzando la console Amazon Rekognition o utilizzando gliAWS SDK.

Assegnazione di tag ai modelli (console)

Puoi utilizzare la console Rekognition per aggiungere tag ai modelli, visualizzare i tag collegati a un modello e rimuovere i tag.

Aggiunta o rimozione di tag

Questa procedura spiega come aggiungere o rimuovere tag da un modello esistente. È possibile aggiungere i tag a un nuovo modello quando viene addestrato. Per ulteriori informazioni, consulta Addestramento di un modello Amazon Rekognition Custom Labels.

Per aggiungere o rimuovere tag da un modello esistente utilizzando la console

Apri la console Amazon Rekognition all'indirizzo https://console.aws.amazon.com/rekognition/.
Scegliere Inizia.
Nel riquadro di navigazione selezionare Projects (Progetti).
Nella pagina delle risorse dei progetti, scegli il progetto che contiene il modello da etichettare.
Nel pannello di navigazione, sotto il progetto scelto in precedenza, scegli Modelli.
Nella sezione Modelli, scegli il modello a cui desideri aggiungere un tag.
Nella pagina dei dettagli del modello seleziona la scheda Tag.
Nella sezione Tags scegliere Manage tags (Gestisci tag).
Nella pagina Gestisci tag, scegli Aggiungi nuovo tag.
Immettere una coppia chiave valore.
1. In Chiave, inserire un nome per la coppia chiave.
2. Per Value (Valore), immetti un valore.
Per aggiungere altri tag, ripeti i passaggi 9 e 10.
(Facoltativo) Per rimuovere un tag, scegli Remove (Rimuovi) accanto al tag che desideri rimuovere. Se si rimuove un tag salvato in precedenza, questo viene rimosso quando si salvano le modifiche.
Per salvare le modifiche, scegliere Salva modifiche.

Visualizzazione dei tag del modello

Puoi utilizzare la console Amazon Rekognition per visualizzare i tag collegati 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 Elenco dei tag del modello.

Per visualizzare i tag associati a un modello

Apri la console Amazon Rekognition all'indirizzo https://console.aws.amazon.com/rekognition/.
Scegliere Inizia.
Nel riquadro di navigazione selezionare Projects (Progetti).
Nella pagina delle risorse dei progetti, scegli il progetto che contiene il modello di cui desideri visualizzare il tag.
Nel pannello di navigazione, sotto il progetto scelto in precedenza, scegli Modelli.
Nella sezione Modelli, scegli il modello di cui si desidera visualizzare l'etichetta.
Nella pagina dei dettagli del modello seleziona la scheda Tag. I tag sono mostrati nella sezione Tag.

Modelli di etichettatura (SDK)

Puoi usare l'AWSSDK per:

Aggiunta di tag a un nuovo modello
Aggiunta di tag a un modello esistente
Elenca i tag collegati a un modello
Rimozione di tag da un modello

I tag negliAWS CLI esempi seguenti sono nel seguente formato.


--tags '{"key1":"value1","key2":"value2"}'

In alternativa, puoi utilizzare questo formato.


--tags key1=value1,key2=value2

Se non hai installato ilAWS CLI, vediPassaggio 4: configura il AWS CLI e AWS SDKs.

Aggiunta di tag a un nuovo modello

È possibile aggiungere tag a un modello quando si crea mediante l'CreateProjectVersionoperazione. Specifica uno o più tag nel parametro di input dell'Tagsarray.


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 informazioni sulla creazione e l'addestramento di un modello, consultaAddestramento di un modello (SDK).

Aggiunta di tag a un modello esistente

Per aggiungere uno o più tag a un modello esistente, utilizzare l'TagResourceoperazione. Specifica l'Amazon Resource Name () (ResourceArn) del modello e i tag (Tags) che desideri aggiungere. L'esempio che segue 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 per un modello chiamando CreateProjectVersion.

Elenco dei tag del modello

Per elencare i tag associati a un modello, utilizzate l'ListTagsForResourceoperazione e specificate l'ARN del modello (ResourceArn). La risposta è una mappa delle chiavi e dei valori dei tag associati al 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, chiamaDescribeProjectVersions per ottenere un elenco di modelli. Quindi chiamaListTagsForResource ogni modello nel modulo di rispostaDescribeProjectVersions. Ispeziona il modulo di rispostaListTagsForResource per vedere se il tag richiesto è presente.

Il seguente esempio di Python 3 mostra come cercare in tutti i tuoi progetti una chiave e un valore di tag specifici. L'output include l'ARN del progetto e l'ARN del modello in cui si trova una chiave corrispondente.

Per cercare un valore di tag

Salva il il il il il il il il il seguente codice in un file denominatofind_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()

Nel prompt dei comandi inserisci il comando seguente. Sostituisci chiave e valore con il nome della chiave e il valore della chiave che desideri trovare.
```
python find_tag.py key value
```

Eliminazione di tag da un modello

Per rimuovere uno o più tag da un modello, utilizzare l'UntagResourceoperazione. Specificate l'ARN del modello (ResourceArn) e le chiavi di tag (Tag-Keys) che desiderate rimuovere.


aws rekognition untag-resource --resource-arn resource-arn \
  --tag-keys '["key1","key2"]' \
  --profile custom-labels-access

In alternativa, puoi specificaretag-keys in questo formato.


--tag-keys key1,key2

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Eliminazione di un modello

Descrizione di un modello (SDK)