# 查询密钥对实例 - ListResourceInstancesFilter #### 功能介绍 查询密钥对实例。通过标签过滤，筛选用户密钥对，返回密钥对列表 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-dew/dew_02_0002.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dew/dew_02_0308.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI POST /v3/{project_id}/keypairs/resource-instances/filter 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目ID。可参考[获取项目ID](https://support.huaweicloud.com/api-dew/dew_02_0009.html)获取。 **约束限制：** 不涉及 **取值范围：** 以IAM服务接口返回值为准，字符长度32-32 **默认取值：** 不涉及 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | limit | 否 | Integer | **参数解释：** 查询记录数 **约束限制：** - limit必须为整数 **取值范围：** 1\~1000 **默认取值：** 默认为"1000" | | offset | 否 | Integer | **参数解释：** 索引位置。从offset指定的下一条数据开始查询。查询第一页数据时，将查询前一页数据时响应体中的值带入此参数 **约束限制：** - offset必须为整数 **取值范围：** 不涉及 **默认取值：** offset默认为"0" | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。通过调用IAM服务查询用户Token接口获取（响应消息头中X-Subject-Token的值） **约束限制：** 不涉及 **取值范围：** IAM服务查询用户Token接口为准 **默认取值：** 不涉及 | 表4请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | tags | 否 | Array of [Tag] objects | **参数解释：** 标签列表，key和value键值对的集合。最多不超过10个 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | without_any_tag | 否 | Boolean | **参数解释：** 不包含任意一个标签，该字段为true时查询所有不带标签的资源，此时忽略 "tags"字段。该字段为false或者未提供该参数时，该条件不生效，即返回所有资源或按"tags"，"matches"等条件过滤。为空返回空值 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | matches | 否 | Array of [TagMatches] objects | **参数解释：** 搜索字段 - key为搜索的字段，目前仅支持搜索密钥对名称，值为"resource_name" - value为模糊匹配的值，最大长度为255个字符。为空返回空值 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | sys_tags | 否 | Array of [Tag] objects | **参数解释：** 标签列表，key和value键值对的集合。最多不超过10个 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表5TagMatches | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | key | 否 | String | **参数解释：** 待匹配的字段 **约束限制：** 只能为密钥对资源名称 **取值范围：** 不涉及 **默认取值：** 不涉及 | | value | 否 | String | **参数解释：** 标签的值 **约束限制：** 不涉及 **取值范围：** 取值范围不超过255个字符，满足正则匹配"\^(\[\\p{L}\\p{Z}\\p{N}_.:\\/=+\\-@\]\*)$" **默认取值：** 不涉及 | 表6Tag | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | key | 否 | String | **参数解释：** 标签键 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | values | 否 | Array of strings | **参数解释：** 标签值集合 最多包含10个value。标签列表中的标签value值不允许重复。标签列表如果为空列表，表示匹配任意值。标签列表中多个value之间是"或"的关系，在key已经满足要求的前提下，满足请求中的某个value就会匹配出来 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 响应参数 **状态码：200** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total_count | Integer | **参数解释：** 总记录数 **取值范围：** 不涉及 | | resources | Array of [Resources] objects | **参数解释：** 资源实例列表，详情请参见resource字段数据结构说明 **取值范围：** 不涉及 | 表8Resources | 参数 | 参数类型 | 描述 | |:---|:---|:---| | resource_id | String | **参数解释：** 凭据资源ID **取值范围：** 不涉及 | | resource_name | String | **参数解释：** 资源名称，默认为空字符串 **取值范围：** 不涉及 | | tags | Array of [TagItem] objects | **参数解释：** 标签列表，没有标签，数组默认为空 **参数解释：** 不涉及 | | sys_tags | Array of [TagItem] objects | **参数解释：** 系统标签列表，没有标签，数组默认为空 **取值范围：** 不涉及 | | resource_detail | [KeypairDetails] object | **参数解释：** 资源信息 **取值范围：** 不涉及 | | total_count | Integer | **参数解释：** 标签数量 **取值范围：** 不涉及 | 表9TagItem | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key | String | **参数解释：** 标签的名称 **取值范围：** 取值范围为1到128个字符，满足正则匹配"\^((?!\\s)(?!*sys*)\[\\p{L}\\p{Z}\\p{N}_.:=+\\-@\]\*)(?\