功能介绍
查询云服务器信息列表。
调试
您可以在ＡＰＩ Ｅｘｐｌｏｒｅｒ中调试该接口。
ＵＲＩ
ＧＥＴ ／ｖ２．１／｛ｐｒｏｊｅｃｔ＿ｉｄ｝／ｓｅｒｖｅｒｓ？ｃｈａｎｇｅｓ－ｓｉｎｃｅ＝｛ｃｈａｎｇｅｓ－ｓｉｎｃｅ｝＆ｉｍａｇｅ＝｛ｉｍａｇｅ｝＆ｆｌａｖｏｒ＝｛ｆｌａｖｏｒ｝＆ｎａｍｅ＝｛ｎａｍｅ｝＆ｓｔａｔｕｓ＝｛ｓｔａｔｕｓ｝＆ｌｉｍｉｔ＝｛ｌｉｍｉｔ｝＆ｍａｒｋｅｒ＝｛ｍａｒｋｅｒ｝¬－ｔａｇｓ＝｛ｎｏｔ－ｔａｇｓ｝＆ｒｅｓｅｒｖａｔｉｏｎ＿ｉｄ＝｛ｒｅｓｅｒｖａｔｉｏｎ＿ｉｄ｝＆ｉｐ＝｛ｉｐ｝
参数说明请参见表１。
表１ 路径参数
参数
是否必选
描述
ｐｒｏｊｅｃｔ＿ｉｄ
是
项目ＩＤ。
获取方法请参见获取项目ＩＤ。
表２ 查询参数
参数
是否必选
参数类型
描述
ｃｈａｎｇｅｓ－ｓｉｎｃｅ
否
Ｓｔｒｉｎｇ
云服务器上次更新状态的时间戳信息，过滤出该时间戳之后状态更新的云服务器。格式符合ＩＳＯ ８６０１，采用ＵＴＣ ＋０时区。ＣＣＹＹ－ＭＭ－ＤＤＴｈｈ：ｍｍ：ｓｓ＋／－ｈｈ：ｍｍ，例如：２０１８－０１－１７Ｔ０３：０３：３２Ｚ 。
ｉｍａｇｅ
否
Ｓｔｒｉｎｇ
镜像ＩＤ。
在使用ｉｍａｇｅ作为条件过滤时，不能同时支持其他过滤条件和分页条件。如果同时指定ｉｍａｇｅ及其他条件，则以ｉｍａｇｅ条件为准；当条件不含ｉｍａｇｅ时，接口功能不受限制。
ｆｌａｖｏｒ
否
Ｓｔｒｉｎｇ
云服务器类型ＩＤ，匹配规则为模糊匹配。
ｎａｍｅ
否
Ｓｔｒｉｎｇ
云服务器名称，匹配规则为模糊匹配。
ｓｔａｔｕｓ
否
Ｓｔｒｉｎｇ
云服务器状态。
取值范围：
ＡＣＴＩＶＥ、ＢＵＩＬＤ、ＥＲＲＯＲ、ＨＡＲＤ＿ＲＥＢＯＯＴ、ＭＩＧＲＡＴＩＮＧ、ＲＥＢＯＯＴ、ＲＥＢＵＩＬＤ、ＲＥＳＩＺＥ、ＲＥＶＥＲＴ＿ＲＥＳＩＺＥ、ＳＨＵＴＯＦＦ、ＶＥＲＩＦＹ＿ＲＥＳＩＺＥ
直到２．３７微版本，非上面范围的ｓｔａｔｕｓ字段将返回空列表，微版本２．３８及以上版本，将返回４００错误。
云服务器状态说明请参考云服务器状态。
ｌｉｍｉｔ
否
Ｉｎｔｅｇｅｒ
查询返回云服务器数量限制。
每页默认值是２５，最多返回１０００台云服务器的信息。
ｍａｒｋｅｒ
否
Ｓｔｒｉｎｇ
从ｍａｒｋｅｒ指定的云服务器ＩＤ的下一条数据开始查询。
ｔａｇｓ
否
Ｓｔｒｉｎｇ
查询ｔａｇ字段中包含该值的云服务器。
ｎｏｔ－ｔａｇｓ
否
Ｓｔｒｉｎｇ
查询ｔａｇ字段中不包含该值的云服务器，值为标签的Ｋｅｙ。
说明：
系统近期对标签功能进行了升级。如果之前添加的Ｔａｇ为“Ｋｅｙ．Ｖａｌｕｅ”的形式，则查询的时候需要使用“Ｋｅｙ”来查询。
例如：之前添加的ｔａｇ为“ａ．ｂ”，则升级后，查询时需使用“ｎｏｔ－ｔａｇｓ＝ａ”。
ｒｅｓｅｒｖａｔｉｏｎ＿ｉｄ
否
Ｓｔｒｉｎｇ
批量创建弹性云服务器时，指定返回的ＩＤ，用于查询本次批量创建的弹性云服务器。
ｓｏｒｔ＿ｋｅｙ
否
Ｓｔｒｉｎｇ
查询结果按弹性云服务器属性排序，默认排序顺序为ｃｒｅａｔｅｄ＿ａｔ逆序。
取值范围：ｃｒｅａｔｅｄ＿ａｔ，ａｖａｉｌａｂｉｌｉｔｙ＿ｚｏｎｅ，ｄｉｓｐｌａｙ＿ｎａｍｅ，ｈｏｓｔ，ｉｎｓｔａｎｃｅ＿ｔｙｐｅ＿ｉｄ，ｋｅｙ＿ｎａｍｅ，ｐｒｏｊｅｃｔ＿ｉｄ，ｕｓｅｒ＿ｉｄ，ｕｐｄａｔｅｄ＿ａｔ，ｕｕｉｄ，ｖｍ＿ｓｔａｔｅ
ｉｐ
否
Ｓｔｒｉｎｇ
ＩＰｖ４地址过滤结果，匹配规则为模糊匹配。
请求消息
无
响应消息
响应参数如表３所示。
表３ 响应参数
参数
参数类型
描述
ｓｅｒｖｅｒｓ
Ａｒｒａｙ ｏｆ ｏｂｊｅｃｔｓ
查询云服务器信息列表，请参见表４。
ｓｅｒｖｅｒｓ＿ｌｉｎｋｓ
Ａｒｒａｙ ｏｆ ｏｂｊｅｃｔｓ
分页查询时，查询下一页数据链接，详情请参见表５
表４ ｓｅｒｖｅｒｓ字段数据结构说明
参数
参数类型
描述
ｎａｍｅ
Ｓｔｒｉｎｇ
云服务器名称。
ｉｄ
Ｓｔｒｉｎｇ
云服务器标识。
ｌｉｎｋｓ
Ａｒｒａｙ ｏｆ ｏｂｊｅｃｔｓ
云服务器相关快捷链接信息，详情请参见表５。
表５ ｓｅｒｖｅｒｓ＿ｌｉｎｋｓ，ｌｉｎｋｓ字段数据结构说明
参数
参数类型
描述
ｒｅｌ
Ｓｔｒｉｎｇ
快捷链接标记名称。
ｈｒｅｆ
Ｓｔｒｉｎｇ
对应快捷链接。
请求示例
查询云服务器信息列表。
ＧＥＴ ｈｔｔｐｓ：／／｛ｅｎｄｐｏｉｎｔ｝／ｖ２．１／｛ｐｒｏｊｅｃｔ＿ｉｄ｝／ｓｅｒｖｅｒｓ
响应示例
｛
＂ｓｅｒｖｅｒｓ＂： ［
｛
＂ｉｄ＂： ＂６１６ｆｂ９８ｆ－４６ｃａ－４７５ｅ－９１７ｅ－２５６３ｅ５ａ８ｃｄ１９＂，
＂ｌｉｎｋｓ＂： ［
｛
＂ｈｒｅｆ＂： ＂ｈｔｔｐ：／／ｏｐｅｎｓｔａｃｋ．ｅｘａｍｐｌｅ．ｃｏｍ／ｖ２／ｏｐｅｎｓｔａｃｋ／ｓｅｒｖｅｒｓ／６１６ｆｂ９８ｆ－４６ｃａ－４７５ｅ－９１７ｅ－２５６３ｅ５ａ８ｃｄ１９＂，
＂ｒｅｌ＂： ＂ｓｅｌｆ＂
｝，
｛
＂ｈｒｅｆ＂： ＂ｈｔｔｐ：／／ｏｐｅｎｓｔａｃｋ．ｅｘａｍｐｌｅ．ｃｏｍ／ｏｐｅｎｓｔａｃｋ／ｓｅｒｖｅｒｓ／６１６ｆｂ９８ｆ－４６ｃａ－４７５ｅ－９１７ｅ－２５６３ｅ５ａ８ｃｄ１９＂，
＂ｒｅｌ＂： ＂ｂｏｏｋｍａｒｋ＂
｝
］，
＂ｎａｍｅ＂： ＂ｎｅｗ－ｓｅｒｖｅｒ－ｔｅｓｔ＂
｝
］
｝
返回值
请参考通用请求返回值。
华为云共建智能世界云底座[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]
