查询实例详情
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
}实例
查询实例详情
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
}请求头
string
必填
Bearer 身份验证格式,例如:Bearer {{API 密钥}}。
查询参数
string
必填
要查询详情的实例 ID。
响应参数
string
必填
实例 ID。
string
必填
实例名称。
string
必填
集群 ID。
string
必填
集群名称。
string
必填
实例状态。取值:
toCreate:待创建creating:创建中pulling:拉取镜像中running:运行中toStart:待启动starting:启动中toStop:待停止stopping:停止中exited:已停止toRestart:待重启restarting:重启中toRemove:待删除removing:删除中removed:已删除toReset:待重置(升级)resetting:重置中migrating:迁移中freezing:冻结中
string
用于 SSH 远程登录的命令。
string
用于 SSH 远程登录的密码。
string
必填
容器镜像地址。
string
必填
镜像仓库认证信息。
string
必填
容器启动命令。
string
容器启动 entrypoint。
string
必填
实例的 CPU 数。单位为核。
string
必填
实例的内存大小。单位为 GB。
string
必填
实例的 GPU 卡数。
string
必填
实例的创建时间。格式为 Unix 时间戳。
string
必填
实例最近一次的启动时间。格式为 Unix 时间戳。
string
必填
实例最近一次的停止时间。格式为 Unix 时间戳。
string
必填
实例的使用时长。单位为秒。
string
必填
实例的计费方式。取值:
- onDemand:按量计费。
- monthly:包年包月。
- spot: 抢占式计费。
string
必填
用于部署实例的产品 ID。
string
必填
用于部署实例的产品名称。
integer
必填
系统盘大小。单位为 GB。
object[]
object[]
object
object
实例日志连接信息(HTTP Stream)。
显示 properties
显示 properties
string
系统日志地址。
string
实例日志地址。请求日志时可在地址中增加如下参数:
- 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=200boolean
是否正在连接。
string
实例类型。
string
包年包月实例到期时间。若是按量计费实例,则返回 -1。
integer
免费的系统盘容量大小。单位为 GB。
integer
实例关机后,数据保留的天数。
最后修改于 2026年6月16日
⌘I