查询资源实例数量

功能介绍

根据标签查询资源实例数量。

调用方法

请参见如何调用API。

URI

POST /v5/{project_id}/{resource_type}/resource-instances/count

请求消息

• 请求参数

  表2 请求参数

  名称	类型	是否必选	描述
  without_any_tag	Boolean	否	功能说明：该字段为true时查询所有不带标签的资源，此时忽略 “tags”字段。该字段为false或者未提供该参数时，该条件不生效，即返回所有资源或按"tags"，"matches"等条件过滤。
  tags	Array of Tag objects	否	功能说明：标签列表。 约束：最多填写20个。
  matches	Array of Match objects	否	功能说明：搜索字段，包含key和value。key为要匹配的字段，如resource_name等。value为匹配的值。key为固定字典值。

  表3 Tag

  名称	类型	是否必选	描述
  key	String	是	功能说明：标签的键。 取值范围：1-128个字符。
  values	Array of String	是	功能说明：标签的值列表。如果values为空列表，则表示any_value。value之间为或的关系。 取值范围：0-255个字符。 约束：最多填写20个。

  表4 Match

  名称	类型	是否必选	描述
  key	String	是	功能说明：匹配的键。 取值范围：resource_name。
  value	String	是	功能说明：匹配的值。 取值范围：0-255个字符。

• 请求样例

  POST https://{Endpoint}/v5/{project_id}/{resource_type}/resource-instances/count
  {
      "tags": [{
              "key": "key1",
              "values": [
                  "value1",
                  "value2"
              ]
          },
          {
              "key": "key2",
              "values": [
                  "value1",
                  "value2"
              ]
          }
      ],
      "matches": [{
          "key": "resource_name",
          "value": "resource1"
      }],
      "without_any_tag": "false"
  }

响应消息

• 响应参数

  返回状态码为 200: 查询成功。

  表5 响应Body参数列表

  名称	类型	描述
  total_count	Integer	总记录数。

• 响应样例

  {
      "total_count": 1000
  }

状态码

请参见状态码。