Amazon Forecast ya no está disponible para nuevos clientes. Los clientes actuales de Amazon Forecast pueden seguir utilizando el servicio con normalidad. [Más información](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Exporta una previsión creada por la operación [CreateWhatIfForecast](API_CreateWhatIfForecast.md) en su bucket de Amazon Simple Storage Service (Amazon S3). El nombre del archivo de previsión coincidirá con las siguientes convenciones:

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

El componente < ExportTimestamp > está en Java SimpleDateFormat (aaaa-MM-DDTHH-MM-SSZ).

**importante**  
Amazon Forecast ya no está disponible para nuevos clientes. Los clientes actuales de Amazon Forecast pueden seguir utilizando el servicio con normalidad. [Más información](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

Debe especificar un objeto [DataDestination](API_DataDestination.md) que incluya un rol (IAM) de AWS Identity and Access Management que Amazon Forecast pueda asumir para acceder al bucket de Amazon S3. Para obtener más información, consulte [Configuración de permisos para Amazon Forecast](aws-forecast-iam-roles.md).

Para obtener más información, consulte [Generación de previsiones](howitworks-forecast.md).

Para obtener una lista de todos sus trabajos de exportación de previsiones condicionales, utilice la operación [ListWhatIfForecastExports](API_ListWhatIfForecastExports.md).

**nota**  
El `Status` del trabajo de exportación de previsión debe estar `ACTIVE` antes de poder acceder a la previsión en su bucket de Amazon S3. Utilice la operación [DescribeWhatIfForecastExport](API_DescribeWhatIfForecastExport.md) para obtener el estado.

## Sintaxis de la solicitud
<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"
}
```

## Parámetros de la solicitud
<a name="API_CreateWhatIfForecastExport_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [Destination](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-request-Destination"></a>
La ubicación en la que desea guardar la previsión y una función AWS Identity and Access Management (IAM) que Amazon Forecast puede asumir para acceder a la ubicación. La previsión debe exportarse a un bucket de Amazon S3.  
Si se utiliza el cifrado, `Destination` debe incluir una clave AWS Key Management Service (KMS). El rol de IAM debe permitir a Amazon Forecast acceder a la clave.  
Tipo: objeto [DataDestination](API_DataDestination.md)  
Obligatorio: sí

 ** [Format](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-request-Format"></a>
El formato de los datos exportados, CSV o PARQUET.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 7.  
Patrón: `^CSV|PARQUET$`   
Obligatorio: no

 ** [Tags](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-request-Tags"></a>
Lista de [etiquetas](https://docs.aws.amazon.com/forecast/latest/dg/tagging-forecast-resources.html) que se aplican a la previsión condicional.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

 ** [WhatIfForecastArns](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-request-WhatIfForecastArns"></a>
La lista de nombres de recursos de Amazon (ARNs) con pronósticos hipotéticos que se van a exportar.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 50 artículos.  
Limitaciones de longitud: longitud máxima de 300.  
Patrón: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Obligatorio: sí

 ** [WhatIfForecastExportName](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-request-WhatIfForecastExportName"></a>
El nombre de la previsión condicional que exportar.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z][a-zA-Z0-9_]*`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_CreateWhatIfForecastExport_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_CreateWhatIfForecastExport_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [WhatIfForecastExportArn](#API_CreateWhatIfForecastExport_ResponseSyntax) **   <a name="forecast-CreateWhatIfForecastExport-response-WhatIfForecastExportArn"></a>
El nombre de recurso de Amazon (ARN) de la previsión condicional.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 300.  
Patrón: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

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

 ** InvalidInputException **   
No podemos procesar la solicitud porque incluye un valor no válido o un valor que supera el rango válido.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado el límite en el número de recursos por cuenta.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
Ya existe un recurso con este nombre. Inténtelo de nuevo con un nombre diferente.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No podemos encontrar un recurso con ese nombre de recurso de Amazon (ARN). Compruebe el ARN e inténtelo de nuevo.  
Código de estado HTTP: 400

## Véase también
<a name="API_CreateWhatIfForecastExport_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateWhatIfForecastExport)