检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
W或ZVHD2格式,因此镜像文件小于128GB时推荐您优先使用常规的创建私有镜像的方式。 作为异步接口,调用成功,只是说明后台收到了制作请求,镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态,具体请参考异步任务查询。 约束与限制 快速导入前请确认RAW或ZVHD2格式的镜像文件已完成以下准备:
批量更新镜像成员状态 功能介绍 该接口为扩展接口,主要用于用户接受或者拒绝多个共享镜像时批量更新镜像成员的状态。 该接口为异步接口,返回job_id说明任务下发成功,查询异步任务状态,如果是success说明任务执行成功,如果是failed说明任务执行失败。如何查询异步任务,请参见异步任务查询。
Region内复制镜像 功能介绍 该接口为扩展接口,主要用于用户将一个已有镜像复制为另一个镜像。复制镜像时,可以更改镜像的加密等属性,以满足不同的场景。 该接口为异步接口,返回job_id说明任务下发成功,查询异步任务状态,如果是success说明任务执行成功,如果是failed
查询镜像列表视图(OpenStack原生) 查询镜像成员视图(OpenStack原生) 查询镜像成员列表视图(OpenStack原生) 父主题: OpenStack原生API
单个镜像最多添加10个标签。 请求体中的多个标签的key不允许重复。 此接口为幂等接口: 创建时,如果创建的标签已经存在,即key相同而value不同,则更新对应标签;如果创建的标签已经存在,key/value均相同,则不进行重复添加,视为添加成功。 删除时,如果指定的标签不存在,则默认视为删除成功。 批量删除时对key、value的限制:
异步任务进度查询 功能介绍 该接口为扩展接口,主要用于查询异步任务进度。 URI GET /v1/cloudimages/job/{job_id} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 job_id 是 异步任务ID 请求消息 请求参数 无 请求示例 异步任务进度查询。
跨Region复制镜像 功能介绍 该接口为扩展接口,用户在一个区域制作的私有镜像,可以通过跨Region复制镜像将镜像复制到其他区域,在其他区域发放相同类型的云服务器,帮助用户实现区域间的业务迁移。 该接口为异步接口,返回job_id说明任务下发成功,查询异步任务状态,如果是su
查询镜像支持的OS列表 功能介绍 查询当前区域弹性云服务器的OS兼容性列表。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/cloudimages/os_version 表1 查询参数 参数 是否必选 参数类型 描述 tag 否 String OS的标签。
按条件查询租户镜像标签列表 功能介绍 根据不同条件查询镜像标签列表信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/cloudimages/tags{?__isregistered,__imagetype,__whole_image,__system__cmkid
使用上传至OBS桶中的外部数据盘镜像文件制作数据镜像。作为异步接口,调用成功,只是说明后台收到了制作请求,镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态,具体请参考异步任务查询。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/cloudimages/dataimages/action
删除标签(OpenStack原生) 功能介绍 该接口主要用于删除某个镜像的自定义标签,通过该接口,用户可以将私有镜像中一些不用的标签删除。 当前接口已废弃,推荐使用以下接口。 如果需要为镜像删除指定的标签时,请使用删除镜像标签。 如果需要为指定镜像批量添加/更新、删除标签时,请使用批量添加删除镜像标签。
删除镜像(OpenStack原生) 功能介绍 该接口主要用于删除镜像,用户可以通过该接口将自己的私有镜像删除。 调试 您可以在API Explorer中调试该接口。 URI DELETE /v2/images/{image_id} 参数说明请参见表1。 表1 参数说明 参数 是否必选
创建镜像元数据(OpenStack原生) 功能介绍 创建镜像元数据。 调用创建镜像元数据接口成功后,只是创建了镜像的元数据,镜像对应的实际镜像文件并不存在。 调试 您可以在API Explorer中调试该接口。 URI POST /v2/images 请求消息 请求参数 参数 是否必选 参数类型
本节通过调用一系列IMS的API使用云服务器来创建私有镜像。 API的调用方法请参见如何调用API。 使用云服务器创建私有镜像时,请确保云服务器处于关机状态。 通过IAM服务获取到的Token有效期为24小时,需要使用同一个Token鉴权时,可以先将Token缓存,避免频繁调用。 涉及API 当您使
获取镜像成员详情(OpenStack原生) 功能介绍 该接口主要用于镜像共享中查询某个镜像成员的详情。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/images/{image_id}/members/{member_id} 参数说明请参见表1。 表1
应用示例 使用ISO文件创建镜像
公共参数 镜像属性 镜像标签数据格式 镜像共享的约束限制 获取项目ID 相关参数取值列表
查询镜像视图(OpenStack原生) 功能介绍 该接口主要用于查询镜像视图,通过视图,用户可以了解到镜像包含哪些属性,同时也可以了解每个属性的数据类型等。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/schemas/image 请求消息 请求参数
invalid.", "code": "IMG.0024" } } 错误码说明 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 表1 错误码 状态码 错误码 错误信息 描述 处理措施 400 IMG.0001 The request
获取镜像成员列表(OpenStack原生) 功能介绍 该接口用于共享镜像过程中,获取接受该镜像的成员列表。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/images/{image_id}/members 参数说明请参见表1。 表1 参数说明 参数