查询Flexus L实例云主机详情列表
功能介绍
根据用户请求条件筛选、查询所有的云主机,并关联获取云主机的详细信息。
该接口支持查询云主机计费方式,以及是否被冻结。
接口约束
当前云主机详情列表中未包含包年/包云主机到期时间,如需获取,可以通过客户运营能力相关接口进行查询,详细内容,请参见查询客户包年/包月资源列表。
调试
您可以在API Explorer中调试该接口。
URI
GET /v1/{project_id}/cloudservers/detail?flavor={flavor}&name={name}&status={status}&limit={limit}&offset={offset}¬-tags={not-tags}&reservation_id={reservation_id}&enterprise_project_id={enterprise_project_id}&tags={tags}&ip={ip}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
offset |
否 |
Integer |
页码。 当前页面数,默认值为1,取值范围大于等于0。 当取值为0时,系统默认返回第1页,与取值为1时相同。 建议设置该参数大于等于1。 |
flavor |
否 |
String |
云主机规格ID。 |
name |
否 |
String |
名称,匹配规则为模糊匹配。 支持特殊字符,例如,"." 匹配除换行符(\n、\r)之外的任何单个字符,相等于 [^\n\r]。 |
status |
否 |
String |
云主机状态。 取值范围: ACTIVE、BUILD、ERROR、HARD_REBOOT、MIGRATING、REBOOT、REBUILD、RESIZE、REVERT_RESIZE、SHUTOFF、VERIFY_RESIZE、DELETED、SHELVED、SHELVED_OFFLOADED 、UNKNOWN 状态说明请参考云服务器状态。
说明:
当处于中间状态时,查询范围如下:
|
limit |
否 |
Integer |
查询返回列表当前页面的数量。 每页默认值是25,最多返回1000台的信息,如果数据量过大建议设置成100。 |
tags |
否 |
String |
查询tag字段中包含该值的。 |
not-tags |
否 |
String |
查询tag字段中不包含该值的。 示例:查询的列表中不包含裸金属服务器,该字段设置如下:not-tags=__type_baremetal |
reservation_id |
否 |
String |
使用Openstack Nova 接口批量创建时,会返回该ID,用于查询本次批量创建的。 |
enterprise_project_id |
否 |
String |
查询绑定某个企业项目的。 若需要查询当前用户所有企业项目绑定的,请传参all_granted_eps。 |
ip |
否 |
String |
IPv4地址过滤结果,匹配规则为模糊匹配。 此处IP为的私有IP。 |
ip_eq |
否 |
String |
IPv4地址过滤结果,匹配规则为精确匹配。 此处IP为云主机的私有IP。 |
server_id |
否 |
String |
云主机ID,格式为UUID,匹配规则为精确匹配 示例:server_id={id1}&server_id={id2}
说明:
|
相关信息
本接口复用ECS相应接口,响应参数说明、接口使用示例、返回值等信息详见ECS文档查询云服务器详情,该文档内容同样适用于Flexus L实例云主机。
![](https://support.huaweicloud.com/api-flexusl/public_sys-resources/note_3.0-zh-cn.png)
ECS接口信息中,FlexusL实例中的云主机对应于弹性云服务器。