華為云計(jì)算 云知識 按條件查詢租戶鏡像標(biāo)簽列表ListTags
按條件查詢租戶鏡像標(biāo)簽列表ListTags

 

接口說明

根據(jù)不同條件查詢 鏡像 標(biāo)簽列表信息。

URL
GET  https://ims.cn-north-1.myhuaweicloud.com/v1/cloudimages/tags 
請求參數(shù)
名稱 類型 IN 必選 描述
X-Auth-Token
 
string header

用戶Token,使用Token認(rèn)證時(shí)該字段必選。

limit
 
integer query

用于分頁,表示查詢幾條記錄,取值為整數(shù),默認(rèn)為所有。

page
 
integer query

頁碼,表示需要查詢第幾頁的數(shù)據(jù)。默認(rèn)值為1。

__imagetype
 
string query

鏡像類型,目前支持以下類型:公共鏡像:gold私有鏡像:private共享鏡像:shared 市場鏡像:market

id
 
string query

鏡像ID。

status
 
string query

鏡像狀態(tài)。取值如下: queued:表示鏡像元數(shù)據(jù)已經(jīng)創(chuàng)建成功,等待上傳鏡像文件。 saving:表示鏡像正在上傳文件到后端存儲。 deleted:表示鏡像已經(jīng)刪除。 killed:表示鏡像上傳錯(cuò)誤。 active:表示鏡像可以正常使用。

name
 
string query

鏡像名稱。

min_disk
 
integer query

鏡像運(yùn)行需要的最小磁盤,單位為GB 。

__platform
 
string query

鏡像平臺分類。

__os_type
 
string query

鏡像系統(tǒng)類型,取值如下:Linux,Windows,Other

member_status
 
string query

成員狀態(tài)。目前取值有accepted、rejected、pending。

virtual_env_type
 
string query

鏡像使用環(huán)境類型:FusionCompute、Ironic、DataImage。

enterprise_project_id
 
string query

表示查詢某個(gè)企業(yè)項(xiàng)目下的鏡像。

architecture
 
string query

鏡像架構(gòu)類型。取值包括:x86,arm

created_at
 
string query

鏡像創(chuàng)建時(shí)間。支持按照時(shí)間點(diǎn)過濾查詢,取值格式為“操作符:UTC時(shí)間”。 其中操作符支持如下幾種: gt:大于 gte:大于等于 lt:小于 lte:小于等于 eq:等于 neq:不等于 時(shí)間格式支持:yyyy-MM-ddThh:mm:ssZ或者yyyy-MM-dd hh:mm:ss 例如,查詢創(chuàng)建時(shí)間在2018-10-28 10:00:00之前的鏡像,可以通過如下條件過濾: created_at=gt:2018-10-28T10:00:00Z

updated_at
 
string query

鏡像修改時(shí)間。支持按照時(shí)間點(diǎn)過濾查詢,取值格式為“ 操作符:UTC時(shí)間”。 其中操作符支持如下幾種: gt:大于 gte:大于等于 lt:小于 lte:小于等于 eq:等于 neq:不等于 時(shí)間格式支持:yyyy-MM-ddThh:mm:ssZ或者yyyy-MM-dd hh:mm:ss 例如,查詢修改時(shí)間在2018-10-28 10:00:00之前的鏡像,可以通過如下條件過濾: updated_at=gt:2018-10-28T10:00:00Z

返回參數(shù)
返回碼: 200

正常

名稱 類型 必選 描述
tags
 
Array of strings

標(biāo)簽列表

返回碼: 400

Bad Request 請求錯(cuò)誤。

名稱 類型 必選 描述
error
 
ErrorMessageInfo object

請求失敗響應(yīng)體

400 error
名稱 類型 必選 描述
code
 
string

錯(cuò)誤碼

message
 
string

錯(cuò)誤信息

返回碼: 401

Unauthorized 鑒權(quán)失敗。

名稱 類型 必選 描述
error
 
ErrorMessageInfo object

請求失敗響應(yīng)體

401 error
名稱 類型 必選 描述
code
 
string

錯(cuò)誤碼

message
 
string

錯(cuò)誤信息

返回碼: 403

Forbidden 沒有操作權(quán)限。

名稱 類型 必選 描述
error
 
ErrorMessageInfo object

請求失敗響應(yīng)體

403 error
名稱 類型 必選 描述
code
 
string

錯(cuò)誤碼

message
 
string

錯(cuò)誤信息

返回碼: 404

Not Found 找不到資源。

名稱 類型 必選 描述
error
 
ErrorMessageInfo object

請求失敗響應(yīng)體

404 error
名稱 類型 必選 描述
code
 
string

錯(cuò)誤碼

message
 
string

錯(cuò)誤信息

返回碼: 500

Internal Server Error 服務(wù)內(nèi)部錯(cuò)誤。

名稱 類型 必選 描述
error
 
ErrorMessageInfo object

請求失敗響應(yīng)體

500 error
名稱 類型 必選 描述
code
 
string

錯(cuò)誤碼

message
 
string

錯(cuò)誤信息

返回碼: 503

Service Unavailable 服務(wù)不可用。

名稱 類型 必選 描述
error
 
ErrorMessageInfo object

請求失敗響應(yīng)體

503 error
名稱 類型 必選 描述
code
 
string

錯(cuò)誤碼

message
 
string

錯(cuò)誤信息

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

正常

示例 1
 
{
"tags": [
"jjjj.11111",
"uuuu.22222",
"234.4",
"test",
"image"
]
}
SDK
點(diǎn)擊  鏡像服務(wù)  (IMS) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認(rèn)證方式等在SDK文檔中對應(yīng)語言類型的【使用】目錄下。
錯(cuò)誤碼
請參考 錯(cuò)誤碼說明。