# 查询云手机规格列表 - ListCloudPhoneModels #### 功能介绍 查询或统计云手机的规格列表。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CPH/doc?api=ListCloudPhoneModels)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cph/cph_api_06000.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | cph::listPhoneSpecifications | List | - | - | cph:system:listPhoneSpecifications | - | #### URI GET /v1/{project_id}/cloud-phone/phone-models 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目id。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | status | 否 | Integer | 规格状态 - 0：下线状态 - 1：正常使用 不传该参数表示查询所有状态的规格。 | | offset | 否 | Integer | 偏移量为一个大于等于0整数，表示查询该偏移量后面的所有的资源数，默认值为0。 | | 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。 | | phone_models | Array of [PhoneModel] objects | 云手机的规格信息。 | 表5PhoneModel | 参数 | 参数类型 | 描述 | |:---|:---|:---| | server_model_name | String | 云手机服务器的规格名称，不超过64个字节。 | | phone_model_name | String | 云手机的规格名称，不超过64个字节。 | | status | Integer | 规格状态。 - 1 表示正常使用状态 - 0 表示已下线状态 已下线的规格不可用来购买云手机服务器 | | cpu | Integer | CPU核数。 | | memory | Integer | 内存大小，单位：MB。 | | disk | Integer | 系统存储大小，单位：GiB。 | | resolution | String | 分辨率，不超过16个字节。 | | extend_spec | String | 扩展描述，不超过512个字节。 | | spec_code | String | 规格名称，不超过64个字节。 | | phone_capacity | Integer | 当前云手机规格包含的云手机个数。 | | image_label | String | 镜像类型，只支持如下类型： - qemu_phone - cloud_phone - cloud_phone_1620 - cloud_game - cloud_game_1620 | | product_type | Integer | 产品类型。 - 0：云手机 - 1：云手游 | | phone_model_version | Integer | 规格版本： - 0：规格1.0 - 1：规格2.0 | | dpi | Integer | 每英寸点数。 | | fps | String | 渲染帧率。 | | volume_mode | Integer | 手机物理磁盘是否独立。 - 0：不独立 - 1：独立 | | render_fps | Integer | 渲染帧率。 | | stream_fps | Integer | 出流帧率。 | #### 请求示例 查询手机规格列表 ``` GET https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phone-models ``` #### 响应示例 **状态码：200** OK ``` { "phone_models" : [ { "server_model_name" : "physical.rx1.xlarge", "phone_model_name" : "rx1.cp.c60.d32.e1v1.qemu", "status" : 1, "cpu" : 2, "memory" : 3072, "disk" : 32, "resolution" : "540x960", "render_fps" : 60, "stream_fps" : 60, "extend_spec" : "{\"eip_count\": 1, \"vip_count\":1, \"emulator_type\":0, \"bms_image_id\":\"72460777-7fcb-4cae-8bb5-62d93be86bd7\",\"core_bind_strategy\":\"lxc_qemu_common_hosted_c60\", \"sd_disk\": 1}", "spec_code" : "rx1.cp.c60.d32.e1v1.qemu", "phone_capacity" : 60, "image_label" : "qemu_phone", "product_type" : 0 }, { "server_model_name" : "physical.rx1.xlarge", "phone_model_name" : "rx1.cp.c60.d10.e1v1", "status" : 1, "cpu" : 2, "memory" : 3584, "disk" : 10, "resolution" : "720x1280", "render_fps" : 60, "stream_fps" : 60, "extend_spec" : "{\"eip_count\": 1, \"vip_count\":1, \"emulator_type\":1,\"thinpool_size_g\":70, \"sharepool_size_g\":650,\"max_share_disk_size_g\":50,\"encode_server_spec\": {\"cpu\": 2,\"memory\": 14448,\"disk\": 10,\"image_id\":\"coderserver_v2.5\", \"port_num\":0},\"core_bind_strategy\":\"common_hosted_c60\"}", "spec_code" : "rx1.cp.c60.d10.e1v1", "phone_capacity" : 60, "image_label" : "cloud_phone", "product_type" : 0 } ], "request_id" : "e0dd77cb688743468599487ca2a1c738" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-cph/ErrorCode.html)。