View a markdown version of this page

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

DescribePredictor

Anmerkung

Diese Operation ist nur für ältere Prädiktoren gültig, die mit CreatePredictor erstellt wurden. Wenn Sie keinen älteren Prädiktor verwenden, verwenden Sie. DescribeAutoPredictor

Beschreibt einen Prädiktor, der mit der CreatePredictor Operation erstellt wurde.

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“

Dieser Vorgang listet nicht nur die in der CreatePredictor Anfrage angegebenen Eigenschaften auf, sondern listet auch die folgenden Eigenschaften auf:

  • DatasetImportJobArns— Die Aufträge zum Importieren von Datensätzen, die zum Importieren von Trainingsdaten verwendet werden.

  • AutoMLAlgorithmArns- Wenn AutoML ausgeführt wird, die Algorithmen, die ausgewertet wurden.

  • CreationTime

  • LastModificationTime

  • Status

  • Message- Wenn ein Fehler aufgetreten ist, Informationen über den Fehler.

Anforderungssyntax

{
   "PredictorArn": "string"
}

Anforderungsparameter

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

PredictorArn

Der Amazon-Ressourcenname (ARN) des Prädiktors, über den Sie Informationen erhalten möchten.

Typ: Zeichenfolge

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

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

Erforderlich: Ja

Antwortsyntax

{
   "AlgorithmArn": "string",
   "AutoMLAlgorithmArns": [ "string" ],
   "AutoMLOverrideStrategy": "string",
   "CreationTime": number,
   "DatasetImportJobArns": [ "string" ],
   "EncryptionConfig": { 
      "KMSKeyArn": "string",
      "RoleArn": "string"
   },
   "EstimatedTimeRemainingInMinutes": number,
   "EvaluationParameters": { 
      "BackTestWindowOffset": number,
      "NumberOfBacktestWindows": number
   },
   "FeaturizationConfig": { 
      "Featurizations": [ 
         { 
            "AttributeName": "string",
            "FeaturizationPipeline": [ 
               { 
                  "FeaturizationMethodName": "string",
                  "FeaturizationMethodParameters": { 
                     "string" : "string" 
                  }
               }
            ]
         }
      ],
      "ForecastDimensions": [ "string" ],
      "ForecastFrequency": "string"
   },
   "ForecastHorizon": number,
   "ForecastTypes": [ "string" ],
   "HPOConfig": { 
      "ParameterRanges": { 
         "CategoricalParameterRanges": [ 
            { 
               "Name": "string",
               "Values": [ "string" ]
            }
         ],
         "ContinuousParameterRanges": [ 
            { 
               "MaxValue": number,
               "MinValue": number,
               "Name": "string",
               "ScalingType": "string"
            }
         ],
         "IntegerParameterRanges": [ 
            { 
               "MaxValue": number,
               "MinValue": number,
               "Name": "string",
               "ScalingType": "string"
            }
         ]
      }
   },
   "InputDataConfig": { 
      "DatasetGroupArn": "string",
      "SupplementaryFeatures": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ]
   },
   "IsAutoPredictor": boolean,
   "LastModificationTime": number,
   "Message": "string",
   "OptimizationMetric": "string",
   "PerformAutoML": boolean,
   "PerformHPO": boolean,
   "PredictorArn": "string",
   "PredictorExecutionDetails": { 
      "PredictorExecutions": [ 
         { 
            "AlgorithmArn": "string",
            "TestWindows": [ 
               { 
                  "Message": "string",
                  "Status": "string",
                  "TestWindowEnd": number,
                  "TestWindowStart": number
               }
            ]
         }
      ]
   },
   "PredictorName": "string",
   "Status": "string",
   "TrainingParameters": { 
      "string" : "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.

AlgorithmArn

Der Amazon-Ressourcenname (ARN) des Algorithmus, der für das Modelltraining verwendet wird.

Typ: Zeichenfolge

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

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

AutoMLAlgorithmArns

Wenn angegeben, PerformAutoML ist der ARN des ausgewählten Algorithmus angegeben.

Typ: Zeichenfolgen-Array

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

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

AutoMLOverrideStrategy
Anmerkung

Die LatencyOptimized AutoML-Override-Strategie ist nur in der privaten Betaversion verfügbar. Wenden Sie sich an den AWS Support oder Ihren Kundenbetreuer, um mehr über Zugriffsrechte zu erfahren.

Die AutoML-Strategie, die zum Trainieren des Prädiktors verwendet wurde. Sofern nicht anders LatencyOptimized angegeben, optimiert die AutoML-Strategie die Genauigkeit des Prädiktors.

Dieser Parameter ist nur für Prädiktoren gültig, die mit AutoML trainiert wurden.

Typ: Zeichenfolge

Zulässige Werte: LatencyOptimized | AccuracyOptimized

CreationTime

Als die Modelltrainingsaufgabe erstellt wurde.

Typ: Zeitstempel

DatasetImportJobArns

Ein Array der ARNs der Datensatz-Importaufträge, die zum Importieren von Trainingsdaten für den Prädiktor verwendet werden.

Typ: Zeichenfolgen-Array

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

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

EncryptionConfig

Ein AWS Key Management Service (KMS-) Schlüssel und die AWS Identity and Access Management (IAM-) Rolle, die Amazon Forecast für den Zugriff auf den Schlüssel übernehmen kann.

Typ: EncryptionConfig Objekt

EstimatedTimeRemainingInMinutes

Die geschätzte Zeit in Minuten, die bis zum Abschluss des Prädiktor-Trainings noch verbleibt.

Type: Long

EvaluationParameters

Wird verwendet, um die Standard-Evaluierungsparameter des angegebenen Algorithmus zu überschreiben. Amazon Forecast bewertet einen Prädiktor, indem es einen Datensatz in Trainingsdaten und Testdaten aufteilt. Die Bewertungsparameter definieren, wie die Aufteilung durchgeführt wird und wie viele Iterationen durchgeführt werden.

Typ: EvaluationParameters Objekt

FeaturizationConfig

Die Konfiguration der Feature-Ausstattung.

Typ: FeaturizationConfig Objekt

ForecastHorizon

Die Anzahl der Zeitschritte der Prognose. Der Prognosehorizont wird auch als Prognoselänge bezeichnet.

Typ: Ganzzahl

ForecastTypes

Die beim Prädiktortraining verwendeten Prognosetypen. Der Standardwert ist ["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$)

HPOConfig

Die Hyperparameter überschreiben die Werte für den Algorithmus.

Typ: HyperParameterTuningJobConfig Objekt

InputDataConfig

Beschreibt die Datensatzgruppe, die die Daten enthält, die zum Trainieren des Prädiktors verwendet werden sollen.

Typ: InputDataConfig Objekt

IsAutoPredictor

Ob der Prädiktor mit erstellt wurde. CreateAutoPredictor

Typ: Boolescher Wert

LastModificationTime

Das letzte Mal, als die Ressource geändert wurde. Der Zeitstempel hängt vom Status des Jobs ab:

  • CREATE_PENDING- DerCreationTime.

  • CREATE_IN_PROGRESS- Der aktuelle Zeitstempel.

  • CREATE_STOPPING- Der aktuelle Zeitstempel.

  • CREATE_STOPPED- Als der Job beendet wurde.

  • ACTIVEoder CREATE_FAILED — Wenn der Job abgeschlossen wurde oder fehlgeschlagen ist.

Typ: Zeitstempel

Message

Wenn ein Fehler aufgetreten ist, eine Informationsmeldung über den Fehler.

Typ: Zeichenfolge

OptimizationMetric

Die Genauigkeitsmetrik, die zur Optimierung des Prädiktors verwendet wird.

Typ: Zeichenfolge

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

PerformAutoML

Ob der Prädiktor so eingestellt ist, dass er AutoML ausführt.

Typ: Boolescher Wert

PerformHPO

Ob der Prädiktor so eingestellt ist, dass er eine Hyperparameteroptimierung (HPO) durchführt.

Typ: Boolescher Wert

PredictorArn

Der ARN des Prädiktors.

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_]*

PredictorExecutionDetails

Einzelheiten zum Status und zu den Ergebnissen der Backtests, die zur Bewertung der Genauigkeit des Prädiktors durchgeführt wurden. Sie geben die Anzahl der durchzuführenden Backtests an, wenn Sie den Vorgang aufrufen. CreatePredictor

Typ: PredictorExecutionDetails Objekt

PredictorName

Der Name des Prädiktors.

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_]*

