View a markdown version of this page

CreateAutoPredictor - Amazon Forecast
AnforderungssyntaxAnforderungsparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Amazon Forecast ist für Neukunden nicht mehr verfügbar. Bestehende Kunden von Amazon Forecast können den Service weiterhin wie gewohnt nutzen. Erfahren Sie mehr“

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.

CreateAutoPredictor

Erstellt einen Amazon Forecast Predictor.

Wichtig

Amazon Forecast ist für Neukunden nicht mehr verfügbar. Bestehende Kunden von Amazon Forecast können den Service weiterhin wie gewohnt nutzen. Erfahren Sie mehr“

Amazon Forecast erstellt Prädiktoren mit AutoPredictor. Dabei wird die optimale Kombination von Algorithmen auf jede Zeitreihe in Ihren Datensätzen angewendet. Sie können sie verwendenCreateAutoPredictor, um neue oder upgrade/retrain bestehende Prädiktoren zu erstellen.

Neue Prädiktoren erstellen

Die folgenden Parameter sind für die Erstellung eines neuen Prädiktors erforderlich:

  • PredictorName- Ein eindeutiger Name für den Prädiktor.

  • DatasetGroupArn- Der ARN der Datensatzgruppe, die zum Trainieren des Prädiktors verwendet wurde.

  • ForecastFrequency- Die Granularität Ihrer Prognosen (stündlich, täglich, wöchentlich usw.).

  • ForecastHorizon- Die Anzahl der Zeitschritte, die das Modell vorhersagt. Der Prognosehorizont wird auch als Prognoselänge bezeichnet.

Geben Sie beim Erstellen eines neuen Prädiktors keinen Wert für an. ReferencePredictorArn

Prädiktoren aktualisieren und neu trainieren

Die folgenden Parameter sind erforderlich, wenn ein Prädiktor erneut trainiert oder aktualisiert wird:

  • PredictorName— Ein eindeutiger Name für den Prädiktor.

  • ReferencePredictorArn— Der ARN des Prädiktors, der neu trainiert oder aktualisiert werden soll.

Wenn Sie einen Prädiktor aktualisieren oder erneut trainieren, geben Sie nur Werte für „und“ an. ReferencePredictorArn PredictorName

Anforderungssyntax

{
   "DataConfig": { 
      "AdditionalDatasets": [ 
         { 
            "Configuration": { 
               "string" : [ "string" ]
            },
            "Name": "string"
         }
      ],
      "AttributeConfigs": [ 
         { 
            "AttributeName": "string",
            "Transformations": { 
               "string" : "string" 
            }
         }
      ],
      "DatasetGroupArn": "string"
   },
   "EncryptionConfig": { 
      "KMSKeyArn": "string",
      "RoleArn": "string"
   },
   "ExplainPredictor": boolean,
   "ForecastDimensions": [ "string" ],
   "ForecastFrequency": "string",
   "ForecastHorizon": number,
   "ForecastTypes": [ "string" ],
   "MonitorConfig": { 
      "MonitorName": "string"
   },
   "OptimizationMetric": "string",
   "PredictorName": "string",
   "ReferencePredictorArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TimeAlignmentBoundary": { 
      "DayOfMonth": number,
      "DayOfWeek": "string",
      "Hour": number,
      "Month": "string"
   }
}

Anforderungsparameter

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

DataConfig

Die Datenkonfiguration für Ihre Datensatzgruppe und alle zusätzlichen Datensätze.

Typ: DataConfig Objekt

Erforderlich: Nein

EncryptionConfig

Ein AWS Key Management Service (KMS-) Schlüssel und eine AWS Identity and Access Management (IAM-) Rolle, die Amazon Forecast für den Zugriff auf den Schlüssel übernehmen kann. Sie können dieses optionale Objekt in den CreateDataset und CreatePredictor -Anfragen angeben.

Typ: EncryptionConfig Objekt

Erforderlich: Nein

ExplainPredictor

Erstellen Sie eine Erklärbarkeitsressource für den Prädiktor.

Typ: Boolesch

Erforderlich: Nein

ForecastDimensions

Eine Reihe von Dimensions- (Feld-) Namen, die angeben, wie die generierte Prognose gruppiert werden soll.

