
# 查询云服务器详情列表 - ListServersDetails
#### 功能介绍
根据用户请求条件筛选、查询所有的弹性云服务器，并关联获取弹性云服务器的详细信息。
该接口支持查询弹性云服务器计费方式，以及是否被冻结。
#### 接口约束
当前云服务器详情列表中未包含包年/包月云服务器到期时间，如需获取，可以通过客户运营能力相关接口进行查询，详细内容，请参见[查询客户包年/包月资源列表](https://support.huaweicloud.com/api-oce/api_order_00021.html)。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=ECS&api=ListServersDetails)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ecs/ecs_06_0000.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
 
| 授权项                                 | 访问级别 | 资源类型（\*为必须） | 条件键                   | 别名                    | 依赖的授权项 |
|:---|:---|:---|:---|:---|:---|
| ecs:cloudServers:listServersDetails | list | -           | g:EnterpriseProjectId | ecs:cloudServers:list | -      |
   
#### URI
GET /v1/{project_id}/cloudservers/detail
参数说明请参见[表1]。
 表1路径参数 
| 参数         | 是否必选 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|
| project_id | 是    | **参数解释：** 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ecs/ecs_01_0016.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
   
表2查询参数 
| 参数                    | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| offset                | 否    | Integer | **参数解释：** 当前页面数（废弃，不推荐使用，建议使用marker进行分页查询）。 **约束限制：** 当取值为0时，系统默认返回第1页，与取值为1时相同。 建议设置该参数大于等于1。 **取值范围：** 大于等于0。 **默认取值：** 1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| marker                | 否    | String  | **参数解释：** 以单页最后一条server的id作为分页标记。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| flavor                | 否    | String  | **参数解释：** 云服务器规格ID。 已上线的规格请参见《弹性云服务器产品介绍》的"[实例规格](https://support.huaweicloud.com/productdesc-ecs/ecs_01_0008.html)"章节。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| name                  | 否    | String  | **参数解释：** 云服务器名称，匹配规则为模糊匹配。 **约束限制：** 不涉及 **取值范围：** 只能由中文字符、英文字母、数字及"_"、"-"、"."组成，且长度为\[1-128\]个英文字符或\[1-64\]个中文字符。 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| status                | 否    | String  | **参数解释：** 云服务器状态。 **约束限制：** 不涉及 **取值范围：** ACTIVE、BUILD、ERROR、HARD_REBOOT、MIGRATING、REBOOT、REBUILD、RESIZE、REVERT_RESIZE、SHUTOFF、VERIFY_RESIZE、DELETED、SHELVED、SHELVED_OFFLOADED 、UNKNOWN 弹性云服务器状态说明请参考[云服务器状态](https://support.huaweicloud.com/api-ecs/ecs_08_0002.html)。 说明： 当云服务器处于中间状态时，查询范围如下： - ACTIVE，查询范围：ACTIVE，REBOOT，HARD_REBOOT，REBUILD，MIGRATING、RESIZE  - SHUTOFF，查询范围：SHUTOFF，RESIZE，REBUILD  - ERROR，查询范围：ERROR，REBUILD  - VERIFY_RESIZE，查询范围：VERIFY_RESIZE，REVERT_RESIZE   **默认取值：** 不涉及 |
| limit                 | 否    | Integer | **参数解释：** 查询返回云服务器列表当前页面的数量。 **约束限制：** 每页默认值是25，最多返回1000台云服务器的信息，如果数据量过大建议设置成200。 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| tags                  | 否    | String  | **参数解释：** 查询tag字段中包含该值的云服务器。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| not-tags              | 否    | String  | **参数解释：** 查询tag字段中不包含该值的云服务器。 示例：查询的云服务器列表中不包含裸金属服务器，该字段设置如下：not-tags=__type_baremetal **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| reservation_id        | 否    | String  | **参数解释：** 使用Openstack Nova 接口批量创建弹性云服务器时，会返回该ID，用于查询本次批量创建的弹性云服务器。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| enterprise_project_id | 否    | String  | **参数解释：** 查询绑定某个企业项目的弹性云服务器。 **约束限制：** 若需要查询当前用户所有企业项目绑定的弹性云服务器，请传参**all_granted_eps**。 说明： - 查询的企业项目需具备ecs:cloudServers:list的权限。 如果用户只有某个企业项目的权限，则需要传递该参数，查询指定企业项目绑定的弹性云服务器，否则会因权限不足而报错。   - 当前**all_granted_eps**支持查询的企业项目个数不超过100。   **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ip                    | 否    | String  | **参数解释：** IPv4地址过滤结果，匹配规则为模糊匹配。 此处IP为云服务器的私有IP。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ip_eq                 | 否    | String  | **参数解释：** IPv4地址过滤结果，匹配规则为精确匹配。 此处IP为云服务器的私有IP。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| server_id             | 否    | String  | **参数解释：** 云服务器ID，格式为UUID，匹配规则为精确匹配 示例：server_id=id1,id2 **参数解释：** - 在使用server_id作为过滤条件时，不能同时使用其他过滤条件。如果同时指定server_id及其他过滤条件，则以server_id条件为准，其他过滤条件会被忽略  - 当server_id中含有不存在的云服务器ID时，返回的响应参数中该云服务器ID对应的servers结构体中除了id和fault其它字段均为null  - 为了避免API的URI过长，建议一次查询的server_id个数不超过100个   **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                                                               |
   
#### 请求消息
无
#### 响应消息
响应参数如[表3]所示。
 表3响应参数 
| 参数      | 参数类型             | 描述                                                                                                                                                                                                                                      |
|:---|:---|:---|
| servers | Array of objects | **参数解释：** 弹性云服务器详情列表，具体参照[表4]接口。 **取值范围：** 不涉及 |
| count   | Integer          | **参数解释：** 弹性云服务器的总数。 **取值范围：** 不涉及                                                                            |
   
 表4server字段数据结构说明 
| 参数                                   | 参数类型                            | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|
| status                               | String                          | **参数解释：** 弹性云服务器状态。 **取值范围：** ACTIVE、BUILD、ERROR、HARD_REBOOT、MIGRATING、REBOOT、REBUILD、RESIZE、REVERT_RESIZE、SHUTOFF、VERIFY_RESIZE、DELETED、SHELVED、SHELVED_OFFLOADED 、UNKNOWN 弹性云服务器状态说明请参考[云服务器状态](https://support.huaweicloud.com/api-ecs/ecs_08_0002.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| updated                              | String                          | **参数解释：** 弹性云服务器最近一次更新时间，例如开机、关机、重启等操作。 时间格式例如：2019-05-22T03:30:52Z **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| hostId                               | String                          | **参数解释：** 弹性云服务器所在主机的主机ID的哈希值。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| OS-EXT-SRV-ATTR:host                 | String                          | **参数解释：** 弹性云服务器所在主机的主机名称。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| addresses                            | Map\<String, Array of objects\> | **参数解释：** 弹性云服务器的网络属性。 **取值范围：** - key为vpc_id。  - value为网络属性，详情请参见[表5]。                                                                                                                                                                                                                                                                                                                                                                      |
| key_name                             | String                          | **参数解释：** 弹性云服务器使用的密钥对名称。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| image                                | Object                          | **参数解释：** 弹性云服务器镜像信息。详情请参见[表7](https://support.huaweicloud.com/api-ecs/ecs_05_0002.html#ecs_05_0002__table173259974818) **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| OS-EXT-STS:task_state                | String                          | **参数解释：** 扩展属性，弹性云服务器当前任务的状态，请参考[云服务器状态](https://support.huaweicloud.com/api-ecs/ecs_08_0002.html)。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| OS-EXT-STS:vm_state                  | String                          | **参数解释：** 扩展属性，弹性云服务器当前状态，请参考[云服务器状态](https://support.huaweicloud.com/api-ecs/ecs_08_0002.html)。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| OS-EXT-SRV-ATTR:instance_name        | String                          | **参数解释：** 扩展属性，弹性云服务器别名。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| OS-EXT-SRV-ATTR:hypervisor_hostname  | String                          | **参数解释：** 扩展属性，弹性云服务器所在虚拟化主机名。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| flavor                               | Object                          | **参数解释：** 弹性云服务器规格信息。 详情请参见[表1](https://support.huaweicloud.com/api-ecs/ecs_05_0002.html#ecs_05_0002__zh-cn_topic_0057972887_table41869715)。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| id                                   | String                          | **参数解释：** 弹性云服务器ID，格式为UUID。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| security_groups                      | Array of objects                | **参数解释：** 弹性云服务器所属安全组列表。 详情请参见[表3](https://support.huaweicloud.com/api-ecs/ecs_05_0002.html#ecs_05_0002__zh-cn_topic_0057972887_table38168783)。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| OS-EXT-AZ:availability_zone          | String                          | **参数解释：** 扩展属性，弹性云服务器所在可用区名称。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| user_id                              | String                          | **参数解释：** 创建弹性云服务器的用户ID。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| name                                 | String                          | **参数解释：** 弹性云服务器名称。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| created                              | String                          | **参数解释：** 弹性云服务器创建时间。 时间格式例如：2019-05-22T03:19:19Z **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| tenant_id                            | String                          | **参数解释：** 弹性云服务器所属租户ID，即项目id，和project_id表示相同的概念。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| OS-DCF:diskConfig                    | String                          | **参数解释：** 扩展属性， diskConfig的类型。 **取值范围：** - MANUAL，镜像空间不会扩展。  - AUTO，系统盘镜像空间会自动扩展为与flavor大小一致。                                                                                                                                                                                                                                                                                                                                                                               |
| accessIPv4                           | String                          | **参数解释：** 预留属性。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| accessIPv6                           | String                          | **参数解释：** 预留属性。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| fault                                | Object                          | **参数解释：** 弹性云服务器故障原因。 **取值范围：** - 当弹性云服务器状态正常或异常时，返回NULL。  - 当弹性云服务器不存在时，返回"fault": "Instance xxxx could not be found"。                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| progress                             | Integer                         | **参数解释：** 弹性云服务器进度。 **取值范围：** 0到100。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| OS-EXT-STS:power_state               | Integer                         | **参数解释：** 扩展属性，弹性云服务器电源状态。 **取值范围：** - 0：NOSTATE  - 1：RUNNING  - 4：SHUTDOWN                                                                                                                                                                                                                                                                                                                                                                                                                      |
| config_drive                         | String                          | **参数解释：** config drive信息。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| metadata                             | Map\<String,String\>            | **参数解释：** 弹性云服务器元数据。详情请参见[表5](https://support.huaweicloud.com/api-ecs/ecs_05_0002.html#ecs_05_0002__table537485761711)。 说明： 元数据包含系统默认添加字段和用户设置的字段。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| OS-SRV-USG:launched_at               | String                          | **参数解释：** 弹性云服务器启动时间。时间格式例如：2019-05-22T03:23:59.000000 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| OS-SRV-USG:terminated_at             | String                          | **参数解释：** 弹性云服务器删除时间。 时间格式例如：2019-05-22T03:23:59.000000 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| os-extended-volumes:volumes_attached | Array of objects                | **参数解释：** 挂载到弹性云服务器上的磁盘。 详情请参见[表4](https://support.huaweicloud.com/api-ecs/ecs_05_0002.html#ecs_05_0002__zh-cn_topic_0057972887_table33871262)。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| description                          | String                          | **参数解释：** 弹性云服务器的描述信息。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| host_status                          | String                          | **参数解释：** 云服务器所在主机状态。 **取值范围：** - UP：服务正常  - UNKNOWN：状态未知  - DOWN：服务异常  - MAINTENANCE：维护状态  - 空字符串：弹性云服务器无主机信息   |
| OS-EXT-SRV-ATTR:hostname             | String                          | **参数解释：** 弹性云服务器的主机名。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| OS-EXT-SRV-ATTR:reservation_id       | String                          | **参数解释：** 批量创建场景，弹性云服务器的预留ID，可以根据该id查询出批创的所有虚拟机。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| OS-EXT-SRV-ATTR:launch_index         | Integer                         | **参数解释：** 批量创建场景，批创的所有弹性云服务器的启动顺序，范围为0到批量数量。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| OS-EXT-SRV-ATTR:kernel_id            | String                          | **参数解释：** 若使用AMI格式的镜像，则表示kernel image的UUID；否则，留空。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| OS-EXT-SRV-ATTR:ramdisk_id           | String                          | **参数解释：** 若使用AMI格式镜像，则表示ramdisk image的UUID；否则，留空。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| OS-EXT-SRV-ATTR:root_device_name     | String                          | **参数解释：** 弹性云服务器系统盘的设备名称，例如当系统盘的磁盘模式是VBD，为/dev/vda，磁盘模式是SCSI，为/dev/sda。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| OS-EXT-SRV-ATTR:user_data            | String                          | **参数解释：** 创建弹性云服务器时指定的user_data（编码过后的信息）。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| locked                               | Boolean                         | **参数解释：** 弹性云服务器是否为锁定状态。 **取值范围：** - true：锁定  - false：未锁定                                                                                                                                                                                                                                                                                                                                                                                                                    |
| tags                                 | Array of strings                | **参数解释：** 弹性云服务器标签列表。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| os:scheduler_hints                   | Object                          | **参数解释：** 弹性云服务器调度信息，详情请参见[表13](https://support.huaweicloud.com/api-ecs/zh-cn_topic_0167957246.html#ZH-CN_TOPIC_0167957246__table3756175217341) 。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| enterprise_project_id                | String                          | **参数解释：** 弹性云服务器所属的企业项目ID。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| sys_tags                             | Array of objects                | **参数解释：** 弹性云服务器系统标签。 详情请参见[表6](https://support.huaweicloud.com/api-ecs/ecs_05_0002.html#ecs_05_0002__table6690227839)。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| auto_terminate_time                  | String                          | **参数解释：** 云服务器定时删除时间。 说明： 如果云服务器未设置定时删除时间，返回为空。 包年/包月云服务器不支持设置定时删除时间，返回为空。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| cpu_options                          | Object                          | **参数解释：** 自定义CPU选项。 详情请参见[表6]。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| hypervisor                           | Object                          | **参数解释：** 扩展属性，虚拟化信息。 详情请参见 [表7]。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| enclave_options                      | Object                          | **参数解释：** 自定义enclave_options项。 详情请参见[表9 enclave_options数据结构说明]。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| security_options                     | Object                          | **参数解释：** 安全启动选项security_options 详情请参见[表9]。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| network_interfaces                   | Array of objects                | **参数解释：** 网络接口信息。 详情请参见[表10]。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| spod_id                              | String                          | **参数解释：** 共池裸机按整机柜发放的同一批次的批创ID。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| capacity_reservation_specification   | Object                          | **参数解释：** 容量预留规格。 详情请参见[表12]。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| capacity_reservation_id              | String                          | **参数解释：** 容量预留ID。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   
 表5addresses字段数据结构说明 
| 参数                      | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|
| version                 | String  | **参数解释：** IP地址版本。 **取值范围：** - "4"：代表IPv4。  - "6"：代表IPv6。                          |
| addr                    | String  | **参数解释：** IP地址。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                 |
| primary                 | Boolean | **参数解释：** 是否是主网卡。 **取值范围：** - true：主网卡。  - false：辅助网卡。                                                                                    |
| OS-EXT-IPS:type         | String  | **参数解释：** IP地址类型。 **取值范围：** - fixed：代表私有IP地址。  - floating：代表浮动IP地址。   |
| OS-EXT-IPS-MAC:mac_addr | String  | **参数解释：** MAC地址。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                               |
| OS-EXT-IPS:port_id      | String  | **参数解释：** IP地址对应的端口ID。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                              |
   
 表6cpu_options数据结构说明 
| 参数             | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|
| hw:cpu_threads | Integer | **参数解释：** 用于控制CPU是否开启超线程。 需要同时满足如下条件，才能设置为"关闭超线程"： - 只能在实例创建或者resize时指定。  - 只有目标flavor的os_extra_specs参数： - 存在"hw:cpu_policy"并取值为"dedicated"。  - 存在"hw:cpu_threads"并取值为"2"。   os_extra_specs参数详情可通过调用[查询规格详情和规格扩展信息列表 - ListFlavors](https://support.huaweicloud.com/api-ecs/zh-cn_topic_0020212656.html)接口进行查询。    **取值范围：** - 1: 关闭超线程。  - 2: 打开超线程。   |
   
 表7hypervisor数据结构说明 
| 参数              | 参数类型   | 描述                                                                                                                                                                                             |
|:---|:---|:---|
| hypervisor_type | String | **参数解释：** 虚拟化类型。 **取值范围：** 不涉及 |
| csd_hypervisor  | String | **参数解释：** 预留属性。 **取值范围：** 不涉及     |
   
 表8enclave_options数据结构说明 
| 参数      | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|
| enabled | Boolean | **参数解释：** enclave使能开关。 **约束限制：** 不涉及 **取值范围：** - true: 打开enclave。  - false: 关闭enclave。   **默认取值：** false |
   
 表9security_options数据结构说明 
| 参数                  | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| secure_boot_enabled | 否    | Boolean | **参数解释：** 安全启动开关。 **约束限制：** 不涉及 **取值范围：** - true: 打开安全启动。  - false: 关闭安全启动。   **默认取值：** false |
| tpm_enabled         | 否    | Boolean | **参数解释：** tpm启动开关。 **约束限制：** 不涉及 **取值范围：** - true: 打开tpm。  - false: 关闭tpm。   **默认取值：** false                         |
   
 表10network_interface数据结构说明 
| 参数             | 参数类型             | 描述                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|
| port_id        | String           | **参数解释：** 端口ID。 **取值范围：** 不涉及                                                                                                                                                                                                                                 |
| primary        | Boolean          | **参数解释：** 是否为主网卡。 **取值范围：** - true：主网卡  - false：扩展网卡   |
| ip_addresses   | Array of strings | **参数解释：** 私有IPv4地址。 **取值范围：** 不涉及                                                                                                                                                                                                                              |
| ipv6_addresses | Array of strings | **参数解释：** 私有IPv6地址。 **取值范围：** 不涉及                                                                                                                                                                                                                             |
| association    | Object           | **参数解释：** 关联的弹性公网IP信息。详情请参见[表11]。 **取值范围：** 不涉及                                                                                                                                                                   |
| subnet_id      | String           | **参数解释：** 子网ID。 **取值范围：** 不涉及                                                                                                                                                                                                                                 |
   
 表11association字段数据结构说明 
| 参数                | 参数类型   | 描述                                                                                                                                                                                                      |
|:---|:---|:---|
| public_ip_address | String | **参数解释：** 弹性公网IP地址，IPv4地址。 **取值范围：** 不涉及 |
   
 表12capacity_reservation_specification数据结构说明 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|
| id         | String | **参数解释：** 目标容量预留ID。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                       |
| preference | String | **参数解释：** 实例启动的私有池容量选项。 **取值范围：** - none：不使用模式。实例启动将不使用私有池容量。  - targeted：指定模式。使用指定的私有池容量启动实例，如果该私有池容量不可用，则实例会启动失败。   |
   
#### 请求示例
查询云服务器详情列表，每页返回10个记录，从第1页开始。
```
GET https://{endpoint}/v1/{project_id}/cloudservers/detail?offset=1&limit=10
```
#### 响应示例
```
{
    "count":4,
    "servers":[
        {
            "fault":null,
            "id":"b37fd80e-ac67-4d02-b9f1-9891c9c0fabf",
            "name":"ecs-5e70",
            "addresses":{
                "164489f6-cbf7-45b4-b6d0-d407c48cf7fc":[
                    {
                        "version":"4",
                        "addr":"192.168.0.206",
                        "OS-EXT-IPS-MAC:mac_addr":"fa:16:3e:95:88:3f",
                        "OS-EXT-IPS:port_id":"7b5d615c-186d-4646-9cb8-444addfe9b92",
                        "OS-EXT-IPS:type":"fixed"
                    },
                    {
                        "version":"4",
                        "addr":"192.168.0.8",
                        "OS-EXT-IPS-MAC:mac_addr":"fa:16:3e:1d:88:43",
                        "OS-EXT-IPS:port_id":"dda2027b-2f03-497b-8d42-620da2baacc3",
                        "OS-EXT-IPS:type":"fixed"
                    }
                ]
            },
            "flavor":{
                "disk":"0",
                "vcpus":"2",
                "ram":"1024",
                "id":"c3.large.2",
                "name":"c3.large.2",
                "gpus": [],
                "asic_accelerators": [] 
            },
            "accessIPv4":"",
            "accessIPv6":"",
            "status":"SHUTOFF",
            "image":{
                "id":"1ce5800a-e487-4c1b-b264-3353a39e2b4b"
            },
            "hostId":"f92345b97fd291f67a29ed735a82a8983f370175d2ba3d18d66893f4",
            "updated":"2018-08-14T07:26:49Z",
            "created":"2018-08-13T13:46:09Z",
            "metadata":{
                "metering.image_id":"af60e0d5-6952-4f3d-b0ed-31bb19d4a692",
                "metering.resourcespeccode":"c3.large.2.linux",
                "image_name":"HEC_Public_Cloudinit_CentOS_7.4_64bit",
                "metering.product_id":"00301-253164-0--0",
                "os_bit":"64",
                "lockSourceId":"",
                "lockScene":"",
                "metering.order_id":"CS1808132145NRVRE",
                "lockCheckEndpoint":"",
                "metering.imagetype":"gold",
                "lockSource":"",
                "metering.resourcetype":"1",
                "vpc_id":"164489f6-cbf7-45b4-b6d0-d407c48cf7fc",
                "os_type":"Linux",
                "charging_mode":"1"
            },
            "tags":[
            ],
            "description":"ecs-4cff",
            "locked":false,
            "config_drive":"",
            "tenant_id":"edcb94a885a84ed3a3fdf8ea4d2741da",
            "user_id":"bb7f23e27e7e46f3aaceb5f53a158bdc",
            "os-extended-volumes:volumes_attached":[
                {
                    "device":"/dev/sda",
                    "bootIndex":"0",
                    "id":"2edc879f-022e-4bd6-b079-95a27564d449",
                    "delete_on_termination":"false"
                }
            ],
            "OS-EXT-STS:task_state":null,
            "OS-EXT-STS:power_state":4,
            "OS-EXT-STS:vm_state":"stopped",
            "OS-EXT-SRV-ATTR:host":"az1.dc1",
            "OS-EXT-SRV-ATTR:instance_name":"instance-00137941",
            "OS-EXT-SRV-ATTR:hypervisor_hostname":"nova001@248",
            "OS-DCF:diskConfig":"MANUAL",
            "OS-EXT-AZ:availability_zone":"az1-dc1",
            "os:scheduler_hints":{
            },
            "OS-EXT-SRV-ATTR:root_device_name":"/dev/sda",
            "OS-EXT-SRV-ATTR:ramdisk_id":"8999878c-4a62-4014-89be-1743ff3a5daf",
            "enterprise_project_id":"441d5677-b76a-4dd4-a97a-ef7fd633c095",
            "OS-EXT-SRV-ATTR:user_data":"IyEvYmluL2Jhc2gKZWNobyAncm9vdDokNiRKQ2FzUWQkbm5wVmhJUFZlNVMwc3pXbnJGLnZVZ1FCWk4xTEo5Vy8wd09WTmFZaWpBRXdtRnhuQmZaTllVZXhBWktVWFVTeVhEeERuSUMzV2JjZEJyQUVBZkZvLy8nIHwgY2hwYXNzd2QgLWU7",
            "OS-SRV-USG:launched_at":"2018-08-13T13:46:46.000000",
            "OS-EXT-SRV-ATTR:kernel_id":"",
            "OS-EXT-SRV-ATTR:launch_index":0,
            "host_status":"UP",
            "OS-EXT-SRV-ATTR:reservation_id":"r-a8mg9vwr",
            "OS-EXT-SRV-ATTR:hostname":"ecs-4cff",
            "sys_tags":[
                {
                    "key":"_sys_enterprise_project_id",
                    "value":"441d5677-b76a-4dd4-a97a-ef7fd633c095"
                }
            ],
            "security_groups":[
                {
                    "id":"71846bf6-1cda-4515-8590-3707be295e76",
                    "name":"Sys-FullAccess"
                },
                {
                    "id":"b1786350-da65-11e7-b312-0255ac101b03",
                    "name":"default"
                }
            ]
        },
        {
            "fault":null,
            "id":"8380dcc9-0eac-4407-9f9e-df8c9eddeacd",
            "name":"ecs-f680",
            "addresses":{
                "164489f6-cbf7-45b4-b6d0-d407c48cf7fc":[
                    {
                        "version":"4",
                        "addr":"192.168.0.218",
                        "OS-EXT-IPS-MAC:mac_addr":"fa:16:3e:bb:b3:fe",
                        "OS-EXT-IPS:port_id":"240c696f-68d8-4f3f-941d-fecf2b375132",
                        "OS-EXT-IPS:type":"fixed"
                    }
                ]
            },
            "flavor":{
                "disk":"0",
                "vcpus":"2",
                "ram":"1024",
                "id":"c3.large.2",
                "name":"c3.large.2",
                "gpus": [],
                "asic_accelerators": [] 
            },
            "accessIPv4":"",
            "accessIPv6":"",
            "status":"SHUTOFF",
            "image":{
                "id":"1ce5800a-e487-4c1b-b264-3353a39e2b4b"
            },
            "hostId":"f92345b97fd291f67a29ed735a82a8983f370175d2ba3d18d66893f4",
            "updated":"2018-08-14T03:01:00Z",
            "created":"2018-08-13T13:38:29Z",
            "metadata":{
                "metering.image_id":"af60e0d5-6952-4f3d-b0ed-31bb19d4a692",
                "metering.imagetype":"gold",
                "metering.resourcespeccode":"c3.large.2.linux",
                "image_name":"HEC_Public_Cloudinit_CentOS_7.4_64bit",
                "metering.resourcetype":"1",
                "os_bit":"64",
                "vpc_id":"164489f6-cbf7-45b4-b6d0-d407c48cf7fc",
                "os_type":"Linux",
                "charging_mode":"0"
            },
            "tags":[
                "_sys_root_resource_id=9d81b37c-455f-4528-b0ab-a6abcd0a330b",
                "_sys_root_resource_type=xxx.resource.type.vm"
            ],
            "description":"ecs-f680",
            "locked":false,
            "config_drive":"",
            "tenant_id":"edcb94a885a84ed3a3fdf8ea4d2741da",
            "user_id":"61ee747d36bf421fa25c51a3b9565046",
            "os-extended-volumes:volumes_attached":[
                {
                    "device":"/dev/sda",
                    "bootIndex":"0",
                    "id":"3721b948-9c2f-4980-90ad-b2a16811f58c",
                    "delete_on_termination":"false"
                }
            ],
            "OS-EXT-STS:task_state":null,
            "OS-EXT-STS:power_state":4,
            "OS-EXT-STS:vm_state":"stopped",
            "OS-EXT-SRV-ATTR:host":"az1.dc1",
            "OS-EXT-SRV-ATTR:instance_name":"instance-00137937",
            "OS-EXT-SRV-ATTR:hypervisor_hostname":"nova001@248",
            "OS-DCF:diskConfig":"MANUAL",
            "OS-EXT-AZ:availability_zone":"az1-dc1",
            "os:scheduler_hints":{
            },
            "OS-EXT-SRV-ATTR:root_device_name":"/dev/sda",
            "OS-EXT-SRV-ATTR:ramdisk_id":"8999878c-4a62-4026-92be-1743ff3a5daf",
            "enterprise_project_id":"441d5677-b76a-4dd4-a97a-ef7fd633c095",
            "OS-EXT-SRV-ATTR:user_data":"IyEvYmluL2Jhc2gKZWNobyAncm9vdDokNiR5aG9aeFIkVE00OWlwSGQ2OEFWcjlTMTFXNEZrZmFYTENVbEkvd0xVTmdSVjhOb0dCem5WOWFsU1lEN0ZNSHc0VmtwdU9GOERyLncudGUzVmRHLnVmY005elVZSDEnIHwgY2hwYXNzd2QgLWU7",
            "OS-SRV-USG:launched_at":"2018-08-13T13:38:53.000000",
            "OS-EXT-SRV-ATTR:kernel_id":"",
            "OS-EXT-SRV-ATTR:launch_index":0,
            "host_status":"UP",
            "OS-EXT-SRV-ATTR:reservation_id":"r-7e2g78rq",
            "OS-EXT-SRV-ATTR:hostname":"ecs-f680",
            "sys_tags":[
                {
                    "key":"_sys_enterprise_project_id",
                    "value":"441d5677-b76a-4dd4-a97a-ef7fd633c095"
                }
            ],
            "security_groups":[
                {
                    "name":"test"
                }
            ]
        },
        {
            "fault":null,
            "id":"fb70fed9-5774-44a7-ad4a-af3ea2c2da61",
            "name":"ecs-3993",
            "addresses":{
                "00159d7d-b3c3-4108-8bc4-6658814e6422":[
                    {
                        "version":"4",
                        "addr":"192.168.20.83",
                        "OS-EXT-IPS-MAC:mac_addr":"fa:16:3e:a9:8d:88",
                        "OS-EXT-IPS:port_id":"579ab762-bf89-435e-80ad-a8bdd25119c5",
                        "OS-EXT-IPS:type":"fixed"
                    }
                ]
            },
            "flavor":{
                "disk":"0",
                "vcpus":"2",
                "ram":"1024",
                "id":"c3.large.2",
                "name":"c3.large.2",
                "gpus": [],
                "asic_accelerators": [] 
            },
            "accessIPv4":"",
            "accessIPv6":"",
            "status":"SHUTOFF",
            "image":{
                "id":"1ce5800a-e487-4c1b-b264-3353a39e2b4b"
            },
            "hostId":"f92345b97fd291f67a29ed735a82a8983f370175d2ba3d18d66893f4",
            "updated":"2018-08-14T03:01:03Z",
            "created":"2018-08-13T13:38:02Z",
            "metadata":{
                "metering.image_id":"af60e0d5-6952-4f3d-b0ed-31bb19d4a692",
                "metering.imagetype":"gold",
                "metering.resourcespeccode":"c3.large.2.linux",
                "image_name":"HEC_Public_Cloudinit_CentOS_7.4_64bit",
                "metering.resourcetype":"1",
                "os_bit":"64",
                "vpc_id":"00159d7d-b3c3-4108-8bc4-6658814e6422",
                "os_type":"Linux",
                "charging_mode":"0"
            },
            "tags":[
               "combined_order_id=CBRCS231010102024YL8962"
            ],
            "description":"ecs-3993",
            "locked":false,
            "config_drive":"",
            "tenant_id":"edcb94a885a84ed3a3fdf8ea4d2741da",
            "user_id":"eb4698fe015848e9a3e86cc9956e54fa",
            "key_name":"KeyPair-3b38",
            "os-extended-volumes:volumes_attached":[
                {
                    "device":"/dev/sda",
                    "bootIndex":"0",
                    "id":"85bfbc4f-7733-419a-b171-c00585abf926",
                    "delete_on_termination":"false"
                }
            ],
            "OS-EXT-STS:task_state":null,
            "OS-EXT-STS:power_state":4,
            "OS-EXT-STS:vm_state":"stopped",
            "OS-EXT-SRV-ATTR:host":"az1.dc1",
            "OS-EXT-SRV-ATTR:instance_name":"instance-00137936",
            "OS-EXT-SRV-ATTR:hypervisor_hostname":"nova001@248",
            "OS-DCF:diskConfig":"MANUAL",
            "OS-EXT-AZ:availability_zone":"az1-dc1",
            "os:scheduler_hints":{
            },
            "OS-EXT-SRV-ATTR:root_device_name":"/dev/sda",
            "OS-EXT-SRV-ATTR:ramdisk_id":"8999878c-4a25-4014-92be-1743ff3a5daf",
            "enterprise_project_id":"441d5677-b76a-4dd4-a97a-ef7fd633c095",
            "OS-SRV-USG:launched_at":"2018-08-13T13:38:24.000000",
            "OS-EXT-SRV-ATTR:kernel_id":"",
            "OS-EXT-SRV-ATTR:launch_index":0,
            "host_status":"UP",
            "OS-EXT-SRV-ATTR:reservation_id":"r-uzsewxii",
            "OS-EXT-SRV-ATTR:hostname":"ecs-3993",
            "sys_tags":[
                {
                    "key":"_sys_enterprise_project_id",
                    "value":"441d5677-b76a-4dd4-a97a-ef7fd633c095"
                }
            ],
            "security_groups":[
                {
                    "name":"test"
                },
                {
                    "name":"default"
                }
            ]
        },
        {
            "fault":null,
            "id":"e3d3f219-b445-4a7a-8f00-e31412481f8c",
            "name":"ecs-1f30",
            "addresses":{
                "00159d7d-b3c3-4108-8bc4-6658814e6422":[
                    {
                        "version":"4",
                        "addr":"192.168.20.197",
                        "OS-EXT-IPS-MAC:mac_addr":"fa:16:3e:41:5a:32",
                        "OS-EXT-IPS:port_id":"cfa2e055-54fb-427a-bde4-128bda47ae5c",
                        "OS-EXT-IPS:type":"fixed"
                    }
                ]
            },
            "flavor":{
                "disk":"0",
                "vcpus":"2",
                "ram":"1024",
                "id":"c3.large.2",
                "name":"c3.large.2",
                "gpus": [],
                "asic_accelerators": [] 
            },
            "accessIPv4":"",
            "accessIPv6":"",
            "status":"ACTIVE",
            "image":{
                "id":"1ce5800a-e487-4c1b-b264-3353a39e2b4b"
            },
            "progress":0,
            "hostId":"f92345b97fd291f67a29ed735a82a8983f370175d2ba3d18d66893f4",
            "updated":"2018-08-15T08:16:01Z",
            "created":"2018-08-13T11:57:29Z",
            "metadata":{
                "sadfasfasf":"sdffffd",
                "metering.order_id":"CS180813193577ORO",
                "metering.imagetype":"gold",
                "metering.resourcespeccode":"c3.large.2.win",
                "metering.image_id":"65cb40e6-f67e-4bef-a1e7-808166a5999d",
                "image_name":"HEC_Public_Windows2008R2_Ent_64bit40G_English",
                "aaaaaa":"0",
                "metering.resourcetype":"1",
                "aaaa":"0",
                "metering.product_id":"00301-146042-0--0",
                "os_bit":"64",
                "vpc_id":"00159d7d-b3c3-4108-8bc4-6658814e6422",
                "os_type":"Windows",
                "charging_mode":"1"
            },
            "tags":[
                "_sys_root_resource_id=4514d9b0-d611-4744-bdf9-60802fd5198a",
                "_sys_root_resource_type=xxx.resource.type.vm"
            ],
            "description":"ecs-1f30",
            "locked":false,
            "config_drive":"",
            "tenant_id":"edcb94a885a84ed3a3fdf8ea4d2741da",
            "user_id":"bb7f23e27e7e46f3aaceb5f53a158bdc",
            "key_name":"Autotest_Init_TC_OriginalAPI_Create_Keypairs_02_keypair",
            "os-extended-volumes:volumes_attached":[
                {
                    "device":"/dev/sda",
                    "bootIndex":"0",
                    "id":"5043f66b-a0d8-4eb2-8c48-49976bcdc253",
                    "delete_on_termination":"false"
                }
            ],
            "OS-EXT-STS:task_state":null,
            "OS-EXT-STS:power_state":1,
            "OS-EXT-STS:vm_state":"active",
            "OS-EXT-SRV-ATTR:host":"az1.dc1",
            "OS-EXT-SRV-ATTR:instance_name":"instance-0013772d",
            "OS-EXT-SRV-ATTR:hypervisor_hostname":"nova001@248",
            "OS-DCF:diskConfig":"MANUAL",
            "OS-EXT-AZ:availability_zone":"az1-dc1",
            "os:scheduler_hints":{
            },
            "OS-EXT-SRV-ATTR:root_device_name":"/dev/sda",
            "OS-EXT-SRV-ATTR:ramdisk_id":"8999878c-4a62-4014-92be-1743ff3a5daf",
            "enterprise_project_id":"441d5677-b76a-4dd4-a97a-ef7fd633c095",
            "OS-SRV-USG:launched_at":"2018-08-13T11:57:53.576640",
            "OS-EXT-SRV-ATTR:kernel_id":"",
            "OS-EXT-SRV-ATTR:launch_index":0,
            "host_status":"UP",
            "OS-EXT-SRV-ATTR:reservation_id":"r-xmjj4pnm",
            "OS-EXT-SRV-ATTR:hostname":"ecs-1f30",
            "sys_tags":[
                {
                    "key":"_sys_enterprise_project_id",
                    "value":"441d5677-b76a-4dd4-a97a-ef7fd633c095"
                }
            ],
            "security_groups":[
                {
                    "name":"default"
                }
            ]
        }
    ]
}
```
#### 返回值
请参考[通用请求返回值](https://support.huaweicloud.com/api-ecs/ecs_07_0001.html)。
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-ecs/ecs_07_0002.html)。
