查询实例详情
curl --request GET \
--url https://api.ppio.com/gpu-instance/openapi/v1/gpu/instance \
--header 'Authorization: <authorization>'import requests
url = "https://api.ppio.com/gpu-instance/openapi/v1/gpu/instance"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.ppio.com/gpu-instance/openapi/v1/gpu/instance', 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/gpu-instance/openapi/v1/gpu/instance",
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/gpu-instance/openapi/v1/gpu/instance"
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/gpu-instance/openapi/v1/gpu/instance")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ppio.com/gpu-instance/openapi/v1/gpu/instance")
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": "<string>",
"name": "<string>",
"clusterId": "<string>",
"clusterName": "<string>",
"status": "<string>",
"sshCommand": "<string>",
"password": "<string>",
"imageUrl": "<string>",
"imageAuthId": "<string>",
"command": "<string>",
"entrypoint": "<string>",
"cpuNum": "<string>",
"memory": "<string>",
"gpuNum": "<string>",
"createdAt": "<string>",
"lastStartedAt": "<string>",
"lastStoppedAt": "<string>",
"useTime": "<string>",
"billingMode": "<string>",
"productId": "<string>",
"productName": "<string>",
"rootfsSize": 123,
"tools": [
{
"name": "<string>",
"port": "<string>",
"type": "<string>",
"endpoint": "<string>"
}
],
"volumeMounts": [
{
"type": "<string>",
"size": "<string>",
"id": "<string>",
"mountPath": "<string>"
}
],
"node": [
{
"maxRootfsSize": "<string>"
}
],
"jobs": [
{
"id": "<string>",
"type": "<string>"
}
],
"statusError": {
"state": "<string>",
"message": "<string>"
},
"network": {
"id": "<string>",
"ip": "<string>"
},
"portMappings": [
{
"port": 123,
"endpoint": "<string>",
"type": "<string>"
}
],
"envs": [
{
"key": "<string>",
"value": "<string>"
}
],
"connectComponentSSH": {
"isRunning": true
},
"connectComponentWebTerminal": {
"address": "<string>",
"username": "<string>",
"password": "<string>",
"isRunning": true
},
"connectComponentJupyter": {
"port": 123,
"address": "<string>",
"isRunning": true
},
"connectComponentLog": {
"systemLogAddress": "<string>",
"instanceLogAddress": "<string>",
"isRunning": true
},
"kind": "<string>",
"endTime": "<string>",
"freeStorageSize": 123,
"keepDataDay": 123
}实例
查询实例详情
PPIO 算力 API 文档介绍如何读取指定实例详情,说明相关请求与结果处理方式,为开发者核对实例信息与相关运行配置提供参考。
GET
/
gpu-instance
/
openapi
/
v1
/
gpu
/
instance
查询实例详情
curl --request GET \
--url https://api.ppio.com/gpu-instance/openapi/v1/gpu/instance \
--header 'Authorization: <authorization>'import requests
url = "https://api.ppio.com/gpu-instance/openapi/v1/gpu/instance"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.ppio.com/gpu-instance/openapi/v1/gpu/instance', 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/gpu-instance/openapi/v1/gpu/instance",
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/gpu-instance/openapi/v1/gpu/instance"
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/gpu-instance/openapi/v1/gpu/instance")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ppio.com/gpu-instance/openapi/v1/gpu/instance")
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": "<string>",
"name": "<string>",
"clusterId": "<string>",
"clusterName": "<string>",
"status": "<string>",
"sshCommand": "<string>",
"password": "<string>",
"imageUrl": "<string>",
"imageAuthId": "<string>",
"command": "<string>",
"entrypoint": "<string>",
"cpuNum": "<string>",
"memory": "<string>",
"gpuNum": "<string>",
"createdAt": "<string>",
"lastStartedAt": "<string>",
"lastStoppedAt": "<string>",
"useTime": "<string>",
"billingMode": "<string>",
"productId": "<string>",
"productName": "<string>",
"rootfsSize": 123,
"tools": [
{
"name": "<string>",
"port": "<string>",
"type": "<string>",
"endpoint": "<string>"
}
],
"volumeMounts": [
{
"type": "<string>",
"size": "<string>",
"id": "<string>",
"mountPath": "<string>"
}
],
"node": [
{
"maxRootfsSize": "<string>"
}
],
"jobs": [
{
"id": "<string>",
"type": "<string>"
}
],
"statusError": {
"state": "<string>",
"message": "<string>"
},
"network": {
"id": "<string>",
"ip": "<string>"
},
"portMappings": [
{
"port": 123,
"endpoint": "<string>",
"type": "<string>"
}
],
"envs": [
{
"key": "<string>",
"value": "<string>"
}
],
"connectComponentSSH": {
"isRunning": true
},
"connectComponentWebTerminal": {
"address": "<string>",
"username": "<string>",
"password": "<string>",
"isRunning": true
},
"connectComponentJupyter": {
"port": 123,
"address": "<string>",
"isRunning": true
},
"connectComponentLog": {
"systemLogAddress": "<string>",
"instanceLogAddress": "<string>",
"isRunning": true
},
"kind": "<string>",
"endTime": "<string>",
"freeStorageSize": 123,
"keepDataDay": 123
}请求头
查询参数
响应参数
实例状态。取值:
toCreate:待创建creating:创建中pulling:拉取镜像中running:运行中toStart:待启动starting:启动中toStop:待停止stopping:停止中exited:已停止toRestart:待重启restarting:重启中toRemove:待删除removing:删除中removed:已删除toReset:待重置(升级)resetting:重置中migrating:迁移中freezing:冻结中
实例日志连接信息(HTTP Stream)。
显示 properties
显示 properties
实例日志地址。请求日志时可在地址中增加如下参数:
- follow=0 或 1:是否持续获取日志。取值 0(不持续) 或 1(持续)。默认 1。
- sse=0 或 1:是否使用 SSE 协议返回日志。取值 0(不使用) 或 1(使用)。默认 1。
- timestamp=0 或 1:是否需要时间戳。取值 0(不需要) 或 1(需要)。默认 1。
- tail=x:初始化日志时获取最后 x 行。
https://c092dad5a76a3da2-2224.gpu-instance.ppinfra.com/sys?follow=1&sse=1×tamps=1&tail=200最后修改于 2026年10月13日