# 查询云手机服务器规格列表 - ListCloudPhoneServerModels
#### 功能介绍
查询云手机服务器的规格列表。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CPH/doc?api=ListCloudPhoneServerModels)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cph/cph_api_06000.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                  | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名                         | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | cph::listServerTypes | List | -           | -   | cph:system:listServerTypes | -      |
     
  
 
#### URI
GET /v1/{project_id}/cloud-phone/server-models
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述    |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目id。 |
   
表2Query参数 
| 参数           | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|:---|
| product_type | 否    | Integer | 产品类型。 - 0：云手机   - 1：云手游    |
| marker       | 否    | String  | 分页标记。                                                                                                                                                                                                                                                                                                                          |
| limit        | 否    | Integer | 每页返回的服务器规格个数。取值范围：1\~100（默认值为100），一般设置为10、20、50。                                                                                                                                                                                                                                                                               |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                        |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数            | 参数类型                                                                | 描述           |
|:---|:---|:---|
| request_id    | String                                                              | 请求的唯一标识ID。   |
| server_models | Array of [ServerModel] objects | 云手机服务器的规格信息。 |
| page_info     | [page_info] object               | 页标记。         |
   
 表5ServerModel 
| 参数                | 参数类型                                                      | 描述                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|
| server_model_name | String                                                    | 云手机服务器的规格名称，不超过64字节。                                                                                                                                                                                                                                                                                                           |
| server_type       | String                                                    | 云手机服务器的型号，如Hi1616。不超过32字节。                                                                                                                                                                                                                                                                                                     |
| cpu               | Integer                                                   | 云手机服务器的CPU核数。                                                                                                                                                                                                                                                                                                                  |
| memory            | Integer                                                   | 云手机服务器的内存大小，单位G。                                                                                                                                                                                                                                                                                                               |
| extend_spec       | [extend_spec] object | 云手机服务器的属性描述，不超过512个字节。                                                                                                                                                                                                                                                                                                         |
| disk_max_num      | Integer                                                   | 云手机服务器最大挂载磁盘数量。值为0时表示该机型磁盘为本地盘。                                                                                                                                                                                                                                                                                                |
| product_type      | Integer                                                   | 产品类型。 - 0：云手机   - 1：云手游    |
| free_size         | Integer                                                   | 服务器磁盘的免费配额，单位G。                                                                                                                                                                                                                                                                                                                |
   
 表6extend_spec 
| 参数                | 参数类型                                                  | 描述                     |
|:---|:---|:---|
| cpu               | String                                                | 云手机服务器cpu类型。           |
| memory            | String                                                | 云手机服务器内存类型。            |
| disk              | String                                                | 云手机服务器磁盘类型。            |
| network_interface | String                                                | 云手机服务器网络类型。            |
| gpu               | String                                                | 云手机服务器gpu类型。           |
| bms_flavor        | String                                                | 云手机服务器bms规格。           |
| gpu_count         | Integer                                               | 云手机服务器gpu数量。           |
| numa_count        | Integer                                               | 云手机服务器numa数量。          |
| os_volume         | [os_volume] object | 云盘服务器操作系统盘信息，本地盘服务器不返回 |
   
 表7os_volume 
| 参数          | 参数类型    | 描述      |
|:---|:---|:---|
| size        | Integer | 操作系统盘大小 |
| volume_type | String  | 操作系统盘类型 |
   
 表8page_info 
| 参数          | 参数类型   | 描述               |
|:---|:---|:---|
| next_marker | String | 返回下一页查询marker地址。 |
   
#### 请求示例
查询服务器规格
```
GET https://{CPH Endpoint}/v1/{project_id}/cloud-phone/server-models
```
#### 响应示例
**状态码：200**
OK
```
{
  "request_id" : "4d4aefaa7b1d4a2bb5637e9d5631342f",
  "server_models" : [ {
    "server_model_name" : "physical.rx1.xlarge",
    "server_type" : "Hi1616",
    "cpu" : 64,
    "memory" : 256,
    "extend_spec" : {
      "cpu" : "Hi1616(2*32Core*2.4GHz)",
      "memory" : "DDR4 RAM",
      "disk" : "2*1.2T SAS + 800G SSD",
      "network_interface" : "2 x 2*10GE",
      "gpu" : "3*WX5100",
      "bms_flavor" : "physical.rg1.xlarge.cph.ondemand",
      "gpu_count" : 3,
      "numa_count" : 4
    },
    "product_type" : 0,
    "free_size" : 0
  } ],
  "page_info" : {
    "next_marker" : "string"
  }
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cph/ErrorCode.html)。