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. # CreateDataDeletionJob Erstellt einen Batch-Job, der stapelweise alle Verweise auf bestimmte Benutzer aus einer Amazon Personalize-Datensatzgruppe löscht. Sie geben die zu löschenden Benutzer in einer CSV-Datei mit Benutzer-IDs in einem Amazon S3-Bucket an. Nach Abschluss eines Auftrags trainiert Amazon Personalize die Benutzerdaten nicht mehr und berücksichtigt die Benutzer nicht mehr bei der Generierung von Benutzersegmenten. Weitere Informationen zum Erstellen eines Jobs zum Löschen von Daten finden Sie unter Benutzer [https://docs.aws.amazon.com/personalize/latest/dg/delete-records.html](https://docs.aws.amazon.com/personalize/latest/dg/delete-records.html) löschen. + Ihre Eingabedatei muss eine CSV-Datei mit einer einzelnen USER\_ID-Spalte sein, in der die Benutzer-IDs aufgeführt sind. Weitere Informationen zur Vorbereitung der CSV-Datei finden Sie unter [ Vorbereiten Ihrer Datenlöschdatei und Hochladen auf Amazon S3. ](https://docs.aws.amazon.com/personalize/latest/dg/prepare-deletion-input-file.html) + Um Amazon Personalize die Erlaubnis zu geben, auf Ihre CSV-Eingabedatei mit Benutzer-IDs zuzugreifen, müssen Sie eine IAM-Servicerolle angeben, die die Berechtigung hat, aus der Datenquelle zu lesen. Für diese Rolle sind `ListBucket` Berechtigungen für den Bucket `GetObject` und seinen Inhalt erforderlich. Diese Berechtigungen entsprechen dem Importieren von Daten. Informationen zum Gewähren des Zugriffs auf Ihren Amazon S3-Bucket finden Sie unter Amazon Personalize Zugriff auf Amazon S3-Ressourcen [https://docs.aws.amazon.com/personalize/latest/dg/granting-personalize-s3-access.html](https://docs.aws.amazon.com/personalize/latest/dg/granting-personalize-s3-access.html) gewähren. Nachdem Sie einen Job erstellt haben, kann es bis zu einem Tag dauern, bis alle Verweise auf die Benutzer aus Datensätzen und Modellen gelöscht sind. Bis der Job abgeschlossen ist, verwendet Amazon Personalize die Daten weiterhin beim Training. Und wenn Sie ein Rezept für die Benutzersegmentierung verwenden, werden die Benutzer möglicherweise in Benutzersegmenten angezeigt. **Status** Ein Auftrag zum Löschen von Daten kann einen der folgenden Status haben: + AUSSTEHEND > IN BEARBEITUNG > ABGESCHLOSSEN — ODER — FEHLGESCHLAGEN Um den Status des Datenlöschauftrags abzurufen, rufen Sie [ DescribeDataDeletionJob ](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataDeletionJob.html) API operation auf und geben Sie den Amazon-Ressourcennamen (ARN) des Auftrags an. Wenn der Status FAILED lautet, enthält die Antwort einen `failureReason` Schlüssel, der beschreibt, warum der Auftrag fehlgeschlagen ist. **Verbundene APIs** + [ListDataDeletionJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDataDeletionJobs.html) + [DescribeDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataDeletionJob.html) ## Anforderungssyntax ``` { "datasetGroupArn": "{{string}}", "dataSource": { "dataLocation": "{{string}}" }, "jobName": "{{string}}", "roleArn": "{{string}}", "tags": [ { "tagKey": "{{string}}", "tagValue": "{{string}}" } ] } ``` ## Anforderungsparameter Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [datasetGroupArn](#API_CreateDataDeletionJob_RequestSyntax) ** Der Amazon-Ressourcenname (ARN) der Datensatzgruppe, die die Datensätze enthält, aus denen Sie Datensätze löschen möchten. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen. Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+` Erforderlich: Ja ** [dataSource](#API_CreateDataDeletionJob_RequestSyntax) ** Der Amazon S3-Bucket, der die Liste der Benutzer-IDs der zu löschenden Benutzer enthält. Typ: [DataSource](API_DataSource.md) Objekt Erforderlich: Ja ** [jobName](#API_CreateDataDeletionJob_RequestSyntax) ** Der Name für den Auftrag zum Löschen von Daten. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 63 Zeichen. Pattern: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` Erforderlich: Ja ** [roleArn](#API_CreateDataDeletionJob_RequestSyntax) ** Der Amazon-Ressourcenname (ARN) der IAM-Rolle, die über Leseberechtigungen aus der Amazon S3-Datenquelle verfügt. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen. Pattern: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` Erforderlich: Ja ** [tags](#API_CreateDataDeletionJob_RequestSyntax) ** Eine Liste von [ Tags](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html), die auf den Auftrag zum Löschen von Daten angewendet werden sollen. Typ: Array von [Tag](API_Tag.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente. Erforderlich: Nein ## Antwortsyntax ``` { "dataDeletionJobArn": "string" } ``` ## Antwortelemente Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück. Die folgenden Daten werden vom Service im JSON-Format zurückgegeben. ** [dataDeletionJobArn](#API_CreateDataDeletionJob_ResponseSyntax) ** Der Amazon-Ressourcenname (ARN) des Datenlöschauftrags. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen. Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## Fehler ** InvalidInputException ** Geben Sie einen gültigen Wert für das Feld oder den Parameter an. HTTP-Statuscode: 400 ** LimitExceededException ** Das Limit für die Anzahl der Anfragen pro Sekunde wurde überschritten. HTTP-Statuscode: 400 ** ResourceAlreadyExistsException ** Die angegebene Ressource ist bereits vorhanden. HTTP-Statuscode: 400 ** ResourceInUseException ** Die angegebene Ressource wird verwendet. HTTP-Statuscode: 400 ** ResourceNotFoundException ** Die angegebene Ressource konnte nicht gefunden werden. HTTP-Statuscode: 400 ** TooManyTagsException ** Sie haben die maximale Anzahl von Tags überschritten, die Sie auf diese Ressource anwenden können. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: + [AWS Befehlszeilenschnittstelle V2 ](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK für.NET V4 ](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK für C\+\+ ](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK für Go v2 ](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK für Java V2 ](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK für JavaScript V3 ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK für Kotlin ](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK für PHP V3 ](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK für Python (Boto3) ](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDataDeletionJob) + [AWS SDK für Ruby V3 ](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDataDeletionJob)