# 镜像管理
| 权限                                | 对应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 说明： 制作整机镜像前请确保用户已拥有云服务器备份服务的CSBS 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原生）                 | 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                           |