工单状态修改 - UpdateTicket

功能介绍

变更单状态修改，请求路径中的ticket_type为固定值change，且ticket_id传递变更单单号。此接口可操作变更开始、变更结束、变更取消和添加变更结果操作。

调试

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

授权信息

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

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

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

URI

PUT /v1/{ticket_type}/tickets/{ticket_id}

请求参数

响应参数

状态码：200

状态码：400

请求示例

• 变更开始。

  PUT https://{Endpoint}/v1/change/tickets/CM202506261919380164485133
  
  {
    "history_info" : {
      "action" : "change_start_change_success"
    },
    "sub_tickets" : [ {
      "ticket_id" : "e72f9b49-2294-4c58-bc57-4a0c6903c5e1"
    } ]
  }

• 变更结束。

  PUT https://{Endpoint}/v1/change/tickets/CM202506261919380164485133
  
  {
    "history_info" : {
      "action" : "change_end_change_success"
    },
    "sub_tickets" : [ {
      "ticket_id" : "e72f9b49-2294-4c58-bc57-4a0c6903c5e1"
    } ]
  }

• 变更成功填写变更结果。

  PUT https://{Endpoint}/v1/change/tickets/CM202506261919380164485133
  
  {
    "sub_tickets" : [ {
      "ticket_id" : "e72f9b49-2294-4c58-bc57-4a0c6903c5e1",
      "sub_tickets" : [ ],
      "change_result" : "change_result_success",
      "is_verified_in_change_time" : true,
      "verified_docs" : null,
      "comment" : "变更成功"
    } ],
    "history_info" : {
      "action" : "change_set_change_result_success"
    }
  }

• 变更失败填写变更结果。

  PUT https://{Endpoint}/v1/change/tickets/CM202506261919380164485133
  
  {
    "sub_tickets" : [ {
      "ticket_id" : "80f198c6-14c0-4541-8e2d-1808bfcedf48",
      "sub_tickets" : [ ],
      "change_result" : "change_result_failed",
      "verified_docs" : null,
      "comment" : "变更失败了",
      "change_fail_type" : "fr_dependent_service_issue",
      "rollback_start_time" : null,
      "rollback_end_time" : null,
      "is_rollback_success" : true,
      "is_monitor_found" : false
    } ],
    "history_info" : {
      "action" : "change_set_change_result_success"
    }
  }

• 变更取消。

  PUT https://{Endpoint}/v1/change/tickets/CM202506261919380164485133
  
  {
    "history_info" : {
      "action" : "change_cancel_change_success"
    },
    "sub_tickets" : [ {
      "ticket_id" : "b0a966fa-5be7-40e4-bad0-a0749d6fac9c",
      "sub_tickets" : [ ],
      "change_result" : "change_result_cancel",
      "comment" : "取消变更"
    } ]
  }

响应示例

状态码：200

请求成功。

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

{
  "error_code" : "GOM.00000000",
  "error_msg" : null,
  "provider_code" : 4,
  "data" : {
    "ticket_info" : {
      "is_start_process_async" : true,
      "is_update_null" : false,
      "is_return_full_info" : false,
      "is_start_process" : true,
      "ticket_id" : "CM202506261919380164485133",
      "sub_tickets" : [ ],
      "enum_data_list" : [ ]
    },
    "history_info" : null
  }
}

状态码

错误码

请参见错误码。