Sintassi della richiesta Parametri della richiesta Sintassi della risposta Elementi di risposta Errori Vedi anche

CreateAutoPredictor

Crea un predittore Amazon Forecast.

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

Amazon Forecast crea predittori con AutoPredictor, il che implica l'applicazione della combinazione ottimale di algoritmi a ciascuna serie temporale dei tuoi set di dati. Puoi utilizzarli CreateAutoPredictor per creare nuovi predittori o predittori esistenti. upgrade/retrain

Creazione di nuovi predittori

I seguenti parametri sono obbligatori per la creazione di un nuovo predittore:

PredictorName- Un nome univoco per il predittore.
DatasetGroupArn- L'ARN del gruppo di set di dati utilizzato per addestrare il predittore.
ForecastFrequency- La granularità delle tue previsioni (orarie, giornaliere, settimanali, ecc.).
ForecastHorizon- Il numero di fasi temporali previste dal modello. L'orizzonte di previsione è anche chiamato lunghezza della previsione.

Quando si crea un nuovo predittore, non specificare un valore per. ReferencePredictorArn

Aggiornamento e riqualificazione dei predittori

I seguenti parametri sono necessari per il riaddestramento o l'aggiornamento di un predittore:

PredictorName- Un nome univoco per il predittore.
ReferencePredictorArn- L'ARN del predittore da riqualificare o aggiornare.

Quando si aggiorna o si riqualifica un predittore, specificate solo i valori per e. ReferencePredictorArn PredictorName

Sintassi della richiesta


{
   "DataConfig": { 
      "AdditionalDatasets": [ 
         { 
            "Configuration": { 
               "string" : [ "string" ]
            },
            "Name": "string"
         }
      ],
      "AttributeConfigs": [ 
         { 
            "AttributeName": "string",
            "Transformations": { 
               "string" : "string" 
            }
         }
      ],
      "DatasetGroupArn": "string"
   },
   "EncryptionConfig": { 
      "KMSKeyArn": "string",
      "RoleArn": "string"
   },
   "ExplainPredictor": boolean,
   "ForecastDimensions": [ "string" ],
   "ForecastFrequency": "string",
   "ForecastHorizon": number,
   "ForecastTypes": [ "string" ],
   "MonitorConfig": { 
      "MonitorName": "string"
   },
   "OptimizationMetric": "string",
   "PredictorName": "string",
   "ReferencePredictorArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TimeAlignmentBoundary": { 
      "DayOfMonth": number,
      "DayOfWeek": "string",
      "Hour": number,
      "Month": "string"
   }
}

Parametri della richiesta

La richiesta accetta i seguenti dati in formato JSON.

DataConfig

La configurazione dei dati per il gruppo di set di dati e gli eventuali set di dati aggiuntivi.

Tipo: oggetto DataConfig

Obbligatorio: no

EncryptionConfig

Una chiave AWS Key Management Service (KMS) e un ruolo AWS Identity and Access Management (IAM) che Amazon Forecast può assumere per accedere alla chiave. Puoi specificare questo oggetto opzionale nelle CreatePredictor richieste CreateDataset e.

Tipo: oggetto EncryptionConfig

Obbligatorio: no

ExplainPredictor

Crea una risorsa Explainability per il predittore.

Tipo: Booleano

Obbligatorio: no

ForecastDimensions

Una matrice di nomi di dimensioni (campi) che specificano come raggruppare la previsione generata.

Ad esempio, se stai generando previsioni per le vendite degli articoli in tutti i tuoi negozi e il tuo set di dati contiene un store_id campo, devi specificare store_id come dimensione per raggruppare le previsioni di vendita per ogni negozio.

Tipo: array di stringhe

Membri dell’array: numero minimo di 1 elemento. Numero massimo di 10 elementi.

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

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

Obbligatorio: no

ForecastFrequency

La frequenza delle previsioni in una previsione.

Gli intervalli validi sono un numero intero seguito da Y (anno), M (mese), W (settimana), D (giorno), H (ora) e min (minuti). Ad esempio, "1D" indica ogni giorno e "15min" indica ogni 15 minuti. Non è possibile specificare un valore che si sovrapponga alla successiva frequenza più grande. Ciò significa, ad esempio, che non è possibile specificare una frequenza di 60 minuti, poiché equivale a 1 ora. Di seguito sono riportati i valori validi per ciascuna frequenza:

Minuti: 1-59
Ora: 1-23
Giorno: 1-6
Settimana: 1-4
Mese: 1-11
Anno: 1

Pertanto, se desideri previsioni a settimane alterne, specifica "2W". Oppure, se desideri previsioni trimestrali, specifica "3M".

La frequenza deve essere maggiore o uguale alla frequenza del set di dati TARGET_TIME_SERIES.

Quando viene fornito un set di dati RELATED_TIME_SERIES, la frequenza deve essere uguale alla frequenza del set di dati RELATED_TIME_SERIES.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 5.

Modello: ^Y|M|W|D|H|30min|15min|10min|5min|1min$

Obbligatorio: no

ForecastHorizon

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

L'orizzonte di previsione massimo è il minore tra 500 intervalli temporali o la lunghezza del set di dati 1/4 TARGET_TIME_SERIES. Se stai riqualificando un esistente AutoPredictor, l'orizzonte di previsione massimo è il minore tra 500 intervalli temporali o la lunghezza del set di dati TARGET_TIME_SERIES. 1/3

Se stai effettuando l'aggiornamento AutoPredictor o la riqualificazione di un esistente, non puoi aggiornare il parametro dell'orizzonte di previsione. AutoPredictor È possibile soddisfare questo requisito fornendo serie temporali più lunghe nel set di dati.

Tipo: Integer

Obbligatorio: no

ForecastTypes

I tipi di previsione utilizzati per addestrare un predittore. È possibile specificare fino a cinque tipi di previsione. I tipi di previsione possono essere quantili da 0,01 a 0,99, con incrementi di 0,01 o superiori. È inoltre possibile specificare la previsione media conmean.

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$)

Obbligatorio: no

MonitorConfig

I dettagli di configurazione per il monitoraggio dei predittori. Fornisci un nome per la risorsa di monitoraggio per abilitare il monitoraggio predittivo.

Il monitoraggio predittivo consente di vedere come le prestazioni del predittore cambiano nel tempo. Per ulteriori informazioni, consulta Predictor Monitoring.

Tipo: oggetto MonitorConfig

Obbligatorio: no

OptimizationMetric

La metrica di precisione utilizzata per ottimizzare il predittore.

Tipo: stringa

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

Campo obbligatorio: no

PredictorName

Un nome univoco per il predittore

Tipo: stringa

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

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

Obbligatorio: sì

ReferencePredictorArn

L'ARN del predittore da riqualificare o aggiornare. Questo parametro viene utilizzato solo durante il riaddestramento o l'aggiornamento di un predittore. Quando si crea un nuovo predittore, non specificate un valore per questo parametro.

Quando si aggiorna o si riqualifica un predittore, specificate solo i valori per e. ReferencePredictorArn PredictorName Il valore per PredictorName deve essere un nome di predittore univoco.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

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

Obbligatorio: no

Tags

Metadati opzionali per aiutarti a classificare e organizzare i tuoi predittori. Ogni tag è composto da una chiave e da un valore opzionale, entrambi personalizzabili. I valori e le chiavi dei tag rispettano la distinzione tra maiuscole e minuscole.

Ai tag si applicano le limitazioni seguenti:

Per ogni risorsa, ogni chiave del tag deve essere univoca e ogni chiave del tag deve avere un valore.
Numero massimo di tag per risorsa: 50.
Lunghezza massima della chiave: 128 caratteri Unicode in. UTF-8
Lunghezza massima del valore: 256 caratteri Unicode in. UTF-8
Caratteri accettati: tutte le lettere e i numeri, gli spazi rappresentabili in UTF-8 e + - =. _:/@. Se il tuo schema di tagging viene utilizzato in altri servizi e risorse, si applicano anche le restrizioni relative ai caratteri di tali servizi.
I prefissi chiave non possono includere alcuna combinazione maiuscola o minuscola di o. aws: AWS: I valori possono avere questo prefisso. Se un valore di tag ha aws come prefisso ma la chiave no, Forecast lo considera un tag utente e verrà conteggiato nel limite di 50 tag. I tag con il solo prefisso chiave di aws non vengono conteggiati nel calcolo dei tag per limite di risorse. Non è possibile modificare o eliminare le chiavi dei tag con questo prefisso.

Tipo: matrice di oggetti Tag

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.

Obbligatorio: no

TimeAlignmentBoundary

Il limite temporale utilizzato da Forecast per allineare e aggregare tutti i dati che non sono in linea con la frequenza della previsione. Fornisci l'unità di tempo e il limite temporale come coppia chiave-valore. Per ulteriori informazioni sulla specificazione di un limite temporale, vedere Specificazione di un limite temporale. Se non fornisci un limite di tempo, Forecast utilizza un set di limiti temporali predefiniti. https://docs.aws.amazon.com/forecast/latest/dg/data-aggregation.html#default-time-boundaries

Tipo: oggetto TimeAlignmentBoundary

Obbligatorio: no

Sintassi della risposta


{
   "PredictorArn": "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.

PredictorArn

L'Amazon Resource Name (ARN) del predittore.

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

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Servizio Amazon Forecast

CreateDataset