# 更新变更单 - UpdateChange #### 功能介绍 更新变更单信息。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/COC/doc?api=UpdateChange)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-coc/coc_api_06.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | coc:ticket:update | Write | - | - | - | - | #### URI PUT /v2/changes/{change_id} 表1请求path参数 | 名称 | 类型 | 是否必选 | 描述 | |:---|:---|:---|:---| | change_id | String | 是 | **参数解释：** 变更单号。 **约束限制：** 字符串 **取值范围：** 字符长度1-50 **默认取值：** 不涉及 | #### 请求参数 表2请求body参数列表 | 名称 | 类型 | 是否必选 | 描述 | |:---|:---|:---|:---| | ticket_info | [TicketInfoObject] object | 否 | **参数解释：** 变更主单信息。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | sub_tickets | Arrays of [SubTicketInfoObject] | 否 | **参数解释：** 变更子单信息。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | history_info | [TicketHistoryInfoObject] object | 否 | **参数解释：** 变更历史信息。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表3TicketInfoObject属性： | 名称 | 类型 | 是否必选 | 描述 | |:---|:---|:---|:---| | phase | String | 否 | **参数解释：** 工单操作的类型，枚举值。 **约束限制：** 字符串，长度限制0-255 **取值范围：** 枚举值 - phase_change_end：完成 - phase_change_cancel：撤销 - phase_change_draft：草稿 - phase_change_implemente：变更实施和验证 - phase_change_apply：申请人确认 - phase_change_approve：审批中 - phase_change_close：关闭 **默认取值：** 不涉及 | | work_flow_status | String | 否 | **参数解释：** 工单状态。 **约束限制：** 字符串，长度限制0-255 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表4SubTicketInfoObject属性： | 名称 | 类型 | 是否必选 | 描述 | |:---|:---|:---|:---| | ticket_id | String | 否 | **参数解释：** 子单ID。 **约束限制：** 字符串，长度限制0-100 **取值范围：** 不涉及 **默认取值：** 不涉及 | | change_result | String | 否 | **参数解释：** 变更结果。 **约束限制：** 字符串，长度限制1-100 **取值范围：** 不涉及 **默认取值：** 不涉及 | | is_verified_in_change_time | Boolean | 否 | **参数解释：** 在时间窗内是否可验证。 **约束限制：** 不涉及 **取值范围：** true/false **默认取值：** 不涉及 | | verified_docs | String | 否 | **参数解释：** 验证文档ID。 **约束限制：** 字符串，长度限制0-1000 **取值范围：** 不涉及 **默认取值：** 不涉及 | | comment | String | 否 | **参数解释：** 变更失败原因描述。 **约束限制：** 字符串，长度限制0-100 **取值范围：** 不涉及 **默认取值：** 不涉及 | | change_fail_type | String | 否 | **参数解释：** 变更失败类型。 **约束限制：** 字符串，长度限制1-100 **取值范围：** 不涉及 **默认取值：** 不涉及 | | rollback_start_time | Long | 否 | **参数解释：** 回退开始时间。 **约束限制：** 不涉及 **取值范围：** 1-9999999999999 **默认取值：** 不涉及 | | rollback_end_time | Long | 否 | **参数解释：** 回退结束时间。 **约束限制：** 不涉及 **取值范围：** 1-9999999999999 **默认取值：** 不涉及 | | is_rollback_success | Boolean | 否 | **参数解释：** 是否回退成功。 **约束限制：** 不涉及 **取值范围：** true：回退成功 false：回退失败 **默认取值：** 不涉及 | | is_monitor_found | Boolean | 否 | **参数解释：** 是否被监控发现。 **约束限制：** 不涉及 **取值范围：** true：被监控发现 false：未被监控发现 **默认取值：** 不涉及 | 表5TicketHistoryInfoObject属性： | 名称 | 类型 | 是否必选 | 描述 | |:---|:---|:---|:---| | action | String | 否 | **参数解释：** 操作类型。 **约束限制：** 字符串，长度限制1-1000 **取值范围：** - change_start_change_success：变更开始 - change_end_change_success：变更结束 - change_set_change_result_success：添加变更结果 - change_complete_success：关单 **默认取值：** 不涉及 | #### 响应参数 状态码：200 表6响应Body参数列表 | 名称 | 类型 | 是否必选 | 描述 | |:---|:---|:---|:---| | provider_code | String | 否 | **参数解释：** 服务标识。 **取值范围：** 字符长度0-256 **默认取值：** 049 | | error_code | String | 否 | **参数解释：** 请求响应代码，范围：0000\~9999，正常时取值：0。 **取值范围：** 字符长度0-256 **默认取值：** 0 | | error_msg | String | 否 | **参数解释：** 请求响应描述。 **取值范围：** 字符长度0-256 **默认取值：** 不涉及 | #### 请求示例 - 变更结束。 ``` PUT https://{Endpoint}/v2/changes/{change_id} { "history_info": { "action": "change_end_change_success" }, "sub_tickets": [ { "ticket_id": " 92f0c22f-4ca4-4cbe-89cf-281aed331f50" } ] } ``` - 添加变更结果：在变更计划执行变更结束后执行。 ``` PUT https://{Endpoint}/v2/changes/{change_id} { "sub_tickets": [ { "ticket_id": "{{sub_ticket_id}}", "change_result": "change_result_failed", "verified_docs": null, "comment": "111", "change_fail_type": "fr_dependent_service_issue", "rollback_start_time": 1742888808000, "rollback_end_time": 1742975208000, "is_rollback_success": false, "is_monitor_found": true } ], "history_info": { "action": "change_set_change_result_success" } } ``` - 关单：在所有变更计划执行完成后执行。 ``` PUT https://{Endpoint}/v2/changes/{change_id} { "history_info": { "action": "change_complete_success" }, "ticket_info": { "phase": "phase_change_end", "work_flow_status": "COMPLETE" } } ``` #### 响应示例 **状态码：200** 请求成功。 更多状态码请参考[状态码](https://support.huaweicloud.com/api-coc/coc_api_05_03.html)。 ``` { "provider_code": "049", "error_code": "GOM.00000000", "error_msg": null } ``` **状态码：400** 服务器未能处理请求。 更多状态码请参考[状态码](https://support.huaweicloud.com/api-coc/coc_api_05_03.html)。 ``` { "error_code" : "GOM.00007256", "error_msg" : "参数错误", "provider_code" : "049", "data" : null } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 请求成功。 更多状态码请参考[状态码](https://support.huaweicloud.com/api-coc/coc_api_05_03.html)。 | | 400 | 服务器未能处理请求。 更多状态码请参考[状态码](https://support.huaweicloud.com/api-coc/coc_api_05_03.html)。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-coc/ErrorCode.html)。