启动任务
所有文档
menu

消息服务 for Kafka

启动任务

产品详情立即开通

该接口用于启动集群中的任务。

  • 目前支持的任务类型只有:REASSIGN_PARTITION(主题调整)。

请求结构

PUT /v{version}/clusters/{clusterId}/jobs/{jobId}/start 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_PRE_UPDATING 集群非待变更状态 451 集群非待变更状态
JOB_NOT_FOUND 找不到相关任务 451 找不到相关任务
JOB_STATE_NOT_NEW 非待执行任务 451 非待执行任务
INTERNAL_ERROR 服务内部错误 500 服务内部错误

请求示例

PUT http://kafka-api.bj.baidubce.com/v2/clusters/33a168bb70c0459787416077114ab233/jobs/c4636f6efb5a056b48a2abe97e6c3ee2/start
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": "c4636f6efb5a056b48a2abe97e6c3ee2"
}
上一篇
集群管理接口
下一篇
取消任务