检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
镜像标签(OpenStack原生) 增加标签(OpenStack原生v2--已废弃,不推荐使用) 删除标签(OpenStack原生) 父主题: 历史API
查询镜像列表视图(OpenStack原生) 查询镜像成员视图(OpenStack原生) 查询镜像成员列表视图(OpenStack原生) 父主题: OpenStack原生API
完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。 对于管理员创建IAM用户接口,返回如图1所示的消息头,其中“X-Subject-To
注册镜像 功能介绍 该接口用于将镜像文件注册为云平台未初始化的私有镜像。 使用该接口注册镜像的具体步骤如下: 将镜像文件上传到OBS个人桶中。具体操作请参见“上传文件或文件夹”。 使用创建镜像元数据接口创建镜像元数据。调用成功后,保存该镜像的ID。创建镜像元数据请参考创建镜像元数据(OpenStack原生)。
应用示例 使用ISO文件创建镜像
公共参数 镜像属性 镜像标签数据格式 镜像共享的约束限制 获取项目ID 相关参数取值列表
文字符必须为UTF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。 对于管理员创建IAM用户接口,您可以从接口的请求部分看到所需的请求参数及参数
功能介绍 本接口用于制作私有镜像,支持: 使用云服务器制作私有镜像(系统盘镜像/数据盘镜像)。 使用上传至OBS桶中的外部镜像文件制作系统盘镜像。 使用数据盘制作系统盘镜像。 作为异步接口,调用成功,只是说明云平台收到了制作请求,镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态,具体请参考异步任务查询。
查询镜像配额 功能介绍 该接口为扩展接口,主要用于查询租户在当前Region的私有镜像的配额数量。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/cloudimages/quota 请求消息 请求参数 无 请求示例 查询镜像配额。 GET http
删除镜像标签 功能介绍 该接口用于为镜像删除指定的标签。 约束与限制 为兼容遗留数据,不对key进行字符集校验和长度校验。 此接口为非幂等接口:如果指定删除的key不存在,则返回404状态码。 调试 您可以在API Explorer中调试该接口。 URI DELETE /v2/{
异步任务查询 功能介绍 该接口为扩展接口,主要用于查询异步接口执行情况,比如查询导出镜像任务的执行状态。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/jobs/{job_id} 参数说明请参见表1。 表1 参数说明 参数
更新镜像信息 功能介绍 更新镜像信息接口,主要用于镜像属性的修改。 当前仅支持可用(active)状态的镜像更新相关信息。 调试 您可以在API Explorer中调试该接口。 URI PATCH /v2/cloudimages/{image_id} 参数说明请参见表1。 表1 参数说明
查询镜像列表 功能介绍 根据不同条件查询镜像列表信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/cloudimages{?__isregistered,__imagetype,__whole_image,__system__cmkid,protected
导出镜像 功能介绍 该接口为扩展接口,用于用户将自己的私有镜像导出到指定的OBS桶中。 导出镜像前请确保用户已拥有对象存储服务的Tenant Administrator权限。 约束与限制 仅支持导出到存储类别为标准存储的桶,并且桶和镜像在同一区域。 如下类型的私有镜像不允许导出:
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token,即调用获取用户Token接口时,请求body中auth.scope的取值需要选择project,如下所示。
功能介绍 该接口用于为指定镜像添加或更新指定的单个标签。 约束与限制 每个标签由键值对组成,标签的key的长度不超过36个字符,value的长度不超过43个字符。key不能为空或空白字符串,value不能为空,但可以是空白字符串。 单个镜像最多添加10个标签。 此接口为幂等接口:如果创
查询租户所有镜像标签 功能介绍 该接口用于查询租户的所有镜像上的标签。 调试 您可以在API Explorer中调试该接口。 URI GET /v2/{project_id}/images/tags 参数说明请参见表1。 表1 参数说明 参数 是否必选 参数类型 描述 project_id
查询指定版本信息(OpenStack原生) 功能介绍 查询指定版本API的信息,包括该版本API的兼容性、域名信息等。 URI GET /{api_version} 参数说明请参见表1。 表1 参数说明 参数 是否必选 参数类型 描述 api_version 是 String API版本号。例如:v2.0 请求消息
按标签查询镜像 功能介绍 该接口用于按标签或其他条件对镜像进行过滤或者计数使用。 约束与限制 为兼容遗留数据,使用tags、not_tags、tags_any、not_tags_any参数时,不对查询条件中标签的key、value进行字符集校验。 调试 您可以在API Explorer中调试该接口。
增加或修改标签 功能介绍 该接口主要用于为某个镜像增加或修改一个自定义标签。通过自定义标签,用户可以将镜像进行分类。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1/cloudimages/tags 请求消息 请求参数 参数 是否必选 参数类型 描述