镜像服务 IMS-API概览

时间：2024-11-13 14:59:39

镜像服务 IMS

API概览

镜像服务所提供的接口分为IMS接口与OpenStack原生接口。推荐您使用IMS接口。

通过配合使用镜像服务提供的接口和OpenStack原生接口，您可以完整地使用镜像服务的所有功能。例如制作私有镜像，可以使用OpenStack原生接口，也可以使用IMS接口进行操作。

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