# 查询资源实例数量 - ListResourceQuantityByTag
#### 功能介绍
根据标签查询资源实例数量。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-sfs/sfs_02_0079.html)。
#### 接口约束
如果您将标签权限限制在某个企业项目中，将无法访问TMS平台，查询资源实例数量时会失败。
#### URI
- POST /v3/sfs/tms/{project_id}/file-systems/resource-instances/count

- 参数说明
  
  | 参数         | 是否必选 | 参数类型   | 描述                                                                                   |
  |:---|:---|:---|:---|
  | project_id | 是    | String | 操作用户的项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-sfs/sfs_02_0090.html)。 |
     
  
 
#### 请求参数
表1请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                         |
|:---|:---|:---|:---|
| Content-type | 是    | String | 发送的实体的MIME类型。 示例：application/json |
| X-Auth-Token | 否    | String | 用户Token。                                                                                                                   |
   
表2请求Body参数 
| 参数              | 是否必选 | 参数类型                                                                                                      | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| without_any_tag | 否    | boolean                                                                                                   | 不包含任意一个标签，该字段为true时查询所有不带标签的资源，此时忽略 "tags"字段。该字段为false或者未提供该参数时，该条件不生效，即返回所有资源或按"tags"，"matches"等条件过滤。                                                                                                                                                                                                                                                                                                                                                    |
| tags            | 否    | List\<[tag](https://support.huaweicloud.com/api-sfs/sfs_03_0005.html#sfs_03_0005__table138157172456)\>    | 包含标签，最多包含20个key，每个key下面的value最多20个，每个key对应的value可以为空数组但结构体不能缺失。Key不能重复，同一个key中values不能重复。结果返回包含所有标签的资源列表，key之间是与的关系，key-value结构中value是或的关系。无tag过滤条件时返回全量数据。 详细说明参见[表3](https://support.huaweicloud.com/api-sfs/sfs_03_0005.html#sfs_03_0005__table138157172456)。                                                                                                                                                             |
| sys_tags        | 否    | List\<[tag](https://support.huaweicloud.com/api-sfs/sfs_03_0005.html#sfs_03_0005__table138157172456)\>    | 包含系统标签。仅op_service权限可以使用此字段。 sys_tags和过滤条件without_any_tag 、tags不能同时使用。 目前此字段只包含一个tag结构体： key：_sys_enterprise_project_id value：企业项目id列表 目前key下面只包含一个value。0表示默认企业项目。 详细说明参见[表3](https://support.huaweicloud.com/api-sfs/sfs_03_0005.html#sfs_03_0005__table138157172456)。 |
| matches         | 否    | List\<[match](https://support.huaweicloud.com/api-sfs/sfs_03_0005.html#sfs_03_0005__table1225513315466)\> | 搜索字段。match中key为固定字典值，当前key固定为resource_name，表示根据key对应的value值实现前缀搜索，后续再扩展。 详细说明参见[表4](https://support.huaweicloud.com/api-sfs/sfs_03_0005.html#sfs_03_0005__table1225513315466)。                                                                                                                                                                                                                                            |
   
#### 响应参数
表3响应body参数 
| 参数          | 是否必选 | 参数类型    | 描述   |
|:---|:---|:---|:---|
| total_count | 是    | Integer | 总记录数 |
   
#### 请求示例
projectId为"c80a2157ba1d46c0825265947342077c"，查询资源实例数量示例：
```
POST https://{endpoint}/v3/sfs/tms/c80a2157ba1d46c0825265947342077c/file-systems/resource-instances/count
```
请求体示例：
```
{
    "tags":[
        {
            "key":"key1",
            "values":[
                "value1",
                "value2"
            ]
        },
        {
            "key":"key2",
            "values":[
                "value1",
                "value2"
            ]
        }
    ],
    "matches":[
        {
            "key":"resource_name",
            "value":"resource1"
        }
    ],
    "without_any_tag":"true"
}
```
#### 响应示例
```
{
    "total_count":1
}
```
#### 状态码
- 正常
| 状态码 | 描述          |
|:---|:---|
| 200 | 查询资源实例数量成功。 |
   
- 异常
| 状态码 | 描述      |
|:---|:---|
| 400 | 标签等参数非法 |
| 401 | 认证失败    |
| 403 | 鉴权失败    |
| 404 | 资源未找到   |
| 500 | 系统异常    |