国产精品久久久久久三区欧美,一区二区三区成人毛片亚洲精品

華為云計算云知識按標(biāo)簽查詢專屬主機列表ListDedicatedHostsByTags

按標(biāo)簽查詢專屬主機列表ListDedicatedHostsByTags

時間: 2023-07-27 16:17:49

API網(wǎng)關(guān) 云服務(wù)器云主機云計算

猜你想看：

實時語音識別云服務(wù)器配置 CDN是什么意思視頻點播加速什么是云桌面

功能介紹

使用標(biāo)簽過濾專屬主機列表，并返回專屬主機使用的所有標(biāo)簽。

標(biāo)簽管理服務(wù)（TMS）使用該接口過濾專屬主機列表。

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

POST /v1.0/{project_id}/dedicated-host-tags/resource_instances/action

參數(shù)說明請參見表1。

表1 參數(shù)說明
參數(shù)	參數(shù)類型	是否必選	描述
project_id	String	是	項目ID。

請求消息

表2 請求參數(shù)
參數(shù)	參數(shù)類型	是否必選	描述
tags	Array of objects	否	查詢包含所有指定標(biāo)簽的專屬主機。更多信息，請參見表3。最多包含10個key，每個key下面的value最多10個。結(jié)構(gòu)體不能缺失。 key不能為空或者空字符串。 key不能重復(fù)。同一個key中value不能重復(fù)。
not_tags	Array of objects	否	查詢不包含所有指定標(biāo)簽的專屬主機。更多信息，請參見表3。最多包含10個key，每個key下面的value最多10個。結(jié)構(gòu)體不能缺失。 key不能為空或者空字符串。 Key不能重復(fù)。同一個key中value不能重復(fù)。
limit	Integer	否	查詢返回的專屬主機數(shù)量限制，最多為1000，不能為負數(shù)。如果action的值為count，此參數(shù)無效。如果action的值為filter，limit默認為1000。
offset	Integer	否	索引位置，從offset指定的下一條數(shù)據(jù)開始查詢。必須為數(shù)字，不能為負數(shù)。查詢第一頁數(shù)據(jù)時，不需要傳入此參數(shù)。查詢后續(xù)頁碼數(shù)據(jù)時，將查詢前一頁數(shù)據(jù)時響應(yīng)體中的值帶入此參數(shù)。如果action的值為count，此參數(shù)無效。如果action的值為filter，offset默認為0。
action	String	是	操作標(biāo)識，包括filter和count兩種。 filter：表示按標(biāo)簽過濾專屬主機，返回符合條件的專屬主機列表。此時，為分頁查詢。 count：表示按標(biāo)簽搜索專屬主機，返回符合條件的專屬主機個數(shù)。
tags_any	Array of objects	否	包含任意標(biāo)簽。更多信息，請參見表3。最多包含10個key，每個key下面的value最多10個，每個key對應(yīng)的value可以為空數(shù)組但結(jié)構(gòu)體不能缺失。 key不能重復(fù)，同一個key中value不能重復(fù)。結(jié)果返回包含標(biāo)簽的資源列表，key之間是“或”的關(guān)系，key-value結(jié)構(gòu)中value是“或”的關(guān)系。無過濾條件時返回全量數(shù)據(jù)。
not_tags_any	Array of objects	否	不包含任意標(biāo)簽。更多信息，請參見表3。最多包含10個key，每個key下面的value最多10個，每個key對應(yīng)的value可以為空數(shù)組但結(jié)構(gòu)體不能缺失。 key不能重復(fù)，同一個key中value不能重復(fù)。結(jié)果返回不包含標(biāo)簽的資源列表，key之間是“或”的關(guān)系，key-value結(jié)構(gòu)中value是或的關(guān)系。無過濾條件時返回全量數(shù)據(jù)。
matches	Array of objects	否	搜索字段，用于按條件搜索專屬主機。當(dāng)前僅支持按resource_name進行搜索。更多信息，請參見表4。

表3 tag字段數(shù)據(jù)結(jié)構(gòu)說明
參數(shù)	參數(shù)類型	是否必選	描述
key	String	是	鍵。最大長度127個unicode字符。 key不能為空。
values	Array of strings	否	值列表。最多10個value。 value不允許重復(fù)。每個值最大長度255個unicode字符。如果value缺失則表示any_value。 value之間為“或”的關(guān)系。

表4 match字段數(shù)據(jù)結(jié)構(gòu)說明
參數(shù)	參數(shù)類型	是否必選	描述
key	String	是	鍵，表示要匹配的字段。 key不能重復(fù)，value為匹配的值。此字段為固定字典值。不允許為空字符串。說明：當(dāng)前key的參數(shù)值僅支持resource_name，此時value的參數(shù)值為專屬主機名稱。
value	String	是	值。每個值最大長度為255個unicode字符。不可以為空。

響應(yīng)消息

表5 響應(yīng)參數(shù)
參數(shù)	參數(shù)類型	描述
resources	Array of objects	返回的專屬主機列表，詳情參見表6。
total_count	Integer	總記錄數(shù)。

表6 resource字段數(shù)據(jù)結(jié)構(gòu)說明
參數(shù)	參數(shù)類型	描述
resource_id	String	專屬主機ID。
resouce_detail	String	專屬主機詳情。該字段用于后續(xù)擴展，默認為空。
tags	Array of objects	標(biāo)簽列表。詳見表表7。
resource_name	String	資源名稱。

表7 tag字段數(shù)據(jù)結(jié)構(gòu)說明
參數(shù)	參數(shù)類型	描述
key	String	鍵。最大長度36個unicode字符。 key不能為空。不能包含以下ASCII非打印字符：“=”,“*”,“<”,“>”,“\”,“\|”,“/”,“,”。
value	String	值。每個值最大長度43個unicode字符。可以為空字符串。不能包含以下ASCII非打印字符： “=”,“*”,“<”,“>”,“\”,“\|”,“/”,“,”。

請求示例

按標(biāo)簽查詢專屬主機列表，按標(biāo)簽過濾專屬主機，從第一條數(shù)據(jù)開始查詢，搜索名稱為resource1的專屬主機，標(biāo)簽鍵為key1值為value1。

POST https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-host-tags/resource_instances/action

{ 
    "offset": "0",
    "limit": "100",
    "action": "filter",
    "matches": [
        {
            "key": "resource_name",
            "value": "resource1"
        }
    ],
    "tags": [
        {
            "key": "key1",
            "values": ["value1"]
        }
    ]
}

響應(yīng)示例

action為filter時的響應(yīng)體：

{
    "resources": [
        {
            "resource_detail": null,
            "resource_id": "cdfs_cefs_wesas_12_dsad",
            "resource_name": "resource1",
            "tags": [
                {
                    "key": "key1",
                    "value": "value1"
                }
            ]
        }
    ],
    "total_count": 1
}

action為count時的響應(yīng)體：

{
    "total_count": 100
}

返回值

請參見狀態(tài)碼。

上一篇：數(shù)據(jù)庫設(shè)計與管理下一篇：「智能制造」火了，云端協(xié)同的數(shù)字工廠究竟長啥樣？

五月婷婷丁香性爱|j久久一级免费片|久久美女福利视频|中文观看在线观看|加勒比四区三区二|亚洲裸女视频网站|超碰97AV在线69网站免费观看|有码在线免费视频|久久青青日本视频|亚洲国产AAAA