Help Center/ Cloud Operations Center/ API Reference/ API/ Change Management/ Querying a Resource Change Sub-Ticket
Updated on 2025-10-24 GMT+08:00

Querying a Resource Change Sub-Ticket

Function

This API is used to search for resource change sub-tickets based on the conditions. This API is used only to search for resource change sub-tickets on the hosting center tab page.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

  • If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    coc:ticket:list

    List

    -

    -

    -

    -

URI

GET /v1/{ticket_type}/tickets/{ticket_id}/list-sub-tickets

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

ticket_type

Yes

String

Definition:

Service ticket type. The value is fixed to hosting_change_tenant, indicating that a service ticket for resource type change is searched.

Constraints:

N/A

Value range:

hosting_change_tenant

Default value:

N/A

ticket_id

Yes

String

Definition:

Service ticket ID.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

type

Yes

String

Definition:

Resource type.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

limit

No

Long

Definition:

Number of records displayed on each page.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

marker

No

String

Definition:

ID of the last record on the previous page.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

Request Parameters

None

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

provider_code

String

Definition:

Service ID.

Value range:

N/A

Default value:

049

error_code

String

Definition:

Request response code.

Value range:

GOM.00000000~GOM.00009999999

Default value:

GOM.00000000

error_msg

String

Definition:

Response description for a request.

Value range:

N/A

data

data object

Definition:

Information about the searched service sub-ticket.

Constraints:

N/A

Table 4 data

Parameter

Type

Description

total

Long

Definition:

Number of the searched service sub-tickets.

Constraints:

N/A

tickets

Array of SubTicketListInfo objects

Definition:

Search result, which is the service ticket details.

Constraints:

N/A

Table 5 SubTicketListInfo

Parameter

Type

Description

ep_id

String

Definition:

Enterprise project ID.

Constraints:

N/A

resource_id

String

Definition:

Resource ID.

Constraints:

N/A

type

String

Definition:

Resource type.

Constraints:

N/A

name

String

Definition:

Resource name.

Constraints:

N/A

provider

String

Definition:

Resource type.

Constraints:

N/A

domain_id

String

Definition:

Tenant ID.

Constraints:

N/A

region_id

String

Definition:

Region information.

Constraints:

N/A

hosting_id

String

Definition:

Host ID.

Constraints:

N/A

properties_json

String

Definition:

Resource attribute information.

Constraints:

N/A

tags_json

String

Definition:

Resource tag information.

Constraints:

N/A

is_deleted

Boolean

Definition:

Whether the change ticket has been deleted.

Constraints:

N/A

id

String

Definition:

Change ticket ID.

Constraints:

N/A

main_ticket_id

String

Definition:

Primary key ID of the change ticket.

Constraints:

N/A

parent_ticket_id

String

Definition:

Parent ticket ID.

Constraints:

N/A

ticket_id

String

Definition:

Change ticket ID.

Constraints:

N/A

real_ticket_id

String

Definition:

Change ticket number.

Constraints:

N/A

ticket_path

String

Definition:

Change ticket path.

Constraints:

N/A

target_value

String

Definition:

Region information of the change sub-ticket.

Constraints:

N/A

target_type

String

Definition:

Change ticket subticket type.

Constraints:

N/A

create_time

Long

Definition:

Time when a change ticket is created.

Constraints:

N/A

update_time

Long

Definition:

Timestamp when a change ticket is updated.

Constraints:

N/A

creator

String

Definition:

Change ticket creator.

Constraints:

N/A

operator

String

Definition:

Change ticket operator.

Constraints:

N/A

Status code: 400

Table 6 Response body parameters

Parameter

Type

Description

provider_code

String

Definition:

Service ID.

Value range:

N/A

Default value:

049

error_code

String

Definition:

Request response code.

Value range:

GOM.00000000~GOM.00009999999

Default value:

GOM.00000000

error_msg

String

Definition:

Response description for a request.

Value range:

N/A

Example Requests

Query the sub-ticket information of resource change ticket 20250630165211010544266340.

GET https://{Endpoint}/v1/hosting_change_tenant/tickets/20250630165211010544266340/list-sub-tickets?limit=120&type=CloudServer

Example Responses

Status code: 200

Definition:

Information about the searched service sub-ticket.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

{
  "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" : [ ]
    } ]
  }
}

Status code: 400

The server failed to process the request.

For more status codes, see Status Codes.

{
  "error_code" : "COC.00067003",
  "error_msg" : "The service ticket does not exist.",
  "provider_code" : 4,
  "data" : null
}

Status Codes

Status Code

Description

200

Definition:

Information about the searched service sub-ticket.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

400

The server failed to process the request.

For more status codes, see Status Codes.

Error Codes

See Error Codes.