ListInstanceModel
Queries the list of AI node resources.
Operation description
Request description
Retrieves information about deployed model services on a specific Hologres instance, including but not limited to resource usage such as CPU, GPU, and memory.
The
instanceIdparameter is optional. If not provided, the information of all related instances is returned by default.This operation applies to Hologres AI nodes. Some parameters may be invalid or inapplicable for non-AI nodes.
Make sure that you fully understand the billing methods and pricing of Alibaba Cloud Hologres before you call this operation.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
hologram:ListInstanceModel |
none |
*All Resource
|
None | None |
Request syntax
GET /api/v1/instances/rpc/listInstanceModel HTTP/1.1
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
No parameters required.
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Schema of Response |
||
| requestId |
string |
Id of the request |
2C2ECDC1-FBAD-14A5-AA4A-96BC787FBDBC |
| instanceModelList |
array<object> |
The list of AI resources. |
|
|
object |
|||
| cpu |
integer |
The CPU specifications. This parameter applies only to Hologres AI nodes. |
7 |
| gpu |
integer |
The number of GPUs. This parameter applies only to Hologres AI nodes. |
1 |
| memory |
integer |
The memory size. Unit: GiB. This parameter applies only to Hologres AI nodes. |
16 |
| gpuMemory |
integer |
The GPU memory size. Unit: GB. This parameter applies only to Hologres AI nodes. |
32 |
| cpuUsed |
integer |
The total CPU usage of the node. This parameter applies only to Hologres AI nodes. |
7 |
| memoryUsed |
integer |
The total memory usage of the node. This parameter applies only to Hologres AI nodes. |
32 |
| gpuUsed |
integer |
The total GPU usage of the node. This parameter applies only to Hologres AI nodes. |
32 |
| aiInstanceId |
string |
The ID of the AI node instance. |
hologram_aicombo_public_cn-77xxx |
| gpuMemoryUsed |
integer |
The total GPU memory usage of the node. This parameter applies only to Hologres AI nodes. |
32 |
| regionId |
string |
The region ID. |
cn-hangzhou |
| resourceType |
string |
The resource type. |
small |
| nodeCount |
integer |
The number of nodes. |
2 |
| commodityCode |
string |
The commodity code. |
hologram_aipostpay_public_cn |
| chargeType |
string |
The billing method. Valid values:
|
PostPaid |
| status |
string |
The status. |
ResourceReady |
| expirationTime |
string |
The expiration time (UTC). |
2026-01-28T07:44:27.535Z |
| autoRenewal |
boolean |
Specifies whether auto-renewal is enabled. |
|
| holoInstanceId |
string |
The Hologres instance ID. |
hgpostcn-cn-yi34hlzdx003 |
| holoInstanceName |
string |
The Hologres instance name. |
myInstance |
| aiSpec |
string |
The AI specifications. |
small-8core-30G-24G |
Examples
Success response
JSON format
{
"requestId": "2C2ECDC1-FBAD-14A5-AA4A-96BC787FBDBC",
"instanceModelList": [
{
"cpu": 7,
"gpu": 1,
"memory": 16,
"gpuMemory": 32,
"cpuUsed": 7,
"memoryUsed": 32,
"gpuUsed": 32,
"aiInstanceId": "hologram_aicombo_public_cn-77xxx",
"gpuMemoryUsed": 32,
"regionId": "cn-hangzhou",
"resourceType": "small",
"nodeCount": 2,
"commodityCode": "hologram_aipostpay_public_cn",
"chargeType": "PostPaid",
"status": "ResourceReady",
"expirationTime": "2026-01-28T07:44:27.535Z",
"autoRenewal": false,
"holoInstanceId": "hgpostcn-cn-yi34hlzdx003",
"holoInstanceName": "myInstance",
"aiSpec": "small-8core-30G-24G"
}
]
}
Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.