镜像管理 权限 对应API接口 授权项（Action） 依赖的授权项 IAM 项目（Project） 企业项目（Enterprise Project） 查询镜像列表 GET /v2/cloudimages ims:images:list - √ √ 查询镜像支持的OS列表 GET /v1/cloudimages/os_version ims:images:list - √ × 更新镜像信息 PATCH /v2/cloudimages/{image_id} ims:images:update ims:serverImages:create（仅企业项目迁移需要） ims:serverImages:create（仅企业项目迁移需要） obs:bucket:* obs:object:* kms:*:* ecs:cloudServers:get ecs:servers:get ecs:serverVolumes:use ecs:cloudServers:list ecs:serverVolumeAttachments:list ecs:servers:list evs:volumes:* bms:servers:list bms:servers:get bms:serverFlavors:get √ √ 制作镜像 POST /v2/cloudimages/action 说明： 外部文件制作镜像前请确保用户已拥有 对象存储服务 的Tenant Administrator权限。 ims:serverImages:create obs:bucket:* obs:object:* kms:*:* ecs:cloudServers:get ecs:servers:get ecs:serverVolumes:use ecs:cloudServers:list ecs:serverVolumeAttachments:list ecs:servers:list evs:volumes:* bms:servers:list bms:servers:get bms:serverFlavors:get √ √ 镜像文件快速导入 POST /v2/cloudimages/quickimport/action 说明： 使用镜像文件快速导入前请确保用户已拥有对象存储服务的Tenant Administrator权限。 ims:serverImages:create（仅快速导入系统盘镜像需要） ims:dataImages:create（仅快速导入数据盘镜像需要） ims:serverImages:create（仅快速导入系统盘镜像需要） obs:bucket:* obs:object:* kms:*:* ecs:cloudServers:get ecs:servers:get ecs:serverVolumes:use ecs:cloudServers:list ecs:serverVolumeAttachments:list ecs:servers:list evs:volumes:* bms:servers:list bms:servers:get bms:serverFlavors:get ims:dataImages:create（仅快速导入数据盘镜像需要） obs:bucket:* obs:object:* kms:*:* ecs:cloudServers:get ecs:servers:get ecs:serverVolumes:use ecs:cloudServers:list ecs:serverVolumeAttachments:list ecs:servers:list evs:volumes:* √ √ 使用外部镜像文件制作数据镜像 POST /v1/cloudimages/dataimages/action 说明： 使用外部镜像文件前请确保用户已拥有对象存储服务的Tenant Administrator权限。 ims:dataImages:create obs:bucket:* obs:object:* kms:*:* ecs:cloudServers:get ecs:servers:get ecs:serverVolumes:use ecs:cloudServers:list ecs:serverVolumeAttachments:list ecs:servers:list evs:volumes:* √ √ 制作整机镜像 POST /v1/cloudimages/wholeimages/action 说明： 制作整机镜像前请确保用户已拥有云服务器备份服务的 CS BS Administrator权限，或者云备份服务的CBR Admin权限。 ims:wholeImages:create obs:bucket:* obs:object:* kms:*:* cbr:*:* CSBS:backup:* ecs:cloudServers:get ecs:servers:get ecs:serverVolumes:use ecs:cloudServers:list ecs:serverVolumeAttachments:list ecs:servers:list evs:volumes:* √ √ 注册镜像 PUT /v1/cloudimages/{image_id}/upload 说明： 注册镜像前请确保用户已拥有对象存储服务的Tenant Administrator权限。 必须配置default的企业项目权限，才能正常使用企业项目权限注册镜像。 ims:images:upload ims:images:get ims:images:update obs:bucket:* obs:object:* kms:*:* √ √ 导出镜像 POST /v1/cloudimages/{image_id}/file 说明： 导出镜像前请确保用户已拥有对象存储服务的Tenant Administrator权限。 ims:images:export obs:bucket:* obs:object:* kms:*:* √ √ 查询镜像列表（OpenStack原生） GET /v2/images ims:images:list - √ x 查询镜像详情（OpenStack原生） GET /v2/images/{image_id} ims:images:get - √ √ 更新镜像信息（OpenStack原生） PATCH /v2/images/{image_id} ims:images:update - √ √ 删除镜像（OpenStack原生） DELETE /v2/images/{image_id} ims:images:delete - √ √ 创建镜像元数据（OpenStack原生） POST /v2/images ims:images:create - √ x 上传镜像（OpenStack原生） PUT /v2/images/{image_id}/file ims:images:get ims:images:update ims:images:upload ims:images:upload obs:bucket:* obs:object:* kms:*:* √ x 查询版本(OpenStack原生） GET / 无 - √ x 查询镜像详情（OpenStack原生v1.1--已废弃，不推荐使用） GET /v1.1/images/detail ims:images:list - √ x 查询镜像元数据（OpenStack原生v1--已废弃，不推荐使用） HEAD /v1/images/{image_id} ims:images:get - √ x 删除镜像（OpenStack原生v1.1--已废弃，不推荐使用） DELETE /v1.1/images/{image_id} ims:images:delete - √ x 父主题： 权限和授权项

请求示例 批量添加镜像成员，其中，镜像ID为“d164b5df-1bc3-4c3f-893e-3e471fd16e64”、“0b680482-acaa-4045-b14c-9a8c7dfe9c70”，项目ID为"9c61004714024f9586705d090530f9fa", "edc89b490d7d4392898e19b2deb34797"。 1 2 3 4 5 6 7 8 9 10 11 POST https://{Endpoint}/v1/cloudimages/members { "images": [ "d164b5df-1bc3-4c3f-893e-3e471fd16e64", "0b680482-acaa-4045-b14c-9a8c7dfe9c70" ], "projects": [ "9c61004714024f9586705d090530f9fa", "edc89b490d7d4392898e19b2deb34797" ] }

响应消息 响应参数 参数 参数类型 描述 status String 共享状态 created_at String 共享时间，格式为UTC时间 updated_at String 更新时间，格式为UTC时间 image_id String 镜像ID member_id String 成员ID schema String 共享视图 响应样例 STATUS CODE 200 1 2 3 4 5 6 7 8 { "status": "accepted", "created_at": "2016-09-01T02:05:14Z", "updated_at": "2016-09-01T02:37:11Z", "image_id": "d164b5df-1bc3-4c3f-893e-3e471fd16e64", "member_id": "edc89b490d7d4392898e19b2deb34797", "schema": "/v2/schemas/member" }

API概览 镜像服务 所提供的接口分为IMS接口与OpenStack原生接口。推荐您使用IMS接口。 通过配合使用镜像服务提供的接口和OpenStack原生接口，您可以完整地使用镜像服务的所有功能。例如制作私有镜像，可以使用OpenStack原生接口，也可以使用IMS接口进行操作。 表1 接口说明 类型 子类型 说明 IMS接口 镜像 可以实现镜像的制作、镜像列表查询、镜像导出等操作。 镜像标签 对私有镜像进行自定义标记。通过镜像标签，用户可以自由地对私有镜像分类管理。 镜像共享 用户可以将私有镜像共享给其他用户使用。通过镜像共享的接口完成镜像共享的相关操作。 镜像复制 通过Region内复制镜像实现加密镜像与非加密镜像的转换；通过跨Region复制镜像实现镜像在两个区域间复制，帮助用户实现区域间的业务迁移。 镜像配额 查询租户在当前Region的私有镜像的配额数量。 镜像任务 查询异步任务接口执行情况以及异步任务进度。 OpenStack原生接口 镜像 可以实现镜像的制作、镜像列表/详情查询、镜像导出等操作。 镜像视图 镜像视图是提供给用户查询镜像属性详情的接口，比如属性的取值类型、用途等。通过镜像视图，用户可以从宏观上对镜像的基本情况进行了解。 镜像共享 用户可以将私有镜像共享给其他用户使用。通过镜像共享的接口完成镜像共享的相关操作。 查询API版本信息 查询镜像服务当前所用的API版本。

响应示例 当任务类型为imsCreateImageByInstance，云服务器创建镜像时，响应示例如下： { "job_id": "9a175ac792fa12d20193002100dd2762", "job_type": "imsCreateImageByInstance", "begin_time": "2024-11-06T06:19:43.195Z", "end_time": "2024-11-06T06:23:25.158Z", "status": "SUC CES S", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "image_id": "3f7185de-b59a-4bb8-aa1d-7a513528b0e9" } } 当任务类型为imsImportImageJob，外部镜像文件创建镜像时，响应示例如下： { "job_id": "9a175ac892fa1342019300224f22218e", "job_type": "imsImportImageJob", "begin_time": "2024-11-06T06:21:08.769Z", "end_time": "2024-11-06T06:27:03.742Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "image_id": "431df7fd-a898-4dc0-86b1-22cfefb8a517" } } 当任务类型为imsImportOvaImageJob，外部Ova镜像文件创建镜像时，响应示例如下： { "job_id": "9a175ac892fa13420193006a49173317", "job_type": "imsImportOvaImageJob", "begin_time": "2024-11-06T07:39:45.814Z", "end_time": "2024-11-06T07:49:45.814Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "sub_jobs_result": [ { "job_id": "9a175ac892fa13420193006c29e133f0", "job_type": "imsImportImageJob", "begin_time": "2024-11-06T07:41:48.896Z", "end_time": "2024-11-06T07:49:45.814Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "image_id": "fc496c19-40c2-4220-8b1a-eba9d53fca7b" } } ], "sub_jobs_list": [ "9a175ac892fa13420193006c29e133f0" ] } } 当任务类型为imsVolumeCreateImageJob，数据盘创建系统盘镜像时，响应示例如下： { "job_id": "9a175ac692fa125401930037d9e329aa", "job_type": "imsVolumeCreateImageJob", "begin_time": "2024-11-06T06:44:40.545Z", "end_time": "2024-11-06T06:47:40.545Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "image_id": "21b04ab5-e817-40ee-8d56-7ccdb8820335" } } 当任务类型为imsImportDataImageJob，外部镜像文件创建数据盘镜像时，响应示例如下： { "job_id": "9a175ac692fa125401930027b9c026b3", "job_type": "imsImportDataImageJob", "begin_time": "2024-11-06T06:27:03.742Z", "end_time": "2024-11-06T06:37:03.742Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "image_id": "aa5306f7-bc95-4fa3-aa40-dd38fbdf2031" } } 当任务类型为imsCreateWholeImageByInstanceJob，云服务器创建整机镜像时，响应示例如下： { "job_id": "9a175ac792fa12d201930028cddb29c6", "job_type": "imsCreateWholeImageByInstanceJob", "begin_time": "2024-11-06T06:28:14.425Z", "end_time": "2024-11-06T06:37:03.742Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "image_id": "17b7bdeb-2e72-43a0-a202-d36ce344e902" } } 当任务类型为imsCreateWholeImageByBackupJob，云备份或云服务器备份创建整机镜像时，响应示例如下： { "job_id": "9a175ac892fa13420193002961972392", "job_type": "imsCreateWholeImageByBackupJob", "begin_time": "2024-11-06T06:28:52.245Z", "end_time": "2024-11-06T06:28:58.399Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "image_id": "ea0d5dce-ddb2-4f6f-83e3-55da065347fd" } } 当任务类型为imsNativeImportImageJob，注册镜像时，响应示例如下： { "job_id": "9a175ac692fa12540193005389023059", "job_type": "imsNativeImportImageJob", "begin_time": "2024-11-06T07:14:54.848Z", "end_time": "2024-11-06T07:19:54.848Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_id": "af8ea1dc-02f2-4019-8fa9-c9952a0077ce" } } 当任务类型为imsNativeExportImageJob，导出镜像时，响应示例如下： { "job_id": "9a175ac892fa134201930039db1a27b1", "job_type": "imsNativeExportImageJob", "begin_time": "2024-11-06T06:46:51.929Z", "end_time": "2024-11-06T06:49:53.657Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_id": "1ab4df10-fe18-48b7-91c9-53695fcd9df5" } } 当任务类型为imsAddImageMembersJob，添加镜像成员时，响应示例如下： { "job_id": "9a175ac692fa12540193002a6d4b2720", "job_type": "imsAddImageMembersJob", "begin_time": "2024-11-06T06:30:00.778Z", "end_time": "2024-11-06T06:30:03.179Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "results": [ { "image_id": "30e55148-deb9-4923-adb9-91618de16ba0", "status": "success" } ] } } 当任务类型为imsDelImageMembersJob，删除镜像成员时，响应示例如下： { "job_id": "9a175ac792fa12d20193002da96f2ac2", "job_type": "imsDelImageMembersJob", "begin_time": "2024-11-06T06:33:32.781Z", "end_time": "2024-11-06T06:33:34.181Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "results": [] } } 当任务类型为imsUpdateImageMembersJob，修改镜像成员时，响应示例如下： { "job_id": "9a175ac692fa12540193005c340f321c", "job_type": "imsUpdateImageMembersJob", "begin_time": "2024-11-06T07:24:22.925Z", "end_time": "2024-11-06T07:24:23.773Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "results": [ { "image_id": "6596628c-42d4-4ff1-8660-8ea5ae61f243", "status": "success" } ] } } 当任务类型为当任务类型为imsCopyImageInRegionJob，Region内复制镜像时，响应示例如下： { "job_id": "9a175ac892fa13420193001c2e62205a", "job_type": "imsCopyImageInRegionJob", "begin_time": "2024-11-06T06:14:27.168Z", "end_time": "2024-11-06T06:16:38.446Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "image_id": "30e55148-deb9-4923-adb9-91618de16ba0" } } 当任务类型为imsCrossRegionCopyImageJob，跨Region复制镜像时，响应示例如下： { "job_id": "9a175ac792fa12d20193001f2a2c2641", "job_type": "imsCrossRegionCopyImageJob", "begin_time": "2024-11-06T06:17:42.699Z", "end_time": "2024-11-06T06:20:22.419Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "image_id": "d998b96f-b7e3-4be9-b0c2-9773e592977d" } } 当任务类型为imsVolumesToSysDataImagesJob，数据盘创建数据盘镜像时，响应示例如下： { "job_id": "9a175ac792fa12d201930031febf2bdd", "job_type": "imsVolumesToSysDataImagesJob", "begin_time": "2024-11-06T06:38:16.765Z", "end_time": "2024-11-06T06:48:16.765Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "sub_jobs_result": [ { "job_id": "9a175ac792fa12d20193003205b22be1", "job_type": "imsCopyVolumeToImageJob", "begin_time": "2024-11-06T06:38:18.545Z", "end_time": "2024-11-06T06:48:16.765Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "image_id": "bfb2de92-e7b9-4820-9522-416d8f2c812a" } } ], "sub_jobs_list": [ "9a175ac792fa12d20193003205b22be1" ] } }

