View a markdown version of this page

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 stai utilizzando un predittore legacy, usa. 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 dei 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:.*:.*:.+

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: array 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 l' AWS assistenza o il tuo account manager per saperne di più sui privilegi di accesso.

La strategia AutoML utilizzata per addestrare il predittore. A meno che non LatencyOptimized sia specificato, la strategia AutoML ottimizza la precisione del predittore.

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 matrice degli ARN dei job di importazione 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

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 rimanente stimato in minuti per il completamento del processo di formazione sui 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 caratterizzazione.

Tipo: oggetto FeaturizationConfig

ForecastHorizon

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

Tipo: numero intero

ForecastTypes

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

L'iperparametro sovrascrive 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 chiama 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 valore del 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 di addestramento o le sostituzioni predefiniti selezionati durante l'addestramento del modello. Quando si esegue AutoML o si sceglie HPO with 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 della mappa: numero minimo di 0 elementi. Numero massimo di 100 elementi.

Vincoli di lunghezza chiave: lunghezza massima di 256.

Modello di chiave:^[a-zA-Z0-9\-\_\.\/\[\]\,\\]+$

Vincoli 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 tale 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 uno degli AWS SDK specifici della lingua, consulta quanto segue: