智星云开放接口
  1. 获取实例信息
智星云开放接口
  • OpenAPI v2
    • 开始使用
    • 使用文档
      • 接口约定
      • 接口签名
      • 接入案例
      • 更新日志
      • 常见问题Q&A
      • 签名调试工具
    • 逻辑参考
      • 价格与费用
    • 用户模块
      • 获取apikey信息
      • 获取主账户信息
    • 账单模块
      • 获取充值订单列表
      • 获取余额变更明细
    • 自主实例
      • 获取实例信息
        • 获取实例状态统计
          POST
        • 获取自主实例列表
          POST
        • 获取自主实例详情
          POST
      • 获取实例费用
        • 获取自主实例费用汇总
        • 获取自主实例费用明细
      • 变更实例信息
        • 修改实例备注
        • 修改实例扣费优先级
        • 修改实例到期处理模式
        • 修改实例访问密码
      • 实例配置升级
        • 修改实例带宽
        • 查询资源池剩余CPU
        • 添加CPU
        • 查询资源池剩余内存
        • 添加内存
        • 查询资源池剩余磁盘
        • 添加磁盘
      • 实例费用管理
        • 实例启动错误,手动退费
        • 设置实例自动续费
        • 手动续费实例
      • 获取本地镜像
        POST
      • 重置系统
        POST
      • 释放保留的磁盘
        POST
      • 从保留磁盘创建实例
        POST
      • 重启实例
        POST
    • 租用市场
      • 获取基础配置项
      • 获取价格信息
      • 获取云主机租用选项
      • 创建云主机
      • 获取Maas云主机租用选项
  1. 获取实例信息

获取自主实例详情

POST
/openapi/v2/instance/get_instance_detail
// 实例状态Status字段
const Status_Error int = -1 // 启动错误,可手动退费
const Status_Error_Refunded int = -2 // 启动错误,已手动退费
const Status_End int = 0 // 已结束
const Status_Running int = 1 // 运行中
const Status_Starting int = 4 // 启动中
const Status_Rebooting int = 5 // 重启中
const Status_RebootFailed int = 7 // 重启失败
const Status_DiskKeepped int = 8 // 磁盘保留中

请求参数

Body 参数multipart/form-data
instance_name
string 
实例名
必需
示例值:
18621629564_inner-0112_6d217e13d04544c58267581711c241fe_u1_c1

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://app.ai-galaxy.cn/openapi/v2/instance/get_instance_detail' \
--form 'instance_name="18621629564_inner-0112_6d217e13d04544c58267581711c241fe_u1_c1"'

返回响应

