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

常见问题Q&A

用户反馈的问题#

Q: 重启接口缺失?#

A: 2024年12月已补上,可使用 restart_instance 接口。

Q: instance_name 参数值传什么?#

A: 租用接口和详情接口返回的 Container_name 字段值。

Q: 文档返回的字段是否可以添加说明?#

A: 技术人员有空就会完善,但完成时间不确定。大部分字段能直接看懂,看不懂的可先使用邮件进行反馈,我会及时回复并更新对应文档。

Q: 我的签名不通过,如何调试?#

A: 签名的核心逻辑:
1.
按参数字母升序排列非空参数(排除 sign 和 secret)
2.
末尾拼接 &secret=你的SecretKey
3.
对整个字符串取 MD5
签名如果不通过,可使用 签名调试工具 进行调试分析。

Q: Docker 容器和 KVM 云主机有什么区别?#

A: KVM 云主机提供完整的虚拟机环境(含独立系统盘),适合需要完全隔离环境的场景;Docker 容器是容器化环境,启动更快。Docker 实例支持 stop_container / start_container / remove_container 操作,KVM 实例支持 restart_instance / restart_instance_from_shutdown / 迁移 / 救援等操作。

Q: 如何选择租用方式?新版和老版有什么区别?#

A: 老版(性能模式):通过 performance 参数选择 normal(普通性能)或 high(高性能)。新版(按规格,推荐):通过 spec_name 参数选择具体规格(如 ecs.c4.base、gcs.g2.large 等),划分更细,可按需选择 CPU/内存配比。可通过 /store/get_instance_specifications 获取所有可用规格。

Q: 如何查询某个 GPU 类型是否有可用资源?#

A: 使用 /store/get_kvm_available_selector(KVM)或 /store/get_docker_available_selector(Docker)接口,可获取各 GPU 类型的可用数量、区域、镜像等信息。也可使用 /store/get_instance_available_kvm_num 查询具体 GPU 类型的可用数量。

Q: 提前退租如何计算退款?#

A: 使用 /instance/stop_instance_with_refund_query_price 查询预期退款金额,确认后调用 /instance/stop_instance_with_refund 执行退租。退款金额 = 已付剩余时长的费用 - 退租手续费。

Q: 实例启动失败(Status=-1)怎么办?#

A: 启动失败后,可尝试以下操作:
1.
error_refund — 申请异常退费,退还已扣费用
2.
salvage_instance — 尝试救援恢复(需先查询救援条件)
3.
如果以上都不行,建议联系技术支持
修改于 2026-07-13 08:25:40
上一页
更新日志
下一页
关于计费
Built with