按标签条件统计超节点数量-CountHypernodesByTag
功能介绍
按标签条件统计超节点数量接口,用于根据标签、资源名称或资源 ID 等组合条件,统计指定项目下符合条件的超节点实例总数。
该接口适用于以下场景:仅需获取匹配资源数量、无需分页列表时的快速统计。请求体过滤条件与按标签分页查询超节点列表接口相同。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| aics:hypernode:listResourcesByTag | List | - | g:TagKeys | - | - |
URI
POST /v2/{project_id}/hypernodes/resource-instances/count
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 否 | String | 参数解释: 用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| without_any_tag | 否 | Boolean | 参数解释: 是否仅查询未绑定任何标签的资源。 约束限制: 为 true 时返回所有不带标签的资源,此时忽略 tags 字段;为 false 或未指定时该条件不生效。 取值范围: 默认取值: false。 |
| tags | 否 | Array of FilterTag objects | 参数解释: 按标签过滤资源。 约束限制: 最多指定 20 个标签键,每个键下最多 64 个取值;多个标签键之间为“与”关系,同一键下多个取值为“或”关系;若某键的 values 为空数组,表示仅按该键是否存在进行过滤。 取值范围: 不涉及。 默认取值: 不涉及。 |
| matches | 否 | Array of Match objects | 参数解释: 按资源名称或资源 ID 等属性进行附加匹配,可与标签条件组合使用。 约束限制: 最多指定 16 条匹配条件。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| key | 是 | String | 参数解释: 标签键。 约束限制: 不能以 _sys_ 开头;首尾不能为空白字符。 取值范围: 最大128个Unicode字符,满足'^((?!\s)(?!_sys_)[\p{L}\p{Z}\p{N}_.:/=+-@]*)(?<!\s)$'。 默认取值: 不涉及。 |
| values | 是 | Array of strings | 参数解释: 标签取值列表。 约束限制: 为空数组时表示仅匹配存在该标签键的资源,不限定取值。 取值范围: 每个取值最大255个Unicode字符;最多64个取值,满足'^([\p{L}\p{Z}\p{N}_.:/=+-@]*)$'。 默认取值: 不涉及。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| total_count | Integer | 参数解释: 满足过滤条件的资源实例总数。 取值范围: 大于等于 0 的整数。 |
请求示例
按标签条件统计超节点数量请求示例。使用场景:用户需要统计项目中满足标签过滤条件的超节点总数时使用。
POST https://{endpoint}/v2/{project_id}/hypernodes/resource-instances/count 响应示例
状态码:200
成功返回满足过滤条件的超节点实例总数。
{
"total_count" : 5
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 成功返回满足过滤条件的超节点实例总数。 |
错误码
请参见错误码。