CreateAutoPredictor - Amazon Forecast

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 Forect-Prädiktor.

Amazon Forecast erstellt Prädiktoren mit AutoPredictor, bei dem die optimale Kombination von Algorithmen auf jede Zeitreihe in Ihren Datensätzen angewendet wird. Sie können Folgendes verwendenCreateAutoPredictorum neue Prädiktoren zu erstellen oder bestehende Prädiktoren zu aktualisieren/neu zu trainieren

Erstellen neuer Prädiktoren

Für die Erstellung eines neuen Prädiktors sind folgende Parameter erforderlich:

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

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

  • 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 an fürReferencePredictorArn.

Verbesserung und Umschulung von Prädiktoren

Für die Umschulung oder Aufrüstung eines Prädiktors sind folgende Parameter erforderlich:

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

  • ReferencePredictorArn- Die ARN des Prädiktors, der umtrainiert oder aufgerüstet werden soll.

Geben Sie beim Upgrade oder Umschulung eines Prädiktors nur Werte für dieReferencePredictorArnundPredictorName.

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" } }

Anfrageparameter

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 annehmen kann, um auf den Schlüssel zuzugreifen. Sie können dieses optionale Objekt in derCreateDatasetundCreatePredictoranfragen.

Typ: EncryptionConfig Objekt

Erforderlich: Nein

ExplainPredictor

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

Type: Boolesch

Erforderlich: Nein

ForecastDimensions

Ein Array von Dimensionsnamen (Feldnamen), die angeben, wie die generierte Prognose gruppiert werden soll.

Wenn Sie beispielsweise Prognosen für Artikelverkäufe in allen Ihren Filialen erstellen und Ihr Datensatz einestore_idFeld, würden Sie angebenstore_idals Dimension, um Verkaufsprognosen für jedes Geschäft zu gruppieren.

Type: Zeichenfolgen-Array

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

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

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

Erforderlich: Nein

ForecastFrequency

Die Häufigkeit von Vorhersagen 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 „1D“ für jeden Tag und „15min“ für alle 15 Minuten. Sie können keinen Wert angeben, der sich mit der nächsthöheren Frequenz überlappen würde. Das bedeutet, dass Sie beispielsweise keine Häufigkeit von 60 Minuten angeben können, da dies einer Stunde entspricht. Die gültigen Werte für jede Frequenz sind die folgenden:

  • Minute - 1-59

  • Stunde — 1-23

  • Tag — 1-6

  • Woche — 1-4

  • Monat - 1-11

  • Jahr - 1

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

Die Häufigkeit muss größer oder gleich der Dataset-Häufigkeit TARGET_TIME_SERIES sein.

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

Type: Zeichenfolge

Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 5.

Pattern: ^1Y|Y|([1-9]|1[0-1])M|M|[1-4]W|W|[1-6]D|D|([1-9]|1[0-9]|2[0-3])H|H|([1-9]|[1-5][0-9])min$

Erforderlich: Nein

ForecastHorizon

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

Der maximale Prognosehorizont ist der kleinere von 500 Zeitschritten oder 1/4 der TARGET_TIME_SERIES Datensatzlänge. Wenn Sie ein bestehendes umschulen AutoPredictor, dann ist der maximale Prognosehorizont der kleinere von 500 Zeitschritten oder 1/3 der TARGET_TIME_SERIES Datensatzlänge.

Wenn Sie ein Upgrade auf ein AutoPredictor oder die Umschulung einer vorhandenen AutoPredictorkönnen Sie den Parameter für den Prognosehorizont nicht aktualisieren. Sie können diese Anforderung erfüllen, indem Sie längere Zeitreihen im Datensatz bereitstellen.

Type: Ganzzahl

Erforderlich: Nein

ForecastTypes

Die zum Trainieren eines Prädiktors verwendeten Prognosetypen. Sie können bis zu fünf Prognosetypen angeben. Prognosetypen können Quantile von 0,01 bis 0,99 sein, in Schritten von 0,01 oder höher. Sie können die durchschnittliche Prognose auch mit angebenmean.

Type: Zeichenfolgen-Array

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

Längenbeschränkungen: Mindestlänge 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 Monitor-Ressource 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 ändert. Weitere Informationen finden Sie unterPrädiktorenüberwachung.

Typ: MonitorConfig Objekt

Erforderlich: Nein

OptimizationMetric

Die zur Optimierung des Prädiktors verwendete Genauigkeitsmetrik.

Type: Zeichenfolge

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

Erforderlich: Nein

PredictorName

Ein eindeutiger Name für den Prädiktor

Type: Zeichenfolge

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

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

Erforderlich: Ja

ReferencePredictorArn

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

Geben Sie beim Upgrade oder Umschulung eines Prädiktors nur Werte für dieReferencePredictorArnundPredictorName. Der Wert fürPredictorNamemuss ein eindeutiger Prädiktorname sein.

Type: Zeichenfolge

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

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

Erforderlich: Nein

Tags

Optionale Metadaten, die Ihnen bei der Kategorisierung und Organisation Ihrer Prädiktoren helfen. 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:

  • Jeder Tag muss für jede Ressource eindeutig sein. Jeder Tag muss einen Wert haben.

  • Die maximale Anzahl an Tags pro Ressource beträgt: 50.

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

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

  • Zulässige Zeichen: alle Buchstaben und Zahlen, Leerzeichen, die in UTF-8 darstellbar sind, und + - =. _:/@. Wenn Ihr Markierungsschema für andere Services und Ressourcen verwendet wird, gelten auch die Zeichenbeschränkungen dieser Services.

  • Tastenpräfixe dürfen keine Groß- oder Kleinschreibung vonaws:oderAWS:. Werte können dieses Präfix haben. Wenn ein Tag-Wertawsals Präfix, der Schlüssel jedoch nicht, betrachtet Forecast es als Benutzer-Tag und wird auf das Limit von 50 Tags angerechnet. Tags mit nur dem key prefixawsnicht als Ihre Tags (Markierungen) pro Ressourcenlimit angerechnet. Sie können keine Tag-Schlüssel mit diesem Präfix bearbeiten oder löschen.

Type: Array vonTagObjekte

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

Erforderlich: Nein

TimeAlignmentBoundary

Die Zeitgrenze, die Forecast verwendet, um Daten auszurichten und zu aggregieren, die nicht mit Ihrer Prognosefrequenz übereinstimmen. Geben Sie die Zeiteinheit und die Zeitgrenze als Schlüsselwertpaar an. Weitere Informationen zum Festlegen einer Zeitbegrenzung erhalten Sie unterFestlegen einer Zeitgrenze. Wenn Sie keine Zeitbegrenzung angeben, verwendet Forecast einen Satz vonStandardmäßige 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.

Type: 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 oder einen Wert enthält, der den gültigen Bereich überschreitet.

HTTP-Statuscode: 400

LimitExceededException

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

HTTP-Statuscode: 400

ResourceAlreadyExistsException

Es gibt bereits eine Ressource mit diesem Namen. Geben Sie einen anderen Namen ein.

HTTP-Statuscode: 400

ResourceInUseException

Die angegebene Ressource wird verwendet.

HTTP-Statuscode: 400

ResourceNotFoundException

Wir können keine Ressource mit diesem Amazon-Ressourcenname (ARN) finden. Überprüfe die ARN und versuche es erneut.

HTTP-Statuscode: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: