检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询镜像列表 功能介绍 根据不同条件查询镜像列表信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/cloudimages{?__isregistered,__imagetype,__whole_image,__system__cmkid,protected
查询指定版本信息(OpenStack原生) 功能介绍 查询指定版本API的信息,包括该版本API的兼容性、域名信息等。 URI GET /{api_version} 参数说明请参见表1。 表1 参数说明 参数 是否必选 参数类型 描述 api_version 是 String API版本号。例如:v2.0 请求消息
批量添加镜像成员 功能介绍 该接口为扩展接口,主要用于镜像共享时用户将多个镜像共享给多个用户。 该接口为异步接口,返回job_id说明任务下发成功,查询异步任务状态,如果是success说明任务执行成功,如果是failed说明任务执行失败。如何查询异步任务,请参见异步任务查询。 调试
查询版本列表(OpenStack原生) 功能介绍 查询API的版本信息列表,包括API的版本兼容性、域名信息等。 URI GET / 请求消息 请求参数 无 请求示例 查询API的版本信息列表。 GET https://{Endpoint}/ 响应消息 响应参数 参数 参数类型 描述
制作整机镜像 功能介绍 使用云服务器、云服务器备份或者云备份制作整机镜像。作为异步接口,调用成功,只是说明后台收到了制作整机镜像的请求,镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态,具体请参考异步任务查询。 约束与限制(使用云服务器制作整机镜像) 创建整机镜像时,
使用上传至OBS桶中的外部数据盘镜像文件制作数据镜像。作为异步接口,调用成功,只是说明后台收到了制作请求,镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态,具体请参考异步任务查询。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/cloudimages/dataimages/action
删除镜像(OpenStack原生) 功能介绍 该接口主要用于删除镜像,用户可以通过该接口将自己的私有镜像删除。 调试 您可以在API Explorer中调试该接口。 URI DELETE /v2/images/{image_id} 参数说明请参见表1。 表1 参数说明 参数 是否必选
查询镜像支持的OS列表 功能介绍 查询当前区域弹性云服务器的OS兼容性列表。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/cloudimages/os_version 表1 查询参数 参数 是否必选 参数类型 描述 tag 否 String OS的标签。
W或ZVHD2格式,因此镜像文件小于128GB时推荐您优先使用常规的创建私有镜像的方式。 作为异步接口,调用成功,只是说明后台收到了制作请求,镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态,具体请参考异步任务查询。 约束与限制 快速导入前请确认RAW或ZVHD2格式的镜像文件已完成以下准备:
Region内复制镜像 功能介绍 该接口为扩展接口,主要用于用户将一个已有镜像复制为另一个镜像。复制镜像时,可以更改镜像的加密等属性,以满足不同的场景。 该接口为异步接口,返回job_id说明任务下发成功,查询异步任务状态,如果是success说明任务执行成功,如果是failed
公共参数 镜像属性 镜像标签数据格式 镜像共享的约束限制 获取项目ID 相关参数取值列表
按条件查询租户镜像标签列表 功能介绍 根据不同条件查询镜像标签列表信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/cloudimages/tags{?__isregistered,__imagetype,__whole_image,__system__cmkid
删除标签(OpenStack原生) 功能介绍 该接口主要用于删除某个镜像的自定义标签,通过该接口,用户可以将私有镜像中一些不用的标签删除。 当前接口已废弃,推荐使用以下接口。 如果需要为镜像删除指定的标签时,请使用删除镜像标签。 如果需要为指定镜像批量添加/更新、删除标签时,请使用批量添加删除镜像标签。
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token,即调用获取用户Token接口时,请求body中auth.scope的取值需要选择project,如下所示。
权限和授权项 权限及授权项说明 镜像管理 镜像标签 镜像视图 镜像共享 镜像复制 镜像配额
创建镜像元数据(OpenStack原生) 功能介绍 创建镜像元数据。 调用创建镜像元数据接口成功后,只是创建了镜像的元数据,镜像对应的实际镜像文件并不存在。 调试 您可以在API Explorer中调试该接口。 URI POST /v2/images 请求消息 请求参数 参数 是否必选 参数类型
功能介绍 该接口主要用于查询镜像成员视图,通过视图,用户可以了解到镜像成员包含哪些属性,同时也可以了解每个属性的数据类型。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/schemas/member 请求消息 请求参数 无 请求示例 查询镜像成员视图。
也可以使用弹性云服务器、云服务器备份或云备份创建带数据盘的整机镜像。 您可以使用本文档提供API对镜像进行相关操作,如创建、查询、删除、更新等。支持的全部操作请参见API概览。 在调用镜像服务API之前,请确保已经充分了解镜像服务相关概念,详细信息请参见“什么是镜像服务”。 镜像
镜像复制 权限 对应API接口 授权项(Action) IAM项目(Project) 企业项目(Enterprise Project) Region内复制镜像 POST /v1/cloudimages/{image_id}/copy ims:images:copy ims:ser
镜像标签 权限 对应API接口 授权项(Action) IAM项目(Project) 企业项目(Enterprise Project) 增加标签(OpenStack原生) PUT /v2/images/{image_id}/tags/{tag} ims:images:get ims:images:update