DescribePredictor - Amazon Forecast
AnforderungssyntaxAnforderungsparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

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.

Diese Operation listet nicht nur die in der CreatePredictor Anforderung angegebenen Eigenschaften auf, sondern listet auch die folgenden Eigenschaften auf:

  • DatasetImportJobArns- Die Datensatz-Importjobs, 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 benötigen.

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

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

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 Account Manager, um mehr über Zugriffsrechte zu erfahren.

Die AutoML, mit der der Prädiktor trainiert wurde. Sofern nicht anders LatencyOptimized angegeben, optimiert die AutoML-Strategie die Genauigkeit der Prädiktoren.

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-Importjobs, 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 verbleibende Zeit in Minuten bis zum Abschluss des Prädiktor-Trainingsjobs.

Type: Long

EvaluationParameters

Wird verwendet, um die Standard-Bewertungsparameter 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 Funktionen.

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 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: Boolesch

LastModificationTime

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

  • CREATE_PENDING- DasCreationTime.

  • 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 wurde.

Typ: Zeichenfolge

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

PerformAutoML

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

Typ: Boolesch

PerformHPO

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

Typ: Boolesch

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 vorliegen, 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 Overrides. 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-Forecast-Algorithmen.

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\-\_\.\/\[\]\,\\]+$

Längenbeschränkungen für Werte: Maximale Länge von 256.

Wertemuster: ^[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 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 einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: