

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

# DescribeJobRun
<a name="API_DescribeJobRun"></a>

表示 DataBrew 作业的一次运行。

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

```
GET /jobs/name/jobRun/runId HTTP/1.1
```

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

请求使用以下 URI 参数。

 ** [name](#API_DescribeJobRun_RequestSyntax) **   <a name="databrew-DescribeJobRun-request-uri-Name"></a>
在此运行期间正在处理的作业的名称。  
长度限制：最小长度为 1。最大长度为 240。  
是否必需：是

 ** [runId](#API_DescribeJobRun_RequestSyntax) **   <a name="databrew-DescribeJobRun-request-uri-RunId"></a>
作业运行的唯一标识符。  
长度约束：最小长度为 1。最大长度为 255。  
是否必需：是

## 请求体
<a name="API_DescribeJobRun_RequestBody"></a>

该请求没有请求正文。

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

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

{
   "Attempt": number,
   "CompletedOn": number,
   "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",
   "ErrorMessage": "string",
   "ExecutionTime": number,
   "JobName": "string",
   "JobSample": { 
      "Mode": "string",
      "Size": number
   },
   "LogGroupName": "string",
   "LogSubscription": "string",
   "Outputs": [ 
      { 
         "CompressionFormat": "string",
         "Format": "string",
         "FormatOptions": { 
            "Csv": { 
               "Delimiter": "string"
            }
         },
         "Location": { 
            "Bucket": "string",
            "BucketOwner": "string",
            "Key": "string"
         },
         "MaxOutputFiles": number,
         "Overwrite": boolean,
         "PartitionColumns": [ "string" ]
      }
   ],
   "ProfileConfiguration": { 
      "ColumnStatisticsConfigurations": [ 
         { 
            "Selectors": [ 
               { 
                  "Name": "string",
                  "Regex": "string"
               }
            ],
            "Statistics": { 
               "IncludedStatistics": [ "string" ],
               "Overrides": [ 
                  { 
                     "Parameters": { 
                        "string" : "string" 
                     },
                     "Statistic": "string"
                  }
               ]
            }
         }
      ],
      "DatasetStatisticsConfiguration": { 
         "IncludedStatistics": [ "string" ],
         "Overrides": [ 
            { 
               "Parameters": { 
                  "string" : "string" 
               },
               "Statistic": "string"
            }
         ]
      },
      "EntityDetectorConfiguration": { 
         "AllowedStatistics": [ 
            { 
               "Statistics": [ "string" ]
            }
         ],
         "EntityTypes": [ "string" ]
      },
      "ProfileColumns": [ 
         { 
            "Name": "string",
            "Regex": "string"
         }
      ]
   },
   "RecipeReference": { 
      "Name": "string",
      "RecipeVersion": "string"
   },
   "RunId": "string",
   "StartedBy": "string",
   "StartedOn": number,
   "State": "string",
   "ValidationConfigurations": [ 
      { 
         "RulesetArn": "string",
         "ValidationMode": "string"
      }
   ]
}
```

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

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

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

 ** [JobName](#API_DescribeJobRun_ResponseSyntax) **   <a name="databrew-DescribeJobRun-response-JobName"></a>
在此运行期间正在处理的作业的名称。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 240。

 ** [Attempt](#API_DescribeJobRun_ResponseSyntax) **   <a name="databrew-DescribeJobRun-response-Attempt"></a>
尝试运行作业 DataBrew 的次数。  
类型：整数

 ** [CompletedOn](#API_DescribeJobRun_ResponseSyntax) **   <a name="databrew-DescribeJobRun-response-CompletedOn"></a>
作业完成处理的日期和时间。  
类型：时间戳

 ** [DatabaseOutputs](#API_DescribeJobRun_ResponseSyntax) **   <a name="databrew-DescribeJobRun-response-DatabaseOutputs"></a>
表示 JDBC 数据库输出对象的列表，该对象定义了要写入的 DataBrew 配方作业的输出目标。  
类型：[DatabaseOutput](API_DatabaseOutput.md) 对象数组  
数组成员：最少 1 个物品。

 ** [DataCatalogOutputs](#API_DescribeJobRun_ResponseSyntax) **   <a name="databrew-DescribeJobRun-response-DataCatalogOutputs"></a>
一个或多个工件，表示运行作业的 AWS Glue Data Catalog 输出。  
类型：[DataCatalogOutput](API_DataCatalogOutput.md) 对象数组  
数组成员：最少 1 个物品。

 ** [DatasetName](#API_DescribeJobRun_ResponseSyntax) **   <a name="databrew-DescribeJobRun-response-DatasetName"></a>
作业处理的数据集的名称。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 255。

 ** [ErrorMessage](#API_DescribeJobRun_ResponseSyntax) **   <a name="databrew-DescribeJobRun-response-ErrorMessage"></a>
一条消息，指示作业运行时遇到的错误（如果有）。  
类型：字符串

 ** [ExecutionTime](#API_DescribeJobRun_ResponseSyntax) **   <a name="databrew-DescribeJobRun-response-ExecutionTime"></a>
作业运行使用资源的时间长度（以秒为单位）。  
类型：整数

 ** [JobSample](#API_DescribeJobRun_ResponseSyntax) **   <a name="databrew-DescribeJobRun-response-JobSample"></a>
仅配置文件作业的样本配置。确定要执行配置文件作业的行数。如果未提供 JobSample 值，则将使用默认值。模式参数的默认值为 CUSTOM\$1ROWS，大小参数的默认值为 20000。  
类型：[JobSample](API_JobSample.md) 对象

 ** [LogGroupName](#API_DescribeJobRun_ResponseSyntax) **   <a name="databrew-DescribeJobRun-response-LogGroupName"></a>
Amazon CloudWatch 日志组的名称，作业在运行时写入诊断消息。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 512。

 ** [LogSubscription](#API_DescribeJobRun_ResponseSyntax) **   <a name="databrew-DescribeJobRun-response-LogSubscription"></a>
Amazon CloudWatch 记录任务运行的当前状态。  
类型：字符串  
有效值：`ENABLE | DISABLE`

 ** [Outputs](#API_DescribeJobRun_ResponseSyntax) **   <a name="databrew-DescribeJobRun-response-Outputs"></a>
作业运行的一个或多个输出构件。  
类型：[Output](API_Output.md) 对象数组  
数组成员：最少 1 个物品。

 ** [ProfileConfiguration](#API_DescribeJobRun_ResponseSyntax) **   <a name="databrew-DescribeJobRun-response-ProfileConfiguration"></a>
配置文件作业的配置。用于选择列、进行评估并覆盖评估的默认参数。配置为 null 时，配置文件作业将使用默认设置运行。  
类型：[ProfileConfiguration](API_ProfileConfiguration.md) 对象

 ** [RecipeReference](#API_DescribeJobRun_ResponseSyntax) **   <a name="databrew-DescribeJobRun-response-RecipeReference"></a>
表示 DataBrew 配方的名称和版本。  
类型：[RecipeReference](API_RecipeReference.md) 对象

 ** [RunId](#API_DescribeJobRun_ResponseSyntax) **   <a name="databrew-DescribeJobRun-response-RunId"></a>
作业运行的唯一标识符。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 255。

 ** [StartedBy](#API_DescribeJobRun_ResponseSyntax) **   <a name="databrew-DescribeJobRun-response-StartedBy"></a>
启动作业运行的用户的 Amazon 资源名称（ARN）。  
类型：字符串

 ** [StartedOn](#API_DescribeJobRun_ResponseSyntax) **   <a name="databrew-DescribeJobRun-response-StartedOn"></a>
作业运行的开始日期和时间。  
类型：时间戳

 ** [State](#API_DescribeJobRun_ResponseSyntax) **   <a name="databrew-DescribeJobRun-response-State"></a>
作业运行实体本身的当前状态。  
类型：字符串  
有效值：`STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | TIMEOUT`

 ** [ValidationConfigurations](#API_DescribeJobRun_ResponseSyntax) **   <a name="databrew-DescribeJobRun-response-ValidationConfigurations"></a>
应用于配置文件作业的验证配置列表。  
类型：[ValidationConfiguration](API_ValidationConfiguration.md) 对象数组  
数组成员：最少 1 个物品。

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

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

 ** ResourceNotFoundException **   
无法找到一个或多个资源。  
HTTP 状态代码：404

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

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

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