Wählen Sie Ihre Cookie-Einstellungen aus

Wir verwenden essentielle Cookies und ähnliche Tools, die für die Bereitstellung unserer Website und Services erforderlich sind. Wir verwenden Performance-Cookies, um anonyme Statistiken zu sammeln, damit wir verstehen können, wie Kunden unsere Website nutzen, und Verbesserungen vornehmen können. Essentielle Cookies können nicht deaktiviert werden, aber Sie können auf „Anpassen“ oder „Ablehnen“ klicken, um Performance-Cookies abzulehnen.

Wenn Sie damit einverstanden sind, verwenden AWS und zugelassene Drittanbieter auch Cookies, um nützliche Features der Website bereitzustellen, Ihre Präferenzen zu speichern und relevante Inhalte, einschließlich relevanter Werbung, anzuzeigen. Um alle nicht notwendigen Cookies zu akzeptieren oder abzulehnen, klicken Sie auf „Akzeptieren“ oder „Ablehnen“. Um detailliertere Entscheidungen zu treffen, klicken Sie auf „Anpassen“.

Präferenzen
Kontakt
Feedback
AWS Documentation
AWS-Konto erstellen
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.

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

PDFRSS

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 es verwendenCreateAutoPredictor, um neue Prädiktoren zu erstellen oder bestehende Prädiktoren zu aktualisieren/neu zu 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- 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

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 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 TARGET_TIME_SERIES-Datensatzes sein.

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

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Die 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 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 einen vorhandenen Datensatz erneut 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, können Sie den Parameter für den AutoPredictor 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 ARN des Prädiktors, 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 Wertelänge: 256 Unicode-Zeichen in UTF-8.

  • Zulässige Zeichen: alle Buchstaben und Zahlen, in UTF-8 darstellbare Leerzeichen 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 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 bearbeiten, da sie einen ungültigen Wert oder einen Wert enthält, der den gültigen Bereich überschreitet.

HTTP Status Code: 400

LimitExceededException

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

HTTP Status Code: 400

ResourceAlreadyExistsException

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

HTTP Status Code: 400

ResourceInUseException

Die angegebene Ressource wird verwendet.

HTTP Status Code: 400

ResourceNotFoundException

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

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

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

Nächstes Thema:

CreateDataset

Vorheriges Thema:

Amazon-Prognose-Service

Brauchen Sie Hilfe?

DatenschutzNutzungsbedingungen für die WebsiteCookie-Einstellungen
© 2025, Amazon Web Services, Inc. oder Tochtergesellschaften. Alle Rechte vorbehalten.