响应消息 响应参数 根据job_type的取值不同，响应消息的结构会有所差异，更多响应示例请参见响应示例。 参数 参数类型 描述 status String 任务状态，目前取值如下： SUCCESS：表示该任务执行已经结束，任务执行成功。 FAIL：表示该任务执行已经结束，任务执行失败。 RUNNING：表示该任务正在执行。 INIT：表示该任务还未执行，正在初始化。 job_id String 任务ID。 job_type String 任务类型。 imsCreateImageByInstance：云服务器创建镜像 imsImportImageJob：外部镜像文件创建镜像 imsImportOvaImageJob：外部Ova镜像文件创建镜像 imsVolumeCreateImageJob：数据盘创建系统盘镜像 imsVolumesToSysDataImagesJob：数据盘创建数据盘镜像 imsImportDataImageJob：外部镜像文件创建数据盘镜像 imsCreateWholeImageByInstanceJob：云服务器创建整机镜像 imsCreateWholeImageByBackupJob：云备份或云服务器备份创建整机镜像 imsNativeImportImageJob：注册镜像 imsNativeExportImageJob：导出镜像 imsAddImageMembersJob：添加镜像成员 imsDelImageMembersJob：删除镜像成员 imsUpdateImageMembersJob：修改镜像成员 imsCopyImageInRegionJob：Region内复制镜像 imsCrossRegionCopyImageJob：跨Region复制镜像 begin_time String 任务开始执行时间。格式为UTC时间。 end_time String 任务结束时间。格式为UTC时间。 error_code String 错误码。 fail_reason String 失败原因。 entities Object 任务自定义属性。 任务正常时，返回镜像的ID；任务异常时，返回错误码和信息。 详情请参见表2。 表2 entities字段数据结构说明 参数 参数类型 描述 image_id String 镜像ID。 当job_type取值为以下任务类型时，会返回该参数。 imsCreateImageByInstance imsImportImageJob imsVolumeCreateImageJob imsImportDataImageJob imsCreateWholeImageByInstanceJob imsCreateWholeImageByBackupJob imsNativeImportImageJob imsNativeExportImageJob imsCopyImageInRegionJob imsCrossRegionCopyImageJob current_task String 当前任务名称。 image_name String 镜像名称。 process_percent Double 任务执行进度。 results Array of result objects 批量任务执行结果。详情请参见表3。 sub_jobs_result Array of objects 子任务执行结果。详情请参见表4。 sub_jobs_list Array of string 子任务id列表。 addition_error_code string 添加错误码 addition_error_msg string 添加错误消息 error_code string 错误码 error string 错误消息 alarm_code string 告警代码 表3 results字段数据结构说明 参数 参数类型 描述 image_id String 镜像ID。 当job_type取值为以下任务类型时，会返回该参数。 imsAddImageMembersJob imsUpdateImageMembersJob project_id String 项目ID。 status String 任务状态。 表4 sub_jobs_result字段数据结构说明 参数 参数类型 描述 status String 子任务状态，取值如下： SUCCESS：表示该任务执行已经结束，任务执行成功。 FAIL：表示该任务执行已经结束，任务执行失败。 RUNNING：表示该任务正在执行。 INIT：表示该任务还未执行，正在初始化。 job_id String 子任务ID。 job_type String 子任务类型。 begin_time String 子任务开始执行时间。格式为UTC时间。 end_time String 子任务结束时间。格式为UTC时间。 error_code String 错误码。 fail_reason String 失败原因。 entities Object 子任务自定义属性。详情请参见表5 任务正常时，返回镜像的ID。 任务异常时，返回错误码和信息。 表5 sub_jobs_result.entities字段数据结构说明 参数 参数类型 描述 image_id String 镜像ID。 当job_type取值为以下任务类型时，会返回该参数。 imsImportOvaImageJob imsVolumesToSysDataImagesJob image_name String 镜像名称。

