Marquage des modèles (console)Affichage des balises de modèle Marquage des modèles (SDK)

Marquer un modèle

Vous pouvez identifier, organiser, rechercher et filtrer vos modèles Amazon Rekognition à l'aide de balises. Chaque balise est une étiquette composée d'une clé définie par l'utilisateur et d'une valeur. Par exemple, pour vous aider à déterminer la facturation de vos modèles, étiquetez vos modèles à l'aide d'uneCost center clé et ajoutez le numéro de centre de coûts approprié comme valeur. Pour de plus amples informations, veuillez consulter Balisage des ressources AWS.

Utilisez des balises pour :

Suivez la facturation d'un modèle à l'aide de balises de répartition des coûts. Pour plus d'informations, consultez Utilisation des balises de répartition des coûts.
Contrôlez l'accès à un modèle à l'aide de la Identity and Access Management (IAM). Pour de plus amples informations, veuillez consulter Contrôle de l'accès auxAWS ressources à l'aide des balises de ressources.
Automatisez la gestion des modèles. Par exemple, vous pouvez exécuter des scripts de démarrage ou d'arrêt automatisés qui désactivent les modèles de développement en dehors des heures ouvrables afin de réduire les coûts. Pour plus d'informations, veuillez consulter Exécution d’un modèle Étiquettes personnalisées Amazon Rekognition entraîné.

Vous pouvez étiqueter des modèles à l'aide de la console Amazon Rekognition ou à l'aide des kits deAWS développement logiciel (SDK).

Marquage des modèles (console)

Vous pouvez utiliser la console Rekognition pour ajouter des balises aux modèles, afficher les balises associées à un modèle et supprimer des balises.

Ajout ou suppression de balises

Cette procédure explique comment ajouter des balises à un modèle existant ou en supprimer. Vous pouvez ajouter des balises à un nouveau modèle lorsqu'il est entraîné. Pour plus d'informations, veuillez consulter Entraînement d’un modèle Étiquettes personnalisées Amazon Rekognition.

Pour ajouter des balises à un modèle existant ou en supprimer à l'aide de la console

Ouvrez la console Amazon Rekognition à l'adresse https://console.aws.amazon.com/rekognition/.
Sélectionnez Get started (Démarrer).
Dans le panneau de navigation, choisissez Projects (Projets).
Sur la page Ressources des projets, choisissez le projet qui contient le modèle que vous souhaitez baliser.
Dans le panneau de navigation, sous le projet que vous avez précédemment choisi, choisissez Models (Modèles).
Dans la section Modèles (Modèles), choisissez le modèle auquel vous souhaitez ajouter une balise.
Sur la page de détails du modèle, choisissez l'onglet Tags (Balises).
Dans la section Tags (Balises) choisissez Manage tags (Gérer les balises).
Sur la page Gérer les balises, choisissez Ajouter une nouvelle étiquette.
Entrez une clé et une valeur.
1. Pour Key (Clé), entrez un nom pour la clé.
2. Pour Valeur, entrez une valeur.
Pour ajouter d'autres balises, répétez les étapes 9 et 10.
(Facultatif) Pour supprimer une balise, choisissez Supprimer en regard de la balise à supprimer. Si vous supprimez une étiquette précédemment enregistrée, elle est supprimée lorsque vous enregistrez vos modifications.
Choisissez Enregistrer les modifications pour enregistrer vos modifications.

Affichage des balises de modèle

Vous pouvez utiliser la console Amazon Rekognition pour afficher les balises attachées à un modèle.

Pour afficher les balises associées à tous les modèles d'un projet, vous devez utiliser le kit SDK AWS. Pour plus d'informations, veuillez consulter Établissement de la liste des balises.

Pour afficher les balises attachées à un modèle

