查询资源组(GetResourceGroup)
基本信息
Action:/qai/aicp/resource/resource_group
Method: GET
Content-Type:application/json
请求参数
参数 | 类型 | 描述 | 是否必须 |
---|---|---|---|
offset |
interger |
表示数据偏移量,默认值为 |
no |
limit |
integer |
表示返回数据长度,默认值为 |
no |
reverse |
boolean |
是否倒序排序,默认值为 |
no |
order_by |
string |
排序依据,默认为创建时间。 |
no |
search_word |
string |
搜索关键词。 |
no |
响应参数
此接口包含的公共响应参数,可参见前文内容,其他参数介绍如下:
参数 | 类型 | 说明 |
---|---|---|
data |
array<object> |
资源组数据数组 |
data.user_name |
string |
资源组所属用户名称 |
data.email |
string |
用户联系邮箱 |
data.status |
string |
资源组当前状态 |
data.reason |
string |
状态变更原因说明 |
data.user_id |
string |
用户 ID |
data.root_user_id |
string |
主账户 ID |
data.created_at |
string(date-time) |
创建时间 |
data.updated_at |
string(date-time) |
最后更新时间 |
data.rg_id |
string |
资源组唯一标识 |
data.name |
string |
资源组名称 |
data.resource_type |
string |
资源类型标识 |
data.description |
string |
资源组描述信息 |
data.pod_type |
string |
Pod 类型配置 |
data.customize_enable |
integer |
是否启用自定义配置(0/1) |
data.total_gpu |
integer |
GPU 卡总量 |
data.ava_gpu |
integer |
可用 GPU 卡数量 |
data.total_node_count |
integer |
节点总数 |
data.used_node_count |
integer |
已用节点数 |
data.used_gpu_count |
integer |
已用 GPU 卡数 |
data.sku_id |
string |
资源规格 ID |
data.gpu_model |
string |
GPU 型号名称 |
data.unschedulable_gpu_count |
integer |
不可调度 GPU 数量 |
data.unschedulable_node_count |
integer |
不可调度节点数 |
data.gpu_ava_util |
number |
GPU 平均可用利用率 |
data.gpu_used_mem |
integer |
已用 GPU 显存 |
data.gpu_sum_mem |
integer |
GPU 显存总量 |
请求示例
curl -X 'GET' \
'https://ai.coreshub.cn/qai/aicp/resource/resource_group?offset=0&limit=20&reverse=false&order_by=created_at' \
-H 'accept: application/json'
响应示例
{
"ret_code": 0,
"message": "success",
"meta": {
"X_REQUEST_ID": "string",
"X_REQUEST_USER": "string"
},
"data": [
{
"user_name": "",
"email": "",
"status": "string",
"reason": "string",
"user_id": "string",
"root_user_id": "",
"created_at": "2025-03-27T01:33:37.029Z",
"updated_at": "2025-03-27T01:33:37.029Z",
"rg_id": "string",
"name": "",
"resource_type": "",
"description": "",
"pod_type": "",
"customize_enable": 1,
"total_gpu": 0,
"ava_gpu": 0,
"total_node_count": 0,
"used_node_count": 0,
"used_gpu_count": 0,
"sku_id": "",
"gpu_model": "",
"unschedulable_gpu_count": 0,
"unschedulable_node_count": 0,
"gpu_ava_util": 0,
"gpu_used_mem": 0,
"gpu_sum_mem": 0
}
],
"counts": 0
}