镜像共享 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 添加镜像成员（OpenStack原生） POST /v2/images/{image_id}/members ims:images:get ims:images:share √ x 更新镜像成员状态（OpenStack原生） PUT /v2/images/{image_id}/members/{member_id} ims:images:get ims:images:share √ x 获取镜像成员详情（OpenStack原生） GET /v2/images/{image_id}/members/{member_id} ims:images:get ims:images:share √ x 获取镜像成员列表（OpenStack原生） GET /v2/images/{image_id}/members ims:images:get ims:images:share √ x 删除指定的镜像成员（OpenStack原生） DELETE /v2/images/{image_id}/members/{member_id} ims:images:get ims:images:share √ x 批量添加镜像成员 POST /v1/cloudimages/members ims:images:share √ x 批量更新镜像成员状态 PUT /v1/cloudimages/members ims:images:share √ x 批量删除镜像成员 DELETE /v1/cloudimages/members ims:images:share √ x 父主题： 权限和授权项

请求示例 批量删除镜像成员，其中，镜像ID为“d164b5df-1bc3-4c3f-893e-3e471fd16e64”、“0b680482-acaa-4045-b14c-9a8c7dfe9c70”，项目ID为"9c61004714024f9586705d090530f9fa", "edc89b490d7d4392898e19b2deb34797"。 1 2 3 4 5 6 7 8 9 10 11 DELETE https://{Endpoint}/v1/cloudimages/members { "images": [ "d164b5df-1bc3-4c3f-893e-3e471fd16e64", "0b680482-acaa-4045-b14c-9a8c7dfe9c70" ], "projects": [ "9c61004714024f9586705d090530f9fa", "edc89b490d7d4392898e19b2deb34797" ] }

