# 制作镜像（新） - CreateImageInSafeMode #### 功能介绍 本接口用于制作私有镜像，支持： - 使用云服务器制作私有镜像（系统盘镜像/数据盘镜像）。 - 使用上传至OBS桶中的外部镜像文件制作系统盘镜像。 - 使用数据盘制作系统盘镜像。 作为异步接口，调用成功，只是说明云平台收到了制作请求，镜像是否制作成功需要通过异步任务进度查询接口查询该任务的执行状态，具体请参考[异步任务进度查询 - ShowJobProgress](https://support.huaweicloud.com/api-ims/ims_03_0911.html)。 #### 约束与限制 - 制作加密镜像场景需要租户有KMS相关action权限。 - 使用外部镜像文件制作镜像 外部镜像文件的限制请参见"[准备镜像文件](https://support.huaweicloud.com/usermanual-ims/ims_01_0203.html#section2)"。 - 使用数据盘创建系统盘镜像 使用数据盘制作系统盘镜像前，需要在虚拟机内部先完成初始化配置，以保证镜像的可用性。如何配置，请参见[创建私有镜像准备工作](https://support.huaweicloud.com/usermanual-ims/zh-cn_topic_0047501112.html)。 由于系统无法校验您在调用该接口时指定的卷是否存在操作系统，因此制作系统盘镜像时，请务必确保您输入的os_version（操作系统版本）值合法，具体请参见[相关参数取值列表](https://support.huaweicloud.com/api-ims/ims_03_0910.html)。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IMS/doc?locale=zh-cn&consoleCurrentProductId=ims&consoleCurrentProductshort=&api=CreateImageInSafeMode)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ims/ims_03_appendix_03.html)。 #### URI POST /v2.1/cloudimages/action #### 请求消息 - 使用云服务器制作镜像（系统盘镜像/数据盘镜像）时的请求参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 否 | String | **参数解释：** 系统盘镜像名称。name参数说明请参考[镜像属性](https://support.huaweicloud.com/api-ims/ims_03_0901.html#ims_03_0901__section61598810155254)。 **约束限制：** - 名称的首尾字符不能为空格。 - 使用云服务器制作系统盘镜像时该参数必选，其他场景非必选。 **取值范围：** 只能由中文、字母、数字、空格和特殊字符 - _ . 组成，且首尾字符都不能为空格。名称的长度为1～128位。 **默认取值：** 不涉及 | | description | 否 | String | **参数解释：** 镜像描述信息。description参数说明请参考[镜像属性](https://support.huaweicloud.com/api-ims/ims_03_0901.html#ims_03_0901__section61598810155254)。 **约束限制：** 不涉及 **取值范围：** 支持字母、数字、中文等，不支持回车、\<、\>，长度不能超过1024个字符。 **默认取值：** 不涉及 | | instance_id | 否 | String | **参数解释：** 用于制作镜像的源云服务器ID。 如何获取云服务器ID： 1. 登录[ECS控制台](https://console.huaweicloud.com/ecm/?#/ecs/manager/vmList)。 2. 在云服务器列表栏，单击源云服务器名称，在详情页查看ID。 **约束限制：** 使用云服务器制作系统盘镜像时该参数必选，其他场景非必选。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | data_images | 否 | Array of objects | **参数解释：** 需要转换的数据盘信息，其中，当使用云服务器上的数据盘进行私有数据盘镜像创建时，该字段必选，详情请参见[表1]。 **约束限制：** - 当需要用数据盘创建数据盘镜像时，此表中的其他参数（如name、description、tags）如果有值，系统以data_images中的值为准，不允许再输入instance_id。 - 如果不是用于制作数据盘镜像，该字段默认为空。 | | tags | 否 | Array of strings | **参数解释：** 镜像标签列表。 标签的键可以包含任意语种字母、数字、空格和 _ . : + - @，但首尾不能含有空格，不能以sys_开头。 标签的值可以包含任意语种字母、数字、空格和_ . : / + - @，但首尾不能含有空格。 **约束限制：** tags和image_tags只能使用一个。 | | image_tags | 否 | Array of objects | **参数解释：** 新规范的镜像标签列表。image_tags数据结构说明请参见[表3](https://support.huaweicloud.com/api-ims/ims_03_0603.html#ims_03_0603__table1394012426522)。 **约束限制：** tags和image_tags只能使用一个。 | | 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对应的企业项目。 **默认取值：** 不涉及 | | max_ram | 否 | Integer | **参数解释：** 表示镜像支持的最大内存，单位为MB。 **约束限制：** 必须大于等于min_ram **取值范围：** 大于0的整数 **默认取值：** 不涉及 | | min_ram | 否 | Integer | **参数解释：** 表示镜像支持的最小内存，单位为MB。 **约束限制：** 不涉及 **取值范围：** 大于等于0的整数。 **默认取值：** 默认为0，表示不受限制。 | 表1data_images字段数据结构说明 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 是 | String | **参数解释：** 数据盘镜像名称。 **约束限制：** 名称的首尾字符不能为空格。 **取值范围：** 只能由中文、字母、数字、空格和特殊字符 - _ . 组成，且首尾字符都不能为空格。名称的长度为1～128位。 **默认取值：** 不涉及 | | volume_id | 是 | String | **参数解释：** 数据盘ID。请参考"[查询云服务器详情](https://support.huaweicloud.com/api-ecs/ecs_02_0104.html)"获取。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | description | 否 | String | **参数解释：** 数据盘描述。 **约束限制：** 不涉及。 **取值范围：** 支持字母、数字、中文等，不支持回车、\<、\>，长度不能超过1024个字符。 **默认取值：** 不涉及 | | tags | 否 | Array of strings | **参数解释：** 数据盘镜像标签。 标签的键可以包含任意语种字母、数字、空格和 _ . : + - @，但首尾不能含有空格，不能以sys_开头。 标签的值可以包含任意语种字母、数字、空格和_ . : / + - @，但首尾不能含有空格。 **约束限制：** tags和image_tags只能使用一个。 | - 使用上传至OBS桶中的外部镜像文件时的请求参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 是 | String | **参数解释：** 镜像名称。name参数说明请参考[镜像属性](https://support.huaweicloud.com/api-ims/ims_03_0901.html#ims_03_0901__section61598810155254)。 **约束限制：** 名称的首尾字符不能为空格。 **取值范围：** 只能由中文、字母、数字、空格和特殊字符 - _ . 组成，且首尾字符都不能为空格。名称的长度为1～128位。 **默认取值：** 不涉及 | | description | 否 | String | **参数解释：** 镜像描述信息。description参数说明请参考[镜像属性](https://support.huaweicloud.com/api-ims/ims_03_0901.html#ims_03_0901__section61598810155254)。 **约束限制：** 不涉及 **取值范围：** 支持字母、数字、中文等，不支持回车、\<、\>，长度不能超过1024个字符。 **默认取值：** 不涉及 | | os_version | 否 | String | **参数解释：** 操作系统版本。 **约束限制：** - 如果上传的文件为ISO格式，则该参数为必填参数。 - 当"is_quick_import"的值为"true"时，即使用镜像文件快速导入方式导入系统盘镜像，则该参数为必填参数。 - 使用上传至OBS桶中的外部镜像文件制作系统盘镜像时生效。 - 制作系统盘镜像过程中，如果系统能获取到外部镜像文件的操作系统，则以外部镜像文件中的操作系统版本为准，此时，设置的os_version无效。如果系统无法获取到外部镜像文件中的操作系统，此时，系统以输入的os_version版本为准。 **取值范围：** 具体取值见[os_version取值列表](https://support.huaweicloud.com/api-ims/ims_03_0910.html#ims_03_0910__section1979411301312)。请严格按照列表要求填写该值，否则可能会引起制作的系统盘镜像不可用。 **默认取值：** 不涉及 | | image_url | 是 | String | **参数解释：** OBS桶中外部镜像文件地址。 在使用OBS桶的外部镜像文件制作镜像时生效且为必选字段。格式为\:\。 - "OBS桶名"获取方式： 1. 登录[OBS控制台](https://console.huaweicloud.com/obs/?#/obs/manager/buckets)。 2. 在下方OBS桶列表栏显示所有已创建的OBS桶。 3. 查看当前Region下，用于存放外部镜像文件的"桶名称"。 - "OBS镜像文件名称"获取方式： 1. 登录[OBS控制台](https://console.huaweicloud.com/obs/?#/obs/manager/buckets)。 2. 在下方OBS桶列表栏显示所有已创建的OBS桶。 3. 查看当前Region下，用于存放外部镜像文件的"桶名称"。 4. 单击桶名称，进入对应OBS桶详情页。 5. 在左侧目录中选择"对象"，查看当前OBS桶中的对象，并记录用于制作镜像的外部镜像文件名称。 **约束限制：** 此处的OBS桶和镜像文件的存储类别必须是OBS标准存储。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | min_disk | 是 | Integer | **参数解释：** 最小系统盘大小。单位为GB。 在使用OBS桶的外部镜像文件制作镜像时生效且为必选字段。 **约束限制：** 不涉及 **取值范围：** Linux操作系统取值为10～1024GB，Windows操作系统取值为20～1024GB。 **默认取值：** 不涉及 | | is_config | 否 | Boolean | **参数解释：** 是否自动配置。 后台自动配置的内容请参考"[注册镜像](https://support.huaweicloud.com/usermanual-ims/ims_01_0203.html#section4)"。 **约束限制：** 不涉及 **取值范围：** 取值为true或false。 如果需要后台自动配置，取值为true，否则为false。 **默认取值：** 默认取值为false。 | | cmk_id | 否 | String | **参数解释：** 创建加密镜像的自定义密钥。 **约束限制：** 不涉及 **取值范围：** 具体取值请参考"[查看密钥](https://support.huaweicloud.com/usermanual-dew/dew_01_0179.html)"获取。 **默认取值：** 不涉及 | | tags | 否 | Array of strings | **参数解释：** 镜像标签列表。 标签的键可以包含任意语种字母、数字、空格和 _ . : + - @，但首尾不能含有空格，不能以sys_开头。 标签的值可以包含任意语种字母、数字、空格和_ . : / + - @，但首尾不能含有空格。 **约束限制：** tags和image_tags只能使用一个。 | | image_tags | 否 | Array of objects | **参数解释：** 新规范的镜像标签列表。image_tags数据结构说明请参见[表3](https://support.huaweicloud.com/api-ims/ims_03_0603.html#ims_03_0603__table1394012426522)。 **约束限制：** tags和image_tags只能使用一个。 | | type | 否 | String | **参数解释：** 镜像的类型。 **约束限制：** 不涉及 **取值范围：** 取值为ECS、BMS、FusionCompute、Ironic、IsoImage。 - ECS/FusionCompute：表示是ECS服务器的镜像。 - BMS/Ironic：表示是BMS服务器的镜像。 - IsoImage：表示是使用ISO文件创建的镜像。 **默认取值：** 默认使用"ECS" | | 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对应的企业项目。 **默认取值：** 不涉及 | | max_ram | 否 | Integer | **参数解释：** 表示镜像支持的最大内存，单位为MB。 **约束限制：** 必须大于等于min_ram。 **取值范围：** 大于0的整数。 **默认取值：** 不涉及 | | min_ram | 否 | Integer | **参数解释：** 表示镜像要求的最小内存，单位为MB。 **约束限制：** 不涉及。 **取值范围：** 大于等于0的整数。 **默认取值：** 默认为0，表示不受限制。 | | data_images | 否 | Array of objects | **参数解释：** 需要导入的数据盘信息。详情请参见[表2]。 外部镜像文件最多可携带3块数据盘，此时系统会创建1块系统盘、3块数据盘。 **约束限制：** - 外部镜像文件最多可携带3块数据盘，此时系统会创建1块系统盘、3块数据盘。 - 使用数据盘镜像文件创建数据盘镜像时，数据盘镜像的操作系统类型将和系统盘镜像保持一致。 - [表2]中的其他参数（如name、description、tags）如果有值，系统以data_images中的值为准。 | | is_quick_import | 否 | Boolean | **参数解释：** 是否使用镜像文件快速导入方式，导入系统盘镜像。 **约束限制：** 关于镜像文件快速导入的约束与限制请参见[镜像文件快速导入 - ImportImageQuick](https://support.huaweicloud.com/api-ims/ims_03_0605.html)。 **取值范围：** - true：使用镜像文件快速导入方式导入系统盘镜像。 - false：不使用镜像文件快速导入方式导入系统盘镜像。 **默认取值：** 不涉及 | | architecture | 否 | String | **参数解释：** 镜像的架构类型。 **约束限制：** 当架构类型为arm时，镜像引导方式将自动转为UEFI。 **取值范围：** - x86：表示x86架构。 - arm：表示ARM架构。 **默认取值：** 默认使用"x86"。 | | hw_firmware_type | 否 | String | **参数解释：** 云服务器的启动方式。 **约束限制：** 当镜像的架构类型为ARM时，启动方式只支持uefi。 **取值范围：** - bios：表示bios引导启动。 - uefi：表示uefi引导启动。 **默认取值：** 不涉及 | 表2data_images字段说明 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 否 | String | **参数解释：** 镜像名称。name参数说明请参考[镜像属性](https://support.huaweicloud.com/api-ims/ims_03_0901.html#ims_03_0901__section61598810155254)。 **约束限制：** 名称的首尾字符不能为空格。 **取值范围：** 只能由中文、字母、数字、空格和特殊字符 - _ . 组成，且首尾字符都不能为空格。名称的长度为1～128位。 **默认取值：** 不涉及 | | description | 否 | String | **参数解释：** 镜像描述信息。description参数说明请参考[镜像属性](https://support.huaweicloud.com/api-ims/ims_03_0901.html#ims_03_0901__section61598810155254)。 **约束限制：** 不涉及。 **取值范围：** 支持字母、数字、中文等，不支持回车、\<、\>，长度不能超过1024个字符。 **默认取值：** 不涉及 | | image_url | 是 | String | **参数解释：** OBS桶中外部镜像文件地址。 在使用OBS桶的外部镜像文件制作镜像时生效且为必选字段。格式为\:\。 - "OBS桶名"获取方式： 1. 登录[OBS控制台](https://console.huaweicloud.com/obs/?#/obs/manager/buckets)。 2. 在下方OBS桶列表栏显示所有已创建的OBS桶。 3. 查看当前Region下，用于存放外部镜像文件的"桶名称"。 - "OBS镜像文件名称"获取方式： 1. 登录[OBS控制台](https://console.huaweicloud.com/obs/?#/obs/manager/buckets)。 2. 在下方OBS桶列表栏显示所有已创建的OBS桶。 3. 查看当前Region下，用于存放外部镜像文件的"桶名称"。 4. 单击桶名称，进入对应OBS桶详情页。 5. 在左侧目录中选择"对象"，查看当前OBS桶中的对象，并记录用于制作镜像的外部镜像文件名称。 **约束限制：** 此处的OBS桶和镜像文件的存储类别必须是OBS标准存储。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | min_disk | 是 | Integer | **参数解释：** 最小数据盘大小。单位：GB **约束限制：** 不涉及 **取值范围：** 1\~2048GB **默认取值：** 不涉及 | | is_quick_import | 否 | Boolean | **参数解释：** 当前数据盘镜像是否使用镜像文件快速导入方式，创建数据盘镜像。 **约束限制：** 关于镜像文件快速导入的约束与限制请参见[镜像文件快速导入 - ImportImageQuick](https://support.huaweicloud.com/api-ims/ims_03_0605.html)。 **取值范围：** - true：使用镜像文件快速导入方式创建数据盘镜像 - false：未使用镜像文件快速导入方式创建数据盘镜像 **默认取值：** 不涉及 | | tags | 否 | Array of strings | **参数解释：** 镜像标签列表。 标签的键可以包含任意语种字母、数字、空格和 _ . : + - @，但首尾不能含有空格，不能以sys_开头。 标签的值可以包含任意语种字母、数字、空格和_ . : / + - @，但首尾不能含有空格。 **约束限制：** tags和image_tags只能使用一个。 | | image_tags | 否 | Array of objects | **参数解释：** 新规范的镜像标签列表。image_tags数据结构说明请参见[表3](https://support.huaweicloud.com/api-ims/ims_03_0603.html#ims_03_0603__table1394012426522)。 **约束限制：** tags和image_tags只能使用一个。 | - 使用数据盘制作系统盘镜像时的请求参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 是 | String | **参数解释：** 系统盘镜像名称。name参数说明请参见[镜像属性](https://support.huaweicloud.com/api-ims/ims_03_0901.html#ims_03_0901__section61598810155254)。 **约束限制：** 名称的首尾字符不能为空格。 **取值范围：** 只能由中文、字母、数字、空格和特殊字符 - _ . 组成，且首尾字符都不能为空格。名称的长度为1～128位。 **默认取值：** 不涉及 | | volume_id | 是 | String | **参数解释：** 数据盘的卷ID。请参考"[查询云服务器详情](https://support.huaweicloud.com/api-ecs/ecs_02_0104.html)"获取。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | os_version | 是 | String | **参数解释：** 操作系统版本。 **约束限制：** 制作系统盘镜像过程中，如果系统能获取到卷中的操作系统，则以卷中的操作系统版本为准，此时，设置的os_version无效。如果系统无法获取到卷中的操作系统，此时，系统以输入的os_version版本为准。 **取值范围：** os_version的具体取值请参见[os_version取值列表](https://support.huaweicloud.com/api-ims/ims_03_0910.html#ims_03_0910__section1979411301312)，请严格按照列表要求填写该值，否则可能会引起制作的系统盘镜像不可用。 **默认取值：** 不涉及 | | type | 否 | String | **参数解释：** 镜像的类型。 **约束限制：** 不涉及 **取值范围：** 取值为ECS、BMS、FusionCompute、Ironic。 - ECS/FusionCompute：表示是云服务器的镜像。 - BMS/Ironic：表示是裸金属服务器的镜像。 **默认取值：** 默认使用ECS。 | | description | 否 | String | **参数解释：** 镜像描述信息。参数说明请参见[镜像属性](https://support.huaweicloud.com/api-ims/ims_03_0901.html)。 **约束限制：** 不涉及 **取值范围：** 支持字母、数字、中文等，不支持回车、\<、\>，长度不能超过1024个字符。 **默认取值：** 不涉及 | | min_ram | 否 | Integer | **参数解释：** 镜像运行需要的最小内存，单位为MB。 **约束限制：** 不涉及 **取值范围：** 大于等于0的整数。 参数取值依据云服务器的规格限制。 云服务器的规格限制，请参见[规格清单](https://support.huaweicloud.com/productdesc-ecs/zh-cn_topic_0159822360.html)。 **默认取值：** 默认设置为0 | | max_ram | 否 | Integer | **参数解释：** 表示镜像支持的最大内存，单位为MB。 **约束限制：** 必须大于等于min_ram。 **取值范围：** 大于0的整数。 参数取值依据云服务器的规格限制。 云服务器的规格限制，请参见[规格清单](https://support.huaweicloud.com/productdesc-ecs/zh-cn_topic_0159822360.html)。 **默认取值：** 不涉及 | | tags | 否 | Array of strings | **参数解释：** 镜像标签列表。 标签的键可以包含任意语种字母、数字、空格和 _ . : + - @，但首尾不能含有空格，不能以sys_开头。 标签的值可以包含任意语种字母、数字、空格和_ . : / + - @，但首尾不能含有空格。 **约束限制：** tags和image_tags只能使用一个。 | | image_tags | 否 | Array of objects | **参数解释：** 新规范的镜像标签列表。image_tags数据结构说明请参见[表3](https://support.huaweicloud.com/api-ims/ims_03_0603.html#ims_03_0603__table1394012426522)。 **约束限制：** tags和image_tags只能使用一个。 | | 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对应的企业项目。 **默认取值：** 不涉及 | #### 请求示例 - 使用云服务器制作系统盘镜像，其中，镜像标签数据格式为tags，虚拟机ID为"877a2cda-ba63-4e1e-b95f-e67e48b6129a"。 ``` POST https://{Endpoint}/v2.1/cloudimages/action { "name": "ims_test", "description": "云服务器制作系统盘镜像", "instance_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a", "tags": [ "aaa.111", "bbb.333", "ccc.444" ] } ``` - 使用云服务器数据盘制作数据盘镜像，其中，镜像标签数据格式为tags，卷ID为"c5dfbd0c-bf0a-4798-a453-61dc6b54aa30"。 ``` POST https://{Endpoint}/v2.1/cloudimages/action { "data_images": [{"name": "ims_data_image_test", "description": "云服务器数据盘制作数据盘镜像", "volume_id": "c5dfbd0c-bf0a-4798-a453-61dc6b54aa30", "tags": [ "aaa.111", "bbb.333", "ccc.444" ] }] } ``` - 使用上传至OBS桶中的外部镜像文件制作镜像，其中，镜像标签数据格式为tags，OBS桶中外部镜像文件地址为"ims-image:centos70.qcow2"。 ``` POST https://{Endpoint}/v2.1/cloudimages/action { "name": "ims_test_file", "description": "OBS文件制作镜像", "image_url": "ims-image:centos70.qcow2", "os_version": "CentOS 7.0 64bit", "min_disk": 40, "tags": [ "aaa.111", "bbb.333", "ccc.444" ] } ``` - 使用云服务器制作系统盘镜像，其中，镜像标签数据格式为image_tags，虚拟机ID为"877a2cda-ba63-4e1e-b95f-e67e48b6129a"。 ``` POST https://{Endpoint}/v2.1/cloudimages/action { "name": "ims_test", "description": "云服务器制作系统盘镜像", "instance_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a", "image_tags": [ { "key": "key2", "value": "value2" }, { "key": "key1", "value": "value1" } ] } ``` - 使用云服务器数据盘制作数据盘镜像，其中，镜像标签数据格式为image_tags，卷ID为"c5dfbd0c-bf0a-4798-a453-61dc6b54aa30"。 ``` POST /v2.1/cloudimages/action { "data_images": [{"name": "ims_data_image_test", "description": "云服务器数据盘制作数据盘镜像", "volume_id": "c5dfbd0c-bf0a-4798-a453-61dc6b54aa30", "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] }] } ``` - 使用上传至OBS桶中的外部镜像文件制作镜像，其中，镜像标签数据格式为image_tags，OBS桶中外部镜像文件地址为"ims-image:centos70.qcow2"。 ``` POST https://{Endpoint}/v2.1/cloudimages/action { "name": "ims_test_file", "description": "OBS文件制作镜像", "image_url": "ims-image:centos70.qcow2", "os_version": "CentOS 7.0 64bit", "min_disk": 40, "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] } ``` - 使用上传至OBS桶中的ISO外部镜像文件制作镜像，其中，镜像标签数据格式为tags，OBS桶中外部镜像文件地址为"ims-image:centos70.iso"。 ``` POST https://{Endpoint}/v2.1/cloudimages/action { "name": "ims_test_file", "min_disk": 40, "image_url": "ims-image:centos70.iso", "description": "ISO文件制作镜像", "type": "IsoImage", "os_version": "CentOS 7.0 64bit", "tags": ["aaa.111", "bbb.333", "ccc.444"] } ``` - 使用上传至OBS桶中的ISO外部镜像文件制作镜像，其中，镜像标签数据格式为image_tags，OBS桶中外部镜像文件地址为"ims-image:centos70.iso"。 ``` POST https://{Endpoint}/v2.1/cloudimages/action { "name": "ims_test_file", "min_disk": 40, "image_url": "ims-image:centos70.iso", "description": "ISO文件制作镜像", "type": "IsoImage", "os_version": "CentOS 7.0 64bit", "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] } ``` - 使用数据盘制作系统盘镜像，其中，镜像标签数据格式为tags，卷ID为 "877a2cda-ba63-4e1e-b95f-e67e48b6129a"。 ``` POST https://{Endpoint}/v2.1/cloudimages/action { "name": "ims_test", "description": "数据盘制作系统盘镜像", "volume_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a", "type": "ECS", "os_version": "CentOS 7.0 64bit", "tags": [ "aaa.111", "bbb.333", "ccc.444" ] } ``` - 使用数据盘制作系统盘镜像，其中，镜像标签数据格式为image_tags，卷ID为"877a2cda-ba63-4e1e-b95f-e67e48b6129a"。 ``` POST https://{Endpoint}/v2.1/cloudimages/action { "name": "ims_test", "description": "数据盘制作系统盘镜像", "volume_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a", "type": "ECS", "os_version": "CentOS 7.0 64bit", "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] } ``` #### 响应消息 - 响应参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | job_id | String | **参数解释：** 异步任务ID。 详情请参见[异步任务进度查询 - ShowJobProgress](https://support.huaweicloud.com/api-ims/ims_03_0911.html)。 **取值范围：** 不涉及 | - 响应样例 ``` STATUS CODE 200 ``` ``` { "job_id": "8a12fc664fb4daa3014fb4e581380005" } ``` #### 返回值 - 正常 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 | 服务不可用。 |