整机详情¶

接口说明¶

功能: 获取用户整机状态详情
请求URI: https://api.gpuez.com/zsc/open/api/v2/console/machine/info
请求方法: GET

鉴权

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

请求参数¶

参数	必选	类型	说明
machine_id	true	integer	主机ID

返回字段¶

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

接口请求示例¶

请求示例：

curl --user 'ywpkds6mkks9whwwgqwbaxypqo03zklu:lchkswmht6evpk1csllxdntf6t9bzy0d' \
    -X GET \
    "https://api.gpuez.com/zsc/open/api/v2/console/machine/info?machine_id=10027"

返回示例：

{
  "code": 200,
  "msg": "success",
  "trace": "0739064f-e72c-4368-a0d9-5c95e9d6a752",
  "data": {
    "machine": {
      "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:37:00",
      "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
          }
        ]
      }
    }
  }
}