响应消息 响应参数 参数 参数类型 描述 members Array of objects 共享成员列表。 详情请参见表2。 schema String 共享视图。 表2 members字段说明 参数 参数类型 描述 status String 共享状态。 created_at String 共享时间，格式为UTC时间。 updated_at String 更新时间，格式为UTC时间。 image_id String 镜像ID。 member_id String 成员ID。 schema String 共享视图。 响应样例 STATUS CODE 200 1 2 3 4 5 6 7 8 9 10 11 12 13 { "members": [ { "status": "accepted", "created_at": "2016-09-01T02:05:14Z", "updated_at": "2016-09-01T02:37:11Z", "image_id": "d164b5df-1bc3-4c3f-893e-3e471fd16e64", "member_id": "edc89b490d7d4392898e19b2deb34797", "schema": "/v2/schemas/member" } ], "schema": "/v2/schemas/members" }

镜像视图 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 查询镜像视图（OpenStack原生） GET /v2/schemas/image 无 √ x 查询镜像列表视图（OpenStack原生） GET /v2/schemas/images 无 √ x 查询镜像成员视图（OpenStack原生） GET /v2/schemas/member 无 √ x 查询镜像成员列表视图（OpenStack原生） GET /v2/schemas/members 无 √ x 父主题： 权限和授权项

