You need to enable JavaScript to run this app.
边缘计算节点

边缘计算节点

请输入
  • 文档首页
    • 边缘计算节点边缘计算节点API 参考镜像获取镜像列表
复制全文
我的收藏
镜像
获取镜像列表
复制全文
我的收藏
获取镜像列表

本接口用于获取某一实例规格支持的镜像列表，包括公共镜像和自定义镜像。

使用说明

注意事项：
默认列出自定义镜像。如果需要列出公共镜像，您需要将 property 参数设置为 PublicBaseImage。

请求说明

  • 请求方式：GET
  • 请求地址：https://veenedge.volcengineapi.com/?Action=ListImages&Version=2021-04-30

请求参数

下表列出了接口特定的请求参数以及公共请求参数 Action 和 Version。 其他公共参数，请参见公共参数。

Query

参数
类型
是否必选
示例值
描述
Action
String
是
ListImages
接口名称。当前 API 的名称为 ListImages。
Version
String
是
2021-04-30
接口版本。当前 API 的版本为 2021-04-30。
instance_type
String
是
veEN.G1.large
实例规格。您可以通过 ListInstanceTypes 接口获取可开通的实例规格。
system_arch
String
否
Linux

操作系统的架构。取值范围：

  • Linux：Linux 操作系统。
  • Windows：Windows 操作系统。
system_bit
String
否
64

操作系统的位数。取值范围：

  • 32：32位操作系统。
  • 64：64位操作系统。
system_type
String
否
CentOs

操作系统的类型。取值范围：
Linux：

  • CentOS
  • Ubuntu
  • Debian
  • Rocky

Windows：

  • Windows

veLinux：

  • veLinux
system_version
String
否
8.3

操作系统的版本。
CentOS：

  • 6.9
  • 7.2
  • 7.3
  • 7.4
  • 7.5
  • 7.6
  • 7.8
  • 7.9
  • 8.3

Debian：

  • 9
  • 10
  • 11
  • 12

Ubuntu：

  • Server 16.04 LTS
  • Server 18.04 LTS
  • Server 20.04 LTS
  • Server 22.04 LTS
  • Server 24.04 LTS

Rocky：

  • 9.2

Windows：

  • 10
  • 2012 R2 STD 标准版
  • 2016 STD 标准版
  • 2019 STD 标准版
  • 2022 STD 标准版

veLinux：

  • 1.0(CentOS兼容版)
disk_size
Integer
否
50
镜像的系统盘的大小。单位：GB。
label
String
否
IPV6

镜像标签，取值范围：

  • IPV6：IPv6。
  • MultiIPPriNet：辅助私网 IP。

镜像标签之间用半角逗号（,）分隔。

说明

  • label 参数仅在 property 参数的值为 PublicBaseImage 生效。
  • 如果您没有开通 IPv6、辅助私网 IP 功能，无法通过指定 label 参数来列出相关镜像。如需开通相关功能，请提交工单申请。
property
String
否
UrlImage

镜像属性，取值范围：

  • BENBuildImage：通过边缘实例创建的镜像。
  • LocalImage：本地镜像。
  • PublicBaseImage：公共镜像。
  • UrlImage：通过 URL 上传的镜像。
project
String
否
default
镜像所属的项目。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结果。

参数
类型
示例值
描述
images
Object[]
-
镜像列表。

请求示例

GET https://veenedge.volcengineapi.com/?Action=ListImages&Version=2021-04-30
&instance_type=veEN.G1.large
&<其他公共参数>

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202110222135390102250842170003****",
    "Action": "ListImages",
    "Version": "2021-04-30",
    "Service": "veenedge",
    "Region": "cn-north-1"
  },
  "Result": {
    "images": [
      {
        "id": "imagespnwnf****",
        "name": "helloworld",
        "description": "test",
        "system_arch": "Linux",
        "system_bit": "64位",
        "system_type": "CentOS",
        "system_version": "8.3",
        "disk_size": 50,
        "property": "UrlImage",
        "status": "Online",
        "is_enable": false,
        "label": null,
        "create_time": "2021-07-20T20:09:26+08:00",
        "update_time": "2021-07-20T20:09:26+08:00"，
        "boot_mode": "BIOS"
      },
      {
        "id": "image6gb5xg****",
        "name": "ztest",
        "description": "",
        "system_arch": "Linux",
        "system_bit": "64位",
        "system_type": "CentOS",
        "system_version": "8.3",
        "disk_size": 50,
        "property": "LocalImage",
        "status": "Uploading",
        "is_enable": false,
        "label": null,
        "create_time": "2021-05-26T06:15:50+08:00",
        "update_time": "2021-09-22T16:55:39+08:00"，
        "boot_mode": "BIOS"
      }
    ]
  }
}

错误码

如果响应正文中包含 Error 字段，则表示 API 请求失败。关于错误码的更多信息，参见错误码。

最近更新时间：2025.12.22 17:43:06
这个页面对您有帮助吗？
有用
有用
无用
无用