Status

Der Status des Prädiktors. Zu den Staaten gehören:

  • ACTIVE

  • CREATE_PENDING, CREATE_IN_PROGRESS, CREATE_FAILED

  • DELETE_PENDING, DELETE_IN_PROGRESS, DELETE_FAILED

  • CREATE_STOPPING, CREATE_STOPPED

Anmerkung

Der Wert Status des Prädiktors muss erfüllt sein, ACTIVE bevor Sie den Prädiktor verwenden können, um eine Prognose zu erstellen.

Typ: Zeichenfolge

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

TrainingParameters

Die beim Modelltraining ausgewählten Standard-Trainingsparameter oder -überschreibungen. Wenn Sie AutoML ausführen oder HPO mit CNN-QR oder DeePar+ wählen, werden die optimierten Werte für die ausgewählten Hyperparameter zurückgegeben. Weitere Informationen finden Sie unter Amazon-Prognosealgorithmen.

Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge

Karteneinträge: Mindestanzahl von 0 Elementen. Die maximale Anzahl beträgt 100 Elemente.

Einschränkungen der Schlüssellänge: Die maximale Länge beträgt 256.

Schlüssel-Muster: ^[a-zA-Z0-9\-\_\.\/\[\]\,\\]+$

Beschränkungen der Wertelänge: Die maximale Länge beträgt 256.

Wertemuster: ^[a-zA-Z0-9\-\_\.\/\[\]\,\"\\\s]+$

Fehler

InvalidInputException

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

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 im Folgenden: