修订记录

2023-11-16

第六十一次正式发布。

修改

• 异步任务查询，响应参数中，entities字段中新增参数addition_error_code、addition_error_msg、error_code、error、alarm_code。
• 镜像文件快速导入、制作镜像、制作整机镜像、Region内复制镜像、跨Region复制镜像修改description参数描述。

2023-09-20

第六十次正式发布。

修改

异步任务查询，修改entities、sub_jobs_result参数类型。

2023-08-09

第五十九次正式发布。

修改

• 错误码，修改错误码IMG.0026对应的状态码。
• 查询镜像列表（OpenStack原生），补充响应参数“ _sys_enterprise_project_id”。
• 查询镜像列表，参数“__platform”补充取值。

2023-06-14

第五十八次正式发布。

请求示例规范写作，补充和优化请求示例描述内容。

2023-05-25

第五十七次正式发布。

修改

• 创建镜像元数据（OpenStack原生），修改disk_format参数描述。

2023-04-07

第五十六次正式发布。

修改

10.2-镜像管理，增加“查询镜像支持的OS列表”权限项。

2023-03-23

第五十五次正式发布。

修改

• 认证鉴权，优化Token认证描述。
• 按条件查询租户镜像标签列表，enterprise_project_id字段删除all_granted_eps的取值说明。
• 创建镜像元数据（OpenStack原生），修正tag参数及示例中key示例。
• 错误码，修正错误码IMG.0056描述。

2023-02-24

第五十四次正式发布。

修改

• 异步任务查询、异步任务进度查询，补充job_type具体的任务类型。
• 查询镜像列表（OpenStack原生），修正sort_key描述中的created_at。
• 10.2-镜像管理，补充注册镜像时企业项目权限的限制。

2023-01-17

第五十三次正式发布。

修改

• 错误码，补充IMG.1075错误码。

2023-01-12

第五十二次正式发布。

修改

查询镜像列表、查询镜像列表（OpenStack原生）、查询镜像详情（OpenStack原生）、创建镜像元数据（OpenStack原生）、镜像属性，修改disk_format参数描述。

2023-01-06

第五十一次正式发布。

修改

• 错误码，增加错误码IMG.0238、IMG.0239、IMG.0241、IMG.0242。

2022-12-27

第五十次正式发布。

修改

异步任务查询、异步任务进度查询，增加sub_jobs_result、sub_jobs_list参数及相关字段说明。

2022-12-22

第四十九次正式发布。

修改

制作镜像，请求样例中删除is_config_init字段。

2022-11-29

第四十八次正式发布。

修改

• 查询镜像列表，修改id的参数说明，支持根据镜像ID批量查询镜像。
• 查询版本列表（OpenStack原生）、查询指定版本信息（OpenStack原生），修改正常返回值为300。
• 跨Region复制镜像，增加vault_id参数及整机镜像的请求示例。

2022-10-25

第四十七次正式发布。

修改

查询镜像列表、更新镜像信息、查询镜像列表（OpenStack原生）、查询镜像详情（OpenStack原生）、更新镜像信息（OpenStack原生）、镜像属性，__imagetype参数增加市场镜像类型。

2022-09-26

第四十六次正式发布。

修改

查询镜像列表、查询镜像列表（OpenStack原生）、查询镜像详情（OpenStack原生），删除响应示例中的__support_kvm_fpga_type参数。

2022-08-17

第四十五次正式发布。

修改__lazyloading字段取值。

2022-05-20

第四十四次正式发布。

新增

异步任务进度查询

2022-03-21

第四十三次正式发布。

• 制作整机镜像，修改whole_image_type参数的描述。
• 镜像文件快速导入，修改os_type参数为非必选，默认值为Linux。
• 使用外部镜像文件制作数据镜像，修改os_type参数为非必选，默认值为Linux。

2021-10-30

第四十二次正式发布。

• 异步任务查询，响应参数中entities属性增加响应参数current_task，image_name，process_percent，results；增加result对象。

2021-09-26

第四十一次正式发布。

修改

• 按标签查询镜像，响应参数增加resource_detail和tags的引用。
• 更新镜像信息（OpenStack原生）,新增响应参数__support_amd。

2021-09-13

第四十次正式发布。

修改

• 查询镜像列表（OpenStack原生），size类型改为integer。
• 更新镜像信息（OpenStack原生），删除重复的__account_code字段。
• 按标签查询镜像，resource增加表7的引用。
• 更新镜像信息，删除重复字段__system__cmkid，__account_code，__system_support_market

2021-08-12

第三十九次正式发布。

修改

• 查询镜像列表，__lazyloading类型改为string。
• 查询镜像列表（OpenStack原生），增加字段 images.__system__cmkid，images.hw_vif_multiqueue_enabled，修改__lazyloading类型改为string。
• 更新镜像信息（OpenStack原生），增加字段__support_agent_list，修改__lazyloading类型改为string。
• 按标签查询镜像，resources.resource_detail、tags_any、not_tags、not_tags_any 增加详请。
• 更新镜像信息，修改字段 images.__support_agent_list 为 __support_agent_list ，images.__system__cmkid 为 __system__cmkid，__lazyloading类型改为string。
• 查询镜像详情（OpenStack原生），__lazyloading类型改为string。

2021-08-05

第三十八次正式发布。

新增

• 响应参数__support_amd

修改

• 调用说明，修改SDK参考链接为https://sdkcenter.developer.huaweicloud.com/zh-cn。
• 认证鉴权
• 镜像标签数据格式

2021-07-06

第三十七次正式发布。

修改

• 查询镜像列表，新增响应参数images.__system__cmkid、images.__account_code；删除响应参数deleted、deleted_at。
• 查询镜像列表（OpenStack原生），新增响应参数__account_code；删除响应参数deleted、deleted_at。
• 更新镜像信息，新增响应参数__account_code、__image_location、__is_config_init；删除响应参数deleted、deleted_at。
• 创建镜像元数据（OpenStack原生），新增响应参数properties。
• 更新镜像信息，新增响应参数images.__support_agent_list、images.__system__cmkid、__system_support_market、__account_code；删除响应参数deleted、deleted_at。
• 查询镜像详情（OpenStack原生），新增响应参数__account_code、__image_location、__is_config_init；删除响应参数deleted、deleted_at。

2021-06-21

第三十六次正式发布。

新增

• 在各个接口中增加API Explorer的调试入口。

修改

• 制作镜像，优化image_url的参数说明，补充OBS桶名、OBS桶对象名称的查询方式。

2020-05-30

第三十五次正式发布。

修改

• API概览，补全接口说明表格中的子类型。
• 查询镜像列表，请求参数中补充“__system__cmkid”参数，用户可以按照密钥ID过滤镜像列表。

2020-03-25

第三十四次正式发布。

新增

使用ISO文件创建镜像

修改

查询镜像列表，补充了查看某裸金属服务器规格支持的公共镜像列表的方法。

2020-01-20

第三十三次正式发布。

新增如下接口：

• 按标签查询镜像
• 批量添加删除镜像标签
• 添加镜像标签
• 删除镜像标签
• 查询镜像标签
• 查询租户所有镜像标签

修改

10.1-权限及授权项说明，IAM控制台改版，修改权限相关描述。

2019-11-30

第三十二次正式发布。

修改

查询镜像列表、查询镜像列表（OpenStack原生）、镜像属性，说明镜像属性“name”的匹配规则为精确匹配。

2019-10-30

第三十一次正式发布。

修改

查询镜像列表，补充常用列表查询方法。

2019-07-30

第三十次正式发布。

新增

查询镜像支持的OS列表

修改

• 支持快速导出功能，涉及修改：

  导出镜像，请求消息中新增is_quick_export字段，并更新请求样例。

• 构造请求，修改请求消息体中的示例。
• 获取项目ID，补充通过API获取项目ID的方式。

2019-06-30

第二十九次正式发布。

• 整机镜像支持共享功能，涉及修改：
  • 制作整机镜像，新增vault_id、whole_image_type字段，并更新请求样例。
  • 批量更新镜像成员状态，新增vault_id字段，并更新请求样例。
  • 更新镜像成员状态（OpenStack原生），新增vault_id字段，并更新请求样例。
• 支持创建ARM架构类型的私有镜像，涉及修改：
  • 查询镜像列表、制作镜像、镜像文件快速导入，新增请求参数architecture、响应参数hw_firmware_type和_support_arm。
  • 更新镜像信息，参数hw_firmware_type新增说明，并新增响应参数_support_arm。
  • 镜像文件快速导入，新增请求参数architecture。
  • 查询镜像列表（OpenStack原生）、查询镜像详情（OpenStack原生），新增响应参数hw_firmware_type和_support_arm。
  • 更新镜像信息（OpenStack原生），新增响应参数_support_arm。
  • 错误码，新增错误码IMG.0212。

2019-05-30

第二十八次正式发布。

新增

• 使用前必读
• 如何调用API
• 查询指定版本信息（OpenStack原生）
• 10.1-权限及授权项说明

修改

• 制作镜像，修改os_version参数说明，新增参数data_images、is_quick_import，支持多盘快速导入功能。
• 查询镜像列表、更新镜像信息、查询镜像列表（OpenStack原生）、查询镜像详情（OpenStack原生）、更新镜像信息（OpenStack原生），新增参数“__is_offshelved”。
• 批量更新镜像成员状态、更新镜像成员状态（OpenStack原生），修改“status”参数说明。
• 错误码，新增错误码。

2019-04-30

第二十七次正式发布。

2019-03-30

第二十六次正式发布。

修改

• 查询镜像列表，修改参数“disk_format”的参数说明，补充iso格式。
• 更新镜像信息，修改参数“disk_format”的参数说明，补充iso格式。
• 制作镜像，新增使用ISO文件创建镜像时的约束限制。
• 注册镜像，修改参数“image_url”的参数说明，补充iso格式。
• 制作镜像，修改请求参数“type”和“os_version”的参数说明。
• 删除镜像（OpenStack原生），新增请求参数“delete_backup”，支持删除整机镜像时同步删除云服务器备份。
• 相关参数取值列表，__os_version取值新增CentOS 64bit、Red Hat Linux Enterprise 7.6 64bit、Oracle Linux Server release 7.6 64bit。

2019-01-30

第二十五次正式发布。

修改

• 制作镜像，支持使用数据盘制作系统盘镜像。
• 查询镜像列表、更新镜像信息、查询镜像列表（OpenStack原生）、查询镜像详情（OpenStack原生）、更新镜像信息（OpenStack原生）章节新增参数：“_support_fc_inject”。

2018-12-29

第二十四次正式发布。

本次更新说明如下：

• 认证鉴权章节更新AK/SK认证的内容及Demo。

2018-10-30

第二十三次正式发布。

本次更新说明如下：

• 查询镜像列表章节新增参数："created_at"“updated_at”。
• 查询镜像列表（OpenStack原生）章节新增参数："created_at"“updated_at”。
• 查询镜像列表、更新镜像信息、更新镜像信息（OpenStack原生）新增响应参数max_ram。

2018-09-30

第二十二次正式发布。

本次更新说明如下：

• 新增镜像文件快速导入。
• 修改查询镜像列表章节响应样例。
• 修改查询镜像列表（OpenStack原生）章节响应样例。
• 修改查询镜像详情（OpenStack原生）章节响应样例。

2018-08-30

第二十一次正式发布。

本次更新说明如下：

• 修改“API授权项列表”章节。
• 镜像属性新增“enterprise_project_id”参数。
• 查询镜像列表（OpenStack原生）章节visibility参数新增shared取值。

2018-07-30

第二十次正式发布。

本次更新说明如下：

• 新增“跨Region复制镜像”章节。
• “查询镜像列表”接口删除“__is_config_init”响应参数。
• “查询镜像详情”接口删除“__is_config_init”响应参数。
• “更新镜像信息”接口删除“__is_config_init”响应参数。
• “制作镜像”接口使用上传至OBS桶中的外部镜像文件时的Request Body参数新增“is_config_init”。

2018-06-30

第十九次正式发布。

本次更新说明如下：

新增“制作整机镜像”章节。

2018-05-30

第十八次正式发布。

本次更新说明如下：

新增“异步任务进度查询”章节。

2018-03-30

第十七次正式发布。

本次更新说明如下：

新增“API授权项列表”。

2018-01-30

第十六次正式发布。

本次更新说明如下：

新增“镜像配额”章节。

2017-10-30

第十五次正式发布。

本次更新说明如下：

• 新增“创建镜像元数据（OpenStack原生）”。
• min_disk取值上限调整为1024GB。

2017-09-30

第十四次正式发布。

本次更新说明如下：

新增“查询版本（OpenStack原生）”。

2017-06-30

第十三次正式发布。

本次更新说明如下：

更新“镜像查询列表”URI格式。

2017-05-30

第十二次正式发布。

本次更新说明如下：

• 新增“查询镜像列表（OpenStack原生）”。
• 新增“更新镜像信息（OpenStack原生）”。

2017-03-30

第十一次正式发布。

本次更新说明如下：

• 更新“__os_version”取值列表和镜像类型列表。

2017-02-28

第十次正式发布。

本次更新说明如下：

• 新增“查询镜像成员视图（OpenStack原生）”、“查询镜像成员列表视图（OpenStack原生）”和“Region内复制镜像”接口。
• 更新“__os_version”取值列表。

2017-02-08

第九次正式发布。

更新“__os_version”取值列表。

2017-01-20

第八次正式发布。

本次更新说明如下。

• “制作镜像接口”中使用上传至OBS桶中的外部镜像文件制作镜像时，用户可对镜像加密，新增“cmk_id”参数。
• “查询镜像列表”接口的URI参数说明及响应参数、“查询镜像详情”和“更新镜像信息"接口的响应参数更新。

2016-11-24

第七次正式发布。

本次更新说明如下：

• 修改“生成AK、SK”步骤。
• 优化多个接口中的“min_disk”、“min_ram”、“status”、“created_at”和“updated_at”的参数说明。
• “导出镜像”接口新增“file_format”参数。

2016-10-29

第六次正式发布。

本次更新说明如下：

• “查询镜像列表”接口新增“__is_config_init”响应参数。
• “查询镜像详情”接口新增“__is_config_init”响应参数。
• “更新镜像信息”接口新增“__is_config_init”响应参数。
• “制作镜像”接口使用上传至OBS桶中的外部镜像文件时的Request Body参数新增“is_config_init”。

2016-09-30

第五次正式发布。

本次更新说明如下：

• 修改“查询镜像列表”接口的URI参数。
• 修改“查询镜像详情”接口的响应要素。
• 修改“更新镜像信息”接口的响应要素。
• 刷新“__os_version”取值列表。

2016-09-18

第四次正式发布。

本次更新说明如下：

• 新增“导出镜像”接口。
• 新增“镜像共享”章节。

2016-06-02

第三次正式发布。

• 修改“服务使用方法”中“URL参数说明”。

2016-01-22

第二次正式发布。

本次变更说明如下：

• 修改“请求签名流程”，更新了SDK jar包和签名过程。
• 修改“示例代码”，优化代码。
• 修改“公共请求消息头”，新增消息头，部分消息头更改为非必选。

2015-10-15

第一次正式发布。