

 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](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

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
<a name="API_ListDatasetImportJobs"></a>

Retorna uma lista de trabalhos de importação de conjuntos de dados criados usando a [CreateDatasetImportJob](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetImportJob.html)operaçã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 [DescribeDatasetImportJob](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDatasetImportJob.html)a operação. É possível filtrar a lista fornecendo uma matriz de objetos de [filtro](https://docs.aws.amazon.com/forecast/latest/dg/API_Filter.html).

## Sintaxe da solicitação
<a name="API_ListDatasetImportJobs_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_ListDatasetImportJobs_RequestParameters"></a>

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

 ** [Filters](#API_ListDatasetImportJobs_RequestSyntax) **   <a name="forecast-ListDatasetImportJobs-request-Filters"></a>
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](API_Filter.md)  
Obrigatório: não

 ** [MaxResults](#API_ListDatasetImportJobs_RequestSyntax) **   <a name="forecast-ListDatasetImportJobs-request-MaxResults"></a>
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](#API_ListDatasetImportJobs_RequestSyntax) **   <a name="forecast-ListDatasetImportJobs-request-NextToken"></a>
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
<a name="API_ListDatasetImportJobs_ResponseSyntax"></a>

```
{
   "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
<a name="API_ListDatasetImportJobs_ResponseElements"></a>

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](#API_ListDatasetImportJobs_ResponseSyntax) **   <a name="forecast-ListDatasetImportJobs-response-DatasetImportJobs"></a>
Uma matriz de objetos que resumem as propriedades de cada trabalho de importação de conjuntos de dados.  
Tipo: matriz de objetos [DatasetImportJobSummary](API_DatasetImportJobSummary.md)

 ** [NextToken](#API_ListDatasetImportJobs_ResponseSyntax) **   <a name="forecast-ListDatasetImportJobs-response-NextToken"></a>
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
<a name="API_ListDatasetImportJobs_Errors"></a>

 ** 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
<a name="API_ListDatasetImportJobs_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListDatasetImportJobs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListDatasetImportJobs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListDatasetImportJobs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListDatasetImportJobs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListDatasetImportJobs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListDatasetImportJobs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListDatasetImportJobs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListDatasetImportJobs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListDatasetImportJobs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListDatasetImportJobs) 