Wenn Sie beispielsweise Prognosen für Artikelverkäufe in all Ihren Geschäften erstellen und Ihr Datensatz ein store_id Feld enthält, würden Sie es store_id als Dimension angeben, um Verkaufsprognosen für jedes Geschäft zu gruppieren.

Typ: Zeichenfolgen-Array

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 10 Elemente.

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 63 Zeichen.

Pattern: ^[a-zA-Z][a-zA-Z0-9_]*

Erforderlich: Nein

ForecastFrequency

Die Häufigkeit von Prognosen in einer Prognose.

Gültige Intervalle sind eine Ganzzahl, gefolgt von Y (Jahr), M (Monat), W (Woche), D (Tag), H (Stunde) und min (Minute). Beispielsweise steht „D“ für jeden Tag und „15min“ für alle 15 Minuten. Sie können keinen Wert angeben, der sich mit der nächsthöheren Häufigkeit überlappen würde. Das bedeutet, dass Sie beispielsweise keine Häufigkeit von 60 Minuten angeben können, da dies einer Stunde entspricht. Die folgenden Werte sind gültige Werte für die Häufigkeit:

  • Minute (1–59)

  • Stunde (1–23)

  • Tag (1–6)

  • Woche (1–4)

  • Monat (1–11)

  • Jahr (1)

Wenn Sie also Vorhersagen für jede zweite Woche wünschen, geben Sie „2W“ an. Oder, wenn Sie vierteljährliche Vorhersagen wünschen, geben Sie „3M“ an.

Die Häufigkeit muss größer oder gleich der Häufigkeit des TARGET_TIME_SERIES Datensatzes sein.

Wenn ein RELATED_TIME_SERIES-Datensatz bereitgestellt wird, muss die Frequenz der RELATED_TIME_SERIES Datensatz-Häufigkeit entsprechen.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 5.

Pattern: ^Y|M|W|D|H|30min|15min|10min|5min|1min$

Erforderlich: Nein

ForecastHorizon

Die Anzahl der Zeitschritte, die das Modell vorhersagt. Der Prognosehorizont wird auch als Prognoselänge bezeichnet.

Der maximale Prognosehorizont entspricht 500 Zeitschritten oder der Länge des TARGET_TIME_SERIES Datensatzes, je nachdem, 1/4 welcher Wert geringer ist. Wenn Sie einen vorhandenen erneut trainieren AutoPredictor, ist der maximale Prognosehorizont entweder 500 Zeitschritte oder die Länge des TARGET_TIME_SERIES Datensatzes, je nachdem, welcher Wert geringer ist. 1/3

Wenn Sie ein Upgrade auf einen vorhandenen durchführen AutoPredictor oder einen vorhandenen erneut trainieren AutoPredictor, können Sie den Prognosehorizont-Parameter nicht aktualisieren. Sie können diese Anforderung erfüllen, indem Sie längere Zeitreihen im Datensatz angeben.

Typ: Ganzzahl

Erforderlich: Nein

ForecastTypes

Die Prognosetypen, die zum Trainieren eines Prädiktors verwendet werden. Sie können bis zu fünf Prognosetypen angeben. Bei den Prognosetypen kann es sich um Quantile von 0,01 bis 0,99 handeln, und zwar in Schritten von 0,01 oder höher. Sie können den Mittelwert der Prognose auch mit angebenmean.

Typ: Zeichenfolgen-Array

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 50 Elemente.

Längenbeschränkungen: Mindestlänge von 2. Maximale Länge beträgt 4 Zeichen.

Pattern: (^0?\.\d\d?$|^mean$)

Erforderlich: Nein

MonitorConfig

Die Konfigurationsdetails für die Prädiktorüberwachung. Geben Sie einen Namen für die Monitorressource an, um die Prädiktorüberwachung zu aktivieren.

Mithilfe der Prädiktorüberwachung können Sie sehen, wie sich die Leistung Ihres Prädiktors im Laufe der Zeit verändert. Weitere Informationen finden Sie unter Prädiktorüberwachung.

Typ: MonitorConfig Objekt

Erforderlich: Nein

OptimizationMetric

Die zur Optimierung des Prädiktors verwendete Genauigkeitsmetrik.

Typ: Zeichenfolge

Zulässige Werte: WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE

Erforderlich: Nein

PredictorName

Ein eindeutiger Name für den Prädiktor

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 63 Zeichen.

