You need to enable JavaScript to run this app.
文档中心
容器服务

容器服务

复制全文
下载 pdf
机型镜像管理
ListSupportedImages - 获取实例规格支持的镜像列表
复制全文
下载 pdf
ListSupportedImages - 获取实例规格支持的镜像列表
获取节点对应云服务器(ECS)实例规格支持的镜像列表。​
接口说明​
  • 仅 v1.30 及以上版本的 Kubernetes 集群,支持使用 veLinux 2.0、Ubuntu 22.x 系列镜像的节点。​
  • veLinux 2.0、Ubuntu 22.x 系列镜像默认使用 cgroup v2。​
请求说明​
VKE 已在全球多个地域部署服务,旨在为您提供更稳定、低延迟的访问体验。您可以通过查阅 服务地址 文档,根据业务所在地域,选择最合适的接入点。​
  • 请求方式:POST​
  • 请求地址:https://vke.cn-beijing.volcengineapi.com?Action=ListSupportedImages&Version=2022-05-12​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
调用该 API 时的请求参数如下,除此之外还需传入公共请求参数。公共请求参数说明,请参见 公共参数。​
​
参数​
类型​
是否必选​
示例值​
描述​
Action​
String​
是​
ListSupportedImages​
接口名称。当前 API 的名称为 ListSupportedImages。​
Version​
String​
是​
2022-05-12​
接口版本。当前 API 的版本为 2022-05-12。​
InstanceTypeIds​
Array of String​
是​
["ecs.g1ie.large"]​
节点对应 ECS 实例规格 ID。可以调用 ListNodePools 接口,获取实例规格 ID。单次最多填写 10 个实例规格 ID。​
Intersection​
Boolean​
否​
true​
是否获取镜像交集。取值:​
  • true:返回所有选定实例规格共同支持的镜像列表。​
  • false:(默认值)返回指定实例规格支持的镜像列表。​
KubernetesVersion​
String​
否​
v1.28.3-vke.1​
集群的 Kubernetes 版本,允许基于实例规格和 Kubernetes 版本获取支持的镜像列表。​
​
请求示例​
​
POST https://vke.cn-beijing.volcengineapi.com?Action=ListSupportedImages&Version=2022-05-12​
Content-Type: application/json​
{​
"InstanceTypeIds": [​
"ecs.g1ie.**.**.**.**.**.**",​
"ecs.g3ilt.**.**.**.**.**.**"​
],​
"Intersection": false,​
"KubernetesVersion": "v1.28.3-vke.1"​
}​
​
返回参数​
本接口返回参数如下表所示,公共返回参数请参见 返回结果。​
​
参数​
类型​
示例值​
描述​
Items​
-​
返回的镜像信息列表。​
IntersectionItems​
Array of ImageResponse​
-​
返回的镜像交集列表。​
​
SupportedImagesResponse​
​
参数​
类型​
示例值​
描述​
InstanceTypeId​
String​
ecs.g1i*******​
节点规格 ID。​
SupportedImages​
Array of ImageResponse​
-​
节点对应实例规格支持的镜像列表。​
​
ImageResponse​
​
参数​
类型​
示例值​
描述​
ImageId​
String​
img-1******​
镜像 ID。​
ImageName​
String​
ubuntu-20.04​
镜像名称。​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "202306041104********",​
"Action": "ListSupportedImages",​
"Version": "2022-05-12",​
"Service": "vke",​
"Region": "cn-beijing"​
},​
"Result": {​
"Items": [​
{​
"InstanceTypeId": "ecs.g1i*******",​
"SupportedImages": [​
{​
"ImageId": "img-1*****",​
"ImageName": "ubuntu-20.04"​
},​
{​
"ImageId": "img-3*****",​
"ImageName": "ubuntu-20.04"​
}​
]​
},​
{​
"InstanceTypeId": "ecs.g3i********",​
"SupportedImages": [​
{​
"ImageId": "img-3*****",​
"ImageName": "ubuntu-20.04"​
}​
]​
}​
]​
}​
}​
​
错误码​
本接口无专有错误码,公共错误码请参见 公共错误码。​
​
最近更新时间:2026.05.09 19:23:03
这个页面对您有帮助吗?
有用
有用
无用
无用