镜像复制 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） Region内复制镜像 POST /v1/cloudimages/{image_id}/copy ims:images:copy ims:serverImages:create（仅开通企业项目用户需要） √ √ 说明： 复制共享镜像仅支持IAM项目，不支持企业项目。 跨Region复制镜像 POST /v1/cloudimages/{image_id}/cross_region_copy ims:images:copy √ x 父主题： 权限和授权项

请求示例 使用上传至OBS桶的外部镜像文件制作系统盘镜像，其中，OBS桶中外部镜像文件地址为“ims-image:centos70.zvhd2”，镜像标签数据格式为tags。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 POST https://{Endpoint}/v2/cloudimages/quickimport/action { "name": "ims_test_file", "description": "OBS文件制作镜像", "image_url": "ims-image:centos70.zvhd2", "os_version": "CentOS 7.0 64bit", "min_disk": 40, "type": "ECS", "tags": [ "aaa.111", "bbb.333", "ccc.444" ] } 使用上传至OBS桶的外部镜像文件制作系统盘镜像，其中，OBS桶中外部镜像文件地址为“ims-image:centos70.zvhd2”，镜像标签数据格式为image_tags。 1 2 3 4 5 6 7 8 9 10 POST https://{Endpoint}/v2/cloudimages/quickimport/action { "name": "ims_test_file", "description": "OBS文件制作镜像", "image_url": "ims-image:centos70.zvhd2", "os_version": "CentOS 7.0 64bit", "min_disk": 40, "type": "ECS", "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] } 使用上传至OBS桶的外部镜像文件制作数据盘镜像，其中，OBS桶中外部镜像文件地址为“ims-image:centos70.zvhd2”，镜像标签数据格式为tags。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 POST https://{Endpoint}/v2/cloudimages/quickimport/action { "name": "ims_test_file", "description": "OBS文件制作镜像", "image_url": "ims-image:centos70.zvhd2", "os_type": "Linux", "min_disk": 40, "type": "DataImage", "tags": [ "aaa.111", "bbb.333", "ccc.444" ] } 使用上传至OBS桶的外部镜像文件制作数据盘镜像，其中，OBS桶中外部镜像文件地址为“ims-image:centos70.zvhd2”，镜像标签数据格式为image_tags。 1 2 3 4 5 6 7 8 9 10 POST https://{Endpoint}/v2/cloudimages/quickimport/action { "name": "ims_test_file", "description": "OBS文件制作镜像", "image_url": "ims-image:centos70.zvhd2", "os_type": "Linux", "min_disk": 40, "type": "DataImage", "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] }