🟢200成功
application/json
Body
success
boolean 
必需
code
string 
必需
message
string 
必需
data
object 
实例详情
必需
AbornormalTime
integer 
必需
异常的时间长度(秒)
AddCpu
integer 
必需
额外已添加的CPU核数
AddDisk
integer 
必需
额外已添加的磁盘大小(GB)
AddDiskCost
integer 
必需
额外已添加的磁盘花费金额
AddMemory
integer 
必需
额外已添加的内存大小(GB)
AddingCpu
integer 
必需
正在添加的CPU核数
AddingDisk
integer 
必需
正在添加的磁盘大小(GB)
AddingMemory
integer 
必需
正在添加的内存大小(GB)
Bandwidth
integer 
当前总带宽值
必需
BandwidthCost
integer 
必需
带宽已产生的费用金额
CanUpdateCpuNum
boolean 
字段废弃
必需
CanUpdateDisk
boolean 
字段废弃
必需
CanUpdateMemory
boolean 
字段废弃
必需
ContainerStartId
string 
实例启动id
必需
ContainerType
string 
必需
实例类型:kvm、docker
Container_name
string 
实例名
必需
Cpu_num
integer 
必需
实例初始化的CPU核数
Ctime
integer 
必需
创建时间(秒级时间戳)
DiskReleaseTime
integer 
必需
磁盘释放时间(秒级时间戳)
District
string 
机房
必需
DueMode
integer 
必需
到期磁盘处理方式:1保留,-1释放
Due_time
integer 
必需
实例到期时间(秒级时间戳)
End_time
integer 
必需
实例结束时间(秒级时间戳)
ExtraPort
object 
端口映射-外网端口
必需
Gpu_index
string 
占用的GPU卡编号
必需
Gpu_num
integer 
必需
实例初始化的GPU卡数量
Gpu_type
string 
GPU卡型号
必需
Host
string 
所在主机名
必需
Id
integer 
实例ID
必需
IkatagoName
string 
字段废弃
必需
IkatagoPass
string 
字段废弃
必需
Image
string 
所使用的镜像key
必需
Init_passwd
string 
初始化密码
必需
InstanceAutorenew
null 
实例自动续费的配置
必需
IsAbnormal
integer 
必需
实例是否处于异常状态
IsSaveDiskState
boolean 
字段废弃
必需
KeeppedDiskCost
integer 
必需
保留磁盘产生的费用金额
KvmDataDiskSize
integer 
字段废弃
必需
KvmDataUseSsd
integer 
必需
磁盘是否是SSD固态硬盘
LastAbnoramlTime
integer 
必需
最近一次异常发生的时间
LastInitPasswd
string 
备份的初始密码
必需
LastRestartTime
integer 
最近一次重启时间
必需
LinuxVncPort
integer 
必需
Linux系统Vnc端口
LoginUserName
string 
实例登录用户名
必需
MaxBandwidth
integer 
必需
实例最大可设置的带宽值
Memory
integer 
必需
实例初始化的内存大小(GB)
Message
string 
实例当前启动状态
必需
NoFreeBandwidth
integer 
当前收费带宽的大小
必需
Note
string 
用户备注
必需
PayTypeFirst
string 
必需
实例优先扣费方式:money是余额、power是算力券
Performance
string 
性能模式
必需
PortMappingInner
object 
端口映射-内网端口
必需
RdpPasswd
string 
Rdp密码
必需
RdpPort
integer 
Rdp端口
必需
ReturnMoney
number 
实例已退费金额
必需
SshPort
integer 
SSH端口
必需
Status
integer 
必需
实例状态,见接口说明
SubAccountName
string 
必需
创建该实例的子账户名
Total_cost
integer 
必需
实例已产生的基础费用(不包含添加磁盘费用、保留磁盘费用、带宽产生的费用)
Url
string 
实例IP地址
必需
Use_mode
integer 
必需
1是套餐租用,0是分时租用
VncPasswd
string 
Vnc密码
必需
VncPort
integer 
Vnc端口
必需
Volumn
string 
字段废弃
必需
示例
{
  "success": true,
  "code": "2000",
  "message": "",
  "data": {
    "AbornormalTime": 3480,
    "AddCpu": 0,
    "AddDisk": 0,
    "AddDiskCost": 0,
    "AddMemory": 0,
    "AddingCpu": 0,
    "AddingDisk": 0,
    "AddingMemory": 0,
    "Bandwidth": 32,
    "BandwidthCost": 0,
    "CanUpdateCpuNum": true,
    "CanUpdateDisk": true,
    "CanUpdateMemory": true,
    "ContainerStartId": "18621629564_6d217e13d04544c58267581711c241fe",
    "ContainerType": "kvm",
    "Container_name": "18621629564_inner-0112_6d217e13d04544c58267581711c241fe_u1_c1",
    "Cpu_num": 8,
    "Ctime": 1730191817,
    "DiskReleaseTime": 1731563637,
    "District": "js",
    "DueMode": 1,
    "Due_time": 1731563621,
    "End_time": 1731563621,
    "ExtraPort": {
      "p1": 10158,
      "p2": 10159,
      "p3": 10160,
      "p4": 10161,
      "p5": 10162,
      "p6": 10163
    },
    "Gpu_index": "0",
    "Gpu_num": 1,
    "Gpu_type": "GeForce RTX 3080",
    "Host": "inner-0112",
    "Id": 799,
    "IkatagoName": "",
    "IkatagoPass": "",
    "Image": "centos7_matlabR2021b",
    "Init_passwd": "peeNa3qu",
    "InstanceAutorenew": null,
    "IsAbnormal": 3,
    "IsSaveDiskState": true,
    "KeeppedDiskCost": 0,
    "KvmDataDiskSize": 0,
    "KvmDataUseSsd": 1,
    "LastAbnoramlTime": 1730195400,
    "LastInitPasswd": "ohro4phu",
    "LastRestartTime": 0,
    "LinuxVncPort": 10113,
    "LoginUserName": "",
    "MaxBandwidth": 200,
    "Memory": 6,
    "Message": "[success]服务启动成功!",
    "NoFreeBandwidth": 0,
    "Note": "",
    "PayTypeFirst": "money",
    "Performance": "normal",
    "PortMappingInner": {
      "linux_vnc_port": 5901,
      "p1": 8800,
      "p2": 8801,
      "p3": 8802,
      "p4": 8803,
      "p5": 8804,
      "p6": 8805,
      "rdp_port": 3389,
      "ssh_port": 22
    },
    "RdpPasswd": "peeNa3qu",
    "RdpPort": 10110,
    "ReturnMoney": 0.43,
    "SshPort": 10112,
    "Status": 0,
    "SubAccountName": "",
    "Total_cost": 0,
    "Url": "223.109.239.20",
    "Use_mode": 1,
    "VncPasswd": "peeNa3qu",
    "VncPort": 10111,
    "Volumn": ""
  }
}
修改于 2025-01-23 01:58:33
上一页
获取自主实例列表
下一页
获取自主实例费用汇总
Built with