跳转到主要内容
GET
/
gpus
/
v2
/
instances
/
{instance_id}
查询实例详情
curl --request GET \
  --url https://api.ppio.com/gpus/v2/instances/{instance_id} \
  --header 'Authorization: <authorization>'
{
  "id": "ca338f12f3",
  "name": "example-instance",
  "type": "gpu",
  "product_id": "product-id",
  "image": "registry.example.com/namespace/image:tag",
  "registry_auth_id": "registry-auth-id",
  "entrypoint": "",
  "command": "",
  "billing": {
    "mode": "prepaid",
    "prepaid": {
      "months": 1,
      "end_time": 1714464000,
      "auto_renew": {
        "enabled": true,
        "months": 1,
        "status": "active"
      }
    }
  },
  "envs": [
    {
      "key": "ENV_NAME",
      "value": "ENV_VALUE"
    }
  ],
  "ports": [
    {
      "port": 8080,
      "protocol": "tcp",
      "endpoint": "http://1.2.3.4:8080"
    }
  ],
  "resource_specs": {
    "rootfs_size_gb": 20,
    "gpu_num": 1,
    "cpu_num": 8,
    "memory_gb": 32,
    "gpu_ids": [
      0
    ]
  },
  "network": {
    "id": "vpc-550e8400-e29b-41d4-a716-446655440000",
    "ip": "10.2.1.1"
  },
  "volumes": [
    {
      "type": "network",
      "id": "network-storage-id",
      "mount_point": "/data"
    }
  ],
  "region": "region-id",
  "tools": {
    "jupyter": {
      "endpoint": "https://jupyter.example.com/instance/ca338f12f3",
      "enabled": true,
      "port": 8888
    },
    "ssh": {
      "command": "ssh -p 51039 root@proxy.cn-south-nas-1.gpu-instance.ppinfra.com",
      "password": "xxx",
      "username": "xxx"
    },
    "web_terminal": {
      "endpoint": "wss://terminal.example.com/instance/ca338f12f3",
      "enabled": true,
      "username": "root",
      "password": "xxx"
    },
    "log": {
      "instance_endpoint": "https://log.example.com/system/ca338f12f3",
      "system_endpoint": "https://log.example.com/instance/ca338f12f3"
    }
  },
  "auto_migrate": {
    "enabled": false,
    "include_system_disk": false
  },
  "status": {
    "status": "running",
    "error": "",
    "message": ""
  },
  "pricing": {
    "instance_price": 100,
    "instance_base_price": 120,
    "rootfs_storage_price": 10,
    "prepaid": {
      "monthly_price": [
        {
          "price": 1000,
          "base_price": 1200,
          "month": 1,
          "price_precision": 2,
          "month_spec_id": "spec-1m"
        }
      ]
    },
    "spot": {
      "spot_status": "<string>",
      "spot_reclaim_time": 123
    }
  },
  "created_at": 1714464000,
  "last_started_at": 1714467600,
  "last_stopped_at": 0,
  "member_id": "member-id",
  "owner_id": "550e8400-e29b-41d4-a716-446655440000",
  "region_version": "v1.0"
}

请求头

Authorization
string
必填

Bearer 身份验证格式,例如:Bearer {{API 密钥}}

路径参数

instance_id
string
必填

实例 ID。字符串,长度限制:1-255 字符。

响应

200 - application/json

查询成功

id
string

实例 ID

示例:

"ca338f12f3"

name
string

实例名称

示例:

"example-instance"

type
string

实例类型。可选值:gpucpu

示例:

"gpu"

product_id
string

产品 ID

示例:

"product-id"

image
string

镜像地址

示例:

"registry.example.com/namespace/image:tag"

registry_auth_id
string

镜像仓库认证 ID

示例:

"registry-auth-id"

entrypoint
string

容器 entrypoint

示例:

""

command
string

容器启动命令

示例:

""

billing
object

计费配置

envs
object[]

环境变量列表

ports
object[]

暴露端口列表

resource_specs
object

资源规格(含系统分配信息)

network
object

VPC 网络配置

volumes
object[]

数据盘/网络存储挂载列表

region
string

实例所在区域

示例:

"region-id"

tools
object

实例工具信息

auto_migrate
object

自动迁移配置

status
object

实例状态信息

pricing
object

计费/价格信息

created_at
integer

实例创建时间。Unix 时间戳

示例:

1714464000

last_started_at
integer

最近一次启动时间。Unix 时间戳

示例:

1714467600

last_stopped_at
integer

最近一次停止时间。Unix 时间戳

示例:

0

member_id
string

创建者 member ID

示例:

"member-id"

owner_id
string

所属用户 ID(团队所有者 UUID)

示例:

"550e8400-e29b-41d4-a716-446655440000"

region_version
string

实例版本

示例:

"v1.0"

最后修改于 2026年6月26日