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.
CreateBatchInferenceJob
Generiert Batch-Empfehlungen auf der Grundlage einer Liste von Artikeln oder Benutzern, die in Amazon S3 gespeichert sind, und exportiert die Empfehlungen in einen Amazon S3 S3-Bucket.
Um Batch-Empfehlungen zu generieren, geben Sie den ARN einer Lösungsversion und einen Amazon S3 S3-URI für die Eingabe- und Ausgabedaten an. Für Benutzerpersonalisierung, beliebte Artikel und personalisierte Rankinglösungen generiert der Batch-Inferenz-Job eine Liste mit empfohlenen Elementen für jede Benutzer-ID in der Eingabedatei. Bei Lösungen für verwandte Artikel generiert der Job eine Liste mit empfohlenen Elementen für jede Element-ID in der Eingabedatei.
Weitere Informationen finden Sie unter Einen Batch-Inferenzjob erstellen.
Wenn Sie das Rezept für ähnliche Artikel verwenden, kann Amazon Personalize den Batch-Empfehlungen beschreibende Themen hinzufügen. Um Themen zu generieren, setzen Sie den Auftragsmodus auf THEME_GENERATION und geben Sie den Namen des Felds an, das Artikelnamen in den Eingabedaten enthält.
Weitere Informationen zum Generieren von Themes finden Sie unter Batch-Empfehlungen mit Themes aus dem Content Generator.
Mit Trending-Now oder Next-Best-Action Rezepten können Sie keine Batch-Empfehlungen erhalten.
Anforderungssyntax
{
"batchInferenceJobConfig": {
"itemExplorationConfig": {
"string" : "string"
}
},
"batchInferenceJobMode": "string",
"filterArn": "string",
"jobInput": {
"s3DataSource": {
"kmsKeyArn": "string",
"path": "string"
}
},
"jobName": "string",
"jobOutput": {
"s3DataDestination": {
"kmsKeyArn": "string",
"path": "string"
}
},
"numResults": number,
"roleArn": "string",
"solutionVersionArn": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
],
"themeGenerationConfig": {
"fieldsForThemeGeneration": {
"itemName": "string"
}
}
}Anforderungsparameter
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
- batchInferenceJobConfig
-
Die Konfigurationsdetails eines Batch-Inferenzjobs.
Typ: BatchInferenceJobConfig Objekt
Erforderlich: Nein
- batchInferenceJobMode
-
Der Modus des Batch-Inferenzjobs. Um beschreibende Themen für Gruppen ähnlicher Elemente zu generieren, stellen Sie den Jobmodus auf ein.
THEME_GENERATIONWenn Sie keine Themen generieren möchten, verwenden Sie die StandardeinstellungBATCH_INFERENCE.Wenn Sie Batch-Empfehlungen mit Themes erhalten, fallen zusätzliche Kosten an. Weitere Informationen finden Sie unter Amazon Personalize Personalize-Preise
. Typ: Zeichenfolge
Zulässige Werte:
BATCH_INFERENCE | THEME_GENERATIONErforderlich: Nein
- filterArn
-
Der ARN des Filters, der auf den Batch-Inferenzjob angewendet werden soll. Weitere Informationen zur Verwendung von Filtern finden Sie unter Empfehlungen zum Filtern von Batches.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.
Pattern:
arn:([a-z\d-]+):personalize:.*:.*:.+Erforderlich: Nein
- jobInput
-
Der Amazon S3 S3-Pfad, der zur Eingabedatei führt, auf der Ihre Empfehlungen basieren sollen. Das Eingabematerial muss im JSON-Format vorliegen.
Typ: BatchInferenceJobInput Objekt
Erforderlich: Ja
- jobName
-
Der Name des zu erstellenden Batch-Inferenzjobs.
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
- jobOutput
-
Der Pfad zum Amazon S3 S3-Bucket, in dem die Ausgabe des Jobs gespeichert wird.
Typ: BatchInferenceJobOutput Objekt
Erforderlich: Ja
- numResults
-
Die Anzahl der abzurufenden Empfehlungen.
Typ: Ganzzahl
Erforderlich: Nein
- roleArn
-
Der ARN der Amazon Identity and Access Management-Rolle, die über Lese- und Schreibberechtigungen für Ihre Eingabe- bzw. Ausgabe-Amazon S3-Buckets 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
- solutionVersionArn
-
Der Amazon-Ressourcenname (ARN) der Lösungsversion, die zur Generierung der Batch-Inferenzempfehlungen verwendet wird.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.
Pattern:
arn:([a-z\d-]+):personalize:.*:.*:.+Erforderlich: Ja
-
Eine Liste von Tags, die auf den Batch-Inferenzjob angewendet werden sollen.
Typ: Array von Tag-Objekten
Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente.
Erforderlich: Nein
- themeGenerationConfig
-
Geben Sie für Jobs zur Themengenerierung den Namen der Spalte in Ihrem Artikeldatensatz an, die die Namen der einzelnen Elemente enthält.
Typ: ThemeGenerationConfig Objekt
Erforderlich: Nein
Antwortsyntax
{
"batchInferenceJobArn": "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.
- batchInferenceJobArn
-
Der ARN des Batch-Inferenzjobs.
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 Status Code: 400
- LimitExceededException
-
Das Limit für die Anzahl der Anfragen pro Sekunde wurde überschritten.
HTTP Status Code: 400
- ResourceAlreadyExistsException
-
Die angegebene Ressource ist bereits vorhanden.
HTTP Status Code: 400
- ResourceInUseException
-
Die angegebene Ressource wird verwendet.
HTTP Status Code: 400
- ResourceNotFoundException
-
Die angegebene Ressource konnte nicht gefunden werden.
HTTP Status Code: 400
- TooManyTagsException
-
Sie haben die maximale Anzahl von Tags überschritten, die Sie auf diese Ressource anwenden können.
HTTP Status Code: 400
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
