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-Predictor.

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

Erstellen neuer Prädiktoren

Die folgenden Parameter sind 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 prognostiziert. Der Prognosehorizont wird auch als Prognoselänge bezeichnet.

Geben Sie beim Erstellen eines neuen Prädiktors keinen -Wert fürReferencePredictorArnaus.

Upgrade und Umschulung von Prädiktoren

Die folgenden Parameter sind für die Umschulung oder das Upgrade eines Prädiktors erforderlich:

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

  • ReferencePredictorArn- Der ARN des Prädiktors, der umgeschult oder aktualisiert werden soll.

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

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 Key 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 annehmen kann. Sie können dieses optionale Objekt imCreateDatasetundCreatePredictoranfragen.

Typ: EncryptionConfig Objekt

: Erforderlich Nein

ExplainPredictor

Erstellen Sie eine Erklärbarkeitsressource für den Predictor.

Type: Boolesch

: Erforderlich Nein

ForecastDimensions

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

Wenn Sie beispielsweise Prognosen für Artikelverkäufe in allen Ihren Geschäften generieren und Ihr Datensatz einstore_iddas Feld, das Sie angeben würdenstore_idals Dimension, um Umsatzprognosen 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 Y (Jahr), M (Monat), W (Woche), D (Tag), H (Stunde), 30 Minuten (30 Minuten), 15 Minuten (15 Minuten), 10 Minuten (10 Minuten), 5 Minuten (5 Minuten) und 1 Minute (1 Minute). Zum Beispiel gibt „Y“ jedes Jahr an und „5min“ zeigt alle fünf Minuten an.

Die Frequenz muss größer oder gleich der TARGET_TIME_SERIES-Datasetfrequenz sein.

Wenn ein RELATED_TIME_SERIES-Dataset bereitgestellt wird, muss die Frequenz gleich der RELATED_TIME_SERIES-Datasetfrequenz sein.

Type: String (Zeichenfolge)

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

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

: Erforderlich Nein

ForecastHorizon

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

Der maximale Prognosehorizont ist der geringere von 500 Zeitschritten oder 1/4 der TARGET_TIME_SERIES-Dataset-Länge. Wenn Sie einen vorhandenen AutoRedictor umschulen, beträgt der maximale Prognosehorizont der geringere von 500 Zeitschritten oder 1/3 der TARGET_TIME_SERIES-Dataset-Länge.

Wenn Sie ein Upgrade auf ein AutoPredictor oder einen vorhandenen AutoRedictor umschulen, können Sie den Prognosehorizon-Parameter nicht aktualisieren. Sie können diese Anforderung erfüllen, indem Sie längere Zeitreihe im Dataset bereitstellen.

Type: Ganzzahl

: Erforderlich Nein

ForecastTypes

Die Prognosearten, die zum Trainieren eines Predictors verwendet werden. Sie können bis zu fünf Prognosearten angeben. Prognosetypen können Quantile von 0,01 bis 0,99 in Schritten von 0,01 oder höher sein. Sie können auch die Mittelprognose mit angebenmeanaus.

Type: Zeichenfolgen-Array

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

Längenbeschränkungen: Minimale Länge beträgt 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 ermöglichen

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 unterPredictor-Überwachungaus.

Typ: MonitorConfig Objekt

: Erforderlich Nein

OptimizationMetric

Die zur Optimierung des Prädiktors verwendete Genauigkeitsmetrik.

Type: String (Zeichenfolge)

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

: Erforderlich Nein

PredictorName

Ein eindeutiger Name für den Predictor

Type: String (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

Der ARN des Prädiktors, der umtrainiert oder aktualisiert werden soll. Dieser Parameter wird nur verwendet, wenn ein Prädiktor umtrainiert oder aktualisiert. 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 dieReferencePredictorArnundPredictorNameaus. Der Wert fürPredictorNamemuss ein eindeutiger Prädiktorname sein.

Type: String (Zeichenfolge)

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

Pattern: ^[a-zA-Z0-9\-\_\.\/\:]+$

: 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ß-/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 Wertlänge: 256 Unicode-Zeichen in UTF-8.

  • Akzeptierte 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 Charakterbeschränkungen dieser Dienste.

  • Schlüsselpräfixe können keine Groß- oder Kleinbuchstaben-Kombination vonaws:oderAWS:aus. Werte können dieses Präfix haben. Wenn ein Tag-Wert hatawsDa das Präfix aber der Schlüssel nicht der Fall ist, betrachtet Forecast es als Benutzer-Tag und zählt auf das Limit von 50 Tags. Tags mit nur dem key prefix vonawsSie werden nicht auf Ihre Tags pro Ressourcenlimit angerechnet. Sie können Tag-Schlüssel mit diesem Präfix nicht bearbeiten oder löschen.

Type: Array vonTagObjekte

Array-Mitglieder: Minimale Anzahl der Elemente: 0. Maximale Anzahl der Elemente = 200 Elemente.

: Erforderlich Nein

TimeAlignmentBoundary

Die Zeitgrenzenprognose 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 Zeitgrenze finden Sie unterAngeben einer Zeitgrenzeaus. Wenn Sie keine Zeitgrenze angeben, verwendet Forecast eine Reihe vonStandardzeitgrenzenaus.

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 Predictors.

Type: String (Zeichenfolge)

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

Pattern: ^[a-zA-Z0-9\-\_\.\/\:]+$

Fehler

InvalidInputException

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

HTTP-Statuscode: 400

LimitExceededException

Die Grenze 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-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 unter: