# 搜索资源变更工单子单 - ListSubTickets #### 功能介绍 根据条件搜索资源变更工单子单，该接口只针对托管中心页签下资源变更单进行子单搜索。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/COC/doc?api=ListSubTickets)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-coc/coc_api_06.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | coc:ticket:list | List | - | - | - | - | #### URI GET /v1/{ticket_type}/tickets/{ticket_id}/list-sub-tickets 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | ticket_type | 是 | String | **参数解释：** 工单类型，此处传固定值hosting_change_tenant，表示搜索资源类型变更单子单。 **约束限制：** 不涉及 **取值范围：** hosting_change_tenant **默认取值：** 不涉及 | | ticket_id | 是 | String | **参数解释：** 变更单工单id。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | type | 是 | String | **参数解释：** 资源类型。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | limit | 否 | Long | **参数解释：** 每页显示的条数。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | marker | 否 | String | **参数解释：** 上一页数据的最后一条记录的id。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 请求参数 无 #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | provider_code | String | **参数解释：** 服务标识。 **取值范围：** 不涉及 **默认取值：** 049 | | error_code | String | **参数解释：** 请求响应代码。 **取值范围：** GOM.00000000\~GOM.00009999999 **默认取值：** GOM.00000000 | | error_msg | String | **参数解释：** 请求响应描述。 **取值范围：** 不涉及 | | data | [data] object | **参数解释：** 搜索到的工单子单信息。 **约束限制：** 不涉及 | 表4data | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Long | **参数解释：** 搜索到的工单子单数量。 **约束限制：** 不涉及 | | tickets | Array of [SubTicketListInfo] objects | **参数解释：** 搜索结果，工单详情。 **约束限制：** 不涉及 | 表5SubTicketListInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | ep_id | String | **参数解释：** 企业项目ID。 **约束限制：** 不涉及 | | resource_id | String | **参数解释：** 资源ID。 **约束限制：** 不涉及 | | type | String | **参数解释：** 资源类型。 **约束限制：** 不涉及 | | name | String | **参数解释：** 资源名称。 **约束限制：** 不涉及 | | provider | String | **参数解释：** 资源类型。 **约束限制：** 不涉及 | | domain_id | String | **参数解释：** 租户ID。 **约束限制：** 不涉及 | | region_id | String | **参数解释：** Region信息。 **约束限制：** 不涉及 | | hosting_id | String | **参数解释：** 主机ID。 **约束限制：** 不涉及 | | properties_json | String | **参数解释：** 资源属性信息。 **约束限制：** 不涉及 | | tags_json | String | **参数解释：** 资源标签信息。 **约束限制：** 不涉及 | | is_deleted | Boolean | **参数解释：** 变更工单是否已删除。 **约束限制：** 不涉及 | | id | String | **参数解释：** 变更工单ID。 **约束限制：** 不涉及 | | main_ticket_id | String | **参数解释：** 变更工单主键ID。 **约束限制：** 不涉及 | | parent_ticket_id | String | **参数解释：** 父级工单ID。 **约束限制：** 不涉及 | | ticket_id | String | **参数解释：** 变更单工单ID。 **约束限制：** 不涉及 | | real_ticket_id | String | **参数解释：** 变更单单号。 **约束限制：** 不涉及 | | ticket_path | String | **参数解释：** 变更单工单路径。 **约束限制：** 不涉及 | | target_value | String | **参数解释：** 变更单子单region信息。 **约束限制：** 不涉及 | | target_type | String | **参数解释：** 变更单子单类型。 **约束限制：** 不涉及 | | create_time | Long | **参数解释：** 变更单创建时间。 **约束限制：** 不涉及 | | update_time | Long | **参数解释：** 变更单更新时间戳。 **约束限制：** 不涉及 | | creator | String | **参数解释：** 变更单创单人。 **约束限制：** 不涉及 | | operator | String | **参数解释：** 变更单操作人。 **约束限制：** 不涉及 | **状态码：400** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | provider_code | String | **参数解释：** 服务标识。 **取值范围：** 不涉及 **默认取值：** 049 | | error_code | String | **参数解释：** 请求响应代码。 **取值范围：** GOM.00000000\~GOM.00009999999 **默认取值：** GOM.00000000 | | error_msg | String | **参数解释：** 请求响应描述。 **取值范围：** 不涉及 | #### 请求示例 查询资源变更单20250630165211010544266340子单信息。 ``` GET https://{Endpoint}/v1/hosting_change_tenant/tickets/20250630165211010544266340/list-sub-tickets?limit=120&type=CloudServer ``` #### 响应示例 **状态码：200** **参数解释：** 搜索到的工单子单信息。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 ``` { "error_code" : "GOM.00000000", "error_msg" : null, "provider_code" : 4, "data" : { "total" : 1, "tickets" : [ { "ep_id" : "0", "resource_id" : "07bb5906-abe7-452f-9666-xxx", "type" : "cloudservers", "name" : "cmdb-autoTest-0001", "provider" : "ecs", "domain_id" : "xxx", "region_id" : "xxx", "hosting_id" : "67ba03743cc5fe35782b8436", "properties_json" : "{\"accessIpv4\":\"\",\"hostName\":\"xxx\",\"addresses\":[{\"OsExtIpsType\":\"fixed\",\"OsExtIpsPortId\":\"xxx\",\"addr\":\"xxx\",\"version\":4,\"OsExtIpsMacAddr\":\"xxx\",\"primary\":true}],\"accessIpv6\":\"\",\"metadata\":{\"chargingMode\":\"1\",\"lockScene\":\"\",\"imageName\":\"Huawei Cloud EulerOS 2.0 Standard 64 bit\",\"meteringProductId\":\"00301-234527-0--0\",\"lockSource\":\"\",\"lockSourceId\":\"\",\"meteringOrderId\":\"CS25011611330ECBO\",\"meteringImageType\":\"gold\",\"meteringImageId\":\"7d940784-ac0a-425f-b3fa-8478f1a1df70\",\"meteringResourcesPerCode\":\"t6.small.1.linux\",\"vpcId\":\"xxx\",\"osBit\":\"64\",\"osType\":\"Linux\",\"lockCheckEndpoint\":\"\"},\"OsExtStsVmState\":\"active\",\"configDrive\":\"\",\"OsExtStsPowerState\":1,\"hostId\":\"xxx\",\"securityGroup\":[{\"name\":\"Sys-WebServer\",\"id\":\"xxx\"}],\"ExtVolumesAttached\":[{\"bootIndex\":\"0\",\"id\":\"xxx\",\"device\":\"/dev/vda\"}],\"userId\":\"xxx\",\"flavor\":{\"disk\":\"0\",\"name\":\"t6.small.1\",\"id\":\"t6.small.1\",\"vcpus\":\"1\",\"ram\":\"1024\"},\"osextsrvattr\":{\"hostName\":\"cmdb-autotest-0001\",\"kernelId\":\"\",\"ramdiskId\":\"\",\"reservationId\":\"r-hdv1h30e\",\"instanceName\":\"instance-03fa3c69\",\"host\":\"2c6e5863373ab22b02bc4f2aa59c78ad9000xxx\",\"rootDeviceName\":\"/dev/vda\",\"hypervisorHostName\":\"ab787e4c74c537bxxx\",\"launchIndex\":0},\"OsDcfDiskConfig\":\"MANUAL\",\"hostStatus\":\"UP\",\"OsSrvUsgLaunchedAt\":\"2025-01-16T03:37:03.000000\",\"OsExtAz\":\"xxx\",\"progress\":0,\"locked\":false,\"status\":\"ACTIVE\",\"schedulerHints\":{}}", "tags_json" : "[{\"key\":\"autotest_key\",\"value\":\"autotest_value\"}]", "id" : "5e56457ee7369a60193748144bc1044f", "main_ticket_id" : "1805ff30-0145-4e75-a2d2-32ef5b9ef520", "parent_ticket_id" : "1805ff30-0145-4e75-a2d2-32ef5b9ef520", "ticket_id" : "36df6b7b-0c15-4803-b42e-a6aa3618e796", "real_ticket_id" : "20250630165211010544266340001", "ticket_path" : "1805ff30-0145-4e75-a2d2-32ef5b9ef520:CloudServer:4aa14d9e-af5a-4d0b-8827-bd923892edcf", "target_value" : "4aa14d9e-af5a-4d0b-8827-bd923892edcf", "target_type" : "CloudServer", "create_time" : 1751273531120, "update_time" : 1751273531120, "operator" : "7a581431fe0eab2f17a9f3704f955de79e4ee287c66573d90c2dc2514ae5bfce", "creator" : "7a581431fe0eab2f17a9f3704f955de79e4ee287c66573d90c2dc2514ae5bfce", "is_deleted" : false } ] } } ``` **状态码：400** 服务器未能处理请求。 更多状态码请参考[状态码](https://support.huaweicloud.com/api-coc/coc_api_05_03.html)。 ``` { "error_code" : "COC.00067003", "error_msg" : "工单不存在", "provider_code" : 4, "data" : null } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | **参数解释：** 搜索到的工单子单信息。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | 400 | 服务器未能处理请求。 更多状态码请参考[状态码](https://support.huaweicloud.com/api-coc/coc_api_05_03.html)。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-coc/ErrorCode.html)。