

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Adapter mit der AWS CLI verwalten und SDKs
<a name="managing-adapters"></a>

 Mit Rekognition können Sie mehrere Funktionen nutzen, die vortrainierte Computer-Vision-Modelle nutzen. Mit diesen Modellen können Sie Aufgaben wie die Erkennung von Labels und die Moderation von Inhalten ausführen. Sie können diese bestimmten Modelle auch mithilfe eines Adapters anpassen. 

Sie können die Projekterstellung und das Projektmanagement von Rekognition APIs (wie und [CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion.html)) nutzen, um [CreateProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProject.html)Adapter zu erstellen und zu trainieren. Auf den folgenden Seiten wird beschrieben, wie Sie die API-Operationen verwenden, um Ihre Adapter mithilfe der AWS Konsole, des von Ihnen ausgewählten AWS SDK oder der AWS CLI zu erstellen, zu trainieren und zu verwalten. 

Nachdem Sie einen Adapter trainiert haben, können Sie ihn verwenden, um Inferenz mit unterstützten Features auszuführen. Derzeit werden Adapter unterstützt, wenn das Feature zur Inhaltsmoderation verwendet wird.

Wenn Sie einen Adapter mit einem AWS SDK trainieren, müssen Sie Ihre Ground-Truth-Beschriftungen (Bildanmerkungen) in Form einer Manifestdatei bereitstellen. Alternativ können Sie die Rekognition-Konsole verwenden, um einen Adapter zu erstellen und zu trainieren.

**Anmerkung**  
 Adapter können nicht kopiert werden. Nur Projektversionen von Rekognition Custom Labels können kopiert werden. 

