

 Amazon Forecast tidak lagi tersedia untuk pelanggan baru. Pelanggan Amazon Forecast yang ada dapat terus menggunakan layanan seperti biasa. [Pelajari lebih lanjut”](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# DescribePredictor
<a name="API_DescribePredictor"></a>

**catatan**  
 Operasi ini hanya berlaku untuk prediktor lama yang dibuat dengan. CreatePredictor Jika Anda tidak menggunakan prediktor lama, gunakan. [DescribeAutoPredictor](API_DescribeAutoPredictor.md)

Menjelaskan prediktor yang dibuat menggunakan [CreatePredictor](API_CreatePredictor.md) operasi.

**penting**  
Amazon Forecast tidak lagi tersedia untuk pelanggan baru. Pelanggan Amazon Forecast yang ada dapat terus menggunakan layanan seperti biasa. [Pelajari lebih lanjut”](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

Selain mencantumkan properti yang disediakan dalam `CreatePredictor` permintaan, operasi ini mencantumkan properti berikut:
+  `DatasetImportJobArns`- Pekerjaan impor dataset yang digunakan untuk mengimpor data pelatihan.
+  `AutoMLAlgorithmArns`- Jika AutoML dilakukan, algoritma yang dievaluasi.
+  `CreationTime` 
+  `LastModificationTime` 
+  `Status` 
+  `Message`- Jika terjadi kesalahan, informasi tentang kesalahan tersebut.

## Sintaksis Permintaan
<a name="API_DescribePredictor_RequestSyntax"></a>

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

## Parameter Permintaan
<a name="API_DescribePredictor_RequestParameters"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [PredictorArn](#API_DescribePredictor_RequestSyntax) **   <a name="forecast-DescribePredictor-request-PredictorArn"></a>
Nama Sumber Daya Amazon (ARN) dari prediktor yang Anda inginkan informasi tentang.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Diperlukan: Ya

## Sintaksis Respons
<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" 
   }
}
```

## Elemen Respons
<a name="API_DescribePredictor_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [AlgorithmArn](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-AlgorithmArn"></a>
Nama Sumber Daya Amazon (ARN) dari algoritma yang digunakan untuk pelatihan model.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [AutoMLAlgorithmArns](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-AutoMLAlgorithmArns"></a>
Kapan `PerformAutoML` ditentukan, ARN dari algoritma yang dipilih.  
Tipe: Array string  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [AutoMLOverrideStrategy](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-AutoMLOverrideStrategy"></a>
 Strategi penggantian `LatencyOptimized` AutoML hanya tersedia dalam versi beta pribadi. Hubungi AWS Support atau manajer akun Anda untuk mempelajari lebih lanjut tentang hak akses. 
Strategi AutoML digunakan untuk melatih prediktor. Kecuali `LatencyOptimized` ditentukan, strategi AutoML mengoptimalkan akurasi prediktor.  
Parameter ini hanya berlaku untuk prediktor yang dilatih menggunakan AutoML.  
Tipe: String  
Nilai yang Valid: `LatencyOptimized | AccuracyOptimized` 

 ** [CreationTime](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-CreationTime"></a>
Ketika tugas pelatihan model dibuat.  
Tipe: Timestamp

 ** [DatasetImportJobArns](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-DatasetImportJobArns"></a>
Array pekerjaan impor dataset yang digunakan untuk mengimpor data pelatihan untuk prediktor. ARNs   
Tipe: Array string  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [EncryptionConfig](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-EncryptionConfig"></a>
Kunci AWS Key Management Service (KMS) dan peran AWS Identity and Access Management (IAM) yang dapat diasumsikan Amazon Forecast untuk mengakses kunci tersebut.  
Tipe: Objek [EncryptionConfig](API_EncryptionConfig.md)

 ** [EstimatedTimeRemainingInMinutes](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-EstimatedTimeRemainingInMinutes"></a>
Perkiraan waktu yang tersisa dalam hitungan menit untuk menyelesaikan pekerjaan pelatihan prediktor.  
Tipe: Long

 ** [EvaluationParameters](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-EvaluationParameters"></a>
Digunakan untuk mengganti parameter evaluasi default dari algoritma yang ditentukan. Amazon Forecast mengevaluasi prediktor dengan membagi kumpulan data menjadi data pelatihan dan data pengujian. Parameter evaluasi menentukan bagaimana melakukan split dan jumlah iterasi.  
Tipe: Objek [EvaluationParameters](API_EvaluationParameters.md)

 ** [FeaturizationConfig](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-FeaturizationConfig"></a>
Konfigurasi featurisasi.  
Tipe: Objek [FeaturizationConfig](API_FeaturizationConfig.md)

 ** [ForecastHorizon](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-ForecastHorizon"></a>
Jumlah langkah waktu perkiraan. Cakrawala ramalan juga disebut panjang prediksi.  
Jenis: Integer

 ** [ForecastTypes](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-ForecastTypes"></a>
Jenis perkiraan yang digunakan selama pelatihan prediktor. Nilai defaultnya adalah `["0.1","0.5","0.9"]`   
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 20 item.  
Kendala Panjang: Panjang minimum 2. Panjang maksimum 4.  
Pola: `(^0?\.\d\d?$|^mean$)` 

 ** [HPOConfig](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-HPOConfig"></a>
Nilai override hyperparameter untuk algoritme.  
Tipe: Objek [HyperParameterTuningJobConfig](API_HyperParameterTuningJobConfig.md)

 ** [InputDataConfig](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-InputDataConfig"></a>
Menjelaskan grup kumpulan data yang berisi data yang akan digunakan untuk melatih prediktor.  
Tipe: Objek [InputDataConfig](API_InputDataConfig.md)

 ** [IsAutoPredictor](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-IsAutoPredictor"></a>
Apakah prediktor dibuat dengan[CreateAutoPredictor](API_CreateAutoPredictor.md).  
Jenis: Boolean

 ** [LastModificationTime](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-LastModificationTime"></a>
Terakhir kali sumber daya dimodifikasi. Stempel waktu tergantung pada status pekerjaan:  
+  `CREATE_PENDING`- The`CreationTime`.
+  `CREATE_IN_PROGRESS`- Stempel waktu saat ini.
+  `CREATE_STOPPING`- Stempel waktu saat ini.
+  `CREATE_STOPPED`- Saat pekerjaan berhenti.
+  `ACTIVE`atau `CREATE_FAILED` - Ketika pekerjaan selesai atau gagal.
Tipe: Timestamp

 ** [Message](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-Message"></a>
Jika terjadi kesalahan, pesan informasi tentang kesalahan tersebut.  
Tipe: String

 ** [OptimizationMetric](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-OptimizationMetric"></a>
Metrik akurasi yang digunakan untuk mengoptimalkan prediktor.  
Tipe: String  
Nilai yang Valid: `WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE` 

 ** [PerformAutoML](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PerformAutoML"></a>
Apakah prediktor diatur untuk melakukan AutoML.  
Jenis: Boolean

 ** [PerformHPO](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PerformHPO"></a>
Apakah prediktor diatur untuk melakukan optimasi hyperparameter (HPO).  
Jenis: Boolean

 ** [PredictorArn](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PredictorArn"></a>
ARN dari prediktor.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.  
Pola: `^[a-zA-Z][a-zA-Z0-9_]*` 

 ** [PredictorExecutionDetails](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PredictorExecutionDetails"></a>
Rincian tentang status dan hasil backtests dilakukan untuk mengevaluasi keakuratan prediktor. Anda menentukan jumlah backtests untuk melakukan ketika Anda memanggil [CreatePredictor](API_CreatePredictor.md) operasi.  
Tipe: Objek [PredictorExecutionDetails](API_PredictorExecutionDetails.md)

 ** [PredictorName](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PredictorName"></a>
Nama prediktor.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.  
Pola: `^[a-zA-Z][a-zA-Z0-9_]*` 

 ** [Status](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-Status"></a>
Status prediktor. Negara termasuk:  
+  `ACTIVE` 
+  `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` 
+  `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 
+  `CREATE_STOPPING`, `CREATE_STOPPED` 
Prediktor harus `ACTIVE` sebelum Anda dapat menggunakan prediktor untuk membuat perkiraan. `Status`
Tipe: String  
Batasan Panjang: Panjang maksimum 256.

 ** [TrainingParameters](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-TrainingParameters"></a>
Parameter pelatihan default atau penggantian dipilih selama pelatihan model. Saat menjalankan AutoML atau memilih HPO dengan CNN-QR atau DeepAR\$1, nilai yang dioptimalkan untuk hyperparameter yang dipilih dikembalikan. Untuk informasi selengkapnya, lihat [Algoritma Amazon Forecast](aws-forecast-choosing-recipes.md).  
Tipe: Peta string ke string  
Entri Peta: Jumlah minimum 0 item. Jumlah maksimum 100 item.  
Kendala Panjang Kunci: Panjang maksimum 256.  
Pola Kunci: `^[a-zA-Z0-9\-\_\.\/\[\]\,\\]+$`   
Kendala Panjang Nilai: Panjang maksimum 256.  
Pola nilai: `^[a-zA-Z0-9\-\_\.\/\[\]\,\"\\\s]+$` 

## Kesalahan
<a name="API_DescribePredictor_Errors"></a>

 ** InvalidInputException **   
Kami tidak dapat memproses permintaan karena menyertakan nilai yang tidak valid atau nilai yang melebihi rentang yang valid.  
Kode Status HTTP: 400

 ** ResourceNotFoundException **   
Kami tidak dapat menemukan sumber daya dengan Nama Sumber Daya Amazon (ARN) itu. Periksa ARN dan coba lagi.  
Kode Status HTTP: 400

## Lihat Juga
<a name="API_DescribePredictor_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK para 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 untuk 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) 