功能介绍
使用标签过滤弹性云服务器，并返回云服务器使用的所有标签和资源列表。
该接口支持企业项目细粒度权限的校验，具体细粒度请参见 ｅｃｓ：ｃｌｏｕｄＳｅｒｖｅｒｓ：ｌｉｓｔ
ＵＲＩ
ＰＯＳＴ ／ｖ１／｛ｐｒｏｊｅｃｔ＿ｉｄ｝／ｃｌｏｕｄｓｅｒｖｅｒｓ／ｒｅｓｏｕｒｃｅ＿ｉｎｓｔａｎｃｅｓ／ａｃｔｉｏｎ
参数说明请参见表１。
表１ 参数说明
参数
是否必选
描述
ｐｒｏｊｅｃｔ＿ｉｄ
是
项目ＩＤ。
获取方法请参见获取项目ＩＤ。
请求消息
请求参数如表２所示。
表２ 请求参数
参数
是否必选
参数类型
描述
ａｃｔｉｏｎ
是
Ｓｔｒｉｎｇ
值为ｆｉｌｔｅｒ：表示按标签过滤弹性云服务器，返回符合条件的云服务器列表。
ｌｉｍｉｔ
否
Ｓｔｒｉｎｇ
查询返回的云服务器数量限制，最多为１０００，不能为负数。
如果ａｃｔｉｏｎ的值为ｃｏｕｎｔ时，此参数无效。
如果ａｃｔｉｏｎ的值为ｆｉｌｔｅｒ时，ｌｉｍｉｔ必填，取值范围［０－１０００］，如果不传值，系统默认ｌｉｍｉｔ值为１０００。
ｏｆｆｓｅｔ
否
Ｓｔｒｉｎｇ
偏移量：指定返回记录的开始位置，必须为数字，取值范围为大于或等于０。
查询页数据时，可以不传入此参数。
如果ａｃｔｉｏｎ的值为ｃｏｕｎｔ时，此参数无效。
如果ａｃｔｉｏｎ的值为ｆｉｌｔｅｒ时，必填，如果用户不传值，系统默认ｏｆｆｓｅｔ值为０。
ｔａｇｓ
否
Ａｒｒａｙ ｏｆ ｏｂｊｅｃｔｓ
查询包含所有指定标签的弹性云服务器，详情请参见表３。
结构体不能缺失。
ｋｅｙ不能为空或者空字符串。
ｋｅｙ不能重复。
同一个ｋｅｙ中ｖａｌｕｅｓ不能重复。
ｎｏｔ＿ｔａｇｓ
否
Ａｒｒａｙ ｏｆ ｓｔｒｉｎｇｓ
查询不包含所有指定标签的弹性云服务器。
结构体不能缺失。
ｋｅｙ不能为空或者空字符串。
Ｋｅｙ不能重复。
同一个ｋｅｙ中ｖａｌｕｅｓ不能重复。
ｍａｔｃｈｅｓ
否
Ａｒｒａｙ ｏｆ ｏｂｊｅｃｔｓ
搜索字段，用于按条件搜索弹性云服务器。
当前仅支持按ｒｅｓｏｕｒｃｅ＿ｎａｍｅ进行搜索。更多信息，请参见表４。
表３ ｔａｇ字段数据结构说明
参数
是否必选
参数类型
描述
ｋｅｙ
是
Ｓｔｒｉｎｇ
键。
更大长度１２７个ｕｎｉｃｏｄｅ字符。
ｋｅｙ不能为空。
ｖａｌｕｅｓ
是
Ａｒｒａｙ ｏｆ ｓｔｒｉｎｇｓ
值列表。
ｖａｌｕｅ不允许重复。
每个值更大长度２５５ 个ｕｎｉｃｏｄｅ字符。
如果ｖａｌｕｅｓ为空则表示ａｎｙ＿ｖａｌｕｅ。
ｖａｌｕｅ之间为或的关系。
表４ ｍａｔｃｈ字段数据结构说明
参数
是否必选
参数类型
描述
ｋｅｙ
是
Ｓｔｒｉｎｇ
键，表示要匹配的字段。
当前ｋｅｙ的参数值只能取“ｒｅｓｏｕｒｃｅ＿ｎａｍｅ”，此时ｖａｌｕｅ的参数值为云服务器名称。
ｋｅｙ不能重复，ｖａｌｕｅ为匹配的值。
此字段为固定字典值。
不允许为空字符串。
ｖａｌｕｅ
是
Ｓｔｒｉｎｇ
值。
当前ｋｅｙ的参数值只能取“ｒｅｓｏｕｒｃｅ＿ｎａｍｅ”，此时ｖａｌｕｅ的参数值为云服务器名称。
每个值更大长度２５５个ｕｎｉｃｏｄｅ字符。
不可以为空 。
响应消息
响应参数
响应参数如表５所示。
表５ 响应参数
参数
参数类型
描述
ｒｅｓｏｕｒｃｅｓ
Ａｒｒａｙ ｏｆ ｏｂｊｅｃｔｓ
返回的云服务器列表，详情参见表６。
ｔｏｔａｌ＿ｃｏｕｎｔ
Ｉｎｔｅｇｅｒ
总记录数
表６ ｒｅｓｏｕｒｃｅ字段数据结构说明
参数
参数类型
描述
ｒｅｓｏｕｒｃｅ＿ｉｄ
Ｓｔｒｉｎｇ
云服务器ＩＤ
ｒｅｓｏｕｃｅ＿ｄｅｔａｉｌ
Ｓｔｒｉｎｇ
预留字段。
ｔａｇｓ
Ａｒｒａｙ ｏｆ ｏｂｊｅｃｔｓ
标签列表。
ｒｅｓｏｕｒｃｅ＿ｎａｍｅ
Ｓｔｒｉｎｇ
资源名称，即弹性云服务器名称。
表７ ｒｅｓｏｕｒｃｅ＿ｔａｇ字段数据结构说明
参数
参数类型
描述
ｋｅｙ
Ｓｔｒｉｎｇ
键。
更大长度１２７个ｕｎｉｃｏｄｅ字符。
ｋｅｙ不能为空。
只能包含字母、数字、下划线“＿”、中划线“－”。
ｖａｌｕｅ
Ｓｔｒｉｎｇ
值。
每个值更大长度２５５个ｕｎｉｃｏｄｅ字符。
可以为空字符串。
只能包含字母、数字、下划线“＿”、中划线“－”。
示例
请求示例
ＰＯＳＴ ｈｔｔｐｓ：／／｛ｅｎｄｐｏｉｎｔ｝／ｖ１／｛ｐｒｏｊｅｃｔ＿ｉｄ｝／ｃｌｏｕｄｓｅｒｖｅｒｓ／ｒｅｓｏｕｒｃｅ＿ｉｎｓｔａｎｃｅｓ／ａｃｔｉｏｎ
｛
＂ｏｆｆｓｅｔ＂： ＂１００＂，
＂ｌｉｍｉｔ＂： ＂１＂，
＂ａｃｔｉｏｎ＂： ＂ｆｉｌｔｅｒ＂，
＂ｍａｔｃｈｅｓ＂：［
｛
＂ｋｅｙ＂： ＂ｒｅｓｏｕｒｃｅ＿ｎａｍｅ＂，
＂ｖａｌｕｅ＂： ＂ｅｃｓ＿ｔｅｓｔ＂
｝］，
＂ｔａｇｓ＂： ［
｛
＂ｋｅｙ＂： ＂ｋｅｙ１＂，
＂ｖａｌｕｅｓ＂： ［
＂ｖａｌｕｅ１＂，
＂ｖａｌｕｅ２＂
］
｝］
｝
响应示例
｛
＂ｒｅｓｏｕｒｃｅｓ＂： ［
｛
＂ｒｅｓｏｕｒｃｅ＿ｄｅｔａｉｌ＂： ｎｕｌｌ，
＂ｒｅｓｏｕｒｃｅ＿ｉｄ＂： ＂３１７６０ｆｆａ－６７１１－４０６ｄ－ｂｃ９４－ｂｃｅ４ａｅ９２５ａ８ａ＂，
＂ｒｅｓｏｕｒｃｅ＿ｎａｍｅ＂： ＂ｅｃｓ＿ｔｅｓｔ＂，
＂ｔａｇｓ＂： ［
｛
＂ｋｅｙ＂： ＂ｋｅｙ１＂，
＂ｖａｌｕｅ＂： ＂ｖａｌｕｅ１＂
｝
］
｝
］，
＂ｔｏｔａｌ＿ｃｏｕｎｔ＂： １０００
｝
华为云共建智能世界云底座[52] 华为公有云专属云主机DeH服务[51] 华为云场景化解决方案[49] 华为公有云产品[44] 华为云云主机[43] 华为云产品服务[43] 华为云服务器应用[43] 华为弹性云服务器[39] 华为公有云架构解决方案[38] 华为云提供的服务[37] 华为虚拟私有云vpc[37] 华为公有云介绍[32] 华为公有云提供哪些计算服务[30] 华为云漏洞扫描[27] 华为云软件开发服务[27] 华为公有云和私有云区别[27] 华为云域名注册[26] 华为云官网登陆[26] 华为公有云解决方案[26] 华为私有云产品有哪些[26] 华为私有云服务[25] 华为云数据库[23] 华为云安全[22] 华为公有云官网[22] 华为私有云的搭建方案[22] 华为云弹性云服务器应用[21] 华为公有云平台[20] 华为公有云行业解决方案[20] 华为私有云解决方案服务定制领导者[20] [19] 华为私有云服务器[19] 华为私有云网格结构[19] 华为公有云视讯解决方案[18] 华为云官网[17] 华为云速建站[17] 华为私有云架构[17] 华为云优势[16] 华为云服务器[16] 华为私有云部署架构[16] 华为云企业邮箱服务 (SAAS[15] 华为云邮箱[15] 华为公有云是什么[15] 华为公有云架构[15] 华为云迁移解决方案[14] 华为公有云解决方案服务定制领导者[14] 华为私有云解决方案[14] 云邮箱）[13] 华为云园区解决方案[13] 华为云服务总代理[13] 华为云速智能客服[13] 华为公有云服务[13] 华为私有云搭建方案[13] 云与计算咨询服务[12] 云与计算培训服务[11] 华为云备份[11] 华为云服务器配置[11] 华为云服务服务中心[11] 华为云服务核心分销商[11] 华为公有云[11] 华为私有云搭建[11] 云迁移与运营支撑服务[10] 公有云私有云混合云[10] 华为云服务器ECS[10] 华为云服务器成功案例[10] 华为云解决方案[10] 华为公有云通用解决方案[9] 华为智慧云课堂解决方案[9] 华为云数据解决方案[8] 华为云是什么[8] 华为私有云平台[8] 云与计算客户支持与运维使能服务[7] 华为云官网网站[7] 华为云智慧教育解决方案[7] 华为云智慧校园解决方案[7] 华为云桌面系统集成商[7] 华为云经销商[7] 华为代理公司有哪些[7] 华为私有云方案[7] 智慧教育云平台解决方案[7] 华为云服务器试用[6] 华为云网站建设服务器[6] 华为手机代理加盟[6] 华为私有云[6] 大数据使能服务[6] 智慧教育云计算解决方案[6] 华为云云主机 [5] 华为云智慧***解决方案[5] 华为云桌面总代理商[5] 云与计算客户支持服务[4] 华为云产品介绍[4] 华为云智慧制造解决方案[4] 华为云场景化解决方案[3] 华为公有云官网[3] 华为公有云通用解决方案[3] 华为弹性云服务器[3] 华为公有云产品 [3] 华为云产品服务[2] 华为云域名注册[2] 华为云数据库[2] 华为云智慧校园解决方案[2] 华为云服务器应用[2] 华为云服务器成功案例[2] 华为云软件开发服务[2] 华为公有云产品[2] 华为公有云介绍[2] 华为公有云和私有云区别[2] 华为公有云服务[2] 华为公有云架构[2] 华为公有云架构解决方案[2] 华为公有云视讯解决方案[2] 华为公有云解决方案[2] 华为私有云产品有哪些[2] 华为私有云服务[2] 华为私有云架构[2] 智慧教育云计算解决方案[2] 云规划设计与实施服务[2] 云邮箱[2] 华为云产品报价[2] 华为公有云通用解决方案 [2] 华为云服务器成功案例[1] 华为云桌面系统集成商[1] 云与计算客户支持与运维使能服务[1] 云迁移与运营支撑服务[1] 云迁移与运营支撑服务 [1] 华为云共建智能世界云底座[1] 华为云备份[1] 华为云安全[1] 华为云官网登陆[1] 华为云弹性云服务器应用[1] 华为云提供的服务[1] 华为云数据解决方案[1] 华为云智慧制造解决方案[1] 华为云服务器[1] 华为云服务核心分销商 [1] 华为云漏洞扫描[1] 华为云迁移解决方案 [1] 华为云速智能客服[1] 华为云邮箱[1] 华为公有云专属云主机DeH服务[1] 华为公有云是什么[1] 华为公有云行业解决方案[1] 华为私有云搭建[1] 华为私有云方案[1] 华为私有云服务.华为公有云专属云主机DeH服务.华为云产品报价[1] 华为私有云的搭建方案[1] 华为私有云网格结构[1] 华为私有云解决方案[1] 华为私有云部署架构[1] 为云产品服务[1] 云与计算咨询服务 [1] 云与计算客户支持与运维使能服务 [1] 云与计算客户支持与运维使能服务 云与计算客户支持服务[1] 华为云是什么 [1] 华为云软件开发服[1] 华为云速智能客服 [1] 华为代理加盟[1] 华为公有云架构解决方案 [1] 华为公有云解决方案服务定制领导者 [1] 华为弹性云[1] 华为弹性云服务器 华为云域名注册 华为云服务器应用[1] 华为私有云搭建 [1] 华为私有云搭建方案 [1] 华为私有云部署架构 [1] 大数据使能服务 [1] 撒[1]
