DescribeDatasetImportJob - Amazon Forecast

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

DescribeDatasetImportJob

Descreve um trabalho de importação de conjunto de dados criado usando a CreateDatasetImportJoboperação.

Além de listar os parâmetros fornecidos na solicitação CreateDatasetImportJob, essa operação inclui as seguintes propriedades:

  • CreationTime

  • LastModificationTime

  • DataSize

  • FieldStatistics

  • Status

  • Message: se ocorreu um erro, as informações sobre o erro.

Sintaxe da Solicitação

{ "DatasetImportJobArn": "string" }

Parâmetros da solicitação

A solicitação aceita os dados a seguir no formato JSON.

DatasetImportJobArn

O nome do recurso da Amazon (ARN) do trabalho de importação de conjunto de dados.

Tipo: string

Restrições de tamanho: o tamanho máximo é 256.

Padrão: arn:([a-z\d-]+):forecast:.*:.*:.+

Exigido: Sim

Sintaxe da Resposta

{ "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 Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

CreationTime

Quando o trabalho de importação de conjunto de dados foi criado.

Tipo: carimbo de data/hora

DatasetArn

O nome do recurso da Amazon (ARN) do conjunto de dados para o qual os dados de treinamento foram importados.

Tipo: string

Restrições de tamanho: o tamanho máximo é 256.

Padrão: arn:([a-z\d-]+):forecast:.*:.*:.+

DatasetImportJobArn

O ARN do trabalho de importação do conjunto de dados.

Tipo: string

Restrições de tamanho: o tamanho máximo é 256.

Padrão: arn:([a-z\d-]+):forecast:.*:.*:.+

DatasetImportJobName

O nome do trabalho de importação do conjunto de dados.

Tipo: string

Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 63.

Padrão: ^[a-zA-Z][a-zA-Z0-9_]*

DataSize

O tamanho do conjunto de dados em gigabytes (GB) após a conclusão do trabalho de importação.

Tipo: duplo

DataSource

A localização dos dados de treinamento a serem importados e uma função AWS Identity and Access Management (IAM) que a Amazon Forecast pode assumir para acessar os dados.

Se a criptografia for usada, DataSource inclua uma chave AWS Key Management Service (KMS).

Tipo: objeto DataSource

EstimatedTimeRemainingInMinutes

O tempo estimado restante em minutos para a conclusão do trabalho de treinamento do conjunto de dados.

Tipo: longo

FieldStatistics

Informações estatísticas sobre cada campo nos dados de entrada.

Tipo: string para o mapa de objeto Statistics.

Restrições de tamanho de chave: o tamanho máximo é 256.

Padrão da chave: ^[a-zA-Z0-9\_]+$

Format

O formato dos dados importados: CSV ou PARQUET.

Tipo: string

Restrições de Tamanho: O tamanho máximo é 7.

Padrão: ^CSV|PARQUET$

GeolocationFormat

O formato do atributo de geolocalização. Valores válidos: "LAT_LONG" e "CC_POSTALCODE".

Tipo: string

Restrições de tamanho: o tamanho máximo é 256.

Padrão: ^[a-zA-Z0-9_]+$

ImportMode

O modo de importação do trabalho de importação do conjunto de dados, COMPLETO ou INCREMENTAL.

Tipo: string

Valores Válidos: FULL | INCREMENTAL

LastModificationTime

A última vez que o recurso foi modificado. O carimbo de data e hora depende do status do trabalho:

  • CREATE_PENDING: o CreationTime.

  • CREATE_IN_PROGRESS: o carimbo de data e hora atual.

  • CREATE_STOPPING: o carimbo de data e hora atual.

  • CREATE_STOPPED: quando o trabalho parou.

  • ACTIVE ou CREATE_FAILED: quando o trabalho foi concluído ou falhou.

Tipo: Timestamp

Message

Se ocorreu um erro, uma mensagem informativa sobre o erro.

Tipo: string

Status

O status do trabalho de importação do conjunto de dados. Os estados são:

  • ACTIVE

  • CREATE_PENDING, CREATE_IN_PROGRESS, CREATE_FAILED

  • DELETE_PENDING, DELETE_IN_PROGRESS, DELETE_FAILED

  • CREATE_STOPPING, CREATE_STOPPED

Tipo: string

Restrições de tamanho: o tamanho máximo é 256.

TimestampFormat

O formato dos carimbos de data/hora no conjunto de dados. O formato que você especifica depende da DataFrequency especificada quando o conjunto de dados foi criado. Os formatos a seguir são compatíveis.

  • “aaaa-MM-dd”

    Para as seguintes frequências de dados: A, M, S e D

  • “aaaa-MM-dd HH:mm:ss”

    Para as seguintes frequências de dados: H, 30 min, 15 min e 1 min; e opcionalmente, para: A, M, S e D

Tipo: string

Restrições de tamanho: o tamanho máximo é 256.

Padrão: ^[a-zA-Z0-9\-\:\.\,\'\s]+$

TimeZone

O único fuso horário aplicado a cada item no conjunto de dados

Tipo: string

Restrições de tamanho: o tamanho máximo é 256.

Padrão: ^[a-zA-Z0-9\/\+\-\_]+$

UseGeolocationForTimeZone

Se TimeZone é derivado automaticamente do atributo de geolocalização.

Tipo: booliano

Erros

InvalidInputException

Não podemos processar a solicitação porque ela inclui um valor inválido ou um valor que excede o intervalo válido.

Código de Status HTTP: 400

ResourceNotFoundException

Não conseguimos encontrar um recurso com esse nome do recurso da Amazon (ARN). Verifique o ARN e tente novamente.

Código de Status HTTP: 400

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte: