ListDatasetImportJobs - Amazon Forecast

O Amazon Forecast não está mais disponível para novos clientes. Os clientes existentes do Amazon Forecast podem continuar usando o serviço normalmente. Saiba mais

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á.

ListDatasetImportJobs

Retorna uma lista de trabalhos de importação de conjuntos de dados criados usando a CreateDatasetImportJoboperação. Para cada trabalho de importação, essa operação exibe um resumo das propriedades, incluindo o nome do recurso da Amazon (ARN). Você pode recuperar o conjunto completo de propriedades usando o ARN com DescribeDatasetImportJoba operação. É possível filtrar a lista fornecendo uma matriz de objetos de filtro.

Sintaxe da Solicitação

{ "Filters": [ { "Condition": "string", "Key": "string", "Value": "string" } ], "MaxResults": number, "NextToken": "string" }

Parâmetros da solicitação

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

Filters

Uma matriz de filtros. Para cada filtro, são fornecidas uma condição e uma declaração de correspondência. A condição é IS ou IS_NOT, que especifica se os conjuntos de dados correspondentes à declaração devem ser incluídos ou excluídos da lista, respectivamente. A declaração de correspondência consiste em uma chave e um valor.

Propriedades do filtro

  • Condition: a condição a ser aplicada. Os valores válidos são IS e IS_NOT. Para incluir os conjuntos de dados correspondentes à declaração, especifique IS. Para excluir conjuntos de dados correspondentes, especifique IS_NOT.

  • Key: o nome do parâmetro a ser filtrado. Os valores válidos são DatasetArn e Status.

  • Value: o valor a ser comparado.

Por exemplo, para listar todos os trabalhos de importação de conjuntos de dados cujo status é ATIVO, você vai especificar o seguinte filtro:

"Filters": [ { "Condition": "IS", "Key": "Status", "Value": "ACTIVE" } ]

Tipo: matriz de objetos Filter

Obrigatório: não

MaxResults

O número de itens a serem exibidos na resposta.

Tipo: inteiro

Faixa válida: valor mínimo de 1. Valor máximo de 100.

Obrigatório: não

NextToken

Se o resultado da solicitação anterior estava truncado, a resposta incluirá um NextToken. Para recuperar o próximo conjunto de resultados, use o token na próxima solicitação. Os tokens expiram após 24 horas.

Tipo: string

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

Padrão: .+

Obrigatório: Não

Sintaxe da Resposta

{ "DatasetImportJobs": [ { "CreationTime": number, "DatasetImportJobArn": "string", "DatasetImportJobName": "string", "DataSource": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "ImportMode": "string", "LastModificationTime": number, "Message": "string", "Status": "string" } ], "NextToken": "string" }

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.

DatasetImportJobs

Uma matriz de objetos que resumem as propriedades de cada trabalho de importação de conjuntos de dados.

Tipo: matriz de objetos DatasetImportJobSummary

NextToken

Se a resposta estiver truncada, o Amazon Forecast vai gerar esse token. Para recuperar o próximo conjunto de resultados, use o token na próxima solicitação.

Tipo: string

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

Padrão: .+

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

InvalidNextTokenException

O token não é válido. Os tokens expiram após 24 horas.

Código de Status HTTP: 400

Consulte Também

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: