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
|
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 |
|
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
|
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 |
|
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 |
|
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
|
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.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot