整机列表¶

接口说明¶

功能: 获取用户整机列表
请求URI: https://api.gpuez.com/zsc/open/api/v2/console/machine/list
请求方法: GET

鉴权

该接口需要通过 Basic 认证。请查看接口鉴权文档接口鉴权

请求参数¶

参数	必选	类型	说明
page	true	integer	页码
page_size	true	integer	页数

返回字段¶

返回字段	字段类型	说明
code	integer	错误码
message	string	返回信息
trace	string	请求ID
data.list[..].id	integer	主机ID
data.list[..].name	string	主机名称
data.list[..].type	integer	主机类型[4: 裸金属]
data.list[..].parent_id	integer	主账号ID
data.list[..].user_id	integer	用户ID,大于0代表已租出
data.list[..].rent_type	integer	租用类型[3: 包周, 4: 包月]
data.list[..].auto_renew	integer	自动续费[0: 关闭,1: 开启]默认关闭
data.list[..].area_id	integer	区域 ID
data.list[..].gpu_id	integer	GPU ID
data.list[..].local_ip	string	局域网IP
data.list[..].ssh_ip	string	SSH登录IP
data.list[..].ssh_user	string	SSH默认用户名
data.list[..].ssh_init_pass	string	SSH初始密码
data.list[..].ssh_port	integer	SSH端口
data.list[..].cpu_model	integer	CPU型号
data.list[..].cpu_count	integer	CPU核数
data.list[..].cpu_usage	integer	已用核数
data.list[..].gpu_count	integer	GPU卡数
data.list[..].gpu_usage	integer	已用卡数
data.list[..].mem_size	integer	内存大小，单位：字节
data.list[..].mem_usage	integer	内存用量，单位：字节
data.list[..].physics_system_disk_size	integer	物理主机系统盘大小，单位：字节
data.list[..].physics_system_disk_usage	integer	物理主机系统盘用量，单位：字节
data.list[..].system_disk_size	integer	系统盘大小，单位：字节
data.list[..].system_disk_usage	integer	系统盘用量，单位：字节
data.list[..].data_disk_size	integer	数据盘大小，单位：字节
data.list[..].data_disk_usage	integer	数据盘用量，单位：字节
data.list[..].data_disk_available	integer	数据盘可扩容大小，单位：字节
data.list[..].status	integer	主机状态 [0:初始化,1:回收中,2:运行中,3:待维修,4:关机中,5:已关机,6:释放中,7:已释放]
data.list[..].status_at	string	状态更新时间
data.list[..].expire_at	integer	主机过期时间
data.list[..].ended_at	string	服务期限
data.list[..].report_at	string	上报时间
data.list[..].gpu_stat.id	integer	显卡ID
data.list[..].gpu_stat.model	string	显卡型号
data.list[..].gpu_stat.tf_lops16	float	半精
data.list[..].gpu_stat.tf_lops32	float	单精
data.list[..].gpu_stat.mem_size	integer	显存大小，单位：字节
data.list[..].area_stat.id	integer	区域ID
data.list[..].area_stat.name	string	区域名称
data.list[..].cuda_version	string	cuda 版本号
data.list[..].price_week	string	包周价格
data.list[..].price_month	string	包月价格
data.list[..].extends.hard_disks[..].name	string	磁盘名
data.list[..].extends.hard_disks[..].type	integer	磁盘类型[1: HDD,4: SSD]
data.list[..].extends.hard_disks[..].usage_type	integer	挂载类型[1: 系统盘,其它: 数据盘]
data.list[..].extends.hard_disks[..].capacity	integer	磁盘大小，单位：字节
data.totals	integer	整机总数

接口请求示例¶

请求示例：

curl --user 'ywpkds6mkks9whwwgqwbaxypqo03zklu:lchkswmht6evpk1csllxdntf6t9bzy0d' \
    -X GET \
    "https://api.gpuez.com/zsc/open/api/v2/console/machine/list?page=1&page_size=10"

返回示例：

{
  "code": 200,
  "msg": "success",
  "trace": "e36755f9-d81a-4453-999e-60020a1124c0",
  "data": {
    "total": 1,
    "list": [
      {
        "id": 10027,
        "name": "zscloud-da32b334c",
        "type": 4,
        "parent_id": 10282,
        "user_id": 1000036,
        "rent_type": 3,
        "auto_renew": 1,
        "area_id": 8,
        "gpu_id": 10024,
        "local_ip": "192.168.20.31",
        "ssh_ip": "192.168.1.23",
        "ssh_port": 3,
        "ssh_user": "root",
        "ssh_init_pass": "123",
        "gpu_count": 2,
        "gpu_usage": 0,
        "cpu_model": "AMD EPYC 7302 16-Core Processor",
        "cpu_count": 64,
        "cpu_usage": 0,
        "mem_size": 270305705984,
        "mem_usage": 0,
        "physics_system_disk_size": 470306373632,
        "physics_system_disk_usage": 293114417152,
        "system_disk_size": 1499266035712,
        "system_disk_usage": 0,
        "data_disk_size": 2336462209024,
        "data_disk_usage": 0,
        "data_disk_available": 1894080577536,
        "cuda_version": "12.4",
        "price_week": "2000",
        "price_month": "5000",
        "expire_at": "2025-04-28 17:07:25",
        "ended_at": "2029-07-31 23:59:59",
        "report_at": "2025-04-07 17:23:10",
        "area_stat": {
          "id": 8,
          "name": "合作区"
        },
        "gpu_stat": {
          "id": 10024,
          "vendor": "NVIDIA",
          "model": "3080Ti",
          "mem_size": 12884901888,
          "tf_lops16": 70,
          "tf_lops32": 34.1,
          "cuda_version": "12.2"
        },
        "extends": {
          "hard_disks": [
            {
              "name": "nvme0n1",
              "type": 4,
              "usage_type": 3,
              "capacity": 3840755982336
            },
            {
              "name": "sda",
              "type": 4,
              "usage_type": 1,
              "capacity": 800166076416
            }
          ]
        }
      }
    ]
  }
}