DescribeDatasetImportJob - Amazon Forecast
Sintaxis de la solicitudParámetros de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

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.

DescribeDatasetImportJob

Describe un trabajo de importación de conjuntos de datos creado mediante la CreateDatasetImportJoboperación.

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

Además de enumerar los parámetros proporcionados en la solicitud CreateDatasetImportJob, esta operación incluye las siguientes propiedades:

  • CreationTime

  • LastModificationTime

  • DataSize

  • FieldStatistics

  • Status

  • Message: si se produjo un error, la información sobre el error.

Sintaxis de la solicitud

{
   "DatasetImportJobArn": "string"
}

Parámetros de la solicitud

La solicitud acepta los siguientes datos en JSON formato.

DatasetImportJobArn

El nombre del recurso de Amazon (ARN) del trabajo de importación del conjunto de datos.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256.

Patrón: arn:([a-z\d-]+):forecast:.*:.*:.+

Obligatorio: sí

Sintaxis de la respuesta

{
   "CreationTime": number,
   "DatasetArn": "string",
   "DatasetImportJobArn": "string",
   "DatasetImportJobName": "string",
   "DataSize": number,
   "DataSource": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "EstimatedTimeRemainingInMinutes": number,
   "FieldStatistics": { 
      "string" : { 
         "Avg": number,
         "Count": number,
         "CountDistinct": number,
         "CountDistinctLong": number,
         "CountLong": number,
         "CountNan": number,
         "CountNanLong": number,
         "CountNull": number,
         "CountNullLong": number,
         "Max": "string",
         "Min": "string",
         "Stddev": number
      }
   },
   "Format": "string",
   "GeolocationFormat": "string",
   "ImportMode": "string",
   "LastModificationTime": number,
   "Message": "string",
   "Status": "string",
   "TimestampFormat": "string",
   "TimeZone": "string",
   "UseGeolocationForTimeZone": boolean
}

Elementos de respuesta

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

El servicio devuelve los siguientes datos en JSON formato.

CreationTime

Cuando se creó el trabajo de importación del conjunto de datos.

Tipo: marca temporal

DatasetArn

El nombre del recurso de Amazon (ARN) del conjunto de datos al que se importaron los datos de entrenamiento.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256.

Patrón: arn:([a-z\d-]+):forecast:.*:.*:.+

DatasetImportJobArn

El ARN del trabajo de importación del conjunto de datos.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256.

Patrón: arn:([a-z\d-]+):forecast:.*:.*:.+

DatasetImportJobName

Nombre del trabajo de importación del conjunto de datos.

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

DataSize

El tamaño del conjunto de datos en gigabytes (GB) una vez finalizado el trabajo de importación.

Tipo: Doble

DataSource

La ubicación de los datos de entrenamiento que se van a importar y una función AWS Identity and Access Management (IAM) que Amazon Forecast puede asumir para acceder a los datos.

Si se utiliza el cifrado, DataSource incluye una clave AWS Key Management Service (KMS).

Tipo: objeto DataSource

EstimatedTimeRemainingInMinutes

El tiempo estimado que queda en minutos para que finalice el trabajo de importación del conjunto de datos.

Tipo: largo

FieldStatistics

Información estadística sobre cada campo de los datos de entrada.

Tipo: mapa de cadena a objeto Statistics.

Limitaciones de longitud de clave: longitud máxima de 256.

Patrón de clave: ^[a-zA-Z0-9\_]+$

Format

El formato de los datos importados, CSV oPARQUET.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 7.

Patrón: ^CSV|PARQUET$

GeolocationFormat

El formato del atributo de geolocalización. Valores válidos: "LAT_LONG" y "CC_POSTALCODE".

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256.

Patrón: ^[a-zA-Z0-9_]+$

ImportMode

El modo de importación del trabajo de importación del conjunto de datos, FULL oINCREMENTAL.

Tipo: cadena

Valores válidos: FULL | INCREMENTAL

LastModificationTime

La última vez que se modificó el recurso. La marca temporal depende del estado del trabajo:

  • CREATE_PENDING: la CreationTime.

  • CREATE_IN_PROGRESS: marca temporal actual.

  • CREATE_STOPPING: marca temporal actual.

  • CREATE_STOPPED: cuándo se detuvo el trabajo.

  • ACTIVE o CREATE_FAILED: cuando el trabajo terminó o falló.

Tipo: marca temporal

Message

Si se produjo un error, el mensaje informativo sobre el error.

Tipo: cadena

Status

El estado del trabajo de importación del conjunto de datos. Los estados incluyen:

  • ACTIVE

  • CREATE_PENDING, CREATE_IN_PROGRESS, CREATE_FAILED

  • DELETE_PENDING, DELETE_IN_PROGRESS, DELETE_FAILED

  • CREATE_STOPPING, CREATE_STOPPED

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256.

TimestampFormat

El formato de las marcas temporales del conjunto de datos. El formato que especifique depende de la DataFrequency especificada cuando se creó el conjunto de datos. Se admiten los siguientes formatos:

  • “aaaa-MM-dd”

    Para las siguientes frecuencias de datos: Y (anual), M (mensual), W (semanal) y D (diaria)

  • "aaaa-MM-dd HH:mm:ss"

    Para las siguientes frecuencias de datos: H, 30 minutos, 15 minutos y 1 minuto; y opcionalmente, para: Y, M, W y D

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256.

Patrón: ^[a-zA-Z0-9\-\:\.\,\'\s]+$

TimeZone

La zona horaria única que se aplica a todos los artículos del conjunto de datos

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256.

Patrón: ^[a-zA-Z0-9\/\+\-\_]+$

UseGeolocationForTimeZone

Si TimeZone se deriva automáticamente del atributo de geolocalización.

Tipo: Booleano

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

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: