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.
# Gestion des adaptateurs à l'aide de la AWS CLI et SDKs
Rekognition vous permet d’utiliser de multiples fonctionnalités qui s’appuient sur des modèles de vision par ordinateur préentraînés. Avec ces modèles, vous pouvez effectuer des tâches telles que la détection des étiquettes et la modération du contenu. Vous pouvez également personnaliser certains modèles à l’aide d’un adaptateur.
Vous pouvez utiliser la création et la gestion de projets de Rekognition APIs (comme et [CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion.html)) pour créer [CreateProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProject.html)et former des adaptateurs. Les pages suivantes décrivent comment utiliser les opérations d'API pour créer, entraîner et gérer vos adaptateurs à l'aide de la AWS console, du AWS SDK de votre choix ou de la AWS CLI.
Après avoir entraîné un adaptateur, vous pouvez l’utiliser pour exécuter l’inférence avec les fonctionnalités prises en charge. Actuellement, les adaptateurs sont pris en charge lors de l’utilisation de la fonctionnalité de modération du contenu.
Lorsque vous entraînez un adaptateur à l'aide d'un AWS SDK, vous devez fournir vos étiquettes de base (annotations d'image) sous la forme d'un fichier manifeste. Vous pouvez également utiliser la console de Rekognition pour créer et entraîner un adaptateur.
**Note**
Les adaptateurs ne peuvent pas être copiés. Seules les versions du projet Rekognition Custom Labels peuvent être copiées.
**Topics**
+ [Statuts des adaptateurs](#managing-adapters-project-versions-statuses)
+ [Création d’un projet](managing-adapters-create-project.md)
+ [Description des projets](managing-adapters-describe-projects.md)
+ [Suppression d’un projet](managing-adapters-delete-project.md)
+ [Création d’une version de projet](managing-adapters-create-project-version.md)
+ [Description d’une version de projet](managing-adapters-describe-project.md)
+ [Suppression d’une version de projet](managing-adapters-delete-project-version.md)
## Statuts des adaptateurs
L'adaptateur de modération personnalisé (versions du projet) peut avoir l'un des statuts suivants :
+ TRAINING\$1IN\$1PROGRESS - L'adaptateur est en train de s'entraîner sur les fichiers que vous avez fournis en tant que documents de formation.
+ TRAINING\$1COMPLETED - L'adaptateur a terminé l'entraînement avec succès et vous êtes prêt à vérifier ses performances.
+ TRAINING\$1FAILED - L'adaptateur n'a pas réussi à terminer sa formation pour une raison quelconque. Consultez le fichier manifeste de sortie et le résumé du manifeste de sortie pour obtenir des informations sur la cause de l'échec.
+ SUPPRESSION - L'adaptateur est en cours de suppression.
+ OBSOLÈTE - L'adaptateur a été formé sur une ancienne version du modèle de base de modération du contenu. Il est en période de grâce et expirera dans les 60 à 90 jours suivant la sortie de la nouvelle version du modèle de base. Pendant la période de grâce, vous pouvez toujours utiliser l'adaptateur pour les inférences [DetectModerationLabels](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DetectModerationLabels.html)ou les opérations [StartMediaAnalysisJob](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartMediaAnalysisJob.html)d'API. Reportez-vous à la console de modération personnalisée pour connaître la date d'expiration de vos adaptateurs.
+ EXPIRÉ - L'adaptateur a été formé sur une ancienne version du modèle de base de modération du contenu et il ne peut plus être utilisé pour obtenir des résultats personnalisés avec les opérations de l' StartMediaAnalysisJob API DetectModerationLabels or. Si un adaptateur expiré est spécifié dans une demande d'inférence, il sera ignoré et la réponse sera renvoyée à partir de la version la plus récente du modèle de base de modération personnalisée.
# Création d’un projet
Avec cette [CreateProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProject.html)opération, vous pouvez créer un projet qui contiendra un adaptateur pour les opérations de détection d'étiquettes de Rekognition. Un projet est un groupe de ressources. Dans le cas d'opérations de détection d'étiquettes telles que DetectModerationLabels, un projet vous permet de stocker des adaptateurs que vous pouvez utiliser pour personnaliser le modèle de Rekognition de base. Lors de l'appel CreateProject, vous fournissez le nom du projet que vous souhaitez créer à l' ProjectName argument.
Pour créer un projet à l'aide de la AWS console :
+ Connectez-vous à la console de Rekognition
+ Cliquez sur **Modération personnalisée**
+ Choisissez **Créer un projet**
+ Sélectionnez **Créer un nouveau projet** ou **Ajouter à un projet existant**
+ Ajoutez un **nom de projet**
+ Ajoutez un **nom d’adaptateur**
+ Ajoutez une description si vous le souhaitez
+ Choisissez la manière dont vous souhaitez importer vos images d’entraînement : fichier manifeste, depuis le compartiment S3 ou depuis votre ordinateur
+ Choisissez si vous souhaitez diviser automatiquement vos données d’entraînement ou importer un fichier manifeste
+ Indiquez si vous souhaitez ou non que le projet soit automatiquement mis à jour
+ Cliquez sur **Créer un projet**
Pour créer un projet à l'aide de la AWS CLI et du SDK :
1. Si ce n'est pas déjà fait, installez et configurez la AWS CLI et le AWS SDKs. Pour plus d’informations, consultez [Étape 2 : configurer le AWS CLI et AWS SDKs](setup-awscli-sdk.md).
1. Utilisez le code suivant pour créer un projet :
------
#### [ CLI ]
```
# Request
# Creating Content Moderation Project
aws rekognition create-project \
--project-name "project-name" \
--feature CONTENT_MODERATION \
--auto-update ENABLED
--profile profile-name
```
------
# Description des projets
Vous pouvez utiliser l'[DescribeProjects](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjects.html)API pour obtenir des informations sur vos projets, notamment des informations sur tous les adaptateurs associés à un projet.
Pour décrire les projets avec la AWS CLI et le SDK :
1. Si ce n'est pas déjà fait, installez et configurez la AWS CLI et le AWS SDKs. Pour plus d’informations, consultez [Étape 2 : configurer le AWS CLI et AWS SDKs](setup-awscli-sdk.md).
1. Utilisez le code suivant pour créer un projet :
------
#### [ CLI ]
```
# Request
# Getting CONTENT_MODERATION project details
aws rekognition describe-projects \
--features CONTENT_MODERATION
--profile profile-name
```
------
# Suppression d’un projet
Vous pouvez supprimer un projet à l'aide de la console Rekognition ou en appelant l'API. [DeleteProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProject.html) Pour supprimer un projet, vous devez d’abord supprimer chacun des adaptateurs associés. Il est impossible de rétablir un projet ou un modèle supprimé.
Pour supprimer un projet à l'aide de la AWS console :
+ Connectez-vous à la console de Rekognition.
+ Cliquez sur **Modération personnalisée**.
+ Vous devez supprimer chaque adaptateur associé à votre projet avant de pouvoir supprimer le projet lui-même. Supprimez tous les adaptateurs associés au projet en les sélectionnant, puis en sélectionnant **Supprimer**.
+ Sélectionnez le projet, puis cliquez sur le bouton **Supprimer**.
Pour supprimer un projet à l'aide de la AWS CLI et du SDK :
1. Si ce n'est pas déjà fait, installez et configurez la AWS CLI et le AWS SDKs. Pour plus d’informations, consultez [Étape 2 : configurer le AWS CLI et AWS SDKs](setup-awscli-sdk.md).
1. Utilisez le code suivant pour créer un projet :
------
#### [ CLI ]
```
aws rekognition delete-project
--project-arn project_arn \
--profile profile-name
```
------
# Création d’une version de projet
Vous pouvez entraîner un adaptateur en vue de son déploiement à l'aide de [CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion.html)cette opération. CreateProjectVersion crée d'abord une nouvelle version d'un adaptateur associé à un projet, puis commence à entraîner l'adaptateur. La réponse de CreateProjectVersion est un Amazon Resource Name (ARN) pour la version du modèle. L’entraînement prend un certain temps. Vous pouvez obtenir le statut actuel en appelant DescribeProjectVersions. Lors de l’entraînement d’un modèle, Rekognition utilise les jeux de données d’entraînement et de test associés au projet. Vous créez des jeux de données à l’aide de la console. Pour de plus amples informations, consultez la section sur les jeux de données.
Pour créer une version de projet à l’aide de la console Rekognition :
+ Connectez-vous à la console Rekognition AWS
+ Cliquez sur Modération personnalisée
+ Sélectionner un projet.
+ Sur la page « Détails du projet », choisissez **Créer un adaptateur**
+ Sur la page « Créer un projet », renseignez les informations requises pour les détails du projet, les images de formation et les images de test, puis sélectionnez **Créer un projet**.
+ Sur la page « Attribuer des étiquettes aux images », ajoutez des étiquettes à vos images et, lorsque vous avez terminé, sélectionnez ** Commencer l’entraînement **
Pour créer une version de projet à l'aide de la AWS CLI et du SDK :
1. Si ce n'est pas déjà fait, installez et configurez la AWS CLI et le AWS SDKs. Pour plus d’informations, consultez [Étape 2 : configurer le AWS CLI et AWS SDKs](setup-awscli-sdk.md).
1. Utilisez le code suivant pour créer une version de projet :
------
#### [ CLI ]
```
# Request
aws rekognition create-project-version \
--project-arn project-arn \
--training-data '{Assets=[GroundTruthManifest={S3Object="amzn-s3-demo-source-bucket",Name="manifest.json"}]}' \
--output-config S3Bucket=amzn-s3-demo-destination-bucket,S3KeyPrefix=my-results \
--feature-config "ContentModeration={ConfidenceThreshold=70}"
--profile profile-name
```
------
# Description d’une version de projet
Vous pouvez répertorier et décrire les adaptateurs associés à un projet à l'aide de cette [DescribeProjectVersions](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjectVersions.html)opération. Vous pouvez spécifier jusqu'à 10 versions de modèles dans ProjectVersionArns. Si vous ne spécifiez aucune valeur, les descriptions de toutes les versions de modèle du projet sont renvoyées.
Pour décrire une version de projet à l'aide de la AWS CLI et du SDK :
1. Si ce n'est pas déjà fait, installez et configurez la AWS CLI et le AWS SDKs. Pour plus d’informations, consultez [Étape 2 : configurer le AWS CLI et AWS SDKs](setup-awscli-sdk.md).
1. Utilisez le code suivant pour décrire la version d’un projet :
------
#### [ CLI ]
```
aws rekognition describe-project-versions
--project-arn project_arn \
--version-names [versions]
```
------
# Suppression d’une version de projet
Vous pouvez supprimer un adaptateur de Rekognition associé à un projet à l'aide de cette opération. [DeleteProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProjectVersion.html) Vous ne pouvez pas supprimer un adaptateur s’il fonctionne ou s’il est en cours d’entraînement. Pour vérifier l'état d'un adaptateur, appelez l' DescribeProjectVersions opération et vérifiez le champ Status renvoyé par celui-ci. Pour arrêter un appel d'adaptateur en cours d'exécution StopProjectVersion. Si le modèle est en cours d’entraînement, attendez la fin de l’entraînement pour le supprimer. Vous devez supprimer chaque adaptateur associé à votre projet avant de pouvoir supprimer le projet lui-même.
Pour supprimer une version de projet à l’aide de la console Rekognition :
+ Connectez-vous à la console de Rekognition
+ Cliquez sur Modération personnalisée
+ Dans l’onglet Projets, vous pouvez voir tous vos projets et les adaptateurs associés. Sélectionnez un adaptateur, puis sélectionnez **Supprimer**.
Pour supprimer une version de projet à l'aide de la AWS CLI et du SDK :
1. Si ce n'est pas déjà fait, installez et configurez la AWS CLI et le AWS SDKs. Pour plus d’informations, consultez [Étape 2 : configurer le AWS CLI et AWS SDKs](setup-awscli-sdk.md).
1. Utilisez le code suivant pour supprimer une version de projet :
------
#### [ CLI ]
```
# Request
aws rekognition delete-project-version
--project-version-arn model_arn \
--profile profile-name
```
------