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

CreateForecast

Erstellt eine Prognose für jedes Element imTARGET_TIME_SERIESDatensatz, der zum Trainieren des Prädiktors verwendet wurde. Dies wird als Inferenz bezeichnet. Um die Prognose für ein einzelnes Element bei niedriger Latenz abzurufen, verwenden Sie dieQueryForecastverwenden. Um die vollständige Prognose in Ihren Amazon Simple Storage Service (Amazon S3) -Bucket zu exportieren, verwenden Sie dieCreateForecastExportJobverwenden.

Die Spanne der Prognose wird durch dieForecastHorizonWert, den Sie imCreatePredictorrequest. Wenn Sie eine Prognose abfragen, können Sie einen bestimmten Datumsbereich innerhalb der Prognose anfordern.

Um eine Liste aller Ihrer Prognosen abzurufen, verwenden Sie dieListForecastsverwenden.

Anmerkung

Die von Amazon Forecast generierten Prognosen befinden sich in derselben Zeitzone wie der Dataset, der zum Erstellen des Predictors verwendet wurde.

Weitere Informationen finden Sie unter Generieren von Prognosen.

Anmerkung

DieStatusder Prognose muss seinACTIVEbevor Sie die Prognose abfragen oder exportieren können. Verwenden Sie die DescribeForecast -Operation, um den Status abzurufen.

Standardmäßig enthält eine Prognose Prognosen für jeden Artikel (item_id) in der Dataset-Gruppe, die zum Schulen des Predictors verwendet wurde. Sie können jedoch dieTimeSeriesSelector-Objekt, um eine Prognose für eine Teilmenge von Zeitreihen zu generieren. Forecast Prognoseerstellung wird für alle von Ihnen angegebenen Zeitreihen übersprungen, die sich nicht im Eingabe-Dataset befinden. Die prognostizierte Exportdatei enthält diese Zeitreihen oder ihre prognostizierten Werte nicht.

Anforderungssyntax

{ "ForecastName": "string", "ForecastTypes": [ "string" ], "PredictorArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "TimeSeriesSelector": { "TimeSeriesIdentifiers": { "DataSource": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "Format": "string", "Schema": { "Attributes": [ { "AttributeName": "string", "AttributeType": "string" } ] } } } }

Anfrageparameter

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

ForecastName

Ein Name für die Prognose.

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

ForecastTypes

Die Quantile, bei denen probabilistische Prognosen generiert werden. Sie können derzeit bis zu 5 Quantile pro Prognose angebenaus. Akzeptierte Werte umfassen0.01 to 0.99(nur Inkremente von 0,01) undmeanaus. Die mittlere Prognose unterscheidet sich vom Median (0,50), wenn die Verteilung nicht symmetrisch ist (z. B. Beta und Negative Binomial).

Die Standardquantile sind die Quantile, die Sie während der Prädiktorerstellung angegeben haben. Wenn Sie keine Quantile angegeben haben, lauten die Standardwerte["0.1", "0.5", "0.9"]aus.

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

PredictorArn

Der Amazon-Ressourcenname (ARN) des Predictors, der zum Erstellen der Prognose verwendet werden soll.

Type: String (Zeichenfolge)

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

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

Erforderlich Ja

Tags

Die optionalen Metadaten, die Sie auf die Prognose anwenden, um die Kategorisierung und Organisation zu erleichtern. Jeder Tag (Markierung) besteht aus einem Schlüssel und einem optionalen Wert, beides können Sie bestimmen.

Die folgenden grundlegenden Einschränkungen gelten für Tags (Markierungen):

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

  • Jeder Tag (Markierung) muss für jede Ressource eindeutig sein. Jeder Tag (Markierung) kann nur einen Wert haben.

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

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

  • Wenn Ihr Markierungsschema für mehrere Services und Ressourcen verwendet wird, denken Sie daran, dass andere Services möglicherweise Einschränkungen für zulässige Zeichen haben. Allgemein erlaubte Zeichen sind: Buchstaben, Zahlen und Leerzeichen, die in UTF-8 darstellbar sind, und die folgenden Sonderzeichen: + - = . _ : / @.

  • Bei Tag-Schlüsseln und -Werten muss die Groß-/Kleinschreibung beachtet werden.

  • Verwenden Sie nichtaws:,AWS:oder Kombinationen aus Groß- und Kleinbuchstaben von diesen als Präfix für Schlüssel, da sie für die AWS-Verwendung reserviert sind. Sie können keine Tag-Schlüssel mit diesem Präfix bearbeiten oder löschen. Werte können dieses Präfix haben. Wenn ein Tag-Wert hatawsals Präfix, aber der Schlüssel nicht, betrachtet Forecast es als Benutzer-Tag und zählt auf das Limit von 50 Tags. Tags mit nur dem key prefix vonawsZahlen Sie nicht als Ihre Tags pro Ressourcenlimit.

Type: ArrayTagObjekte

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

Erforderlich Nein

TimeSeriesSelector

Definiert den Satz von Zeitreihen, die zum Erstellen der Prognosen in einemTimeSeriesIdentifiers-Objekt.

DieTimeSeriesIdentifiersobject benötigt die folgenden Informationen:

  • DataSource

  • Format

  • Schema

Typ: TimeSeriesSelector Objekt

Erforderlich Nein

Antwortsyntax

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

ForecastArn

Der Amazon-Ressourcenname (ARN) der Prognose.

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. 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 unter: