暂停任务
所有文档
menu

消息服务 for Kafka

暂停任务

产品详情立即开通

该接口用于暂停集群中已经启动的任务。

  • 目前支持的任务类型只有:REASSIGN_PARTITION(主题调整)。
  • 只有任务状态为RUNNING(执行中)的情况下才能够暂停任务。

请求结构

PUT /v{version}/clusters/{clusterId}/jobs/{jobId}/suspend HTTP/1.1
Host: kafka-api.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外,无其他特殊头域。

请求参数

参数名称 类型 是否必须 参数位置 描述
version String URL参数 API版本号
clusterId String URL参数 待暂停任务的集群ID
jobId String URL参数 待暂停的任务ID

返回头域

除公共头域外,无其他特殊头域。

返回参数

参数名称 类型 描述
jobId String 暂停成功的任务ID

错误码

错误码 错误描述 HTTP状态码 描述
ERROR_PARAMS 请求参数错误 400 请求参数错误
CLUSTER_NOT_FOUND 集群不存在 451 集群不存在
CLUSTER_HAD_DELETED 集群已删除 451 集群已删除
CLUSTER_NOT_BELONGED 未拥有该集群 451 未拥有该集群
CLUSTER_NOT_UPDATING 集群非变更中状态 451 集群非变更中状态
JOB_NOT_FOUND 找不到相关任务 451 找不到相关任务
JOB_STATE_NOT_RUNNING 非运行任务 451 非运行任务
INTERNAL_ERROR 服务内部错误 500 服务内部错误

请求示例

PUT http://kafka-api.bj.baidubce.com/v2/clusters/33a168bb70c0459787416077114ab233/jobs/7a866624b5f1954ef841569b4e3de5d1/suspend
Authorization: bce-auth-v1/ALTAKaiKeDfBD880eMWBE5oIGE/2023-05-08T11:43:45Z/1800/host;x-bce-date/322f3f98ce57d296c0f5abc64e5554b640ea035c5cb462fcaeab54b9810a3c61
Host: kafka-api.bj.baidubce.com

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 97e6d4ad-6fca-4609-ad4d-9a27c4d1a362
Date: Mon, 08 May 2023 09:39:11 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

{
    "jobId": "7a866624b5f1954ef841569b4e3de5d1"
}
上一篇
取消任务
下一篇
恢复任务