跳转到主要内容
GET
/
gpu-instance
/
openapi
/
v1
/
images
获取镜像列表
curl --request GET \
  --url https://api.ppio.com/gpu-instance/openapi/v1/images \
  --header 'Authorization: <authorization>'
{
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "url": "<string>",
      "tags": [
        {
          "name": "<string>",
          "url": "<string>"
        }
      ]
    }
  ],
  "pageSize": 123,
  "pageNum": 123,
  "total": 123
}

​
请求头

​
Authorization
string
必填
Bearer 身份验证格式，例如：Bearer {{API 密钥}}。

​
查询参数

​
type
string
必填
镜像类型。可选值：
  • base：平台官方镜像
  • private：私有仓库镜像
​
name
string
镜像名称（模糊匹配）。
​
pageSize
integer
必填
每页数量。取值范围：>= 1。
​
pageNum
integer
必填
页码。取值范围：>= 1。

​
示例

curl --location --request GET 'https://api.ppio.com/gpu-instance/openapi/v1/images?name=&type=private&pageSize=10&pageNum=1' \
--header 'Authorization: Bearer {{API_KEY}}'

​
响应参数

​
data
object[]
必填
镜像列表。
​
pageSize
integer
必填
每页数量。
​
pageNum
integer
必填
当前页码。
​
total
integer
必填
镜像总数。

​
响应示例

{
  "data": [
    {
      "id": "42",
      "name": "nwe",
      "url": "test-image.ppinfra.com/dev-pukcnedkqkioyhnxrawo/image_ubuntu_test_keli_1202:v1",
      "tags": [
        {
          "name": "v1",
          "url": "test-image.ppinfra.com/dev-pukcnedkqkioyhnxrawo/image_ubuntu_test_keli_1202:v1"
        },
        {
          "name": "v3",
          "url": "test-image.ppinfra.com/dev-pukcnedkqkioyhnxrawo/image_ubuntu_test_keli_1202:v3"
        }
      ],
      "metadata": [],
      "port": []
    }
  ],
  "pageSize": 10,
  "pageNum": 1,
  "total": 14
}
最后修改于 2026年6月10日