View a markdown version of this page

ListRecommenders - Amazon Personalize
AnforderungssyntaxAnforderungsparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

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.

ListRecommenders

Gibt eine Liste der Empfehlenden in einer bestimmten Domain-Datensatzgruppe zurück. Wenn keine Domain-Datensatzgruppe angegeben ist, werden alle mit dem Konto verknüpften Empfehlungsgeber aufgelistet. Die Antwort enthält die Eigenschaften für jeden Empfehlenden, einschließlich des Amazon-Ressourcennamens (ARN). Weitere Informationen zu Empfehlern finden Sie unter. CreateRecommender

Anforderungssyntax

{
   "datasetGroupArn": "string",
   "maxResults": number,
   "nextToken": "string"
}

Anforderungsparameter

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

datasetGroupArn

Der Amazon-Ressourcenname (ARN) der Domain-Datensatzgruppe, für die die Empfehlungen aufgelistet werden sollen. Wenn keine Domain-Datensatzgruppe angegeben ist, werden alle mit dem Konto verknüpften Empfehlungsempfehler aufgelistet.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.

Pattern: arn:([a-z\d-]+):personalize:.*:.*:.+

Erforderlich: Nein

maxResults

Die maximale Anzahl von Empfehlungen, die zurückgegeben werden sollen.

Typ: Ganzzahl

Gültiger Bereich: Mindestwert 1. Maximalwert 100.

Erforderlich: Nein

nextToken

Ein Token, das vom vorherigen Aufruf an zurückgegeben wurde, ListRecommenders um die nächste Gruppe von Empfehlungen abzurufen (falls vorhanden).

Typ: Zeichenfolge

Längenbeschränkungen: Die maximale Länge beträgt 1500.

Pattern: \p{ASCII}{0,1500}

Erforderlich: Nein

Antwortsyntax

{
   "nextToken": "string",
   "recommenders": [ 
      { 
         "creationDateTime": number,
         "datasetGroupArn": "string",
         "lastUpdatedDateTime": number,
         "name": "string",
         "recipeArn": "string",
         "recommenderArn": "string",
         "recommenderConfig": { 
            "enableMetadataWithRecommendations": boolean,
            "itemExplorationConfig": { 
               "string" : "string" 
            },
            "minRecommendationRequestsPerSecond": number,
            "trainingDataConfig": { 
               "excludedDatasetColumns": { 
                  "string" : [ "string" ]
               },
               "includedDatasetColumns": { 
                  "string" : [ "string" ]
               }
            }
         },
         "status": "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.

nextToken

Ein Token für das Abrufen der nächsten Gruppe von Empfehlungen (falls vorhanden).

Typ: Zeichenfolge

Längenbeschränkungen: Die maximale Länge beträgt 1500.

Pattern: \p{ASCII}{0,1500}

recommenders

Eine Liste der Empfehlungsempfehler.

Typ: Array von RecommenderSummary-Objekten

Array-Mitglieder: Maximale Anzahl von 100 Elementen.

Fehler

InvalidInputException

Geben Sie einen gültigen Wert für das Feld oder den Parameter an.

HTTP-Statuscode: 400

InvalidNextTokenException

Das Token ist nicht gültig.

HTTP-Statuscode: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: