查询专属云中的云主机列表 接口功能介绍 该接口提供用户多台云主机信息查询功能,用户可以根据此接口的返回值得到多台云主机的部分信息 准备工作: 构造请求:在调用前需要了解如何构造请求,详情查看构造请求 认证鉴权:openapi请求需要进行加密调用,详细查看认证鉴权 注意事项: 分页查询:当前查询结果以分页形式进行展示,单次查询最多显示50条数据 匹配查找:可以通过部分字段进行匹配筛选数据,无符合条件的为空,在指定多台云主机ID的情况下,只返回匹配到的云主机信息。推荐每次使用单个条件查找 接口约束 无 URI POST /v4/dec/instance/list 路径参数 无 Query参数 无 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 regionID 是 String 资源池ID,您可以查看地域和可用区来了解资源池 获取: 查 资源池列表查询 a39b0db2989140c79e6de8c21d50f132 azName 否 String 可用区名称,您可以查看地域和可用区来了解可用区 获取: 查 资源池可用区查询 注:查询结果中zoneList内返回存在可用区名称(即多可用区,本字段填写实际可用区名称),若查询结果中zoneList为空(即为单可用区,本字段填写default) cnhuadong1jsnj3Apublicctcloud projectID 否 String 企业项目ID,企业项目管理服务提供统一的云资源按企业项目管理,以及企业项目内的资源管理,成员管理。您可以通过查看创建企业项目了解如何创建企业项目 0 pageNo 否 Integer 页码,取值范围:正整数(≥1),注:默认值为1 1 pageSize 否 Integer 每页记录数目,取值范围:[1, 50],注:默认值为10 10 state 否 String 云主机状态,取值范围: active:开机, shutoff:关机, expired:已到期 注:该参数大小写不敏感(如active可填写为ACTIVE) active keyword 否 String 关键字,对部分参数进行模糊查询,包含:instanceName、displayName、instanceID、privateIP ecs888 instanceName 否 String 云主机名称,精准匹配 ecs1 instanceIDList 否 String 云主机ID列表,多台使用英文逗号分割,您可以查看弹性云主机了解云主机的相关信息 获取: 创 创建一台按量付费或包年包月的云主机 创 批量创建按量付费或包年包月云主机 73f321ea62ff11eca8bc005056898fe0,88f888ea88ff88eca8bc888888888fe8 securityGroupID 否 String 安全组ID,模糊匹配,您可以查看安全组概述了解安全组相关信息 获取: 查 查询用户安全组列表 创 创建安全组 sgtolywxbe1f vpcID 否 String 虚拟私有云ID,您可以查看产品定义虚拟私有云来了解虚拟私有云 获取: 查 查询VPC列表 创 创建VPC 注:在多可用区类型资源池下,vpcID通常以“vpc”开头,非多可用区类型资源池vpcID为uuid格式 vpceuu7edo58k resourceID 否 String 资源ID,非资源的UUID,该ID为订单的资源ID(创建云主机接口为异步接口,订单先返回一个该资源ID方便后续查找) 获取: 创 创建一台按量付费或包年包月的云主机 创 批量创建按量付费或包年包月云主机 9178e00c6fd148a88d4307950a9468df