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

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 CreateAutoPredictor damit neue Prädiktoren erstellen oder bestehende Prädiktoren aktualisieren/neu trainieren.

Neue Prädiktoren erstellen

Die folgenden Parameter sind erforderlich, um einen neuen Prädiktor zu erstellen:

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

  • DatasetGroupArn- Die Datensatzgruppe, die zum Trainieren ARN 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

Verbesserung und Umschulung der Prädiktoren

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

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

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

Wenn Sie einen Prädiktor aktualisieren oder neu 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 CreatePredictor Anfragen CreateDataset und 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 Dimensionsnamen (Feldnamen), die angeben, wie die generierte Prognose gruppiert werden soll.

Wenn Sie beispielsweise Prognosen für Artikelverkäufe in all Ihren Filialen generieren 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 SERIES Datensatzes TARGET TIME _ _ sein.

Wenn ein RELATED _ TIME _ SERIES -Datensatz bereitgestellt wird, muss die Häufigkeit der RELATED _ TIME _ SERIES -Datensatzfrequenz 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 ist der kleinere von 500 Zeitschritten oder 1/4 der Länge des TARGET _ TIME _ SERIES Datensatzes. Wenn Sie ein vorhandenes Objekt neu trainieren AutoPredictor, ist der maximale Prognosehorizont der kleinere Wert von 500 Zeitschritten oder 1/3 der Länge des TARGET _ TIME _ SERIES Datensatzes.

Wenn Sie ein Upgrade auf einen vorhandenen durchführen AutoPredictor oder einen vorhandenen neu trainieren AutoPredictor, können Sie den Parameter für den Prognosehorizont 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 die durchschnittliche 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 ein, um die Prädiktorüberwachung zu aktivieren.

Mit 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 Genauigkeitsmetrik, die zur Optimierung des Prädiktors verwendet wird.

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 Prädiktor, ARN der neu trainiert oder aktualisiert werden soll. Dieser Parameter wird nur verwendet, wenn ein Prädiktor neu 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 neu trainieren, geben Sie nur Werte für 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 Wertlänge: 256 Unicode-Zeichen in UTF -8.

  • Zulässige Zeichen: alle Buchstaben und Zahlen, Leerzeichen, die durch UTF -8 dargestellt werden können, und + - =. _:/@. 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 Benutzertag und wird auf das Limit von 50 Tags angerechnet. Tags, die nur das key prefix von enthalten, werden aws nicht auf Ihre Stichwörter pro Ressourcenlimit 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 abzugleichen und zu aggregieren, die nicht mit Ihrer Prognosefrequenz übereinstimmen. Geben Sie die Zeiteinheit und die Zeitgrenze als Schlüsselwertpaar an. Weitere Informationen zur Angabe einer Zeitgrenze finden Sie unter Zeitgrenze angeben. Wenn Sie keine Zeitgrenze angeben, verwendet Forecast eine Reihe von Standardzeitgrenzen.

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 Dienst 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 bearbeiten, da sie einen ungültigen Wert oder einen Wert enthält, der den gültigen Bereich überschreitet.

HTTPStatuscode: 400

LimitExceededException

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

HTTPStatuscode: 400

ResourceAlreadyExistsException

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

HTTPStatuscode: 400

ResourceInUseException

Die angegebene Ressource wird verwendet.

HTTPStatuscode: 400

ResourceNotFoundException

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

HTTPStatuscode: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: