查询实例详情
curl --request GET \
--url https://api.ppio.com/gpus/v2/instances/{instance_id} \
--header 'Authorization: <authorization>'import requests
url = "https://api.ppio.com/gpus/v2/instances/{instance_id}"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.ppio.com/gpus/v2/instances/{instance_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ppio.com/gpus/v2/instances/{instance_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.ppio.com/gpus/v2/instances/{instance_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.ppio.com/gpus/v2/instances/{instance_id}")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ppio.com/gpus/v2/instances/{instance_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"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"
}实例
查询实例详情
GET
/
gpus
/
v2
/
instances
/
{instance_id}
查询实例详情
curl --request GET \
--url https://api.ppio.com/gpus/v2/instances/{instance_id} \
--header 'Authorization: <authorization>'import requests
url = "https://api.ppio.com/gpus/v2/instances/{instance_id}"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.ppio.com/gpus/v2/instances/{instance_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ppio.com/gpus/v2/instances/{instance_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.ppio.com/gpus/v2/instances/{instance_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.ppio.com/gpus/v2/instances/{instance_id}")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ppio.com/gpus/v2/instances/{instance_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"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"
}请求头
Bearer 身份验证格式,例如:Bearer {{API 密钥}}。
路径参数
实例 ID。字符串,长度限制:1-255 字符。
响应
200 - application/json
查询成功
实例 ID
示例:
"ca338f12f3"
实例名称
示例:
"example-instance"
实例类型。可选值:gpu、cpu
示例:
"gpu"
产品 ID
示例:
"product-id"
镜像地址
示例:
"registry.example.com/namespace/image:tag"
镜像仓库认证 ID
示例:
"registry-auth-id"
容器 entrypoint
示例:
""
容器启动命令
示例:
""
计费配置
Show child attributes
Show child attributes
环境变量列表
Show child attributes
Show child attributes
暴露端口列表
Show child attributes
Show child attributes
资源规格(含系统分配信息)
Show child attributes
Show child attributes
VPC 网络配置
Show child attributes
Show child attributes
数据盘/网络存储挂载列表
Show child attributes
Show child attributes
实例所在区域
示例:
"region-id"
实例工具信息
Show child attributes
Show child attributes
自动迁移配置
Show child attributes
Show child attributes
实例状态信息
Show child attributes
Show child attributes
计费/价格信息
Show child attributes
Show child attributes
实例创建时间。Unix 时间戳
示例:
1714464000
最近一次启动时间。Unix 时间戳
示例:
1714467600
最近一次停止时间。Unix 时间戳
示例:
0
创建者 member ID
示例:
"member-id"
所属用户 ID(团队所有者 UUID)
示例:
"550e8400-e29b-41d4-a716-446655440000"
实例版本
示例:
"v1.0"
最后修改于 2026年6月26日
⌘I