检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
通过调用云手机服务器服务提供的接口，您可以完整地使用云手机的所有功能。例如查询云手机列表、重启云手机、为云手机推送文件。 表1 云手机服务器接口说明 类型 子类型 说明 云手机服务器 云手机服务器管理 包括查询云手机服务器列表、查询云手机服务器规格列表、购买云手机服务器等接口。 带宽管理
error_code String 错误码。 error_msg String 错误说明。 请求示例 批量重启encode_server_ids列表中的服务器上的编码容器 POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/encode
图2 查询资源账单 这里设置的统计维度为“按资源名称/ID”，统计周期为“按账期”，您也可以设置其他统计维度和周期，详细介绍请参见流水与明细账单。 核对资源用量是否与实际相符 假设用户在2023/11/23 14:53:24购买了一台包年/包月的CPH云手机服务器。 CPH流水账单
带宽等。 购买云手机服务器 2 云手机服务器详情API优化 云手机服务器详情API支持返回服务器挂载的磁盘及带宽信息。 查询云手机服务器详情 3 云手机控制台优化 云手机服务器详情支持查看云手机绑定的共享带宽，并支持修改大小，查看监控数据等。 购买云手机服务器 4 云手机任务执行优化
参数类型 描述 offset 否 Integer 偏移量为一个大于等于0整数，表示查询该偏移量后面的所有的资源数，默认值为0。 limit 否 Integer 每页返回的资源个数。取值范围：1~200（默认值为100），一般设置为10、20、50。 phone_name 否 String
project_id 是 String 项目id。 resource_type 是 String 资源类型。 cph-server，云手机服务器 resource_id 是 String 资源ID。 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token
project_id 是 String 项目id。 resource_type 是 String 资源类型。 cph-server，云手机服务器 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过
不传该参数表示查询所有状态的规格。 offset 否 Integer 偏移量为一个大于等于0整数，表示查询该偏移量后面的所有的资源数，默认值为0。 limit 否 Integer 每页返回的资源个数。取值范围：1~100（默认值为100），一般设置为10、20、50。 请求参数 表3 请求Header参数
扩容云手机数据盘大小 功能介绍 扩容云手机数据盘大小 注意: 本接口会产生扩容新增容量的费用，新增容量不算入服务器免费存储额度内。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
关闭云手机 功能介绍 批量关闭云手机。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v1/{project_id}/cloud-phone/phones/batch-stop
如果您持有多台到期日不同的云手机服务器，或者您的云手机服务器和其上挂载的云硬盘到期日不同，可以将到期日统一设置到一个日期，便于日常管理和续费。 图7展示了用户将两个不同时间到期的资源，同时续费一个月，并设置“统一到期日”后的效果对比。 图7 统一到期日 更多关于统一到期日的规则请参见如何设置统一到期日。
时存在只处理phone_ids。最多支持传入15个phone_id。 server_ids 否 Array of strings 云手机服务器ID列表。 phone_ids参数不存在时必选，同时存在只处理phone_ids。 响应参数 状态码： 200 表4 响应Body参数 参数
重启云手机 功能介绍 批量重启云手机，也可用于开启云手机。该接口为异步接口。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v1/{project_id
快速入门 本节通过调用一系列云手机服务器服务的API管理云手机。 通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。 涉及API 当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增
恢复云手机数据 功能介绍 批量恢复数据到云手机中。该接口为异步接口。接口调用前请先确保已完成CPH服务操作OBS桶的委托授权。委托CPH操作OBS桶请参见委托CPH操作OBS桶。 高版本手机导出的数据无法在低版本手机内恢复。低版本手机导出的数据可以在高版本手机内恢复，但可能会在极
业务服务的专用Region。 可用区（AZ，Availability Zone）：一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。
导出云手机数据 功能介绍 批量导出云手机中的数据。该接口为异步接口。接口调用前请先确保已完成CPH服务操作OBS桶的委托授权。委托CPH操作OBS桶请参见委托CPH操作OBS桶。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自
删除镜像 功能介绍 删除自定义镜像 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI DELETE /v1/{project_id}/cloud-phone/images/{image_id}
本文介绍使用云手机服务器服务时需要了解的基本概念。 服务器 服务器是用来提供云手机的物理服务器。云手机服务器目前以服务器为单位购买，您只需要指定具体的服务器类型、实例规格、手机镜像、所需要的网络配置等，即可获得一台服务器，以及相应数量的云手机。具体请参见购买云手机服务器。 手机开数
欠费说明 用户在使用云手机服务器时，账户的可用额度小于待结算的账单，即被判定为账户欠费。欠费后，可能会影响云手机服务器资源的正常运行，请及时充值。 欠费原因 已购买包年/包月的云手机服务器，因持续性周期扣款而导致账户的余额不足。 删除包年/包月的云手机服务器后，因存在未删除的关联资
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
