文档首页/ 云运维中心 COC/ API参考/ API/ 故障管理/ 问题单管理/ 工单操作 - ExecuteTicketAction

更新时间：2025-10-23 GMT+08:00

查看PDF

工单操作 - ExecuteTicketAction

功能介绍

变更单审批、撤销以及问题单的所有操作均通过此接口完成。

调试

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

授权信息

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

如果使用角色与策略授权，具体权限要求请参见权限和授权项。

如果使用身份策略授权，需具备如下身份策略权限。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
coc:ticket:action	Write	-	-	-	-

URI

POST /v1/{ticket_type}/actions

表1 路径参数
参数	是否必选	参数类型	描述
ticket_type	是	String	参数解释：需要操作的工单类型，如需对变更单进行审批或者撤销传值change，如需对问题单进行操作传值issues_mgmt。约束限制：字符串 1 - 255字符取值范围：枚举值： change issues_mgmt 默认取值：不涉及最小长度：1 最大长度：255

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
user_id	否	String	参数解释：执行当前操作的用户ID，该字段可不传递，用户信息已通过认证信息中获取。约束限制：字符串 1 - 255字符取值范围：不涉及默认取值：不涉及最小长度：0 最大长度：100000000
ticket_id	否	String	参数解释：需要操作的工单单号。约束限制：字符串 1 - 255字符取值范围：不涉及默认取值：不涉及最小长度：0 最大长度：100000000
task_id	否	String	参数解释：当前进行的操作对应的任务ID。约束限制：字符串 1 - 255字符取值范围：不涉及默认取值：不涉及最小长度：0 最大长度：100000000
action	否	String	参数解释：需要执行操作的动作信息。约束限制：字符串 1 - 255字符取值范围：枚举值 gocm_issues_accepte：问题单受理 ugrading_and_downgrading：问题单升降级 being_handled_initiate_suspend：问题单挂起 agreed：问题单挂起审批通过或者变更单审批通过 rejected：变更单审批驳回 suspend_resume：问题单恢复挂起 gocm_issues_handling_forwarding：问题单转发责任人 gocm_issues_unaccepted_reject：问题单驳回 gocm_issues_undo_create：问题单撤销 submitting_question：问题单提交解决方案 cancel_process_action：变更单撤销 submitting_question：问题单提交解决方案默认取值：不涉及最小长度：0 最大长度：100000000
params	否	Object	参数解释：执行该操作具体的动作信息，以Json对象的方式进行传参，用于对当前执行动作的信息补充，无固定参数限制，具体不同操作需要传递的Json形式可参考请求示例。约束限制： Json对象的Key最多1024个取值范围：不涉及默认取值：不涉及最小长度：0 最大长度：1024

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
provider_code	String	参数解释：服务标识。取值范围：不涉及默认取值： 049 缺省值：049 最小长度：3 最大长度：100000000
error_code	String	参数解释：请求响应代码。取值范围： GOM.00000000~GOM.00009999999 默认取值： GOM.00000000 缺省值：GOM.00000000 最小长度：1 最大长度：15
error_msg	String	参数解释：请求响应描述。取值范围：不涉及最小长度：0 最大长度：100000000

状态码：400

表4 响应Body参数
参数	参数类型	描述
provider_code	String	参数解释：服务标识。取值范围：不涉及默认取值： 049 缺省值：049 最小长度：3 最大长度：100000000
error_code	String	参数解释：请求响应代码。取值范围： GOM.00000000~GOM.00009999999 默认取值： GOM.00000000 缺省值：GOM.00000000 最小长度：1 最大长度：15
error_msg	String	参数解释：请求响应描述。取值范围：不涉及最小长度：0 最大长度：100000000

请求示例

问题单受理。

POST https://{Endpoint}/v1/issues_mgmt/actions

{
  "ticket_id" : "ISU20250704160617014971439",
  "task_id" : "19410458913044643854408",
  "action" : "gocm_issues_accepte",
  "params" : { }
}

问题单升降级。

POST https://{Endpoint}/v1/issues_mgmt/actions

{
  "ticket_id" : "ISU20250704160617014971439",
  "task_id" : "19410463279482880024408",
  "action" : "ugrading_and_downgrading",
  "params" : {
    "up_down_updated_level" : "issues_level_3000",
    "up_down_grade_reason_comment" : "升降级说明信息。",
    "level" : "issues_level_4000"
  }
}

问题单挂起。

POST https://{Endpoint}/v1/issues_mgmt/actions

