更新时间:2026-08-26 GMT+08:00
分享

CLI命令参考

云手机服务器管理

API名称

命令

描述

操作

删除共享应用

hcloud CPH DeleteShareApps

在共享应用存储目录中删除共享应用,该功能仅在支持共享应用的云手机规格上可实现。

去调试

推送共享应用

hcloud CPH PushShareApps

推送应用tar文件至共享应用存储目录中,该功能仅在支持共享应用的云手机服务器上可实现。接口调用前请先确保已完成CPH服务操作OBS桶的委托授权。委托CPH操作OBS桶请参见委托CPH操作OBS桶

去调试

推送共享存储文件

hcloud CPH PushShareFiles

推送文件至共享存储目录中,该功能仅在支持共享存储的云手机规格上可实现。接口调用前请先确保已完成CPH服务操作OBS桶的委托授权。委托CPH操作OBS桶请参见委托CPH操作OBS桶

去调试

删除共享存储文件

hcloud CPH DeleteShareFiles

删除共享存储目录中文件,该功能仅在支持共享存储的云手机规格上可实现。

去调试

查询云手机服务器规格列表

hcloud CPH ListCloudPhoneServerModels

查询云手机服务器的规格列表。

去调试

查询云手机服务器列表

hcloud CPH ListCloudPhoneServers

分页查询云手机服务器,云手机服务器列表按照创建时间进行降序排列。分页查询可以指定offset以及limit。如果不存在云手机服务器,则返回空列表。

去调试

查询云手机服务器详情

hcloud CPH ShowCloudPhoneServerDetail

根据server_id查询云手机服务器的详细信息。

去调试

修改云手机服务器名称

hcloud CPH UpdateServerName

根据serverId修改serverName。

去调试

重启云手机服务器

hcloud CPH RestartCloudPhoneServer

批量重启云手机服务器。

去调试

变更云手机服务器规格

hcloud CPH ChangeCloudPhoneServerModel

变更云手机服务器规格。接口调用成功后,大约2分钟左右规格会变更结束,在订单中心可以查看到变更的订单状态为成功,且查询服务器的详细信息,可以查看到服务器规格名称已经变成新的规格名称。

去调试

查询共享存储文件

hcloud CPH ListShareFiles

查询共享存储指定路径下的文件列表,该功能仅在支持共享存储的云手机规格上可实现。

去调试

购买云手机服务器

hcloud CPH CreateNet2CloudPhoneServer

购买云手机服务器,支持您复用已有的VPC网络管理云手机服务器,支持云手机服务器复用您已购买的共享带宽等资源。

去调试

切换云手机服务器

hcloud CPH ChangeCloudPhoneServer

切换云手机服务器, 支持您换一台新的云手机服务器。切换后服务器名称、服务器ID与原服务器相同, 服务器计费保持不变。服务器切换的同时服务器上的手机重新创建,不保留用户数据。切换需要额外的资源和资源配额。

去调试

创建云手机裸服务器

hcloud CPH CreateCloudPhoneSingleServer

该接口创建的服务器仅包含服务器和服务器的镜像,不包含云手机实例和镜像等内容。若需要创建包含云手机实例的服务器,请使用创建云手机服务器接口。

去调试

带宽管理

API名称

命令

描述

操作

查询带宽信息

hcloud CPH ShowBandwidthDetail

查询云手机使用的带宽信息,本接口只适用于使用系统定义网络的服务器。

去调试

修改共享带宽

hcloud CPH UpdateBandwidth

修改云手机使用的共享带宽大小,本接口只适用于使用系统定义网络的服务器。

去调试

手机实例管理

API名称

命令

描述

操作

查询手机镜像

hcloud CPH ListCloudPhoneImages

根据项目ID查询可用的手机镜像。

去调试

查询云手机规格列表

hcloud CPH ListCloudPhoneModels

查询或统计云手机的规格列表。

去调试

查询云手机列表

hcloud CPH ListCloudPhones

分页查询云手机,云手机列表按照创建时间进行降序排列。分页查询可以指定offset以及limit。如果不存在云手机,则返回空列表。

去调试

云手机流量导流

hcloud CPH ImportTraffic

手机流量路由修改。

去调试

查询云手机详情

hcloud CPH ShowCloudPhoneDetail

查询云手机的详细信息。

去调试

修改云手机名称

hcloud CPH UpdatePhoneName

根据phoneId修改phoneName。

去调试

重置云手机

hcloud CPH ResetCloudPhone

批量重置云手机,将云手机恢复出厂设置。该接口为异步接口。

