文档首页> 云连接 CC> API参考> API> 全域互联带宽标签管理> 查询账户全域互联带宽资源标签数量
更新时间:2024-03-29 GMT+08:00
分享

查询账户全域互联带宽资源标签数量

功能介绍

查询账户全域互联带宽资源标签数量

调用方法

请参见如何调用API

URI

POST /v3/gcb/resource-instances/count

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

最小长度:0

最大长度:102400

表2 请求Body参数

参数

是否必选

参数类型

描述

request_id

String

请求ID。

最小长度:0

最大长度:36

without_any_tag

Boolean

不包含任意一个标签,该字段为true时查询所有不带标签的资源,此时忽略 “tags”、“tags_any”、“not_tags”、“not_tags_any”字段。

tags

Array of QueryTag objects

包含标签,最多包含20个key,每个key下面的value最多10个,每个key对应的value可以为空数组但结构体不能缺失。Key不能重复,同一个key中values不能重复。结果返回包含所有标签的资源列表,key之间是与的关系,key-value结构中value是或的关系。无tag过滤条件时返回全量数据。

数组长度:0 - 50

tags_any

Array of QueryTag objects

包含任意标签,最多包含20个key,每个key下面的value最多10个, 每个key对应的value可以为空数组但结构体不能缺失。Key不能重复,同一个key中values不能重复。结果返回包含标签的资源列表,key之间是或的关系,key-value结构中value是或的关系。无过滤条件时返回全量数据。

数组长度:0 - 50

not_tags

Array of QueryTag objects

不包含标签,最多包含20个key,每个key下面的value最多10个, 每个key对应的value可以为空数组但结构体不能缺失。Key不能重复,同一个key中values不能重复。结果返回不包含标签的资源列表,key之间是与的关系,key-value结构中value是或的关系。无过滤条件时返回全量数据。

数组长度:0 - 50

not_tags_any

Array of QueryTag objects

不包含任意标签,最多包含20个key,每个key下面的value最多10个, 每个key对应的value可以为空数组但结构体不能缺失。Key不能重复,同一个key中values不能重复。结果返回不包含标签的资源列表,key之间是或的关系,key-value结构中value是或的关系。无过滤条件时返回全量数据。

数组长度:0 - 50

matches

Array of TmsMatch objects

是否匹配以下tag,key必须为"resource_name",value如果有值则模糊匹配,如果为空字符串则精确匹配。

数组长度:0 - 50

表3 QueryTag

参数

是否必选

参数类型

描述

key

String

键。

最小长度:0

最大长度:128

values

Array of strings

值列表。

最小长度:0

最大长度:255

数组长度:1 - 10

表4 TmsMatch

参数

是否必选

参数类型

描述

key

String

键。第一期限定为resource_name,后续扩展。

最小长度:1

最大长度:128

value

String

值。

最小长度:0

最大长度:255

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

total_count

Integer

总记录数。

最小值:0

最大值:2000.0

request_id

String

请求ID。

最小长度:0

最大长度:36

请求示例

查询账户全域互联带宽资源标签数量

POST https://{cc_endpoint}/v3/gcb/resource-instances/count

{
  "not_tags" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  } ],
  "tags" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  } ],
  "tags_any" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  } ],
  "not_tags_any" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  } ],
  "matches" : [ {
    "key" : "resource_name",
    "value" : "resource1"
  } ]
}

响应示例

状态码: 200

查询账户全域互联带宽资源标签数量。

{
  "request_id" : "e3371202-7e85-4c16-bb4b-4e3c092734f7",
  "total_count" : 1
}

状态码

状态码

描述

200

查询账户全域互联带宽资源标签数量。

错误码

请参见错误码

分享:

    相关文档

    相关产品