{
  "ticket_id" : "ISU20250704160617014971439",
  "task_id" : "19410468838026199064408",
  "action" : "being_handled_initiate_suspend",
  "params" : {
    "estimated_recovery_time" : 1751703023000,
    "suspend_description" : "test"
  }
}

问题单挂起审批通过。

POST https://{Endpoint}/v1/issues_mgmt/actions

{
  "ticket_id" : "ISU20250704161412012423624",
  "task_id" : "19410479307889786894408",
  "action" : "agreed",
  "params" : {
    "conclusion" : true,
    "approve_note" : "ok"
  }
}

问题单恢复挂起。

POST https://{Endpoint}/v1/issues_mgmt/actions

{
  "ticket_id" : "ISU20250704160617014971439",
  "task_id" : "19410469440202424334408",
  "action" : "suspend_resume",
  "params" : { }
}

问题单转发责任人。

POST https://{Endpoint}/v1/issues_mgmt/actions

{
  "ticket_id" : "ISU20250704160617014971439",
  "task_id" : "19410470423766712334408",
  "action" : "gocm_issues_handling_forwarding",
  "params" : {
    "explain" : "test",
    "forwarding_assigne" : "0ca5c3ca8d664abc832f6126a2d554d4",
    "virtual_schedule_type" : "issues_mgmt_virtual_schedule_type_2000"
  }
}

问题单驳回。

POST https://{Endpoint}/v1/issues_mgmt/actions

{
  "ticket_id" : "ISU20250704161237013947643",
  "task_id" : "19410474849428520974408",
  "action" : "gocm_issues_unaccepted_reject",
  "params" : {
    "unaccepted_rejection_description" : "驳回"
  }
}

问题单撤销。

POST https://{Endpoint}/v1/issues_mgmt/actions

{
  "ticket_id" : "ISU20250704161237013947643",
  "task_id" : "19410475647101255694408",
  "action" : "gocm_issues_undo_create",
  "params" : {
    "revocation_reason" : "cancel reason."
  }
}

问题单提交解决方案无需变更。

POST https://{Endpoint}/v1/issues_mgmt/actions

{
  "ticket_id" : "ISU20250704161412012423624",
  "task_id" : "19410480590801551384408",
  "action" : "submitting_question",
  "params" : {
    "root_cause_cloud_service" : "653f911cfab10c5b1dd33c3a",
    "is_common_issue" : false,
    "issue_version" : "",
    "regions" : "xxx",
    "root_cause_type" : "issues_root_cause_type_1000",
    "root_cause_comment" : "root cause.",
    "solution" : "solution",
    "is_need_change" : false,
    "sub_tickets" : [ {
      "affected_region" : "xxx",
      "target_type" : "regions",
      "target_value" : "xxx"
    } ]
  }
}

变更单撤销。

POST https://{Endpoint}/v1/change/actions

{
  "ticket_id" : "CM202507071541550199864932",
  "task_id" : "19421269243965276188310",
  "action" : "cancel_process_action",
  "params" : {
    "comment" : "reason for cancel"
  }
}

变更单审批驳回。

POST https://{Endpoint}/v1/change/actions

{
  "ticket_id" : "CM202504241549510199912413",
  "task_id" : "19153128494392852491549",
  "action" : "rejected",
  "params" : {
    "comment" : "审批驳回"
  }
}

问题单审批通过。

POST https://{Endpoint}/v1/change/actions

{
  "ticket_id" : "CM202505261606470132568015",
  "task_id" : "19269128923875287077915",
  "action" : "agreed",
  "params" : {
    "comment" : "审批通过"
  }
}

响应示例

状态码：200

请求成功。

更多状态码请参考状态码。

{
  "error_code" : "GOM.00000000",
  "error_msg" : null,
  "provider_code" : 4
}

状态码：400

服务器未能处理请求。

更多状态码请参考状态码。

{
  "error_code" : "GOM.00007256",
  "error_msg" : "参数错误",
  "provider_code" : 4,
  "data" : null
}

状态码

状态码	描述
200	请求成功。更多状态码请参考状态码。
400	服务器未能处理请求。更多状态码请参考状态码。

描述

200

请求成功。

更多状态码请参考状态码。

400

服务器未能处理请求。

更多状态码请参考状态码。

错误码

请参见错误码。

父主题： 问题单管理

上一篇：查询问题单工单详情信息 - ShowTicketInfo

下一篇：获取工单历史记录 - ListTicketOperationHistories

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问

工单操作 - ExecuteTicketAction

功能介绍

调试

授权信息

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

文档内容是否对您有帮助？