Amazon Forecast non è più disponibile per i nuovi clienti. I clienti esistenti di Amazon Forecast possono continuare a utilizzare il servizio normalmente. [Scopri di più»](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

**Nota**  
 Questa operazione è valida solo per i predittori legacy creati con CreatePredictor. Se non si utilizza un predittore legacy, utilizzare. [DescribeAutoPredictor](API_DescribeAutoPredictor.md)

Descrive un predittore creato utilizzando l'[CreatePredictor](API_CreatePredictor.md)operazione.

**Importante**  
Amazon Forecast non è più disponibile per i nuovi clienti. I clienti esistenti di Amazon Forecast possono continuare a utilizzare il servizio normalmente. [Scopri di più»](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

Oltre a elencare le proprietà fornite nella `CreatePredictor` richiesta, questa operazione elenca le seguenti proprietà:
+  `DatasetImportJobArns`- I processi di importazione del set di dati utilizzati per importare i dati di addestramento.
+  `AutoMLAlgorithmArns`- Se viene eseguito AutoML, gli algoritmi che sono stati valutati.
+  `CreationTime` 
+  `LastModificationTime` 
+  `Status` 
+  `Message`- Se si è verificato un errore, informazioni sull'errore.

## Sintassi della richiesta
<a name="API_DescribePredictor_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_DescribePredictor_RequestParameters"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [PredictorArn](#API_DescribePredictor_RequestSyntax) **   <a name="forecast-DescribePredictor-request-PredictorArn"></a>
L'Amazon Resource Name (ARN) del predittore su cui desideri informazioni.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Obbligatorio: sì

## Sintassi della risposta
<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" 
   }
}
```

## Elementi di risposta
<a name="API_DescribePredictor_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [AlgorithmArn](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-AlgorithmArn"></a>
L'Amazon Resource Name (ARN) dell'algoritmo utilizzato per l'addestramento dei modelli.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [AutoMLAlgorithmArns](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-AutoMLAlgorithmArns"></a>
Quando `PerformAutoML` viene specificato, l'ARN dell'algoritmo scelto.  
Tipo: array di stringhe  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [AutoMLOverrideStrategy](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-AutoMLOverrideStrategy"></a>
 La strategia di override di `LatencyOptimized` AutoML è disponibile solo nella versione beta privata. Contatta AWS Support o il tuo account manager per ulteriori informazioni sui privilegi di accesso. 
La strategia AutoML utilizzata per addestrare il predittore. Se non diversamente `LatencyOptimized` specificato, la strategia AutoML ottimizza la precisione dei predittori.  
Questo parametro è valido solo per i predittori addestrati utilizzando AutoML.  
Tipo: String  
Valori validi: `LatencyOptimized | AccuracyOptimized` 

 ** [CreationTime](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-CreationTime"></a>
Quando è stata creata l'attività di addestramento del modello.  
Tipo: Timestamp

 ** [DatasetImportJobArns](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-DatasetImportJobArns"></a>
Una serie di processi di importazione ARNs del set di dati utilizzati per importare i dati di addestramento per il predittore.  
Tipo: array di stringhe  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [EncryptionConfig](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-EncryptionConfig"></a>
Una chiave AWS Key Management Service (KMS) e il ruolo AWS Identity and Access Management (IAM) che Amazon Forecast può assumere per accedere alla chiave.  
Tipo: oggetto [EncryptionConfig](API_EncryptionConfig.md)

 ** [EstimatedTimeRemainingInMinutes](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-EstimatedTimeRemainingInMinutes"></a>
Il tempo stimato in minuti rimanente per il completamento del processo di addestramento dei predittori.  
Tipo: long

 ** [EvaluationParameters](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-EvaluationParameters"></a>
Utilizzato per sovrascrivere i parametri di valutazione predefiniti dell'algoritmo specificato. Amazon Forecast valuta un predittore suddividendo un set di dati in dati di addestramento e dati di test. I parametri di valutazione definiscono come eseguire la suddivisione e il numero di iterazioni.  
Tipo: oggetto [EvaluationParameters](API_EvaluationParameters.md)

 ** [FeaturizationConfig](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-FeaturizationConfig"></a>
La configurazione della feature.  
Tipo: oggetto [FeaturizationConfig](API_FeaturizationConfig.md)

 ** [ForecastHorizon](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-ForecastHorizon"></a>
Il numero di fasi temporali della previsione. L'orizzonte di previsione è anche chiamato lunghezza della previsione.  
Tipo: numero intero

 ** [ForecastTypes](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-ForecastTypes"></a>
I tipi di previsione utilizzati durante l'addestramento dei predittori. Il valore predefinito è `["0.1","0.5","0.9"]`   
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 20 elementi.  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 4 caratteri.  
Modello: `(^0?\.\d\d?$|^mean$)` 

 ** [HPOConfig](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-HPOConfig"></a>
L'iperparametro sostituisce i valori dell'algoritmo.  
Tipo: oggetto [HyperParameterTuningJobConfig](API_HyperParameterTuningJobConfig.md)

 ** [InputDataConfig](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-InputDataConfig"></a>
Descrive il gruppo di set di dati che contiene i dati da utilizzare per addestrare il predittore.  
Tipo: oggetto [InputDataConfig](API_InputDataConfig.md)

 ** [IsAutoPredictor](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-IsAutoPredictor"></a>
Se il predittore è stato creato con. [CreateAutoPredictor](API_CreateAutoPredictor.md)  
Tipo: Booleano

 ** [LastModificationTime](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-LastModificationTime"></a>
L'ultima volta che la risorsa è stata modificata. Il timestamp dipende dallo stato del lavoro:  
+  `CREATE_PENDING`- Il. `CreationTime`
+  `CREATE_IN_PROGRESS`- Il timestamp corrente.
+  `CREATE_STOPPING`- Il timestamp corrente.
+  `CREATE_STOPPED`- Quando il lavoro si è interrotto.
+  `ACTIVE`oppure `CREATE_FAILED` - Quando il lavoro è terminato o non è riuscito.
Tipo: Timestamp

 ** [Message](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-Message"></a>
Se si è verificato un errore, un messaggio informativo sull'errore.  
Tipo: String

 ** [OptimizationMetric](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-OptimizationMetric"></a>
La metrica di precisione utilizzata per ottimizzare il predittore.  
Tipo: String  
Valori validi: `WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE` 

 ** [PerformAutoML](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PerformAutoML"></a>
Se il predittore è impostato per eseguire AutoML.  
Tipo: Booleano

 ** [PerformHPO](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PerformHPO"></a>
Se il predittore è impostato per eseguire l'ottimizzazione degli iperparametri (HPO).  
Tipo: Booleano

 ** [PredictorArn](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PredictorArn"></a>
L'ARN del predittore.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.  
Modello: `^[a-zA-Z][a-zA-Z0-9_]*` 

 ** [PredictorExecutionDetails](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PredictorExecutionDetails"></a>
Dettagli sullo stato e sui risultati dei backtest eseguiti per valutare l'accuratezza del predittore. Si specifica il numero di backtest da eseguire quando si richiama l'operazione. [CreatePredictor](API_CreatePredictor.md)  
Tipo: oggetto [PredictorExecutionDetails](API_PredictorExecutionDetails.md)

 ** [PredictorName](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PredictorName"></a>
Il nome del predittore.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.  
Modello: `^[a-zA-Z][a-zA-Z0-9_]*` 

 ** [Status](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-Status"></a>
Lo stato del predittore. Gli stati includono:  
+  `ACTIVE` 
+  `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` 
+  `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 
+  `CREATE_STOPPING`, `CREATE_STOPPED` 
Il `Status` predittore deve essere impostato `ACTIVE` prima di poter utilizzare il predittore per creare una previsione.
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.

 ** [TrainingParameters](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-TrainingParameters"></a>
I parametri o le sostituzioni di allenamento predefiniti selezionati durante l'addestramento del modello. Quando si esegue AutoML o si sceglie HPO con CNN-QR o Deepar\$1, vengono restituiti i valori ottimizzati per gli iperparametri scelti. Per ulteriori informazioni, consulta [Algoritmi di Amazon Forecast](aws-forecast-choosing-recipes.md).  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero minimo di 0 elementi. Numero massimo di 100 elementi.  
Vincoli di lunghezza della chiave: lunghezza massima di 256.  
Modello di chiave:`^[a-zA-Z0-9\-\_\.\/\[\]\,\\]+$`   
Limiti di lunghezza del valore: lunghezza massima di 256.  
Modello di valore: `^[a-zA-Z0-9\-\_\.\/\[\]\,\"\\\s]+$` 

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

 ** InvalidInputException **   
Non possiamo elaborare la richiesta perché include un valore non valido o un valore che supera l'intervallo valido.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
Non riusciamo a trovare una risorsa con questo Amazon Resource Name (ARN). Controlla l'ARN e riprova.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_DescribePredictor_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribePredictor)