通过标签查询实例列表 - ListInstancesByTags

功能介绍

通过标签查询实例列表

接口约束

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

调用方法

请参见如何调用API。

授权信息

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

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

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

URI

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

请求参数

响应参数

状态码：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

返回的实例列表

{
  "resources" : [ {
    "resource_id" : "e120108ac331422cb539d8609e9a7bb2",
    "resouce_detail" : null,
    "resource_name" : "apig_instance",
    "tags" : [ {
      "key" : "test-key",
      "value" : "test-value"
    } ]
  } ],
  "total_count" : 1
}

状态码：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"
}

状态码

错误码

请参见错误码。