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 :
-
Suivre la facturation d’un modèle à l’aide des balises de répartition des coûts. Pour plus d’informations, consultez Utilisation des balises de répartition des coûts.
-
Contrôler l’accès à un modèle à l’aide de Gestion des identités et des accès (IAM). Pour plus d’informations, consultez Contrôle de l’accès aux ressources AWS à l’aide de balises de ressources.
-
Automatiser la gestion des modèles. Par exemple, vous pouvez exécuter des scripts automatisés de départ ou d’arrêt qui désactivent les modèles de développement en dehors des heures ouvrables afin de réduire les coûts. Pour de plus amples informations, veuillez consulter Exécution d’un modèle Étiquettes personnalisées Amazon Rekognition entraîné.
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
-
Ouvrez la console Amazon Rekognition à l'adresse. https://console.aws.amazon.com/rekognition/
-
Choisissez Démarrer.
-
Dans le panneau de navigation, choisissez Projects (Projets).
-
Sur la page des ressources Projets, choisissez le projet qui contient le modèle entraîné que vous souhaitez baliser.
-
Dans le volet de navigation, sous le projet que vous avez choisi précédemment, choisissez Modèles.
-
Dans la section Modèles, choisissez le modèle auquel vous souhaitez ajouter une balise.
-
Sur la page de détails du modèle, choisissez l’onglet Balises.
-
Dans la section Tags (Balises) choisissez Manage tags (Gérer les balises).
-
Sur la page Gérer les balises, choisissez Ajouter une nouvelle balise.
-
Saisissez une clé et une valeur.
-
Pour Clé, saisissez le nom de la clé.
-
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 que vous souhaitez supprimer. Si vous supprimez une balise précédemment enregistrée, elle sera supprimée lorsque vous enregistrerez 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 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
-
Ouvrez la console Amazon Rekognition à l'adresse. https://console.aws.amazon.com/rekognition/
-
Choisissez Démarrer.
-
Dans le panneau de navigation, choisissez Projects (Projets).
-
Sur la page des ressources Projets, choisissez le projet qui contient le modèle entraîné que vous souhaitez afficher.
-
Dans le volet de navigation, sous le projet que vous avez choisi précédemment, choisissez Modèles.
-
Dans la section Modèles, choisissez le modèle dont vous souhaitez afficher la balise.
-
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-nameversion_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
-
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
key
etvalue
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