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

CreateForecast

Erstellt eine Prognose für jedes Element im TARGET_TIME_SERIES Datensatz, das zum Trainieren des Prädiktors verwendet wurde. Dies wird als Inferenz bezeichnet. Verwenden Sie den QueryForecast Vorgang, um die Prognose für ein einzelnes Element mit geringer Latenz abzurufen. Verwenden Sie den CreateForecastExportJob Vorgang, um die vollständige Prognose in Ihren Amazon Simple Storage Service (Amazon S3) -Bucket zu exportieren.

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“

Der Bereich der Prognose wird durch den ForecastHorizon Wert bestimmt, den Sie in der CreatePredictor Anfrage angeben. Wenn Sie eine Prognose abfragen, können Sie einen bestimmten Zeitraum innerhalb der Prognose anfordern.

Verwenden Sie die ListForecasts Operation, um eine Liste all Ihrer Prognosen zu erhalten.

Anmerkung

Die von Amazon Forecast generierten Prognosen befinden sich in derselben Zeitzone wie der Datensatz, der zur Erstellung des Prädiktors verwendet wurde.

Weitere Informationen finden Sie unter Prognosen generieren.

Anmerkung

Der Status Wert der Prognose muss vorliegen, ACTIVE bevor 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 jedes Element (item_id) in der Datensatzgruppe, das zum Trainieren des Prädiktors verwendet wurde. Sie können das TimeSeriesSelector Objekt jedoch verwenden, um eine Prognose für eine Teilmenge von Zeitreihen zu generieren. Die Erstellung von Prognosen wird für alle Zeitreihen übersprungen, die Sie angeben und die nicht im Eingabe-Dataset enthalten sind. Die Prognose-Exportdatei wird diese Zeitreihen oder ihre prognostizierten Werte nicht enthalten.

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

Anforderungsparameter

Die Anfrage akzeptiert die folgenden Daten im JSON Format.

ForecastName

Ein Name für die Prognose.

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

ForecastTypes

Die Quantile, bei denen probabilistische Prognosen generiert werden. Sie können derzeit bis zu 5 Quantile pro Prognose angeben. Zu den akzeptierten Werten gehören 0.01 to 0.99 (nur in Schritten von 0,01) und. mean Die mittlere Prognose unterscheidet sich vom Median (0,50), wenn die Verteilung nicht symmetrisch ist (z. B. Beta und negatives Binomial).

Die Standardquantile sind die Quantile, die Sie bei der Erstellung des Prädiktors angegeben haben. Wenn Sie keine Quantile angegeben haben, sind die Standardwerte. ["0.1", "0.5", "0.9"]

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

PredictorArn

Der Amazon-Ressourcenname (ARN) des Prädiktors, der zur Generierung der Prognose verwendet werden soll.

Typ: Zeichenfolge

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

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

Erforderlich: Ja

Tags

Die optionalen Metadaten, die Sie auf die Prognose anwenden, um sie zu kategorisieren und zu organisieren. 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):

  • Maximale Anzahl von Tags pro Ressource: 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 zulässige Zeichen sind: Buchstaben, Zahlen und Leerzeichen, die durch UTF -8 dargestellt werden können, sowie die folgenden Zeichen: + - =. _:/@.

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

  • Verwenden Sie nichtaws:,AWS:, oder eine Kombination von Groß- oder Kleinbuchstaben, wie z. B. ein Präfix, für Schlüssel, da es für die Verwendung reserviert ist. AWS Sie können Tag-Schlüssel mit diesem Präfix nicht bearbeiten oder löschen. 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.

Typ: Array von Tag-Objekten

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

Erforderlich: Nein

TimeSeriesSelector

Definiert den Satz von Zeitreihen, die zur Erstellung der Prognosen in einem TimeSeriesIdentifiers Objekt verwendet werden.

Das TimeSeriesIdentifiers Objekt benötigt die folgenden Informationen:

  • DataSource

  • Format

  • Schema

Typ: TimeSeriesSelector Objekt

Erforderlich: Nein

Antwortsyntax

{
   "ForecastArn": "string"
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Dienst eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Dienst im JSON Format zurückgegeben.

ForecastArn

Der Amazon-Ressourcenname (ARN) der Prognose.

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: