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à.
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
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ù»
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 nel JSON formato.
- 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 UTF -8 e i seguenti caratteri: + - =. _:/@.
-
I valori e le chiavi dei tag rispettano la distinzione tra maiuscole e minuscole.
-
Non utilizzare alcuna combinazione maiuscola o minuscola
aws:AWS:, ad esempio un prefisso per le chiavi, in quanto è 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'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.
I seguenti dati vengono restituiti in JSON formato dal 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.
HTTPCodice di stato: 400
- LimitExceededException
-
Il limite del numero di risorse per account è stato superato.
HTTPCodice di stato: 400
- ResourceAlreadyExistsException
-
Esiste già una risorsa con questo nome. Riprova con un nome diverso.
HTTPCodice di stato: 400
- ResourceInUseException
-
La risorsa specificata è in uso.
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:
