Tagging dei modelli (console)Visualizzazione dei tag del modello Tagging dei modelli (SDK)

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 da 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.

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.
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.
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.

Puoi etichettare i modelli utilizzando la console Amazon Rekognition o utilizzando il. AWS SDKs

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.

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/
Scegli Avvia.
Nel riquadro di navigazione selezionare Progetti.
Nella pagina Progetti, scegli il progetto contenente il modello a cui desideri attribuire tag.
Nel pannello di navigazione, sotto il progetto scelto in precedenza, scegli Modelli.
Nella sezione Modelli, scegli il modello a cui vuoi aggiungere un tag.
Nella pagina dei dettagli del modello, seleziona la scheda Tag .
Nella sezione Tag scegli Gestisci tag.
Nella pagina Gestisci tag, scegli Aggiungi nuovo tag.
Immetti una chiave e un valore.
1. In Chiave, immettere un nome per la chiave.
2. Per Value (Valore), immetti un valore.
Ripeti i passaggi 9 e 10 per aggiungere altri tag.
(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.
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.

Per visualizzare i tag associati a un modello

Apri la console Amazon Rekognition all'indirizzo. https://console.aws.amazon.com/rekognition/
Scegli Avvia.
Nel riquadro di navigazione selezionare Progetti.
Nella pagina delle risorse 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 desideri visualizzare l'etichetta.
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 file AWS CLI, consultaPassaggio 4: configura e AWS CLIAWS SDKs.

Aggiungere tag a un nuovo modello

È possibile aggiungere tag a un modello quando lo si crea utilizzando l'CreateProjectVersionoperazione. 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).

Aggiungere tag a un modello esistente

Per aggiungere uno o più tag a un modello esistente, utilizzate l'TagResourceoperazione. 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

È possibile ottenere l'ARN di un modello chiamando. CreateProjectVersion

Elencare i tag di un modello

Per elencare i tag allegati a un modello, utilizzate l'ListTagsForResourceoperazione 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

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()

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'UntagResourceoperazione. 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

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)