弹性云服务器 ECS-创建ECS高频场景示例:查询可用的公共镜像

时间：2025-02-28 08:55:29

弹性云服务器 ECS

使用镜像服务的查询镜像列表的API可以根据不同条件查询镜像列表信息，在GET请求后通过‘?’和‘&’添加不同的查询条件组合。

如需查询公共镜像列表。

GET /v2/cloudimages?__imagetype=gold&visibility=public&protected=true

请注意调用镜像服务接口注意替换镜像服务的Endpoint信息。

查询镜像列表时，建议使用分页查询才能返回全部的镜像列表。通过指定marker和limit实现镜像列表的分页查询。

marker表示从哪个镜像开始查询，取值为镜像ID。limit表示查询几条镜像记录，取值为整数，默认取值为500。

GET /v2/cloudimages?__imagetype=gold&visibility=public&protected=true&marker=af92bb51-ec9d-4b02-912f-da0b3f0f7635&limit=5

如需查询其他的镜像类型

公共镜像列表查询
 GET /v2/cloudimages?__imagetype=gold&visibility=public&protected=true
私有镜像列表查询
 GET /v2/cloudimages?owner={project_id}
可以使用的共享镜像列表
 GET /v2/cloudimages?member_status=accepted&visibility=shared&__imagetype=shared
被拒绝的共享镜像列表
 GET /v2/cloudimages?member_status=rejected&visibility=shared&__imagetype=shared
未接受的共享镜像列表
 GET /v2/cloudimages?member_status=pending&visibility=shared&__imagetype=shared
裸金属服务器某规格支持的公共镜像列表
 GET /v2/cloudimages?__imagetype=gold&__support_xxx=true&virtual_env_type=Ironic