**Topics**
+ [Status der Adapter](#managing-adapters-project-versions-statuses)
+ [Erstellen eines Projekts](managing-adapters-create-project.md)
+ [Projekte beschreiben](managing-adapters-describe-projects.md)
+ [Löschen eines Projekts](managing-adapters-delete-project.md)
+ [Erstellen einer Projektversion](managing-adapters-create-project-version.md)
+ [Beschreibung einer Projektversion](managing-adapters-describe-project.md)
+ [Löschen einer Projektversion](managing-adapters-delete-project-version.md)

## Status der Adapter
<a name="managing-adapters-project-versions-statuses"></a>

Der benutzerdefinierte Moderationsadapter (Projektversionen) kann sich in einem der folgenden Status befinden: 
+ TRAINING\$1IN\$1PROGRESS — Der Adapter wird gerade mit den Dateien trainiert, die Sie als Schulungsdokumente bereitgestellt haben.
+ TRAINING\$1COMPLETED — Der Adapter hat die Schulung erfolgreich abgeschlossen und kann nun von Ihnen überprüft werden. 
+ TRAINING\$1FAILED — Der Adapter konnte sein Training aus irgendeinem Grund nicht abschließen. Informationen zur Ursache des Fehlers finden Sie in der Ausgabemanifestdatei und in der Zusammenfassung des Ausgabemanifests.
+ LÖSCHEN — Der Adapter wird gerade gelöscht.
+ VERALTET — Der Adapter wurde auf einer älteren Version des Basismodells der Inhaltsmoderation trainiert. Es befindet sich in einer Übergangszeit und läuft innerhalb von 60 bis 90 Tagen nach der Veröffentlichung der neuen Basismodellversion ab. Während der Übergangszeit können Sie den Adapter weiterhin für Inferenzen [DetectModerationLabels](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DetectModerationLabels.html)oder [StartMediaAnalysisJob](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartMediaAnalysisJob.html)API-Operationen verwenden. Das Ablaufdatum Ihrer Adapter finden Sie in der Custom Moderation Console.
+ ABGELAUFEN — Der Adapter wurde auf einer älteren Version des Basismodells der Inhaltsmoderation trainiert und kann nicht mehr verwendet werden, um benutzerdefinierte Ergebnisse mit den DetectModerationLabels oder StartMediaAnalysisJob API-Operationen zu erzielen. Wenn in einer Inferenzanforderung ein abgelaufener Adapter angegeben ist, wird er ignoriert und die Antwort wird stattdessen von der neuesten Version des Basismodells der benutzerdefinierten Moderation zurückgegeben. 

# Erstellen eines Projekts
<a name="managing-adapters-create-project"></a>

Mit dieser [CreateProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProject.html)Operation können Sie ein Projekt erstellen, das einen Adapter für die Labelerkennungsoperationen von Rekognition enthält. Ein Projekt ist eine Gruppe von Ressourcen, und im Fall von Etikettenerkennungsoperationen wie einem Projekt können Sie Adapter speichern DetectModerationLabels, mit denen Sie das Rekognition-Basismodell anpassen können. Beim Aufrufen CreateProject geben Sie dem Argument den Namen des Projekts, das Sie erstellen möchten. ProjectName 

 Um ein Projekt mit der AWS Konsole zu erstellen: 
+ Melden Sie sich bei der Rekognition-Konsole an
+ Klicken Sie auf **Benutzerdefinierte Moderation**
+ Wählen Sie **Projekt erstellen** aus
+ Wählen Sie entweder **Neues Projekt erstellen** oder **Zu einem vorhandenen Projekt hinzufügen**
+ Fügen Sie einen **Projektnamen** hinzu
+ Fügen Sie einen **Adapternamen** hinzu
+ Fügen Sie bei Bedarf eine Beschreibung hinzu
+ Wählen Sie aus, wie Sie Ihre Trainingsbilder importieren möchten: Manifest-Datei, aus dem S3-Bucket oder von Ihrem Computer
+ Wählen Sie aus, ob Sie Ihre Trainingsdaten automatisch splitten oder eine Manifestdatei importieren möchten
+ Wählen Sie aus, ob das Projekt automatisch aktualisiert werden soll
+ Klicken Sie auf **Projekt erstellen**

Um ein Projekt mit der AWS CLI und dem SDK zu erstellen:

1. Falls Sie dies noch nicht getan haben, installieren und konfigurieren Sie die AWS CLI und die AWS SDKs. Weitere Informationen finden Sie unter [Schritt 2: Richten Sie das AWS CLI und ein AWS SDKs](setup-awscli-sdk.md).

1. Verwenden Sie den folgenden Code, um ein Projekt zu erstellen:

------
#### [ CLI ]

```
# Request
# Creating Content Moderation Project
aws rekognition create-project \
    --project-name "project-name" \
    --feature CONTENT_MODERATION \
    --auto-update ENABLED
    --profile profile-name
```

------

# Projekte beschreiben
<a name="managing-adapters-describe-projects"></a>

Sie können die [DescribeProjects](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjects.html)API verwenden, um Informationen zu Ihren Projekten abzurufen, einschließlich Informationen zu allen Adaptern, die einem Projekt zugeordnet sind. 

Um Projekte mit der AWS CLI und dem SDK zu beschreiben:

1. Falls Sie dies noch nicht getan haben, installieren und konfigurieren Sie die AWS CLI und die AWS SDKs. Weitere Informationen finden Sie unter [Schritt 2: Richten Sie das AWS CLI und ein AWS SDKs](setup-awscli-sdk.md).

1. Verwenden Sie den folgenden Code, um ein Projekt zu beschreiben:

------
#### [ CLI ]

```
# Request
# Getting CONTENT_MODERATION project details 
aws rekognition describe-projects \
    --features CONTENT_MODERATION
    --profile profile-name
```

------

# Löschen eines Projekts
<a name="managing-adapters-delete-project"></a>

Sie können ein Projekt löschen, indem Sie die Rekognition-Konsole verwenden oder die [DeleteProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProject.html)API aufrufen. Um ein Projekt zu löschen, müssen Sie zuerst jeden der zugehörigen Adapter löschen. Ein gelöschtes Projekt oder Modell kann nicht rückgängig gemacht werden. 

 Um ein Projekt mit der AWS Konsole zu löschen: 
+ Melden Sie sich bei der Rekognition-Konsole an.
+ Klicken Sie auf **Benutzerdefinierte Moderation**.
+ Sie müssen jeden Adapter löschen, der Ihrem Projekt zugeordnet ist, bevor das Projekt selbst gelöscht werden kann. Löschen Sie alle mit dem Projekt verknüpften Adapter, indem Sie den Adapter auswählen und dann **Löschen** wählen.
+ Wählen Sie das Projekt aus und klicken Sie dann auf die Schaltfläche **Löschen**.

Um ein Projekt mit der AWS CLI und dem SDK zu löschen:

1. Falls Sie dies noch nicht getan haben, installieren und konfigurieren Sie die AWS CLI und die AWS SDKs. Weitere Informationen finden Sie unter [Schritt 2: Richten Sie das AWS CLI und ein AWS SDKs](setup-awscli-sdk.md).

1. Verwenden Sie den folgenden Code, um ein Projekt zu löschen: 

------
#### [ CLI ]

```
aws rekognition delete-project 
  --project-arn project_arn \
  --profile profile-name
```

------

# Erstellen einer Projektversion
<a name="managing-adapters-create-project-version"></a>

Sie können einen Adapter für die Bereitstellung trainieren, indem Sie den [CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion.html)Vorgang verwenden. CreateProjectVersion erstellt zuerst eine neue Version eines Adapters, der einem Projekt zugeordnet ist, und beginnt dann mit dem Training des Adapters. Die Antwort von CreateProjectVersion ist ein Amazon Resource Name (ARN) für die Version des Modells. Es dauert eine Weile, bis das Training abgeschlossen ist. Sie können den aktuellen Status abrufen, indem Sie anrufen DescribeProjectVersions. Beim Training eines Modells verwendet Rekognition die mit dem Projekt verknüpften Trainings- und Testdatensätze. Sie erstellen Datensätze über die Konsole. Weitere Informationen finden Sie im Abschnitt über Datensätze. 

 Um eine Projektversion mit der Rekognition-Konsole zu erstellen: 
+  Melden Sie sich bei der AWS-Rekognition-Konsole an 
+  Klicken Sie auf „Benutzerdefinierte Moderation“ 
+  Wählen Sie ein Projekt aus. 
+  Wählen Sie auf der Seite „Projektdetails“ die Option **Adapter erstellen** 
+  Geben Sie auf der Seite „Projekt erstellen“ die erforderlichen Details für Projektdetails, Trainingsbilder und Testbilder ein und wählen Sie dann **Projekt erstellen** aus. 
+  Fügen Sie auf der Seite „Bildern Label zuweisen“ Labels zu Ihren Bildern hinzu und wählen Sie, wenn Sie fertig sind, die Option **Training starten** 

So erstellen Sie eine Projektversion mit der AWS CLI und dem SDK:

1. Falls Sie dies noch nicht getan haben, installieren und konfigurieren Sie die AWS CLI und die AWS SDKs. Weitere Informationen finden Sie unter [Schritt 2: Richten Sie das AWS CLI und ein AWS SDKs](setup-awscli-sdk.md).

1. Verwenden Sie den folgenden Code, um eine Projektversion zu erstellen: 

------
#### [ 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
```

------

# Beschreibung einer Projektversion
<a name="managing-adapters-describe-project"></a>

Mithilfe der [DescribeProjectVersions](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjectVersions.html)Operation können Sie Adapter, die einem Projekt zugeordnet sind, auflisten und beschreiben. Sie können bis zu 10 Modellversionen in angeben ProjectVersionArns. Wenn Sie keinen Wert angeben, werden Beschreibungen für alle Modellversionen im Projekt zurückgegeben. 

Um eine Projektversion mit der AWS CLI und dem SDK zu beschreiben:

1. Falls Sie dies noch nicht getan haben, installieren und konfigurieren Sie die AWS CLI und die AWS SDKs. Weitere Informationen finden Sie unter [Schritt 2: Richten Sie das AWS CLI und ein AWS SDKs](setup-awscli-sdk.md).

1. Verwenden Sie den folgenden Code, um eine Projektversion zu beschreiben:

------
#### [ CLI ]

```
aws rekognition describe-project-versions 
  --project-arn project_arn \
  --version-names [versions]
```

------

# Löschen einer Projektversion
<a name="managing-adapters-delete-project-version"></a>

Mit diesem Vorgang können Sie einen Rekognition-Adapter löschen, der [DeleteProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProjectVersion.html)einem Projekt zugeordnet ist. Sie können einen Adapter nicht löschen, wenn er ausgeführt oder trainiert wird. Um den Status eines Adapters zu überprüfen, rufen Sie den DescribeProjectVersions Vorgang auf und überprüfen Sie das vom Adapter zurückgegebene Statusfeld. Um einen laufenden Adapter zu beenden, rufen Sie ihn auf StopProjectVersion. Wenn das Modell trainiert wird, warten Sie, bis es das Training abgeschlossen hat, um es zu löschen. Sie müssen jeden Adapter löschen, der Ihrem Projekt zugeordnet ist, bevor das Projekt selbst gelöscht werden kann.

 Um eine Projektversion mit der Rekognition-Konsole zu löschen: 
+ Melden Sie sich bei der Rekognition-Konsole an
+ Klicken Sie auf „Benutzerdefinierte Moderation“
+ Auf der Registerkarte „Projekte“ können Sie alle Ihre Projekte und die zugehörigen Adapter sehen. Wählen Sie einen Adapter aus und klicken Sie dann auf **Löschen**.

Um eine Projektversion mit der AWS CLI und dem SDK zu löschen:

1. Falls Sie dies noch nicht getan haben, installieren und konfigurieren Sie die AWS CLI und die AWS SDKs. Weitere Informationen finden Sie unter [Schritt 2: Richten Sie das AWS CLI und ein AWS SDKs](setup-awscli-sdk.md).

1. Verwenden Sie den folgenden Code, um eine Projektversion zu löschen:

------
#### [ CLI ]

```
# Request
aws rekognition delete-project-version 
  --project-version-arn model_arn \
  --profile profile-name
```

------