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"
}查询实例详情
PPIO 算力 API v2 文档介绍如何读取指定实例详情,说明相关请求与结果处理方式,为开发者核对实例信息与相关运行配置提供参考。
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 字符。
响应
查询成功
实例 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"