查询包含指定标签的实例数量 - ShowInstancesNumByTags

功能介绍

查询包含指定标签的实例数量。

接口约束

使用策略授权用户时，需要包含apig:instance:getNumByTags的授权项才允许调用此接口。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

• 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
• 如果使用身份策略授权，需具备如下身份策略权限。

  授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
  apig:instance:getNumByTags	Read	instance *	-	-	-
  		-	g:TagKeys

URI

POST /v2/{project_id}/apigw/resource-instances/count

请求参数

响应参数

状态码：200

状态码：401

状态码：403

状态码：500

请求示例

• 查询包含指定标签的实例数量

  {
    "without_any_tag" : false,
    "tags" : [ {
      "key" : "test-key",
      "values" : [ "test-value" ]
    } ],
    "matches" : [ {
      "key" : "resource_name",
      "value" : "test-apig"
    } ]
  }

• 查询企业项目id为指定值的实例数量

  {
    "without_any_tag" : false,
    "sys_tags" : [ {
      "key" : "_sys_enterprise_project_id",
      "values" : [ "0" ]
    } ],
    "matches" : [ {
      "key" : "resource_name",
      "value" : "test-apig"
    } ]
  }

响应示例

状态码：200

OK

{
  "total_count" : 20
}

状态码：401

Unauthorized

{
  "error_code" : "APIC.7102",
  "error_msg" : "Incorrect token or token resolution failed"
}

状态码：403

Forbidden

{
  "error_code" : "APIC.7106",
  "error_msg" : "No permissions to request for the method"
}

状态码：500

Internal Server Error

{
  "error_code" : "APIC.9000"
}

状态码

错误码

请参见错误码。