# 查询镜像列表 - ListImages #### 功能介绍 根据不同条件查询镜像列表信息。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?locale=zh-cn&consoleCurrentProductId=ims&consoleCurrentProductshort=&product=IMS&api=ListImages)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ims/ims_03_appendix_03.html)。 #### URI GET /v2/cloudimages ![](https://support.huaweicloud.com/api-ims/public_sys-resources/note_3.0-zh-cn.png) - 可以在URI后面用'?'和'\&'添加不同的查询条件组合，请参考请求样例。 - 如果只使用企业项目授权，必须传入enterprise_project_id参数，参数描述参见[表1]获取，否则可能会出现报错无权限。 表1查询参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | __isregistered | 否 | String | **参数解释：** 镜像是否已注册。 **约束限制：** 普通用户只能查询取值为true的镜像。 **取值范围：** 取值为true/false。 - true：已注册的镜像 - false：未注册的镜像 **默认取值：** true | | __imagetype | 否 | String | **参数解释：** 镜像的类型。 **约束限制：** 当前租户共享给其他租户的私有镜像或当前租户接受的共享镜像中，__imagetype均为shared，可用owner字段进行区分。当前租户接受的共享镜像可用member_status进行过滤查询。 **取值范围：** - 公共镜像：gold - 私有镜像：private - 共享镜像：shared - 市场镜像：market **默认取值：** 不涉及。 | | __whole_image | 否 | Boolean | **参数解释：** 是否为整机镜像。 **约束限制：** 不涉及。 **取值范围：** 取值为true/false。 - true：整机镜像 - false：非整机镜像 **默认取值：** 不涉及。 | | __system__cmkid | 否 | String | **参数解释：** 加密镜像所使用的密钥ID。可以从镜像服务控制台获取，或者调用[查询镜像列表 - ListImages](https://support.huaweicloud.com/api-ims/ims_03_0602.html)API查询。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | protected | 否 | Boolean | **参数解释：** 镜像是否受保护。受保护的镜像不允许删除。 **约束限制：** 查询公共镜像时建议取值为true，查询私有镜像时可不指定该参数 **取值范围：** 取值为true/false。 - true：受保护 - false：不受保护 **默认取值：** 不涉及。 | | visibility | 否 | String | **参数解释：** 是否被其他租户可见。 **约束限制：** 不涉及。 **取值范围：** - public：公共镜像 - private：私有镜像 - shared：共享镜像 **默认取值：** 不涉及。 | | owner | 否 | String | **参数解释：** 镜像所属租户的项目ID。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-ims/ims_03_0909.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | id | 否 | String | **参数解释：** 镜像ID。可通过[查看私有镜像详情](https://support.huaweicloud.com/usermanual-ims/ims_01_0720.html)获取。 支持同时输入多个镜像ID，批量查询镜像，镜像ID之间使用英文逗号隔开。 **约束限制：** 一次最多可查询50个镜像。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | status | 否 | String | **参数解释：** 镜像的状态。 **约束限制：** 不涉及。 **取值范围：** - queued：表示镜像元数据已经创建成功，等待上传镜像文件。 - saving：表示镜像正在上传文件到后端存储。 - deleted：表示镜像已经删除。 - killed：表示镜像上传错误。 - active：表示镜像可以正常使用。 **默认取值：** 不涉及。 | | name | 否 | String | **参数解释：** 镜像名称。name参数说明请参考[镜像属性](https://support.huaweicloud.com/api-ims/ims_03_0901.html#ims_03_0901__section61598810155254)。 **约束限制：** 匹配规则为精确匹配。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | flavor_id | 否 | String | **参数解释：** 用于通过云服务器规格过滤出可用公共镜像，取值为规格ID。可通过[查询规格详情和规格扩展信息列表](https://support.huaweicloud.com/api-ecs/zh-cn_topic_0020212656.html)。 **约束限制：** - 仅支持通过单个规格进行过滤。 - 仅支持按照云服务器规格进行过滤，裸金属服务器暂不支持。 如果需要查看某裸金属服务器规格支持的公共镜像，可以使用"__support_s4l=true"标签。其中，s4l为裸金属服务器规格的board_type，若规格为"physical.s4.large"，则填入"s4l"。详细说明请参见"[怎么确定裸金属服务器规格的board_type？](https://support.huaweicloud.com/bms_faq/bms_faq_1601.html)"。调用示例请参考[常用列表查询方法]。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | container_format | 否 | String | **参数解释：** 容器类型。 **约束限制：** 不涉及。 **取值范围：** 固定取值为 bare，表示无容器封装。 **默认取值：** 不涉及。 | | disk_format | 否 | String | **参数解释：** 镜像格式。 **约束限制：** 不涉及。 **取值范围：** 目前支持zvhd2、vhd、zvhd、raw、qcow2、iso。 **默认取值：** 非iso格式时默认值是zvhd2。 | | min_ram | 否 | Integer | **参数解释：** 镜像运行需要的最小内存，单位为MB。 **约束限制：** 不涉及 **取值范围：** 参数取值依据云服务器的规格限制，一般设置为0。云服务器的规格限制，请参见[规格清单](https://support.huaweicloud.com/productdesc-ecs/zh-cn_topic_0159822360.html)。 **默认取值：** 不涉及 | | min_disk | 否 | Integer | **参数解释：** 镜像运行需要的最小磁盘，单位为GB 。 **约束限制：** 不涉及 **取值范围：** linux操作系统取值为10～1024GB，Windows操作系统取值为20～1024GB。 **默认取值：** 不涉及 | | __os_bit | 否 | String | **参数解释：** 操作系统位数。 **约束限制：** 不涉及 **取值范围：** 一般取值为32或者64。 - 32：32位操作系统 - 64：64位操作系统 **默认取值：** 不涉及 | | __platform | 否 | String | **参数解释：** 镜像平台分类。 **约束限制：** 不涉及 **取值范围：** 取值为Windows、Ubuntu、Red Hat、SUSE、CentOS、Debian、OpenSUSE、Oracle Linux、Fedora、Other、CoreOS和Huawei Cloud EulerOS等。 **默认取值：** 不涉及 | | marker | 否 | String | **参数解释：** 用于分页，表示从哪个镜像开始查询。 **约束限制：** 不涉及 **取值范围：** 取值为镜像ID。镜像ID获取请参见[查看私有镜像详情](https://support.huaweicloud.com/usermanual-ims/ims_01_0720.html)。 **默认取值：** 不涉及 | | limit | 否 | Integer | **参数解释：** 用于分页，表示查询几条镜像记录。 **约束限制：** 不涉及 **取值范围：** 取值为整数，取值范围为\[1,1000\]。 **默认取值：** 1000 | | sort_key | 否 | String | **参数解释：** 用于排序，表示按照哪个字段排序。 **约束限制：** 不涉及 **取值范围：** - name：镜像名称 - container_format：容器类型 - disk_format：镜像格式 - status：镜像状态 - id：镜像ID - size：目前暂不使用 - created_at：镜像创建时间 **默认取值：** created_at | | sort_dir | 否 | String | **参数解释：** 用于排序，表示升序还是降序。 **约束限制：** 与sort_key参数组合使用。 **取值范围：** 取值为asc和desc。 - asc：升序 - desc：降序 **默认取值：** 默认为降序desc。 | | __os_type | 否 | String | **参数解释：** 操作系统类型。 **约束限制：** 不涉及 **取值范围：** - Linux：Linux操作系统 - Windows：Windows操作系统 - Other：其他操作系统 **默认取值：** 不涉及 | | tag | 否 | String | **参数解释：** 标签，用户为镜像增加自定义标签后可以通过该参数过滤查询。 说明： 系统近期对标签功能进行了升级。如果之前添加的Tag为"Key.Value"的形式，则查询的时候需要使用"Key=Value"的格式来查询。例如：之前添加的tag为"a.b",则升级后，查询时需使用"tag=a=b"。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | member_status | 否 | String | **参数解释：** 成员状态。 **约束限制：** 需要在查询时，设置"visibility"参数为"shared"。 **取值范围：** - accepted：表示已经接受共享的镜像 - rejected：表示已经拒绝了其他用户共享的镜像 - pending：表示需要确认的其他用户的共享镜像 **默认取值：** 不涉及 | | __support_kvm | 否 | String | **参数解释：** 如果镜像支持KVM，取值为true，否则无需增加该属性。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | __support_xen | 否 | String | **参数解释：** 如果镜像支持XEN，取值为true，否则无需增加该属性。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | __support_largememory | 否 | String | **参数解释：** 表示该镜像支持超大内存。如果镜像支持超大内存，取值为true，否则无需增加该属性。 镜像操作系统类型请参考"[弹性云服务器类型与支持的操作系统版本](https://support.huaweicloud.com/productdesc-ims/ims_01_0007.html)"。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | __support_diskintensive | 否 | String | **参数解释：** 表示该镜像支持密集存储。如果镜像支持密集存储性能，则值为true，否则无需增加该属性。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | __support_highperformance | 否 | String | **参数解释：** 表示该镜像支持高计算性能。如果镜像支持高计算性能，则值为true，否则无需增加该属性。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | __support_xen_gpu_type | 否 | String | **参数解释：** 表示该镜像是支持XEN虚拟化平台下的GPU类型。 **约束限制：** 该属性与"__support_xen"和"__support_kvm"属性不共存。 **取值范围：** 取值参考[表2](https://support.huaweicloud.com/api-ims/ims_03_0910.html#ims_03_0910__table65768383152758)。如果不支持XEN虚拟化下GPU类型，无需添加该属性。 **默认取值：** 不涉及 | | __support_kvm_gpu_type | 否 | String | **参数解释：** 表示该镜像是支持KVM虚拟化平台下的GPU类型。 **约束限制：** 该属性与"__support_xen"和"__support_kvm"属性不共存。 **取值范围：** 取值参考[表3](https://support.huaweicloud.com/api-ims/ims_03_0910.html#ims_03_0910__table282523154017)。如果不支持KVM虚拟化下GPU类型，无需添加该属性。 **默认取值：** 不涉及 | | __support_xen_hana | 否 | String | **参数解释：** 表示该镜像是支持XEN虚拟化平台下的HANA类型。 **约束限制：** 该属性与"__support_xen"和"__support_kvm"属性不共存。 **取值范围：** 如果镜像支持XEN虚拟化下HANA类型，取值为true。否则，无需添加该属性。 **默认取值：** 不涉及 | | __support_kvm_infiniband | 否 | String | **参数解释：** 表示该镜像支持KVM虚拟化平台下的Infiniband网卡类型。 **约束限制：** 该属性与"__support_xen"属性不共存。 **取值范围：** 如果镜像支持KVM虚拟化下Infiniband网卡类型，取值为true。否则，无需添加该属性。 **默认取值：** 不涉及 | | virtual_env_type | 否 | String | **参数解释：** 镜像的使用环境类型。 **约束限制：** 不涉及 **取值范围：** - FusionCompute：云服务器镜像（即系统盘镜像） - DataImage：数据盘镜像 - Ironic：裸金属服务器镜像 - IsoImage：ISO镜像 **默认取值**： 不涉及 | | enterprise_project_id | 否 | String | **参数解释：** 表示查询某个企业项目下的镜像。 关于企业项目特性的详细信息，请参考"[企业中心总览](https://support.huaweicloud.com/usermanual-em/zh-cn_topic_0123692049.html)"。企业项目ID的获取，请参考[如何获取企业项目ID](https://support.huaweicloud.com/usermanual-em/zh-cn_topic_0126101490.html)。 **约束限制：** 如果只使用企业项目授权，必须传入enterprise_project_id参数，否则可能会出现报错无权限。 **取值范围：** - 取值为0，表示查询属于default企业项目下的镜像。 - 取值为UUID，表示查询属于该UUID对应的企业项目下的镜像。 - 取值为all_granted_eps，表示查询当前用户所有企业项目下的镜像。 **默认取值**： 不涉及 | | created_at | 否 | String | **参数解释：** 镜像创建时间。支持按照时间点过滤查询，取值格式为"操作符:UTC时间"。 支持的时间格式为yyyy-MM-ddThh:mm:ssZ或者yyyy-MM-dd hh:mm:ss 例如，查询创建时间在2018-10-28 10:00:00之前的镜像，可以通过如下条件过滤： created_at=lt:2018-10-28T10:00:00Z **约束限制：** 操作符支持如下几种： - gt：大于 - gte：大于等于 - lt：小于 - lte：小于等于 - eq：等于 - neq：不等于 **取值范围：** 不涉及 **默认取值：** 不涉及 | | updated_at | 否 | String | **参数解释：** 镜像修改时间。使用UTC时间格式，格式为yyyy-MM-ddTHH:mm:ssZ或yyyy-MM-dd HH:mm:ss。例如：2018-10-28T10:00:00Z。支持按照时间点过滤查询，取值格式为"操作符:UTC时间"。 **约束限制：** 操作符支持如下几种： - gt：大于 - gte：大于等于 - lt：小于 - lte：小于等于 - eq：等于 - neq：不等于 **取值范围：** 不涉及 **默认取值：** 不涉及 | | architecture | 否 | String | **参数解释：** 镜像架构类型。 **约束限制：** 不涉及 **取值范围：** - x86：表示x86架构。 - arm：表示ARM架构。 **默认取值：** 不涉及 | #### 请求消息 请求参数 无 #### 请求示例 按查询条件查询镜像列表，其中，镜像类型为公共镜像，排序为镜像名称，查询镜像记录为1条。 ``` GET https://{Endpoint}/v2/cloudimages?__imagetype=gold&sort_key=name&limit=1 ``` #### 常用列表查询方法 - 公共镜像列表查询 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 #### 响应消息 - 响应参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | images | Array of objects | **参数解释：** 镜像详情。具体请参见[表2]。 **取值范围：** 不涉及 | | page_info | object | **参数解释：** 分页信息。具体请参见[表3]。 **取值范围：** 不涉及 | 表2images字段说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | file | String | **参数解释：** 镜像文件下载和上传链接。 **取值范围：** 不涉及 | | owner | String | **参数解释：** 镜像所属租户的项目ID。 **取值范围：** 不涉及 | | id | String | **参数解释：** 镜像ID。 **取值范围：** 不涉及 | | size | Long | **参数解释：** 镜像文件的大小，预留字段，当前不支持该功能。 **取值范围：** 不涉及 | | self | String | **参数解释：** 镜像链接信息。 **取值范围：** 不涉及 | | schema | String | **参数解释：** 镜像视图。 **取值范围：** 不涉及 | | status | String | **参数解释：** 镜像状态。 **取值范围：** - queued：表示镜像元数据已经创建成功，等待上传镜像文件。 - saving：表示镜像正在上传文件到后端存储。 - deleted：表示镜像已经删除。 - killed：表示镜像上传错误。 - active：表示镜像可以正常使用。 | | tags | Array of strings | **参数解释：** 镜像标签列表，提供用户可以自定义管理私有镜像的能力。用户可以通过镜像标签接口为每个镜像增加不同的标签，在查询接口中可以根据标签进行过滤。 **取值范围：** 不涉及 | | visibility | String | **参数解释：** 是否被其他租户可见。 **取值范围：** - private：表示私有镜像。 - public：表示公共镜像。 - shared：表示共享镜像。 | | name | String | **参数解释：** 镜像名称。name参数说明请参考[镜像属性](https://support.huaweicloud.com/api-ims/ims_03_0901.html#ims_03_0901__section61598810155254)。 **取值范围：** 不涉及 | | checksum | String | **参数解释：** 镜像文件内容的校验和。预留字段，当前不支持该功能。 **取值范围：** 不涉及 | | protected | Boolean | **参数解释：** 镜像是否受保护。受保护的镜像不允许删除。 **取值范围：** 取值为true或false。 - true：受保护 - false：不受保护 | | container_format | String | **参数解释：** 容器类型。 **取值范围：** 固定取值为 bare，表示无容器封装。 | | min_ram | Integer | **参数解释：** 镜像运行最小内存，单位为MB。云服务器的规格限制，请参见[规格清单](https://support.huaweicloud.com/productdesc-ecs/zh-cn_topic_0159822360.html)。 **取值范围：** 取值参考云服务器规格限制，一般设置为0。 | | max_ram | String | **参数解释：** 镜像支持的最大内存，单位为MB。云服务器的规格限制，请参见[规格清单](https://support.huaweicloud.com/productdesc-ecs/zh-cn_topic_0159822360.html)。 **取值范围：** 取值可以参考云服务器规格限制，一般不设置。 | | updated_at | String | **参数解释：** 更新时间。格式为UTC时间。 **取值范围：** 不涉及 | | __os_bit | String | **参数解释：** 操作系统位数。 **取值范围：** 一般取值为"32"或者"64"。 | | __os_version | String | **参数解释：** 操作系统具体版本。 **取值范围：** 不涉及 | | __description | String | **参数解释：** 镜像描述信息。_description参数说明请参考[镜像属性](https://support.huaweicloud.com/api-ims/ims_03_0901.html#ims_03_0901__section61598810155254)。 **取值范围：** 不涉及 | | disk_format | String | **参数解释：** 镜像格式。 **取值范围：** 目前支持zvhd2、vhd、zvhd、raw、qcow2、iso。 | | __isregistered | String | **参数解释：** 是否是注册过的镜像。 **取值范围：** 取值为"true"或者"false"。 | | __platform | String | **参数解释：** 镜像平台分类。 **取值范围：** 取值为Windows、Ubuntu、Red Hat、SUSE、CentOS、Debian、OpenSUSE、Oracle Linux、Fedora、Other、CoreOS和Huawei Cloud EulerOS等。 | | __os_type | String | **参数解释：** 操作系统类型。 **取值范围：** 目前取值Linux、Windows、Other。 | | min_disk | Integer | **参数解释：** 镜像运行需要的最小磁盘，单位为GB 。 **取值范围：** linux操作系统取值为10～1024GB，Windows操作系统取值为20～1024GB。 | | virtual_env_type | String | **参数解释：** 镜像使用环境类型。 **取值范围：** - FusionCompute：云服务器镜像 - DataImage：数据盘镜像 - Ironic：裸金属服务器镜像 - IsoImage：ISO镜像 | | __image_source_type | String | **参数解释：** 镜像后端存储类型，目前支持uds。 **取值范围：** 不涉及 | | __imagetype | String | **参数解释：** 镜像类型。 **取值范围：** - 公共镜像：gold - 私有镜像：private - 共享镜像：shared - 市场镜像：market | | created_at | String | **参数解释：** 创建时间。格式为UTC时间。 **取值范围：** 不涉及 | | virtual_size | Integer | **参数解释：** 虚拟磁盘的逻辑大小。预留字段，当前不支持该功能。 **取值范围：** 不涉及 | | __originalimagename | String | **参数解释：** 父镜像ID。公共镜像或通过文件创建的私有镜像，取值为空。 **取值范围：** 不涉及 | | __backup_id | String | **参数解释：** 备份ID。如果是备份创建的镜像，则填写为备份的ID，否则为空。 **取值范围：** 不涉及 | | __productcode | String | **参数解释：** 市场镜像的产品ID。 **取值范围：** 不涉及 | | __image_size | String | **参数解释：** 镜像文件的大小，单位为字节。 **取值范围：** 不涉及 | | __data_origin | String | **参数解释：** 镜像来源。公共镜像为空。 **取值范围：** 不涉及 | | __lazyloading | String | **参数解释：** 镜像是否支持延迟加载。 **取值范围：** true：支持延迟加载 false：不支持延迟加载 True：支持延迟加载 False：不支持延迟加载 | | active_at | String | **参数解释：** 镜像状态变为正常的时间。格式为UTC时间，如yyyy-MM-ddTHH:mm:ssZ。示例值如：例如2025-10-28T10:00:00Z。 **取值范围：** 不涉及 | | __image_displayname | String | **参数解释：** 镜像对外展示名称。 **取值范围：** 不涉及 | | __os_feature_list | String | **参数解释：** 镜像附加属性。该属性采用JSON格式来标识镜像支持的高级特性清单。 **取值范围：** 不涉及 | | __support_kvm | String | **参数解释：** 表示该镜像支持KVM。 **取值范围：** 如果镜像支持KVM，取值为true，否则无需增加该属性。 | | __support_xen | String | **参数解释：** 表示该镜像支持XEN。 **取值范围：** 如果镜像支持XEN，取值为true，否则无需增加该属性。 | | __support_largememory | String | **参数解释：** 表示该镜像支持超大内存。 **取值范围：** 如果镜像支持超大内存，取值为true，否则无需增加该属性。 | | __support_diskintensive | String | **参数解释：** 表示该镜像支持密集存储。 **取值范围：** 如果镜像支持密集存储性能，则值为true，否则无需增加该属性。 | | __support_highperformance | String | **参数解释：** 表示该镜像支持高计算性能。 **取值范围：** 如果镜像支持高计算性能，则值为true，否则无需增加该属性。 | | __support_xen_gpu_type | String | **参数解释：** 表示该镜像是支持XEN虚拟化平台下的GPU优化类型。镜像支持的GPU类型请参考[表2](https://support.huaweicloud.com/api-ims/ims_03_0910.html#ims_03_0910__table65768383152758)。 **取值范围：** 如果镜像支持XEN虚拟化平台下的GPU优化类型，则值为true，否则无需增加该属性。 | | __support_kvm_gpu_type | String | **参数解释：** 表示该镜像是支持KVM虚拟化平台下的GPU类型。镜像支持的GPU类型请参考[表3](https://support.huaweicloud.com/api-ims/ims_03_0910.html#ims_03_0910__table282523154017)。 **取值范围：** 如果镜像是支持KVM虚拟化平台下的GPU类型，则值为true，否则无需增加该属性。 | | __support_xen_hana | String | **参数解释：** 表示该镜像支持XEN虚拟化下HANA类型。 **取值范围：** 如果镜像支持XEN虚拟化下HANA类型，取值为true。否则，无需添加该属性。 | | __support_kvm_infiniband | String | **参数解释：** 表示该镜像支持KVM虚拟化下Infiniband网卡类型。 **取值范围：** 如果镜像支持KVM虚拟化下Infiniband网卡类型，取值为true。否则，无需添加该属性。 | | __system_support_market | Boolean | **参数解释：** 表示当前镜像是否支持发布为市场镜像。 **取值范围：** - true：支持 - false：不支持 | | __is_offshelved | String | **参数解释：** 表示当前市场镜像是否下架。 **取值范围：** - true：已下架 - false：未下架 | | enterprise_project_id | String | **参数解释：** 表示当前镜像所属的企业项目。 关于企业项目特性的详细信息，请参考"[企业中心总览](https://support.huaweicloud.com/usermanual-em/zh-cn_topic_0123692049.html)"。企业项目ID的获取，请参考[如何获取企业项目ID](https://support.huaweicloud.com/usermanual-em/zh-cn_topic_0126101490.html)。 **取值范围：** - 取值为0或无该值，表示属于default企业项目。 - 取值为UUID，表示属于该UUID对应的企业项目。 | | __root_origin | String | **参数解释：** 表示当前镜像来源。 **取值范围：** file：通过文件创建的镜像。 | | __sequence_num | String | **参数解释：** 表示当前镜像对应云服务器的系统盘插槽位置。 **取值范围：** 不涉及 | | __support_fc_inject | String | **参数解释：** 表示当前镜像是否支持Cloud-Init密码/密钥注入方式。 说明： 该特性参数只对ECS系统盘镜像生效，其他类型镜像不生效。 **取值范围：** 如果取值为"true"，表示该镜像不支持Cloud-Init注入密码/密钥，其他取值时表示支持Cloud-Init注入密钥/密码。 | | hw_firmware_type | String | **参数解释：** 云服务器的启动方式。 **取值范围：** 目前支持： - bios：表示bios引导启动。 - uefi：表示uefi引导启动。 | | hw_vif_multiqueue_enabled | String | **参数解释：** 镜像是否支持网卡多队列。 **取值范围：** 取值为"true"或者"false"。 - true：支持网卡多队列 - false：不支持网卡多队列 | | __support_arm | String | **参数解释：** 是否是ARM架构类型的镜像。 **取值范围：** 取值为"true"或者"false"。 - true：ARM架构镜像 - false：非ARM架构镜像 | | __support_agent_list | String | **参数解释：** 镜像是否支持主机安全或主机监控。 **取值范围：** - hss：主机安全 - ces：主机监控 取值样例： "__support_agent_list": "hss,ces" 说明： 如果查询结果无此字段，表示镜像不支持主机安全或主机监控。 | | __system__cmkid | String | **参数解释：** 加密镜像所使用的密钥ID。 **取值范围：** 不涉及 | | __account_code | String | **参数解释：** 收费镜像标识。 **取值范围：** 不涉及 | | __support_amd | String | **参数解释：** 是否是AMD架构类型的镜像。 **取值范围：** 取值为"true"或者"false"。 - true：AMD架构镜像 - false：非AMD架构镜像 | | __support_kvm_hi1822_hisriov | String | **参数解释：** 表示该镜像支持sriov直通。 **取值范围：** 如果镜像支持sriov直通，取值为true，否则无需增加该属性。 | | __support_kvm_hi1822_hivirtionet | String | **参数解释：** 表示该镜像支持Virtio-net直通规格。 **取值范围：** 如果镜像支持Virtio-net直通规格，取值为true，否则无需增加该属性。 | | os_shutdown_timeout | String | **参数解释：** 设置虚拟机的优雅关机超时时间。建议Linux镜像设置为120，Windows镜像设置为600。 云服务器在优雅关机超时后会触发强制关机，避免实例长时间处于关机状态中。当您的云服务器关机过程中由于特定软件的状态保存等原因导致优雅关机时间过长，会触发超时强制关机。您可以通过设置镜像该字段，使得发放的云服务器优雅关机超时时间变长。 该字段当前只影响弹性云服务器，不影响裸金属服务器。 **取值范围：** 设置范围为60-1200（取值为整数，单位为秒） | 表3page_info字段说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | next_marker | String | **参数解释：** 分页时，作为查询下一页的marker，取值为镜像ID。如果查询结果中该字段有值，证明有下一页数据。 **取值范围：** 不涉及 | - 响应样例 ``` STATUS CODE 200 ``` ``` { "images": [ { "schema": "/v2/schemas/image", "min_disk": 100, "created_at": "2018-09-06T14:03:27Z", "__image_source_type": "uds", "container_format": "bare", "file": "/v2/images/bc6bed6e-ba3a-4447-afcc-449174a3eb52/file", "updated_at": "2018-09-06T15:17:33Z", "protected": true, "checksum": "d41d8cd98f00b204e9800998ecf8427e", "id": "bc6bed6e-ba3a-4447-afcc-449174a3eb52", "__isregistered": "true", "min_ram": 2048, "__lazyloading": "true", "owner": "1bed856811654c1cb661a6ca845ebc77", "__os_type": "Linux", "__imagetype": "gold", "visibility": "public", "virtual_env_type": "FusionCompute", "tags": [], "__platform": "CentOS", "size": 0, "__os_bit": "64", "__os_version": "CentOS 7.3 64bit", "name": "CentOS 7.3 64bit vivado", "self": "/v2/images/bc6bed6e-ba3a-4447-afcc-449174a3eb52", "disk_format": "zvhd2", "virtual_size": null, "hw_firmware_type": "bios", "status": "active", "__support_fc_inject":"true" }, { "schema": "/v2/schemas/image", "min_disk": 100, "created_at": "2018-09-06T14:03:05Z", "__image_source_type": "uds", "container_format": "bare", "file": "/v2/images/0328c25e-c840-4496-81ac-c4e01b214b1f/file", "updated_at": "2018-09-25T14:27:40Z", "protected": true, "checksum": "d41d8cd98f00b204e9800998ecf8427e", "id": "0328c25e-c840-4496-81ac-c4e01b214b1f", "__isregistered": "true", "min_ram": 2048, "__lazyloading": "true", "owner": "1bed856811654c1cb661a6ca845ebc77", "__os_type": "Linux", "__imagetype": "gold", "visibility": "public", "virtual_env_type": "FusionCompute", "tags": [], "__platform": "CentOS", "size": 0, "__os_bit": "64", "__os_version": "CentOS 7.3 64bit", "name": "CentOS 7.3 64bit with sdx", "self": "/v2/images/0328c25e-c840-4496-81ac-c4e01b214b1f", "disk_format": "zvhd2", "virtual_size": null, "hw_firmware_type": "bios", "status": "active", "__support_fc_inject":"true" } ], "page_info":{ "next_marker": "0328c25e-c840-4496-81ac-c4e01b214b1f" } } ``` #### 返回值 - 正常 200 - 异常 | 返回值 | 说明 | |:---|:---| | 400 Bad Request | 请求错误，具体返回错误码请参考[错误码](https://support.huaweicloud.com/api-ims/ims_03_0908.html)。 | | 401 Unauthorized | 鉴权失败。 | | 403 Forbidden | 没有操作权限。 | | 404 Not Found | 找不到资源。 | | 500 Internal Server Error | 服务内部错误。 | | 503 Service Unavailable | 服务不可用。 |