文档首页/ 云运维中心 COC/ API参考/ API/ 变更管理/ 搜索资源变更工单子单
更新时间:2025-07-11 GMT+08:00
分享

搜索资源变更工单子单

功能介绍

根据条件搜索资源变更工单子单,该接口只针对托管中心页签下资源变更单进行子单搜索。

调试

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

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。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

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

参数解释:

搜索到的工单子单信息。

约束限制:

不涉及

表4 data

参数

参数类型

描述

total

Long

参数解释:

搜索到的工单子单数量。

约束限制:

不涉及

tickets

Array of SubTicketListInfo objects

参数解释:

搜索结果,工单详情。

约束限制:

不涉及

表5 SubTicketListInfo

参数

参数类型

描述

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" : "049",
  "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,
      "sub_tickets" : [ ]
    } ]
  }
}

状态码:400

服务器未能处理请求。

更多状态码请参考状态码

{
  "error_code" : "COC.00067003",
  "error_msg" : "工单不存在",
  "provider_code" : "049",
  "data" : null
}

状态码

状态码

描述

200

参数解释:

搜索到的工单子单信息。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

400

服务器未能处理请求。

更多状态码请参考状态码

错误码

请参见错误码

相关文档