本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# ListJobs
<a name="API_ListJobs"></a>

列出所有已定义的 DataBrew 作业。

## 请求语法
<a name="API_ListJobs_RequestSyntax"></a>

```
GET /jobs?datasetName=DatasetName&maxResults=MaxResults&nextToken=NextToken&projectName=ProjectName HTTP/1.1
```

## URI 请求参数
<a name="API_ListJobs_RequestParameters"></a>

请求使用以下 URI 参数。

 ** [DatasetName](#API_ListJobs_RequestSyntax) **   <a name="databrew-ListJobs-request-uri-DatasetName"></a>
数据集的名称。使用此参数指示仅返回那些作用于指定数据集的作业。  
长度约束：最小长度为 1。最大长度为 255。

 ** [MaxResults](#API_ListJobs_RequestSyntax) **   <a name="databrew-ListJobs-request-uri-MaxResults"></a>
此请求中要返回的最大结果数。  
有效范围：最小值为 1。最大值为 100。

 ** [NextToken](#API_ListJobs_RequestSyntax) **   <a name="databrew-ListJobs-request-uri-NextToken"></a>
由生成的令牌 DataBrew ，用于指定在之前的请求被截断时在哪里继续分页。要获取下一组页面，请传入上一页调用的响应对象中的 NextToken值。  
长度限制：最小长度为 1。最大长度为 2000。

 ** [ProjectName](#API_ListJobs_RequestSyntax) **   <a name="databrew-ListJobs-request-uri-ProjectName"></a>
项目的名称。使用此参数指示仅返回那些与指定项目关联的作业。  
长度约束：最小长度为 1。最大长度为 255。

## 请求正文
<a name="API_ListJobs_RequestBody"></a>

该请求没有请求正文。

## 响应语法
<a name="API_ListJobs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Jobs": [ 
      { 
         "AccountId": "string",
         "CreateDate": number,
         "CreatedBy": "string",
         "DatabaseOutputs": [ 
            { 
               "DatabaseOptions": { 
                  "TableName": "string",
                  "TempDirectory": { 
                     "Bucket": "string",
                     "BucketOwner": "string",
                     "Key": "string"
                  }
               },
               "DatabaseOutputMode": "string",
               "GlueConnectionName": "string"
            }
         ],
         "DataCatalogOutputs": [ 
            { 
               "CatalogId": "string",
               "DatabaseName": "string",
               "DatabaseOptions": { 
                  "TableName": "string",
                  "TempDirectory": { 
                     "Bucket": "string",
                     "BucketOwner": "string",
                     "Key": "string"
                  }
               },
               "Overwrite": boolean,
               "S3Options": { 
                  "Location": { 
                     "Bucket": "string",
                     "BucketOwner": "string",
                     "Key": "string"
                  }
               },
               "TableName": "string"
            }
         ],
         "DatasetName": "string",
         "EncryptionKeyArn": "string",
         "EncryptionMode": "string",
         "JobSample": { 
            "Mode": "string",
            "Size": number
         },
         "LastModifiedBy": "string",
         "LastModifiedDate": number,
         "LogSubscription": "string",
         "MaxCapacity": number,
         "MaxRetries": number,
         "Name": "string",
         "Outputs": [ 
            { 
               "CompressionFormat": "string",
               "Format": "string",
               "FormatOptions": { 
                  "Csv": { 
                     "Delimiter": "string"
                  }
               },
               "Location": { 
                  "Bucket": "string",
                  "BucketOwner": "string",
                  "Key": "string"
               },
               "MaxOutputFiles": number,
               "Overwrite": boolean,
               "PartitionColumns": [ "string" ]
            }
         ],
         "ProjectName": "string",
         "RecipeReference": { 
            "Name": "string",
            "RecipeVersion": "string"
         },
         "ResourceArn": "string",
         "RoleArn": "string",
         "Tags": { 
            "string" : "string" 
         },
         "Timeout": number,
         "Type": "string",
         "ValidationConfigurations": [ 
            { 
               "RulesetArn": "string",
               "ValidationMode": "string"
            }
         ]
      }
   ],
   "NextToken": "string"
}
```

## 响应元素
<a name="API_ListJobs_ResponseElements"></a>

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

 ** [Jobs](#API_ListJobs_ResponseSyntax) **   <a name="databrew-ListJobs-response-Jobs"></a>
已定义的作业列表。  
类型：[Job](API_Job.md) 对象数组

 ** [NextToken](#API_ListJobs_ResponseSyntax) **   <a name="databrew-ListJobs-response-NextToken"></a>
可在后续调用中用于检索下一组结果的令牌。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 2000。

## 错误
<a name="API_ListJobs_Errors"></a>

有关所有操作的常见错误的信息，请参阅[常见错误](CommonErrors.md)。

 ** ValidationException **   
此请求的输入参数验证失败。  
HTTP 状态代码：400

## 另请参阅
<a name="API_ListJobs_SeeAlso"></a>

有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+  [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/databrew-2017-07-25/ListJobs) 
+  [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/databrew-2017-07-25/ListJobs) 
+  [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/databrew-2017-07-25/ListJobs) 
+  [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/databrew-2017-07-25/ListJobs) 
+  [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/databrew-2017-07-25/ListJobs) 
+  [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/databrew-2017-07-25/ListJobs) 
+  [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/databrew-2017-07-25/ListJobs) 
+  [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/databrew-2017-07-25/ListJobs) 
+  [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/databrew-2017-07-25/ListJobs) 
+  [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/databrew-2017-07-25/ListJobs)