CreateWhatIfForecastExport - Amazon Forecast

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

Exporta una previsión creada por la operación CreateWhatIfForecast 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).

Debe especificar un objeto DataDestination 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.

Para obtener más información, consulte Generación de previsiones.

Para obtener una lista de todos sus trabajos de exportación de previsiones condicionales, utilice la operación ListWhatIfForecastExports.

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 para obtener el estado.

Sintaxis de la solicitud

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

Parámetros de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

Destination

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

Obligatorio: sí

Format

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

Lista de etiquetas que se aplican a la previsión condicional.

Tipo: matriz de objetos Tag

Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.

Obligatorio: no

WhatIfForecastArns

La lista de nombres de recursos de Amazon (ARN) de previsiones condicionales que se debe 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

El nombre de la previsión condicional que exportar.

Tipo: string

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

{ "WhatIfForecastExportArn": "string" }

Elementos de respuesta

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

El servicio devuelve los datos siguientes en formato JSON.

WhatIfForecastExportArn

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

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

Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulte lo siguiente: