Balisage d’un modèle - Rekognition

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Balisage d’un modèle

Vous pouvez identifier, organiser, rechercher et filtrer les collections 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 déterminer la facturation de vos modèles, balisez-les avec une clé Cost center et ajoutez le numéro de centre de coûts approprié sous forme de valeur. Pour plus d’informations, consultez Balisage des ressources AWS.

Utilisez des balises pour :

Vous pouvez étiqueter les modèles à l'aide de la console Amazon Rekognition ou à l'aide du. AWS SDKs

Balisage de modèles (console)

Vous pouvez utiliser la console Rekognition pour ajouter des balises aux modèles, afficher les balises jointes à 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 également ajouter des balises à un nouveau modèle lorsqu’il est entraîné. Pour plus d’informations, consultez Entraînement d’un modèle Étiquettes personnalisées Amazon Rekognition.

Pour ajouter ou supprimer des balises à un modèle existant à l’aide de la console
  1. Ouvrez la console Amazon Rekognition à l'adresse. https://console.aws.amazon.com/rekognition/

  2. Choisissez Démarrer.

  3. Dans le panneau de navigation, choisissez Projects (Projets).

  4. Sur la page des ressources Projets, choisissez le projet qui contient le modèle entraîné que vous souhaitez baliser.

  5. Dans le volet de navigation, sous le projet que vous avez choisi précédemment, choisissez Modèles.

  6. Dans la section Modèles, choisissez le modèle auquel vous souhaitez ajouter une balise.

  7. Sur la page de détails du modèle, choisissez l’onglet Balises.

  8. Dans la section Tags (Balises) choisissez Manage tags (Gérer les balises).

  9. Sur la page Gérer les balises, choisissez Ajouter une nouvelle balise.

  10. Saisissez une clé et une valeur.

    1. Pour Clé, saisissez le nom de la clé.

    2. Pour Valeur, entrez une valeur.

  11. Pour ajouter d’autres balises, répétez les étapes 9 et 10.

  12. (Facultatif) Pour supprimer une balise, choisissez Supprimer en regard de la balise que vous souhaitez supprimer. Si vous supprimez une balise précédemment enregistrée, elle sera supprimée lorsque vous enregistrerez vos modifications.

  13. 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 jointes à un modèle.

Pour afficher les balises jointes à tous les modèles d’un projet, vous devez utiliser le kit AWS SDK. Pour plus d’informations, consultez Établissement de la liste des balises de modèle.

Pour afficher les balises jointes à un modèle
  1. Ouvrez la console Amazon Rekognition à l'adresse. https://console.aws.amazon.com/rekognition/

  2. Choisissez Démarrer.

  3. Dans le panneau de navigation, choisissez Projects (Projets).

  4. Sur la page des ressources Projets, choisissez le projet qui contient le modèle entraîné que vous souhaitez afficher.

  5. Dans le volet de navigation, sous le projet que vous avez choisi précédemment, choisissez Modèles.

  6. Dans la section Modèles, choisissez le modèle dont vous souhaitez afficher la balise.

  7. Sur la page de détails du modèle, choisissez l’onglet Balises. Les balises sont affichées dans la section Balises.

Balisage de modèles (kit SDK)

Vous pouvez utiliser le AWS SDK pour :

  • Ajouter des balises à un nouveau modèle

  • Ajouter des balises à un modèle existant

  • Répertorier les balises jointes à un modèle

  • Supprimer des balises d’un modèle

Les balises des AWS CLI exemples suivants sont au format suivant.

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

Vous pouvez également utiliser ce format.

--tags key1=value1,key2=value2

Si vous n'avez pas installé le AWS CLI, consultezÉtape 4 : Configurez le AWS CLI et AWS SDKs.

Ajout de 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 du tableau 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

Pour plus d’informations sur la création et la formation d’un modèle, consultez Entraînement d’un modèle (kit SDK).

Ajout de balises à un modèle existant

Pour ajouter une ou plusieurs balises à un modèle existant, utilisez l'TagResourceopération. Spécifiez l’Amazon Resource Name (ARN) (ResourceArn) et les balises (Tags) du modèle que vous voulez 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 de modèle

Pour répertorier les balises associé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 jointes 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 jointes au modèle.

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

Pour voir quels modèles d’un projet possèdent une balise spécifique, appelez DescribeProjectVersions pour obtenir la liste des modèles. Appelez ensuite ListTagsForResource pour chaque modèle dans la réponse de DescribeProjectVersions. Examinez la réponse de ListTagsForResource pour vérifier si la balise 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
  1. 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()
  2. À partir de l’invite de commande, entrez la commande suivante : Remplacez key et value par le nom de clé et la valeur de clé que vous souhaitez rechercher.

    python find_tag.py key value

Suppression des balises d’un modèle

Pour supprimer une ou plusieurs balises d'un modèle, utilisez l'UntagResourceopération. 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 également spécifier tag-keys dans ce format.

--tag-keys key1,key2