DescribePredictor - Amazon Forecast
Sintassi della richiestaParametri della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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ù»

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

Nota

Questa operazione è valida solo per i predittori legacy creati con CreatePredictor. Se non si utilizza un predittore legacy, utilizzare. DescribeAutoPredictor

Descrive un predittore creato utilizzando l'CreatePredictoroperazione.

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ù»

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

{
   "PredictorArn": "string"
}

Parametri della richiesta

La richiesta accetta i seguenti dati in formato JSON.

PredictorArn

L'Amazon Resource Name (ARN) del predittore su cui desideri informazioni.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: arn:([a-z\d-]+):forecast:.*:.*:.+

Campo obbligatorio: sì

Sintassi della risposta

{
   "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

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

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

AlgorithmArn

L'Amazon Resource Name (ARN) dell'algoritmo utilizzato per l'addestramento dei modelli.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: arn:([a-z\d-]+):forecast:.*:.*:.+

AutoMLAlgorithmArns

Quando PerformAutoML viene specificato, l'ARN dell'algoritmo scelto.

Tipo: matrice di stringhe

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: arn:([a-z\d-]+):forecast:.*:.*:.+

AutoMLOverrideStrategy
Nota

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

Valori validi: LatencyOptimized | AccuracyOptimized

CreationTime

Quando è stata creata l'attività di addestramento del modello.

Tipo: Timestamp

DatasetImportJobArns

Una serie di processi di importazione ARNs del set di dati utilizzati per importare i dati di addestramento per il predittore.

Tipo: matrice di stringhe

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: arn:([a-z\d-]+):forecast:.*:.*:.+

EncryptionConfig

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

EstimatedTimeRemainingInMinutes

Il tempo stimato in minuti rimanente per il completamento del processo di addestramento dei predittori.

Tipo: long

EvaluationParameters

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

FeaturizationConfig

La configurazione della feature.

Tipo: oggetto FeaturizationConfig

ForecastHorizon

Il numero di fasi temporali della previsione. L'orizzonte di previsione è anche chiamato lunghezza della previsione.

Tipo: integer

ForecastTypes

I tipi di previsione utilizzati durante l'addestramento dei predittori. Il valore predefinito è ["0.1","0.5","0.9"]

Tipo: matrice 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

L'iperparametro sostituisce i valori dell'algoritmo.

Tipo: oggetto HyperParameterTuningJobConfig

InputDataConfig

Descrive il gruppo di set di dati che contiene i dati da utilizzare per addestrare il predittore.

Tipo: oggetto InputDataConfig

IsAutoPredictor

Se il predittore è stato creato con. CreateAutoPredictor

Tipo: Booleano

LastModificationTime

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.

  • ACTIVEoppure CREATE_FAILED - Quando il lavoro è terminato o non è riuscito.

Tipo: Timestamp

Message

Se si è verificato un errore, un messaggio informativo sull'errore.

Tipo: stringa

OptimizationMetric

La metrica di precisione utilizzata per ottimizzare il predittore.

Tipo: stringa

Valori validi: WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE

PerformAutoML

Se il predittore è impostato per eseguire AutoML.

Tipo: Booleano

PerformHPO

Se il predittore è impostato per eseguire l'ottimizzazione degli iperparametri (HPO).

Tipo: Booleano

PredictorArn

L'ARN del predittore.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.

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

PredictorExecutionDetails

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

Tipo: oggetto PredictorExecutionDetails

PredictorName

Il nome del predittore.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.

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

Status

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

Nota

Il Status predittore deve essere impostato ACTIVE prima di poter utilizzare il predittore per creare una previsione.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

TrainingParameters

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+, vengono restituiti i valori ottimizzati per gli iperparametri scelti. Per ulteriori informazioni, consulta Algoritmi di Amazon Forecast.

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

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: