更新时间：2025-08-20 GMT+08:00
根据标签信息查询实例数量
功能介绍
根据标签信息查询资源共享实例数量。
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Security-Token |
否 |
String |
如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
without_any_tag |
否 |
Boolean |
不包含任意一个标签，该字段为true时查询所有不带标签的资源。 |
|
tags |
否 |
Array of TagFilter objects |
包含标签，最多包含20个key，每个key下面的value最多20个，结构体不能缺失，key不能为空或者空字符串。Key不能重复，同一个key中values不能重复。返回包含所有标签的资源列表，key之间是"与"的关系，key-value结构中value是"或"的关系。无tag过滤条件时返回全量数据。 |
|
matches |
否 |
Array of Match objects |
搜索字段,key为要匹配的字段，如resource_name等。value为匹配的值。key为固定字典值，不能包含重复的key或不支持的key。根据key的值确认是否需要模糊匹配，如resource_name需要实现前缀搜索，如果value为空字符串精确匹配（多数服务不存在资源名称为空的情况，因此此类情况返回空列表）。resource_id为精确匹配。第一期只做resource_name，后续再扩展。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
total_count |
Integer |
总记录数。 |
请求示例
根据标签信息查询资源共享实例数量。
POST https://{endpoint}/v1/resource-shares/resource-instances/count
{
"without_any_tag" : true,
"tags" : [ {
"key" : "string",
"values" : [ "string" ]
} ],
"matches" : [ {
"key" : "string",
"value" : "string"
} ]
}
响应示例
状态码：200
请求成功。
{
"total_count" : 100
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
请求成功。 |
错误码
请参见错误码。
父主题： 标签管理
