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“](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

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
<a name="API_DescribePredictor"></a>

**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](API_DescribeAutoPredictor.md)

Beschreibt einen Prädiktor, der mit der [CreatePredictor](API_CreatePredictor.md) 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“](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

Dieser Vorgang listet nicht nur die in der `CreatePredictor` Anfrage 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
<a name="API_DescribePredictor_RequestSyntax"></a>

```
{
   "PredictorArn": "string"
}
```

## Anforderungsparameter
<a name="API_DescribePredictor_RequestParameters"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [PredictorArn](#API_DescribePredictor_RequestSyntax) **   <a name="forecast-DescribePredictor-request-PredictorArn"></a>
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
<a name="API_DescribePredictor_ResponseSyntax"></a>

```
{
   "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
<a name="API_DescribePredictor_ResponseElements"></a>

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](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-AlgorithmArn"></a>
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](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-AutoMLAlgorithmArns"></a>
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](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-AutoMLOverrideStrategy"></a>
 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](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-CreationTime"></a>
Als die Modelltrainingsaufgabe erstellt wurde.  
Typ: Zeitstempel

 ** [DatasetImportJobArns](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-DatasetImportJobArns"></a>
Eine Reihe von Datensatz-Importjobs, die zum Importieren ARNs 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](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-EncryptionConfig"></a>
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](API_EncryptionConfig.md) Objekt

 ** [EstimatedTimeRemainingInMinutes](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-EstimatedTimeRemainingInMinutes"></a>
Die geschätzte Zeit in Minuten, die bis zum Abschluss des Prädiktor-Trainingsjobs noch verbleibt.  
Type: Long

 ** [EvaluationParameters](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-EvaluationParameters"></a>
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](API_EvaluationParameters.md) Objekt

 ** [FeaturizationConfig](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-FeaturizationConfig"></a>
Die Konfiguration der Funktionen.  
Typ: [FeaturizationConfig](API_FeaturizationConfig.md) Objekt

 ** [ForecastHorizon](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-ForecastHorizon"></a>
Die Anzahl der Zeitschritte der Prognose. Der Prognosehorizont wird auch als Prognoselänge bezeichnet.  
Typ: Ganzzahl

 ** [ForecastTypes](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-ForecastTypes"></a>
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](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-HPOConfig"></a>
Die Hyperparameter überschreiben die Werte für den Algorithmus.  
Typ: [HyperParameterTuningJobConfig](API_HyperParameterTuningJobConfig.md) Objekt

 ** [InputDataConfig](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-InputDataConfig"></a>
Beschreibt die Datensatzgruppe, die die Daten enthält, die zum Trainieren des Prädiktors verwendet werden sollen.  
Typ: [InputDataConfig](API_InputDataConfig.md) Objekt

 ** [IsAutoPredictor](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-IsAutoPredictor"></a>
Ob der Prädiktor mit erstellt wurde. [CreateAutoPredictor](API_CreateAutoPredictor.md)  
Typ: Boolescher Wert

 ** [LastModificationTime](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-LastModificationTime"></a>
Das letzte Mal, als die Ressource geändert wurde. Der Zeitstempel hängt vom Status des Jobs ab:  
+  `CREATE_PENDING`- Das`CreationTime`.
+  `CREATE_IN_PROGRESS`- Der aktuelle Zeitstempel.
+  `CREATE_STOPPING`- Der aktuelle Zeitstempel.
+  `CREATE_STOPPED`- Als der Job beendet wurde.
+  `ACTIVE`oder `CREATE_FAILED` — Wenn der Job abgeschlossen wurde oder fehlgeschlagen ist.
Typ: Zeitstempel

 ** [Message](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-Message"></a>
Wenn ein Fehler aufgetreten ist, eine Informationsmeldung über den Fehler.  
Typ: Zeichenfolge

 ** [OptimizationMetric](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-OptimizationMetric"></a>
Die Genauigkeitsmetrik, die zur Optimierung des Prädiktors verwendet wurde.  
Typ: Zeichenfolge  
Zulässige Werte: `WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE` 

 ** [PerformAutoML](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PerformAutoML"></a>
Ob der Prädiktor so eingestellt ist, dass er AutoML ausführt.  
Typ: Boolescher Wert

 ** [PerformHPO](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PerformHPO"></a>
Ob der Prädiktor so eingestellt ist, dass er eine Hyperparameteroptimierung (HPO) durchführt.  
Typ: Boolescher Wert

 ** [PredictorArn](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PredictorArn"></a>
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](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PredictorExecutionDetails"></a>
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](API_CreatePredictor.md)  
Typ: [PredictorExecutionDetails](API_PredictorExecutionDetails.md) Objekt

 ** [PredictorName](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PredictorName"></a>
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](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-Status"></a>
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` 
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](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-TrainingParameters"></a>
Die beim Modelltraining ausgewählten Standard-Trainingsparameter oder Overrides. Wenn Sie AutoML ausführen oder HPO mit CNN-QR oder DeePar\$1 wählen, werden die optimierten Werte für die ausgewählten Hyperparameter zurückgegeben. Weitere Informationen finden Sie unter [Amazon-Prognosealgorithmen](aws-forecast-choosing-recipes.md).  
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
<a name="API_DescribePredictor_Errors"></a>

 ** 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:
<a name="API_DescribePredictor_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribePredictor)