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 nel JSON formato.
- 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'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.
I seguenti dati vengono restituiti in JSON formato dal 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, ARN l'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. -
ACTIVE
oppureCREATE_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
-
Il 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 impostatoACTIVE
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.
HTTPCodice di stato: 400
- ResourceNotFoundException
-
Non riusciamo a trovare una risorsa con quel nome di risorsa Amazon (ARN). Controlla ARN e riprova.
HTTPCodice di stato: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue: