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

DescribePredictor

Anmerkung

Dieser Vorgang gilt nur für Legacy-Prädiktoren, die mit CreatePredictor erstellt wurden. Wenn Sie keinen Legacy-Prädiktor verwenden, verwenden SieDescribeAutoPredictoraus.

Beschreibt einen Predictor, der mit demCreatePredictorverwenden.

Neben der Auflistung der in derCreatePredictorrequest, dieser Vorgang listet die folgenden Eigenschaften auf:

  • DatasetImportJobArns- Die Dataset-Importjobs, die zum Importieren von Trainingsdaten verwendet werden.

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

  • CreationTime

  • LastModificationTime

  • Status

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

Anforderungssyntax

{ "PredictorArn": "string" }

Anfrageparameter

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

PredictorArn

Der Amazon-Ressourcenname (ARN) des Predictors, über den Sie Informationen benötigen.

Type: String (Zeichenfolge)

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

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

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.

Type: String (Zeichenfolge)

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

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

AutoMLAlgorithmArns

WannPerformAutoMLangegeben ist, ist der ARN des gewählten Algorithmus.

Type: Zeichenfolgen-Array

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

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

AutoMLOverrideStrategy
Anmerkung

DieLatencyOptimizedDie AutoML-Override-Strategie ist nur in privater Beta verfügbar. Wenden Sie sich an den AWS Support oder Ihren Account Manager, um mehr über Zugriffsberechtigungen zu erfahren.

Die AutoML-Strategie, die zum Trainieren des Prädiktors verwendet wurde. Es sei dennLatencyOptimizedangegeben ist, optimiert die AutoML-Strategie die Prädiktorgenauigkeit.

Dieser Parameter gilt nur für Predictors, die mit AutoML geschult wurden.

Type: String (Zeichenfolge)

Zulässige Werte: LatencyOptimized | AccuracyOptimized

CreationTime

Als die Modelltrainingsaufgabe erstellt wurde.

Type: Zeitstempel

DatasetImportJobArns

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

Type: Zeichenfolgen-Array

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

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

EncryptionConfig

Der AWS Key Management Service (KMS) -Schlüssel und die AWS Identity and Access Management (IAM) -Rolle, die Amazon Forecast übernehmen kann, um auf den Schlüssel zuzugreifen.

Typ: EncryptionConfig Objekt

EstimatedTimeRemainingInMinutes

Die geschätzte Dauer, die in Minuten verbleibt, bis der Predictor Training Job abgeschlossen ist.

Type: Long

EvaluationParameters

Wird verwendet, um die Standardauswertungsparameter des angegebenen Algorithmus zu überschreiben. Amazon Forecast Predictor wertet einen Predictor aus, indem ein Datensatz in Trainingsdaten und Testdaten aufgeteilt wird. Die Auswertungsparameter definieren, wie die Teilung und die Anzahl der Iterationen durchgeführt werden.

Typ: EvaluationParameters Objekt

FeaturizationConfig

Die Featurisierungskonfiguration.

Typ: FeaturizationConfig Objekt

ForecastHorizon

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

Type: Ganzzahl

ForecastTypes

Die während des Prädiktortrainings verwendeten Prognosetypen. Der Standardwert ist["0.1","0.5","0.9"]

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$)

HPOConfig

Der Hyperparameter überschreibt 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 wurdeCreateAutoPredictoraus.

Type: Boolesch

LastModificationTime

Die Uhrzeit, wann die Ressource zuletzt geändert wurde. Der Zeitstempel hängt vom Status des Auftrags ab:

  • CREATE_PENDING- DieCreationTimeaus.

  • CREATE_IN_PROGRESS- Aktueller Zeitstempel

  • CREATE_STOPPING- Aktueller Zeitstempel

  • CREATE_STOPPED- Als der Job aufhörte.

  • ACTIVEoderCREATE_FAILED- Wenn der Job beendet ist oder fehlgeschlagen ist.

Type: Zeitstempel

Message

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

Type: String (Zeichenfolge)

OptimizationMetric

Die zur Optimierung des Prädiktors verwendete Genauigkeitsmetrik.

Type: String (Zeichenfolge)

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

PerformAutoML

Ob der Prädiktor für die Ausführung von AutoML eingestellt ist.

Type: Boolesch

PerformHPO

Ob der Predictor so eingestellt ist, dass Hyperparameter-Optimierung (HPO) durchgeführt werden soll.

Type: Boolesch

PredictorArn

Der ARN des Predictors.

Type: String (Zeichenfolge)

Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 63 Zeichen.

Pattern: ^[a-zA-Z][a-zA-Z0-9_]*

PredictorExecutionDetails

Details zum Status und den Ergebnissen der Backtests, die zur Bewertung der Genauigkeit des Prädiktors durchgeführt wurden. Sie geben die Anzahl der Backtests an, die ausgeführt werden sollen, wenn Sie denCreatePredictorverwenden.

Typ: PredictorExecutionDetails Objekt

PredictorName

Der Name des Predictors.

Type: String (Zeichenfolge)

Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 63 Zeichen.

Pattern: ^[a-zA-Z][a-zA-Z0-9_]*

Status

Der Status des Predictors. 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

DieStatusdes Prädiktors muss seinACTIVEbevor Sie den Predictor verwenden können, um eine Prognose zu erstellen.

Type: String (Zeichenfolge)

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

TrainingParameters

Die Standard-Trainingsparameter oder -überschreibungen, die während des Modelltrainings ausgewählt wurden. 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 .

Type: Zeichenfolge-zu-Zeichenfolge-Zuweisung

Map-Einträge: Minimale Anzahl der Elemente: 0. Die maximale Anzahl beträgt 100 Elemente.

Einschränkungen der Schlüssellänge: Maximale Länge beträgt 256 Zeichen.

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

Einschränkungen für Wertlänge: Maximale Länge beträgt 256 Zeichen.

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

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

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: