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
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.
CreateForecastExportJob
Exporta una previsión creada por la operación CreateForecast 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>
donde el componente < ExportTimestamp > está en Java SimpleDateFormat (aaaa-mm-dd -mm-SSZTHH).
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
Debe especificar un DataDestination objeto que incluya una función AWS Identity and Access Management (IAM) 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, utilice la operación ListForecastExportJobs.
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 DescribeForecastExportJob para obtener el estado.
Sintaxis de la solicitud
{
"Destination": {
"S3Config": {
"KMSKeyArn": "string",
"Path": "string",
"RoleArn": "string"
}
},
"ForecastArn": "string",
"ForecastExportJobName": "string",
"Format": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}Parámetros de la solicitud
La solicitud acepta los siguientes datos en JSON formato.
- 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,
Destinationdebe incluir una clave AWS Key Management Service (KMS). El IAM rol debe permitir a Amazon Forecast acceder a la clave.Tipo: objeto DataDestination
Obligatorio: sí
- ForecastArn
-
El nombre del recurso de Amazon (ARN) de la previsión que quieres exportar.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón:
arn:([a-z\d-]+):forecast:.*:.*:.+Obligatorio: sí
- ForecastExportJobName
-
El nombre del trabajo de exportación de previsión.
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í
- Format
-
El formato de los datos exportados, CSV oPARQUET. El valor por defecto esCSV.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 7.
Patrón:
^CSV|PARQUET$Obligatorio: no
- Tags
-
Los metadatos opcionales que se aplican al trabajo de exportación de previsión para ayudarle a categorizarlas y organizarlas. Cada etiqueta está formada por una clave y un valor opcional, ambos definidos por el usuario.
Se aplican las siguientes restricciones básicas a las etiquetas:
-
Número máximo de etiquetas por recurso: 50.
-
Para cada recurso, cada clave de etiqueta debe ser única y solo puede tener un valor.
-
Longitud máxima de la clave: 128 caracteres Unicode en UTF -8.
-
Longitud máxima del valor: 256 caracteres Unicode en UTF -8.
-
Si se utiliza su esquema de etiquetado en múltiples servicios y recursos, recuerde que otros servicios pueden tener otras restricciones sobre caracteres permitidos. Los caracteres generalmente permitidos son: letras, números y espacios representables en UTF -8, y los siguientes caracteres: + - =. _:/@.
-
Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.
-
No utilice
aws:AWS:, ni ninguna combinación de mayúsculas o minúsculas como prefijo para las teclas, ya que está reservado para su uso. AWS Las claves de etiquetas que tienen este prefijo no se pueden editar ni eliminar. Los valores pueden tener este prefijo. Si el valor de una etiqueta tieneawscomo prefijo pero la clave no, Forecast la considera una etiqueta de usuario y se contabilizará en el límite de 50 etiquetas. Las etiquetas que tengan solo el prefijo de clave deawsno cuentan para el límite de etiquetas por recurso.
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
-
Sintaxis de la respuesta
{
"ForecastExportJobArn": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una HTTP respuesta de 200.
El servicio devuelve los siguientes datos en JSON formato.
- ForecastExportJobArn
-
El nombre del recurso de Amazon (ARN) del trabajo de exportación.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
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.
HTTPCódigo de estado: 400
- LimitExceededException
-
Se ha superado el límite en el número de recursos por cuenta.
HTTPCódigo de estado: 400
- ResourceAlreadyExistsException
-
Ya existe un recurso con este nombre. Inténtelo de nuevo con un nombre diferente.
HTTPCódigo de estado: 400
- ResourceInUseException
-
El recurso especificado está en uso.
HTTPCódigo de estado: 400
- ResourceNotFoundException
-
No podemos encontrar un recurso con ese nombre de recurso de Amazon (ARN). Compruebe la casilla ARN e inténtelo de nuevo.
HTTPCódigo de estado: 400
Véase también
Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
