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 Stapelempfehlungen auf der Grundlage einer in Amazon S3 gespeicherten Liste von Artikeln oder Benutzern und exportiert die Empfehlungen in einen Amazon S3-Bucket.
Um Batch-Empfehlungen zu generieren, geben Sie den ARN einer Lösungsversion und eine Amazon S3-URI für die Eingabe- und Ausgabedaten an. Für Benutzerpersonalisierung, beliebte Artikel und personalisierte Ranking-Lösungen generiert der Batch-Inferenz-Job eine Liste mit empfohlenen Elementen für jede Benutzer-ID in der Eingabedatei. Für Lösungen mit verwandten Artikeln generiert der Job eine Liste mit empfohlenen Artikeln für jede Element-ID in der Eingabedatei.
Weitere Informationen finden Sie unter Einen Batch-Inferenz-Job erstellen.
Wenn Sie das Similar-Items Rezept verwenden, kann Amazon Personalize den Batch-Empfehlungen beschreibende Themen hinzufügen. Um Designs zu generieren, setzen Sie den Modus des Jobs auf THEME_GENERATION und geben Sie den Namen des Felds an, das Artikelnamen in den Eingabedaten enthält.
Weitere Informationen zum Generieren von Designs finden Sie unter Stapelempfehlungen mit Designs aus dem Content Generator.
Mit den Next-Best-Action Rezepten Trending-Now oder können Sie keine Batch-Empfehlungen erhalten.
Anforderungssyntax
{
"batchInferenceJobConfig": {
"itemExplorationConfig": {
"string" : "string"
},
"rankingInfluence": {
"string" : number
}
},
"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-Inferenz-Jobs.
Typ: BatchInferenceJobConfig Objekt
Erforderlich: Nein
- batchInferenceJobMode
-
Der Modus des Batch-Inferenz-Jobs. Um beschreibende Themen für Gruppen ähnlicher Elemente zu generieren, stellen Sie den Jobmodus auf ein.
THEME_GENERATIONWenn Sie keine Designs generieren möchten, verwenden Sie dasBATCH_INFERENCEStandarddesign.Wenn Sie Stapelempfehlungen mit Themes erhalten, fallen zusätzliche Kosten an. Weitere Informationen finden Sie unter Amazon Personalize-Preise.
Typ: Zeichenfolge
Zulässige Werte:
BATCH_INFERENCE | THEME_GENERATIONErforderlich: Nein
- filterArn
-
Der ARN des Filters, der auf den Batch-Inferenz-Job angewendet werden soll. Weitere Informationen zur Verwendung von Filtern finden Sie unter Filtern von Batch-Empfehlungen.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.
Pattern:
arn:([a-z\d-]+):personalize:.*:.*:.+Erforderlich: Nein
- jobInput
-
Der Amazon S3-Pfad, der zur Eingabedatei führt, auf der Ihre Empfehlungen basieren. Das Eingabematerial muss im JSON-Format vorliegen.
Typ: BatchInferenceJobInput Objekt
Erforderlich: Ja
- jobName
-
Der Name des Batch-Inferenz-Jobs, der erstellt werden soll.
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-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-Inferenz-Job 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 bei Aufträgen 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-Inferenz-Jobs.
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:
