1. 产品文档
智星云开放接口
  • OpenAPI v2
    • 开始使用
    • 更新日志
    • 常见问题Q&A
    • 产品文档
      • 关于计费
      • 关于实例
      • 关于租用
      • 实例访问
      • 实例状态
      • 实例费用
    • 接入文档
      • 接口约定
      • 接口签名
      • 接口顺序
      • 参考代码(Golang版)
      • 参考代码(Python3版)
      • 参考代码(Java版)
      • 签名调试工具
    • 算力市场(租用市场)
      • 如何接入CPU和云主机实例租用
      • 旧接口如何迁移至按实例规格租用
      • 获取云主机租用选项
      • 获取实例规格列表(CPU租用和GPU租用均适用)
      • 创建云主机询价
      • 创建云主机
      • 获取价格信息
      • 获取基础配置项
      • 查询镜像详细信息
      • 查询CPU内存规格信息
      • 查询GPU相关信息
    • 自主实例
      • 获取实例信息
        • 获取实例状态统计
        • 获取自主实例列表
        • 获取自主实例详情
        • 获取web端访问vnc和ssh的链接
        • 获取windows远程访问rdp文件
      • 获取实例费用
        • 获取自主实例费用汇总
        • 获取自主实例费用明细
      • 变更实例信息
        • 修改实例备注
        • 修改实例扣费优先级
        • 修改实例到期处理模式
        • 修改实例访问密码
      • 实例费用管理
        • 实例启动错误,手动退费
        • 设置实例自动续费
        • 手动续费实例询价
        • 手动续费实例
      • 实例配置升级
        • 旧接口(待废弃)
          • 查询资源池剩余CPU
          • 添加CPU
          • 查询资源池剩余内存
          • 添加内存
        • 升级实例规格
          • 获取升级规格选项
          • 升级规格询价
          • 升级规格
        • 修改实例带宽询价
        • 修改实例带宽
        • 查询资源池剩余磁盘
        • 添加磁盘询价
        • 添加磁盘
      • 获取本地可用镜像
      • 重置系统
      • 释放保留的磁盘
      • 从保留磁盘创建实例询价
      • 从保留磁盘创建实例
      • 重启实例(从开机状态)
      • 启动实例(从关机状态)
      • 提前退租询价
      • 提前退租(退款至算力券账户)
    • 合同实例
      • 获取合同实例列表
      • 获取合同实例详情
      • 获取合同实例费用明细
    • 用户模块
      • 获取apikey信息
      • 获取主账户信息
      • 获取子账号列表
    • 账单模块
      • 获取充值订单列表
      • 获取余额变更明细
    • Maas专用(请勿接入)
      • 其他接口
        • 添加内存
      • 获取算力租用选项
      • 获取租用规格列表
      • 创建实例
      • 创建实例询价
      • 获取升级可用的规格列表
      • 升级规格询价
      • 升级规格
  1. 产品文档

关于实例

功能一览#

支持的功能列表:
租用
退租
续租
自动续租
资源管理:
重启实例
关机后重启(KVM)
重置系统
实例迁移:将实例从当前宿主机迁移到另一台宿主机
实例救援:实例启动异常时,尝试修复恢复
资源升级:
可增加内存配置,不可降配
可增加CPU配置,不可降配
可添加数据盘,不可删除
系统盘无法更改大小
数据盘可以添加最多16块
支持按规格升级CPU/内存配置
访问开放:
可通过外部ssh登录;可通过web端ssh登录
可通过vnc登录
可通过rdp登录
可通过 API 获取 VNC/SSH 链接 (get_vnc_and_ssh)
可通过 API 下载 RDP 文件 (get_rdp_file)
可通过 API 获取实例截图 (get_screenshot)
无独立ip,有10个端口

关于实例费用字段#

实例详情接口 有如下字段:
Total_cost:实例基础费用(包含初始GPU+CPU+内存、添加CPU、添加内存,续费等)
BandwidthCost:带宽费用:收费带宽大小 × 带宽单价 × 小时时长
AddDiskCost:添加磁盘的费用 × 磁盘单价 × 此刻到实例到期的小时时长
KeeppedDiskCost:保留磁盘费用:(系统盘大小+数据盘大小)× 磁盘单价 × 小时时长
ReturnMoney:已退费的金额
最终实例已产生的总费用 = Total_cost + BandwidthCost + AddDiskCost + KeeppedDiskCost

关于实例时间字段#

实例详情接口 有如下字段:
Ctime:创建时间
Due_time:到期时间
End_time:实际结束时间
DiskReleaseTime:磁盘释放时间
LastRestartTime:上一次重启时间(可为空)
LastAbnoramlTime:上一次发生异常时间(可为空)
AbornormalTime:异常时长(秒)

关于实例资源相关字段#

实例详情接口 有如下字段:
Cpu_num、Memory、Gpu_num:为初始状态下的资源大小;其中系统盘大小字段没有,固定为(Linux 200GB,Windows 350GB)
AddCpu、AddMemory、AddDisk:为已经添加的资源大小
AddingCpu、AddingMemory、AddingDisk:为正在添加的资源大小(状态未完成的话不扣费)
Bandwidth、MaxBandwidth、NoFreeBandwidth:为带宽相关,分别是当前带宽大小、可设置的最大带宽、收费带宽大小;每小时扣费

迁移功能说明#

实例迁移用于将当前实例从原宿主机迁移到另一台宿主机,适用于宿主机故障或资源紧张场景:
1.
获取迁移条件:/instance/get_migration_conditions — 返回可迁移到的目标主机列表
2.
执行迁移:/instance/migrate_instance — 传入 target_host 执行迁移
迁移过程分两阶段:①停止当前实例并保留磁盘 ②在新宿主机从磁盘启动新实例

救援功能说明#

救援功能用于实例启动异常(Status=-1 且 IsAbnormal==1)时的恢复尝试:
1.
查询救援价格:/instance/get_salvage_instance_conditions_and_query_price
2.
执行救援:/instance/salvage_instance
救援会在当前宿主机上尝试重新启动实例。
修改于 2026-07-13 08:25:11
上一页
关于计费
下一页
关于租用
Built with