功能介绍 使用上传至OBS桶中的超大外部镜像文件制作私有镜像，目前仅支持RAW或ZVHD2格式镜像文件。且要求镜像文件大小不能超过1TB。 由于快速导入功能要求提前转换镜像文件格式为RAW或ZVHD2格式，因此镜像文件小于128GB时推荐您优先使用常规的创建私有镜像的方式。 作为异步接口，调用成功，只是说明后台收到了制作请求，镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态，具体请参考异步任务查询。

镜像标签 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 增加标签（OpenStack原生） PUT /v2/images/{image_id}/tags/{tag} ims:images:get ims:images:update √ x 删除标签（OpenStack原生） DELETE /v2/images/{image_id}/tags/{tag} ims:images:get ims:images:update √ x 增加或修改标签 PUT /v1/cloudimages/tags ims:images:get ims:images:update √ x 查询租户镜像标签列表 GET /v1/cloudimages/tags ims:images:list √ x 按标签查询镜像 POST /v2/{project_id}/images/resource_instances/action ims:images:list √ x 批量添加删除镜像标签 POST /v2/{project_id}/images/{image_id}/tags/action ims:images:update √ x 添加镜像标签 POST /v2/{project_id}/images/{image_id}/tags ims:images:update √ x 删除镜像标签 DELETE /v2/{project_id}/images/{image_id}/tags/{key} ims:images:update √ x 查询镜像标签 GET /v2/{project_id}/images/{image_id}/tags ims:images:list √ x 查询租户所有镜像标签 GET /v2/{project_id}/images/tags ims:images:list √ x 父主题： 权限和授权项

约束与限制 用户只能共享自己没有发布为市场镜像的私有镜像，已经发布为市场镜像的不能共享。 镜像共享的范围只能在区域内。 系统盘镜像和数据盘镜像最多可以共享给128个租户，整机镜像最多可以共享给10个租户。 用户可以随时取消自己共享的镜像，无需通知镜像的接受方。 用户可以随时删除自己共享的镜像，无需通知镜像的接受方。 加密镜像不能共享。 只有通过云备份创建的整机镜像，才支持共享。通过其他方式创建的整机镜像，暂不支持共享。