Ouvrez la console Amazon Rekognition à l'adresse https://console.aws.amazon.com/rekognition/.
Sélectionnez Get started (Démarrer).
Dans le panneau de navigation, choisissez Projects (Projets).
Sur la page Ressources des projets, choisissez le projet qui contient le modèle dont vous souhaitez afficher la balise.
Dans le panneau de navigation, sous le projet que vous avez précédemment choisi, choisissez Models (Modèles).
Dans la section Modèles (Modèles), choisissez le modèle dont vous souhaitez afficher l'étiquette.
Sur la page de détails du modèle, choisissez l'onglet Tags (Balises). Les balises sont affichées dans la section Étiquettes.

Marquage des modèles (SDK)

Vous pouvez utiliser leAWS SDK pour :

Ajouter des balises à un nouveau modèle
Ajouter des balises à un modèle existant
Établissement de la liste des balises attachées à un modèle
Supprimer les balises d'un modèle

Les balises desAWS CLI exemples suivants sont au format suivant.


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

Vous pouvez utiliser ce format.


--tags key1=value1,key2=value2

Si vous n'avez pas installé leAWS CLI, consultezÉtape 4 : Configuration des AWS SDK AWS CLI et.

Ajout d'balises à un nouveau modèle

Vous pouvez ajouter des balises à un modèle lorsque vous le créez à l'aide de cette CreateProjectVersionopération. Spécifiez une ou plusieurs balises dans le paramètre d'entrée duTags tableau.


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

Pour plus d'informations sur la création et l'entraînement d'un modèle, consultezEntraînement d’un modèle (kit SDK).

Ajout de balises à un modèle existant

Pour ajouter une ou plusieurs identifications à un modèle existant, utilisez l'TagResourceopération d'. Spécifiez l'Amazon Resource Name (ARN) (ResourceArn) du modèle et les balises (Tags) que vous souhaitez ajouter. L'exemple suivant montre comment ajouter deux balises.


aws rekognition tag-resource --resource-arn resource-arn \
  --tags '{"key1":"value1","key2":"value2"}' \
  --profile custom-labels-access

Vous pouvez obtenir l'ARN d'un modèle en appelant CreateProjectVersion.

Établissement de la liste des balises

Pour répertorier les balises attachées à un modèle, utilisez l'ListTagsForResourceopération et spécifiez l'ARN du modèle (ResourceArn). La réponse est une carte des clés de balise et des valeurs attachées au modèle spécifié.


aws rekognition list-tags-for-resource --resource-arn resource-arn \
  --profile custom-labels-access

La sortie affiche la liste des balises attachées au modèle.


{
    "Tags": {
        "Dept": "Engineering",
        "Name": "Ana Silva Carolina",
        "Role": "Developer"
    }
}

Pour voir quels modèles d'un projet ont une étiquette spécifique, appelezDescribeProjectVersions pour obtenir la liste des modèles. Appelez ensuiteListTagsForResource chaque modèle dans le formulaire de réponseDescribeProjectVersions. Inspectez le formulaire de réponseListTagsForResource pour voir si l'étiquette requise est présente.

L'exemple Python 3 suivant vous montre comment rechercher dans tous vos projets une clé et une valeur de balise spécifiques. La sortie inclut l'ARN du projet et l'ARN du modèle dans lequel une clé correspondante est trouvée.

Pour rechercher la valeur d'une balise

Enregistrez le code suivant dans un fichier nommé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()

À partir de l'invite de commande, entrez la commande suivante : Remplacez la clé et la valeur par le nom de la clé et la valeur de clé que vous souhaitez rechercher.
```
python find_tag.py key value
```

Suppression de balises d'un modèle

Pour supprimer une ou plusieurs identifications d'un modèle, utilisez l'UntagResourceopération d'. Spécifiez l'ARN du modèle (ResourceArn) et les clés de balise (Tag-Keys) que vous souhaitez supprimer.


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

Vous pouvez spécifiertag-keys dans ce format.


--tag-keys key1,key2

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Suppression d'un modèle

Décrire un modèle (SDK)