搜索资源变更工单子单 - ListSubTickets
功能介绍
根据条件搜索资源变更工单子单,该接口只针对托管中心页签下资源变更单进行子单搜索。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
coc:ticket:list
List
-
-
-
-
URI
GET /v1/{ticket_type}/tickets/{ticket_id}/list-sub-tickets
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
ticket_type |
是 |
String |
参数解释: 工单类型,此处传固定值hosting_change_tenant,表示搜索资源类型变更单子单。 约束限制: 不涉及 取值范围: hosting_change_tenant 默认取值: 不涉及 最小长度:1 最大长度:255 |
|
ticket_id |
是 |
String |
参数解释: 变更单工单id。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 最小长度:1 最大长度:255 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
type |
是 |
String |
参数解释: 资源类型。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
limit |
否 |
Long |
参数解释: 每页显示的条数。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 最小值:1 最大值:120 缺省值:1 |
|
marker |
否 |
String |
参数解释: 上一页数据的最后一条记录的id。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 最小长度:0 最大长度:255 |
请求参数
无
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
|
data |
data object |
参数解释: 搜索到的工单子单信息。 约束限制: 不涉及 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
total |
Long |
参数解释: 搜索到的工单子单数量。 约束限制: 不涉及 最小值:0 最大值:9999999999999 |
|
tickets |
Array of SubTicketListInfo objects |
参数解释: 搜索结果,工单详情。 约束限制: 不涉及 数组长度:0 - 1024 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
ep_id |
String |
参数解释: 企业项目ID。 约束限制: 不涉及 最小长度:0 最大长度:100 |
|
resource_id |
String |
参数解释: 资源ID。 约束限制: 不涉及 最小长度:0 最大长度:100 |
|
type |
String |
参数解释: 资源类型。 约束限制: 不涉及 最小长度:0 最大长度:100 |
|
name |
String |
参数解释: 资源名称。 约束限制: 不涉及 最小长度:0 最大长度:100 |
|
provider |
String |
参数解释: 资源类型。 约束限制: 不涉及 最小长度:0 最大长度:100 |
|
domain_id |
String |
参数解释: 租户ID。 约束限制: 不涉及 最小长度:0 最大长度:100 |
|
region_id |
String |
参数解释: Region信息。 约束限制: 不涉及 最小长度:0 最大长度:100 |
|
hosting_id |
String |
参数解释: 主机ID。 约束限制: 不涉及 最小长度:0 最大长度:100 |
|
properties_json |
String |
参数解释: 资源属性信息。 约束限制: 不涉及 最小长度:0 最大长度:100 |
|
tags_json |
String |
参数解释: 资源标签信息。 约束限制: 不涉及 最小长度:0 最大长度:99999 |
|
is_deleted |
Boolean |
参数解释: 变更工单是否已删除。 约束限制: 不涉及 |
|
id |
String |
参数解释: 变更工单ID。 约束限制: 不涉及 最小长度:0 最大长度:255 |
|
main_ticket_id |
String |
参数解释: 变更工单主键ID。 约束限制: 不涉及 最小长度:0 最大长度:255 |
|
parent_ticket_id |
String |
参数解释: 父级工单ID。 约束限制: 不涉及 最小长度:0 最大长度:255 |
|
ticket_id |
String |
参数解释: 变更单工单ID。 约束限制: 不涉及 最小长度:0 最大长度:255 |
|
real_ticket_id |
String |
参数解释: 变更单单号。 约束限制: 不涉及 最小长度:0 最大长度:255 |
|
ticket_path |
String |
参数解释: 变更单工单路径。 约束限制: 不涉及 最小长度:0 最大长度:255 |
|
target_value |
String |
参数解释: 变更单子单region信息。 约束限制: 不涉及 最小长度:0 最大长度:255 |
|
target_type |
String |
参数解释: 变更单子单类型。 约束限制: 不涉及 最小长度:0 最大长度:255 |
|
create_time |
Long |
参数解释: 变更单创建时间。 约束限制: 不涉及 最小值:0 最大值:9999999999999 |
|
update_time |
Long |
参数解释: 变更单更新时间戳。 约束限制: 不涉及 最小值:0 最大值:9999999999999 |
|
creator |
String |
参数解释: 变更单创单人。 约束限制: 不涉及 最小长度:0 最大长度:255 |
|
operator |
String |
参数解释: 变更单操作人。 约束限制: 不涉及 最小长度:0 最大长度:255 |
状态码:400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
请求示例
查询资源变更单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,
"sub_tickets" : [ ]
} ]
}
}
状态码:400
服务器未能处理请求。
更多状态码请参考状态码。
{
"error_code" : "COC.00067003",
"error_msg" : "工单不存在",
"provider_code" : 4,
"data" : null
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
参数解释: 搜索到的工单子单信息。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
400 |
服务器未能处理请求。 更多状态码请参考状态码。 |
错误码
请参见错误码。