终止作业-StopJob

功能介绍

在MRS集群中终止指定作业。

接口约束

无。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

• 如果使用角色与策略授权，具体权限要求请参见权限和受限项。
• 如果使用身份策略授权，需具备如下身份策略权限。

  授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
  mrs:cluster:stopJob	Write	cluster *	g:ResourceTag/<tag-key> g:EnterpriseProjectId	mrs:job:stop	-

URI

• URI格式

  POST /v2/{project_id}/clusters/{cluster_id}/job-executions/{job_execution_id}/kill

• 参数说明

  表1 URI参数说明

  名称	是否必选	参数类型	说明
  project_id	是	String	参数解释： 项目编号。获取方法，请参见获取项目ID。 约束限制： 不涉及 取值范围： 只能由英文字母和数字组成，且长度为[1-64]个字符。 默认取值： 不涉及
  cluster_id	是	String	参数解释： 集群ID。如果指定集群ID，则获取该集群做过补丁更新的最新版本元数据。获取方法，请参见获取集群ID。 约束限制： 不涉及 取值范围： 只能由英文字母、数字以及“_”和“-”组成，且长度为[1-64]个字符。 默认取值： 不涉及
  job_execution_id	是	String	参数解释： 作业ID。获取方法，请参见获取作业ID。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及

请求参数

无。

响应参数

无。

请求示例

终止作业请求示例

POST https://{endpoint}/v2/{project_id}/clusters/{cluster_id}/job-executions/{job_execution_id}/kill

响应示例

状态码： 400

在MRS集群中终止指定作业失败

{
  "error_msg" : "终止作业失败",
  "error_code" : "0175"
}

状态码

请参见状态码。

错误码

请参见错误码。