View a markdown version of this page

CreateForecastExportJob - Amazon Forecast
Sintassi della richiestaParametri della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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 (yyyy-). MM-ddTHH-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ù»

Devi 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 previsionale deve avvenire 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 in formato JSON.

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 ruolo IAM deve consentire ad Amazon Forecast di accedere alla chiave.

Tipo: oggetto DataDestination

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:.*:.*:.+

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_]*

Obbligatorio: sì

Format

Il formato dei dati esportati, CSV o PARQUET. Il valore predefinito è CSV.

Tipo: stringa

Vincoli di lunghezza: lunghezza massima di 7.

Modello: ^CSV|PARQUET$

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 ogni risorsa, ogni chiave di tag deve essere univoca e ogni chiave di 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 aws: né alcuna combinazione di lettere maiuscole o minuscoleAWS:, ad esempio un prefisso per i tasti, poiché è riservato all'uso. AWS Non è possibile modificare o eliminare le chiavi dei tag con questo prefisso. 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.

Tipo: matrice di oggetti Tag

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

Obbligatorio: no

Sintassi della risposta

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

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.

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: