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à.
CreateForecast
Crea una previsione per ogni elemento del TARGET_TIME_SERIES set di dati utilizzato per addestrare il predittore. Questa operazione è nota come inferenza. Per recuperare la previsione per un singolo elemento a bassa latenza, usa l'operazione. QueryForecast Per esportare la previsione completa nel tuo bucket Amazon Simple Storage Service (Amazon S3), utilizza l'operazione. CreateForecastExportJob
L'intervallo della previsione è determinato dal ForecastHorizon valore specificato nella CreatePredictor richiesta. Quando si esegue una query su una previsione, è possibile richiedere un intervallo di date specifico all'interno della previsione.
Per ottenere un elenco di tutte le tue previsioni, usa l'ListForecastsoperazione.
Nota
Le previsioni generate da Amazon Forecast si trovano nello stesso fuso orario del set di dati utilizzato per creare il predittore.
Per ulteriori informazioni, consulta Generazione di previsioni.
Nota
La previsione deve avvenire ACTIVE prima Status di poter interrogare o esportare la previsione. Utilizza l'operazione DescribeForecast per ottenere lo stato.
Per impostazione predefinita, una previsione include le previsioni per ogni elemento (item_id) del gruppo di set di dati utilizzato per addestrare il predittore. Tuttavia, è possibile utilizzare l'TimeSeriesSelectoroggetto per generare una previsione su un sottoinsieme di serie temporali. La creazione di Forecast viene ignorata per tutte le serie temporali specificate che non sono presenti nel set di dati di input. Il file di esportazione delle previsioni non conterrà queste serie temporali o i relativi valori previsti.
Sintassi della richiesta
{
"ForecastName": "string",
"ForecastTypes": [ "string" ],
"PredictorArn": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"TimeSeriesSelector": {
"TimeSeriesIdentifiers": {
"DataSource": {
"S3Config": {
"KMSKeyArn": "string",
"Path": "string",
"RoleArn": "string"
}
},
"Format": "string",
"Schema": {
"Attributes": [
{
"AttributeName": "string",
"AttributeType": "string"
}
]
}
}
}
}Parametri della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- ForecastName
-
Un nome per la previsione.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.
Modello:
^[a-zA-Z][a-zA-Z0-9_]*Campo obbligatorio: sì
- ForecastTypes
-
I quantili in base ai quali vengono generate le previsioni probabilistiche. Attualmente è possibile specificare fino a 5 quantili per previsione. I valori accettati includono
0.01 to 0.99(solo incrementi di 0,01) e.meanLa previsione media è diversa dalla mediana (0,50) quando la distribuzione non è simmetrica (ad esempio, Beta e Binomio negativo).I quantili predefiniti sono i quantili specificati durante la creazione del predittore. Se non hai specificato i quantili, i valori predefiniti sono.
["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$)Campo obbligatorio: no
- PredictorArn
-
L'Amazon Resource Name (ARN) del predittore da utilizzare per generare la previsione.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):forecast:.*:.*:.+Campo obbligatorio: sì
- Tags
-
I metadati opzionali che applichi alla previsione per aiutarti a classificarla e organizzarla. Ogni tag è composto da una chiave e da un valore opzionale, entrambi personalizzabili.
Ai tag si applicano le seguenti limitazioni di base:
-
Numero massimo di tag per risorsa: 50.
-
Per ciascuna risorsa, ogni chiave del tag deve essere univoca e ogni chiave del tag può avere un solo valore.
-
Lunghezza massima della chiave: 128 caratteri Unicode in UTF-8.
-
Lunghezza massima del valore: 256 caratteri Unicode in UTF-8.
-
Se lo schema di assegnazione dei tag viene utilizzato in più servizi e risorse , tieni presente che altri servizi potrebbero prevedere limitazioni sui caratteri consentiti. I caratteri generalmente consentiti sono: lettere, numeri e spazi rappresentabili in formato UTF-8 e i seguenti caratteri speciali + – = . _ : / @.
-
I valori e le chiavi dei tag rispettano la distinzione tra maiuscole e minuscole.
-
Non utilizzare alcuna combinazione di lettere maiuscole o minuscole
aws:AWS:, ad esempio un prefisso per le chiavi, poiché è riservato all'uso. AWS Non è possibile modificare o eliminare le chiavi dei tag con questo prefisso. I valori possono avere questo prefisso. Se il valore di un tag haawscome prefisso ma la chiave no, Forecast lo considera un tag utente e verrà conteggiato nel limite di 50 tag. I tag con solo il prefisso chiave diawsnon vengono conteggiati ai fini del limite di tag per risorsa.
Tipo: matrice di oggetti Tag
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.
Campo obbligatorio: no
-
- TimeSeriesSelector
-
Definisce l'insieme di serie temporali utilizzate per creare le previsioni in un
TimeSeriesIdentifiersoggetto.L'
TimeSeriesIdentifiersoggetto necessita delle seguenti informazioni:-
DataSource -
Format -
Schema
Tipo: oggetto TimeSeriesSelector
Campo obbligatorio: no
-
Sintassi della risposta
{
"ForecastArn": "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.
- ForecastArn
-
L'Amazon Resource Name (ARN) della previsione.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):forecast:.*:.*:.+
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
- LimitExceededException
-
Il limite del numero di risorse per account è stato superato.
Codice di stato HTTP: 400
- ResourceAlreadyExistsException
-
Esiste già una risorsa con questo nome. Riprova con un nome diverso.
Codice di stato HTTP: 400
- ResourceInUseException
-
La risorsa specificata è in uso.
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 uno degli AWS SDK specifici della lingua, consulta quanto segue:
