华为云计算 云知识 按条件查询租户镜像标签列表ListTags
按条件查询租户镜像标签列表ListTags

 

接口说明

根据不同条件查询 镜像 标签列表信息。

URL
GET  https://ims.cn-north-1.myhuaweicloud.com/v1/cloudimages/tags 
请求参数
名称 类型 IN 必选 描述
X-Auth-Token
 
string header

用户Token,使用Token认证时该字段必选。

limit
 
integer query

用于分页,表示查询几条记录,取值为整数,默认为所有。

page
 
integer query

页码,表示需要查询第几页的数据。默认值为1。

__imagetype
 
string query

镜像类型,目前支持以下类型:公共镜像:gold私有镜像:private共享镜像:shared 市场镜像:market

id
 
string query

镜像ID。

status
 
string query

镜像状态。取值如下: queued:表示镜像元数据已经创建成功,等待上传镜像文件。 saving:表示镜像正在上传文件到后端存储。 deleted:表示镜像已经删除。 killed:表示镜像上传错误。 active:表示镜像可以正常使用。

name
 
string query

镜像名称。

min_disk
 
integer query

镜像运行需要的最小磁盘,单位为GB 。

__platform
 
string query

镜像平台分类。

__os_type
 
string query

镜像系统类型,取值如下:Linux,Windows,Other

member_status
 
string query

成员状态。目前取值有accepted、rejected、pending。

virtual_env_type
 
string query

镜像使用环境类型:FusionCompute、Ironic、DataImage。

enterprise_project_id
 
string query

表示查询某个企业项目下的镜像。

architecture
 
string query

镜像架构类型。取值包括:x86,arm

created_at
 
string query

镜像创建时间。支持按照时间点过滤查询,取值格式为“操作符:UTC时间”。 其中操作符支持如下几种: gt:大于 gte:大于等于 lt:小于 lte:小于等于 eq:等于 neq:不等于 时间格式支持:yyyy-MM-ddThh:mm:ssZ或者yyyy-MM-dd hh:mm:ss 例如,查询创建时间在2018-10-28 10:00:00之前的镜像,可以通过如下条件过滤: created_at=gt:2018-10-28T10:00:00Z

updated_at
 
string query

镜像修改时间。支持按照时间点过滤查询,取值格式为“ 操作符:UTC时间”。 其中操作符支持如下几种: gt:大于 gte:大于等于 lt:小于 lte:小于等于 eq:等于 neq:不等于 时间格式支持:yyyy-MM-ddThh:mm:ssZ或者yyyy-MM-dd hh:mm:ss 例如,查询修改时间在2018-10-28 10:00:00之前的镜像,可以通过如下条件过滤: updated_at=gt:2018-10-28T10:00:00Z

返回参数
返回码: 200

正常

名称 类型 必选 描述
tags
 
Array of strings

标签列表

返回码: 400

Bad Request 请求错误。

名称 类型 必选 描述
error
 
ErrorMessageInfo object

请求失败响应体

400 error
名称 类型 必选 描述
code
 
string

错误码

message
 
string

错误信息

返回码: 401

Unauthorized 鉴权失败。

名称 类型 必选 描述
error
 
ErrorMessageInfo object

请求失败响应体

401 error
名称 类型 必选 描述
code
 
string

错误码

message
 
string

错误信息

返回码: 403

Forbidden 没有操作权限。

名称 类型 必选 描述
error
 
ErrorMessageInfo object

请求失败响应体

403 error
名称 类型 必选 描述
code
 
string

错误码

message
 
string

错误信息

返回码: 404

Not Found 找不到资源。

名称 类型 必选 描述
error
 
ErrorMessageInfo object

请求失败响应体

404 error
名称 类型 必选 描述
code
 
string

错误码

message
 
string

错误信息

返回码: 500

Internal Server Error 服务内部错误。

名称 类型 必选 描述
error
 
ErrorMessageInfo object

请求失败响应体

500 error
名称 类型 必选 描述
code
 
string

错误码

message
 
string

错误信息

返回码: 503

Service Unavailable 服务不可用。

名称 类型 必选 描述
error
 
ErrorMessageInfo object

请求失败响应体

503 error
名称 类型 必选 描述
code
 
string

错误码

message
 
string

错误信息

请求示例
示例 1
 
"GET https://{Endpoint}/v1/cloudimages/tags?limit=5&page=1 "
返回示例
返回码:200

正常

示例 1
 
{
"tags": [
"jjjj.11111",
"uuuu.22222",
"234.4",
"test",
"image"
]
}
SDK
点击  镜像服务  (IMS) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明

上一篇:华为云微服务引擎 | 0停机迁移Nacos?“它”是这样做的 下一篇:集群休眠HibernateCluster

镜像服务 IMS

镜像是用于创建服务器或磁盘的模板。镜像服务提供镜像生命周期管理能力。可以通过服务器或外部文件创建系统盘镜像或数据盘镜像,也可以使用弹性云服务器或云服务器备份创建带数据盘的整机镜像。创建镜像功能免费,仅需支付使用对象存储服务或云服务器备份的费用。