Pattern: ^[a-zA-Z][a-zA-Z0-9_]*

Erforderlich: Ja

ReferencePredictorArn

Der ARN des Prädiktors, der neu trainiert oder aktualisiert werden soll. Dieser Parameter wird nur verwendet, wenn ein Prädiktor erneut trainiert oder aktualisiert wird. Geben Sie beim Erstellen eines neuen Prädiktors keinen Wert für diesen Parameter an.

Wenn Sie einen Prädiktor aktualisieren oder erneut trainieren, geben Sie nur Werte für das und an. ReferencePredictorArn PredictorName Der Wert für PredictorName muss ein eindeutiger Prädiktorname sein.

Typ: Zeichenfolge

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

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

Erforderlich: Nein

Tags

Optionale Metadaten, die Ihnen helfen, Ihre Prädiktoren zu kategorisieren und zu organisieren. Jeder Tag (Markierung) besteht aus einem Schlüssel und einem optionalen Wert, beides können Sie bestimmen. Bei Tag-Schlüsseln und -Werten muss die Groß- und Kleinschreibung beachtet werden.

Für Tags gelten die folgenden Einschränkungen:

  • Für jede Ressource muss jeder Tag-Schlüssel eindeutig sein und jeder Tag-Schlüssel muss einen Wert haben.

  • Maximale Anzahl von Tags pro Ressource: 50.

  • Maximale Schlüssellänge: 128 Unicode-Zeichen in UTF-8.

  • Maximale Wertelänge: 256 Unicode-Zeichen in UTF-8.

  • Zulässige Zeichen: alle Buchstaben und Zahlen, Leerzeichen, die in UTF-8 und + - = dargestellt werden können. _:/@. Wenn Ihr Tagging-Schema für andere Dienste und Ressourcen verwendet wird, gelten auch die Zeichenbeschränkungen dieser Dienste.

  • Schlüsselpräfixe dürfen keine Groß- oder Kleinbuchstabenkombination von oder enthalten. aws: AWS: Werte können dieses Präfix haben. Wenn ein Tag-Wert ein Präfix hataws, der Schlüssel jedoch nicht, betrachtet Forecast ihn als Benutzer-Tag und wird auf das Limit von 50 Tags angerechnet. Tags, die nur das Schlüsselpräfix von aws haben, werden nicht auf das Limit für Stichwörter pro Ressource angerechnet. Sie können Tag-Schlüssel mit diesem Präfix nicht bearbeiten oder löschen.

Typ: Array von Tag-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente.

Erforderlich: Nein

TimeAlignmentBoundary

Die Zeitgrenze, die Forecast verwendet, um alle Daten, die nicht mit Ihrer Prognosefrequenz übereinstimmen, abzugleichen und zu aggregieren. Geben Sie die Zeiteinheit und die Zeitgrenze als Schlüsselwertpaar an. Weitere Informationen zum Angeben einer Zeitgrenze finden Sie unter Angeben einer Zeitgrenze. Wenn Sie keine Zeitgrenze angeben, verwendet Forecast eine Reihe von Standard-Zeitgrenzen.

Typ: TimeAlignmentBoundary Objekt

Erforderlich: Nein

Antwortsyntax

{
   "PredictorArn": "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.

PredictorArn

Der Amazon-Ressourcenname (ARN) des Prädiktors.

Typ: Zeichenfolge

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

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

Fehler

InvalidInputException

Wir können die Anfrage nicht verarbeiten, da sie einen ungültigen Wert enthält oder einen Wert, der den gültigen Bereich überschreitet.

HTTP-Statuscode: 400

LimitExceededException

Das Limit für die Anzahl der Ressourcen pro Konto wurde überschritten.

HTTP-Statuscode: 400

ResourceAlreadyExistsException

Es gibt bereits eine Ressource mit diesem Namen. Versuchen Sie es erneut mit einem anderen Namen.

HTTP-Statuscode: 400

ResourceInUseException

Die angegebene Ressource wird verwendet.

HTTP-Statuscode: 400

ResourceNotFoundException

Wir können keine Ressource mit diesem Amazon-Ressourcennamen (ARN) finden. Überprüfen Sie den ARN und versuchen Sie es erneut.

HTTP-Statuscode: 400

Weitere Informationen finden Sie unter:

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