整机列表

接口说明

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

鉴权

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

请求参数

参数	必选	类型	说明
area_id	false	integer	区域 ID，默认0，请求整机配置接口获取
gpu_id	false	integer	GPU ID，默认为0，请求整机配置接口获取
gpu_count_min	false	integer	GPU卡数筛选最小值，可参考整机配置接口 gpu_nums 字段
gpu_count_max	false	integer	GPU卡数筛选最大值，可参考整机配置接口 gpu_nums 字段
machine_type	true	integer	整机类型[4: 裸金属]
page	false	integer	页数，默认1
page_size	false	integer	页数，默认10

返回字段

返回字段	字段类型	说明
code	integer	错误码
message	string	返回信息
trace	string	请求ID
data.list[..].id	integer	主机ID
data.list[..].name	string	主机名
data.list[..].type	integer	主机类型，4：裸金属
data.list[..].area_id	integer	区域ID
data.list[..].gpu_id	integer	GPU ID
data.list[..].gpu_count	integer	GPU总数量
data.list[..].cpu_model	string	CPU型号
data.list[..].cpu_count	integer	CPU核数
data.list[..].mem_size	integer	内存，单位：字节
data.list[..].physics_system_disk_size	integer	物理主机系统盘大小，单位：字节
data.list[..].system_disk_size	integer	系统盘，单位：字节
data.list[..].data_disk_size	integer	数据盘，单位：字节
data.list[..].cuda_version	string	CUDA版本
data.list[..].price_week	string	包周价格
data.list[..].price_month	string	包月价格
data.list[..].ended_at	string	可以租用最终时间
data.list[..].area_stat.id	integer	区域ID
data.list[..].area_stat.name	string	区域名
data.list[..].gpu_stat.id	integer	GPU ID
data.list[..].gpu_stat.vendor	string	GPU 厂商
data.list[..].gpu_stat.model	string	GPU 型号
data.list[..].gpu_stat.mem_size	integer	GPU 显存
data.list[..].gpu_stat.tf_lops16	float	半精算力
data.list[..].gpu_stat.tf_lops32	float	单精算力
data.list[..].gpu_stat.cuda_version	string	CUDA版本
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.user_discount	string	用户折扣
data.total	integer	机器总数

接口请求示例

请求示例：

curl --user 'ywpkds6mkks9whwwgqwbaxypqo03zklu:lchkswmht6evpk1csllxdntf6t9bzy0d' \
    -X GET \
    "https://api.gpuez.com/zsc/open/api/v2/machine/list?area_id=8&machine_type=4&gpu_count_min=1&gpu_count_max=8"

返回示例：

{
  "code": 200,
  "msg": "success",
  "trace": "8536fe09-8b0b-4caa-9715-163919033a75",
  "data": {
    "list": [
      {
        "id": 3002,
        "name": "zsc-8-3002",
        "type": 4,
        "area_id": 8,
        "gpu_id": 1,
        "gpu_count": 8,
        "cpu_model": "Intel(R) Xeon(R) Platinum 8272CL CPU @ 2.60GHz",
        "cpu_count": 64,
        "mem_size": 137438953472,
        "physics_system_disk_size": 470306373632,
        "system_disk_size": 3221225472000,
        "data_disk_size": 1073741824000,
        "cuda_version": "1.2.3",
        "price_week": "2000",
        "price_month": "5000",
        "ended_at": "2025-07-10 00:00:00",
        "area_stat": {
          "id": 8,
          "name": "广州"
        },
        "gpu_stat": {
          "id": 1,
          "vendor": "NVIDIA",
          "model": "RTX 4090",
          "mem_size": 12884901888,
          "tf_lops16": 1,
          "tf_lops32": 111,
          "cuda_version": "0.3.22"
        },
        "extends": {
          "hard_disks": [
            {
              "name": "nvme0n1",
              "type": 4,
              "capacity": 3840755982336
            },
            {
              "name": "sda",
              "type": 4,
              "capacity": 800166076416
            }
          ]
        }
      },
      {
        "id": 3001,
        "name": "zsc-8-3001",
        "type": 4,
        "area_id": 8,
        "gpu_id": 1,
        "gpu_count": 8,
        "cpu_model": "Intel(R) Xeon(R) Platinum 8272CL CPU @ 2.60GHz",
        "cpu_count": 64,
        "mem_size": 137438953472,
        "physics_system_disk_size": 470306373632,
        "system_disk_size": 3221225472000,
        "data_disk_size": 1073741824000,
        "cuda_version": "1.2.3",
        "price_week": "2000",
        "price_month": "5000",
        "ended_at": "2025-07-10 00:00:00",
        "area_stat": {
          "id": 8,
          "name": "广州"
        },
        "gpu_stat": {
          "id": 1,
          "vendor": "NVIDIA",
          "model": "RTX 4090",
          "mem_size": 12884901888,
          "tf_lops16": 1,
          "tf_lops32": 111,
          "cuda_version": "0.3.22"
        },
        "extends": {
          "hard_disks": [
            {
              "name": "nvme0n1",
              "type": 4,
              "usage_type": 3,
              "capacity": 3840755982336
            },
            {
              "name": "sda",
              "type": 4,
              "usage_type": 1,
              "capacity": 800166076416
            }
          ]
        }
      }
    ],
    "total": 2,
    "user_discount": "0.3"
  }
}