去调试

重启云手机

hcloud CPH RestartCloudPhone

批量重启云手机,也可用于开启云手机。该接口为异步接口。

去调试

恢复云手机数据

hcloud CPH BatchImportCloudPhoneData

批量恢复数据到云手机中。该接口为异步接口。接口调用前请先确保已完成CPH服务操作OBS桶的委托授权。委托CPH操作OBS桶请参见委托CPH操作OBS桶

去调试

关闭云手机

hcloud CPH StopCloudPhone

批量关闭云手机。

去调试

导出云手机数据

hcloud CPH BatchExportCloudPhoneData

批量导出云手机中的数据。该接口为异步接口。接口调用前请先确保已完成CPH服务操作OBS桶的委托授权。委托CPH操作OBS桶请参见委托CPH操作OBS桶

去调试

更新云手机属性

hcloud CPH UpdateCloudPhoneProperty

部分云手机属性开放更新能力,部分属性无法更新,部分属性需要重启手机生效,属性约束请云手机属性列表。如果手机处于异常状态,属性更新后需恢复手机状态为运行中才可生效。该接口为异步接口。

去调试

获取云手机连接信息

hcloud CPH BatchShowPhoneConnectInfos

获取云手机连接信息。

去调试

扩容云手机数据盘大小

hcloud CPH ExpandPhoneDataVolumeSize

扩容云手机数据盘大小

去调试

任务管理

API名称

命令

描述

操作

查询任务执行状态列表

hcloud CPH ListJobs

查询同一个request id下的任务。

去调试

查询任务执行状态

hcloud CPH ShowJob

查询任务的执行状态。

去调试

密钥管理

API名称

命令

描述

操作

更改密钥对

hcloud CPH UpdateKeypair

修改连接云手机的密钥对。

去调试

编码服务管理

API名称

命令

描述

操作

查询编码服务

hcloud CPH ListEncodeServers

查询编码服务列表。

去调试

重启编码服务

hcloud CPH RestartEncodeServer

批量重启编码服务。

去调试

ADB命令

API名称

命令

描述

操作

推送文件

hcloud CPH PushFile

推送文件到云手机文件系统中。系统会将所指定的文件下载解压后,将解压后的内容全部推送到云手机的根目录下。只支持指定tar格式的文件进行推送,您需要将tar文件提前上传至您的OBS桶中。该接口为异步接口。接口调用前请先确保已完成CPH服务操作OBS桶的委托授权。委托CPH操作OBS桶请参见委托CPH操作OBS桶

去调试

安装apk

hcloud CPH InstallApk

在云手机中安装apk。系统会将指定的apk文件下载后直接安装到云手机中。

去调试

卸载apk

hcloud CPH UninstallApk

在云手机中卸载apk。该接口为异步接口。

去调试

异步执行adb命令

hcloud CPH RunShellCommand

在云手机中执行shell命令。该接口为异步接口。

去调试

同步执行adb命令

hcloud CPH RunSyncCommand

在云手机中同步执行命令并返回命令执行的输出信息,该接口仅支持adb shell命令的执行。1分钟内每个用户调用接口次数上限为6次,每个云手机允许执行命令超时时间为2秒,接口时间不超过30秒,执行云手机数越多,接口耗时相应越长。

去调试

标签管理

API名称

命令

描述

操作

查询项目标签

hcloud CPH ListProjectTags

查询租户在指定区域和资源类型的所有标签集合。

去调试

查询资源标签

hcloud CPH ListResourceTags

查询资源标签列表。

去调试

查询资源实例

hcloud CPH ListResourceInstances

查询资源实例。

去调试

批量添加标签

hcloud CPH BatchCreateTags

批量添加标签。

去调试

批量删除标签

hcloud CPH BatchDeleteTags

批量删除标签。

去调试

自定义镜像管理

API名称

命令

描述

操作

查询自定义镜像列表

hcloud CPH ListImages

查询自定义镜像列表

去调试

删除镜像

hcloud CPH DeleteImage

删除自定义镜像

去调试

共享镜像给指定账号

hcloud CPH AddImageMember

镜像共享,共享镜像给指定账号。

去调试

获取镜像已共享账号列表

hcloud CPH ListImageMembers

获取镜像已共享账号列表

去调试

更新共享镜像接受信息

hcloud CPH UpdateImageMember

用户收到共享镜像后,选择接受或拒绝共享镜像。未接受的共享镜像无法使用。

去调试

删除共享镜像

hcloud CPH DeleteImageMember

删除共享镜像

去调试

相关文档