文档首页/ 云运维中心 COC/ API参考/ API/ 故障管理/ 故障诊断/ 提交诊断任务 - CreateDiagnosisTask
更新时间:2025-10-24 GMT+08:00
分享

提交诊断任务 - CreateDiagnosisTask

功能介绍

提交实例诊断任务,任务提交后后台异步执行。

调试

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

授权信息

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

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

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    coc:job:action

    Write

    job *

    -

    -

    -

    -

    coc:JobType

URI

POST /v1/diagnosis/tasks

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

resource_ids

Array of strings

参数解释:

待诊断的实例ID。

约束限制:

请选择应用资源管理页面中存在的资源ID。

取值范围:

不涉及。

默认取值:

不涉及。

type

String

参数解释:

被诊断实例的类型。

约束限制:

不涉及。

取值范围:

  • ECS

  • RDS

  • DCS

  • DMS

  • ELB

默认取值:

不涉及。

extra_properties

Array of strings

参数解释:

适用于RDS、DMS、DCS、ELB等的额外参数。

约束限制:

应按照JSON字符串格式组织,数组长度应与提交实例数组长度一致。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

请参考错误码章节。

error_msg

String

参数解释:

错误信息。

取值范围:

请参考错误码章节。

id

String

参数解释:

诊断工单ID。

取值范围:

不涉及。

状态码:400

表3 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

请参考错误码章节。

error_msg

String

参数解释:

错误信息。

取值范围:

请参考错误码章节。

状态码:500

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

请参考错误码章节。

error_msg

String

参数解释:

错误信息。

取值范围:

请参考错误码章节。

请求示例

  • 提交RDS诊断任务

    POST https://{Endpoint}/v1/diagnosis/tasks
    
    {
      "resource_ids" : [ "rds_resource_id1", "rds_resource_id2" ],
      "type" : "RDS",
      "extra_properties" : [ "{\"engine_name\": \"mysql\"}", "{\"engine_name\": \"gaussdb\"}" ]
    }
  • 提交DCS诊断任务

    POST https://{Endpoint}/v1/diagnosis/tasks
    
    {
      "resource_ids" : [ "dcs_resource_id1", "dcs_resource_id2" ],
      "type" : "DCS",
      "extra_properties" : [ "{\"begin_time\":1751012899168,\"end_time\":1751013499168,\"node_ip_list\":[\"xx.xx.xx.xx\"]}", "{\"begin_time\":1751012299000,\"end_time\":1751012899000,\"node_ip_list\":[\"xx.xx.xx.xx\"]}" ]
    }
  • 提交DMS诊断任务

    POST https://{Endpoint}/v1/diagnosis/tasks
    
    {
      "resource_ids" : [ "dms_resource_id1", "dms_resource_id2" ],
      "type" : "DMS",
      "extra_properties" : [ "{\"group_name\":\"dms_resource_group_1\",\"topic_name\":\"dms_resource_group_1_topic_1\"}", "{\"group_name\":\"dms_resource_group_2\",\"topic_name\":\"dms_resource_group_2_topic_2\"}" ]
    }
  • 提交ELB诊断任务

    POST https://{Endpoint}/v1/diagnosis/tasks
    
    {
      "resource_ids" : [ "elb_resource_id1", "elb_resource_id2" ],
      "type" : "ELB",
      "extra_properties" : [ "{\"member_id\":\"elb_member_1_id\",\"label\":\"elb_member_1_label\"}", "{\"member_id\":\"elb_member_2_id\",\"label\":\"elb_member_2_label\"}" ]
    }

响应示例

状态码:200

请求成功。

{
  "id" : "DIAyyyyMMddHHmmss123456789"
}

状态码

状态码

描述

200

请求成功。

400

客户端请求错误。

500

服务端请求错误。

错误码

请参见错误码

相关文档