DescribeJobRun - Amazon Glue DataBrew
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

DescribeJobRun

表示运行一次 DataBrew 作业。

请求语法

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

URI 请求参数

请求使用以下 URI 参数。

name

在此运行期间正在处理的作业的名称。

长度限制:长度下限为 1。最大长度为 240。

必需:是

runId

作业运行的唯一标识符。

长度限制:长度下限为 1。最大长度为 255。

必需:是

请求体

该请求没有请求正文。

响应语法

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" } ] }

响应元素

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

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

JobName

在此运行期间正在处理的作业的名称。

类型:字符串

长度限制:长度下限为 1。最大长度为 240。

Attempt

DataBrew 已经尝试运行作业的次数。

类型:整数

CompletedOn

作业完成处理的日期和时间。

类型:时间戳

DatabaseOutputs

表示一个 JDBC 数据库输出对象列表,它定义了要写入 DataBrew 食谱作业的输出目标。

类型:DatabaseOutput 对象数组

数组成员:最少 1 个物品。

DataCatalogOutputs

代表作业运行时 Amazon Glue Data Catalog 输出的一个或多个构件。

类型:DataCatalogOutput 对象数组

数组成员:最少 1 个物品。

DatasetName

作业处理的数据集的名称。

类型:字符串

长度限制:长度下限为 1。最大长度为 255。

ErrorMessage

一条消息,指示作业运行时遇到的错误(如果有)。

类型:字符串

ExecutionTime

作业运行使用资源的时间长度(以秒为单位)。

类型:整数

JobSample

仅配置文件作业的样本配置。确定要执行配置文件作业的行数。如果未提供 JobSample 值,则使用默认值。模式参数的默认值为 CUSTOM_ROWS,大小参数的默认值为 20000。

类型:JobSample 对象

LogGroupName

Amazon CloudWatch 日志组的名称,作业在运行时将诊断消息写入其中。

类型:字符串

长度限制:长度下限为 1。最大长度为 512。

LogSubscription

作业运行的 Amazon CloudWatch 日志记录的当前状态。

类型:字符串

有效值:ENABLE | DISABLE

Outputs

作业运行的一个或多个输出构件。

类型:Output 对象数组

数组成员:最少 1 个物品。

ProfileConfiguration

配置文件作业的配置。用于选择列、进行评估并覆盖评估的默认参数。配置为 null 时,配置文件作业将使用默认设置运行。

类型:ProfileConfiguration 对象

RecipeReference

表示 DataBrew 配方的名称和版本。

类型:RecipeReference 对象

RunId

作业运行的唯一标识符。

类型:字符串

长度限制:长度下限为 1。最大长度为 255。

StartedBy

启动作业运行的用户的 Amazon 资源名称(ARN)。

类型:字符串

StartedOn

作业运行的开始日期和时间。

类型:时间戳

State

作业运行实体本身的当前状态。

类型:字符串

有效值:STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | TIMEOUT

ValidationConfigurations

应用于配置文件作业的验证配置列表。

类型:ValidationConfiguration 对象数组

数组成员:最少 1 个物品。

错误

有关所有操作的常见错误的信息,请参阅常见错误

ResourceNotFoundException

无法找到一个或多个资源。

HTTP 状态代码:404

ValidationException

此请求的输入参数验证失败。

HTTP 状态代码:400

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: