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ù»](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

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à.

# CreateWhatIfForecastExport
<a name="API_CreateWhatIfForecastExport"></a>

Esporta una previsione creata dall'[CreateWhatIfForecast](API_CreateWhatIfForecast.md)operazione nel tuo bucket Amazon Simple Storage Service (Amazon S3). Il nome del file di previsione corrisponderà alle seguenti convenzioni:

 `≈<ForecastExportJobName>_<ExportTimestamp>_<PartNumber>` 

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ù»](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

È necessario specificare un [DataDestination](API_DataDestination.md) 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](aws-forecast-iam-roles.md).

Per ulteriori informazioni, consulta [Generazione di previsioni](howitworks-forecast.md).

Per ottenere un elenco di tutti i lavori di esportazione delle previsioni ipotetiche, utilizza l'operazione. [ListWhatIfForecastExports](API_ListWhatIfForecastExports.md)

**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'[DescribeWhatIfForecastExport](API_DescribeWhatIfForecastExport.md)operazione.

## Sintassi della richiesta
<a name="API_CreateWhatIfForecastExport_RequestSyntax"></a>

```
{
   "Destination": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "Format": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "WhatIfForecastArns": [ "string" ],
   "WhatIfForecastExportName": "string"
}
```

## Parametri della richiesta
<a name="API_CreateWhatIfForecastExport_RequestParameters"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [Destination](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-request-Destination"></a>
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 l'autorizzazione di Amazon Forecast per accedere alla chiave.  
Tipo: oggetto [DataDestination](API_DataDestination.md)  
Obbligatorio: sì

 ** [Format](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-request-Format"></a>
Il formato dei dati esportati, CSV o PARQUET.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 7.  
Modello: `^CSV|PARQUET$`   
Obbligatorio: no

 ** [Tags](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-request-Tags"></a>
Un elenco di [tag](https://docs.aws.amazon.com/forecast/latest/dg/tagging-forecast-resources.html) da applicare alla previsione what if.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Obbligatorio: no

 ** [WhatIfForecastArns](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-request-WhatIfForecastArns"></a>
L'elenco delle previsioni what-if di Amazon Resource Names (ARNs) da esportare.  
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 50 item.  
Vincoli di lunghezza: lunghezza massima di 300.  
Modello: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Obbligatorio: sì

 ** [WhatIfForecastExportName](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-request-WhatIfForecastExportName"></a>
Il nome della previsione what-if da esportare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.  
Modello: `^[a-zA-Z][a-zA-Z0-9_]*`   
Obbligatorio: sì

## Sintassi della risposta
<a name="API_CreateWhatIfForecastExport_ResponseSyntax"></a>

```
{
   "WhatIfForecastExportArn": "string"
}
```

## Elementi di risposta
<a name="API_CreateWhatIfForecastExport_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [WhatIfForecastExportArn](#API_CreateWhatIfForecastExport_ResponseSyntax) **   <a name="forecast-CreateWhatIfForecastExport-response-WhatIfForecastExportArn"></a>
L'Amazon Resource Name (ARN) della previsione what-if.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 300.  
Modello: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## Errori
<a name="API_CreateWhatIfForecastExport_Errors"></a>

 ** 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
<a name="API_CreateWhatIfForecastExport_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateWhatIfForecastExport)