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à.
CreateForecastExportJob
Esporta una previsione creata dall'CreateForecastoperazione nel tuo bucket Amazon Simple Storage Service (Amazon S3). Il nome del file di previsione corrisponderà alle seguenti convenzioni:
<ForecastExportJobName>_<ExportTimestamp>_<PartNumber>
dove il componente < ExportTimestamp > è in Java SimpleDateFormat (THHyyyy-MM-dd -MM-ssz).
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ù»
È necessario specificare un DataDestination oggetto che includa un ruolo AWS Identity and Access Management (IAM) che Amazon Forecast può assumere per accedere al bucket Amazon S3. Per ulteriori informazioni, consulta Impostazione delle autorizzazioni per Amazon Forecast.
Per ulteriori informazioni, consulta Generazione di previsioni.
Per ottenere un elenco di tutti i lavori di esportazione previsti, utilizza l'ListForecastExportJobsoperazione.
Nota
Il processo Status
di esportazione delle previsioni deve essere eseguito ACTIVE
prima di poter accedere alla previsione nel bucket Amazon S3. Per ottenere lo stato, usa l'DescribeForecastExportJoboperazione.
Sintassi della richiesta
{
"Destination": {
"S3Config": {
"KMSKeyArn": "string
",
"Path": "string
",
"RoleArn": "string
"
}
},
"ForecastArn": "string
",
"ForecastExportJobName": "string
",
"Format": "string
",
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
]
}
Parametri della richiesta
La richiesta accetta i seguenti dati nel JSON formato.
- Destination
-
La posizione in cui desideri salvare la previsione e un ruolo AWS Identity and Access Management (IAM) che Amazon Forecast può assumere per accedere alla posizione. La previsione deve essere esportata in un bucket Amazon S3.
Se viene utilizzata la crittografia,
Destination
deve includere una chiave AWS Key Management Service ()KMS. Il IAM ruolo deve consentire ad Amazon Forecast l'autorizzazione ad accedere alla chiave.Tipo: oggetto DataDestination
Campo obbligatorio: sì
- ForecastArn
-
L'Amazon Resource Name (ARN) della previsione che desideri esportare.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):forecast:.*:.*:.+
Campo obbligatorio: sì
- ForecastExportJobName
-
Il nome del processo di esportazione delle previsioni.
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ì
- Format
-
Il formato dei dati esportati, CSV oPARQUET. Il valore predefinito èCSV.
Tipo: stringa
Vincoli di lunghezza: lunghezza massima di 7.
Modello:
^CSV|PARQUET$
Campo obbligatorio: no
- Tags
-
I metadati opzionali che applichi al processo di esportazione delle previsioni per aiutarti a classificarli e organizzarli. 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 haaws
come 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 diaws
non 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
-
Sintassi della risposta
{
"ForecastExportJobArn": "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.
- ForecastExportJobArn
-
L'Amazon Resource Name (ARN) del processo di esportazione.
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: