检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
实例状态批量查询 功能介绍 实例状态批量查询。 调用此api的前提条件是租户需要先购买koophone云手机实例。 接口返回实例当前的状态：云机状态，0：未知，1： 已停止，2：运行中，3：下线中，4：启动中， 5：已关机。
实例执行任务查询 功能介绍 实例执行任务批量查询。 调用此api的前提条件是租户需要先购买koophone云手机实例。 该接口需要和实例执行异步命令接口一起使用，使用实例执行异步命令接口返回的task_id作为路径上的参数以此获取异步命令执行的结果。
API概览 云手机服务接口的分类与说明如表1所示。 表1 KooPhone接口说明 类型 说明 实例执行同步命令 通过该接口可以指定云机实例同步执行adb shell命令。 实例执行异步命令 通过该接口可以指定云机实例异步执行adb shell命令。
操作 必选项，包含查看详情选项。 应用部署详情 用户可以对创建的应用安装、卸载任务进行执行结果查询。 登录KooPhone管理控制台，进入KooPhone云手机页面。 单击通用云手机左侧导航栏的“应用部署”，选择“应用部署查询”。 单击任务列表右侧“操作”列的“查看详情”。
对于获取用户Token接口，返回如图1所示的消息头，其中“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。
调用该接口获取云机实例的device_token后作为鉴权信息，并携带云机实例的device_id去调用反参中的信令地址（signaling_url）。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。
resource-path 资源路径，也即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。
实例执行异步命令 功能介绍 实例执行异步命令接口。 调用此api的前提条件是租户需要先购买koophone云手机实例。 可以通过调用该接口实现对自己的koophone云手机实例进行异步adb指令操作。 调用完该接口后携带该接口返回的task_id去调用实例执行任务查询接口。
调用此api的前提条件是租户需要先购买koophone云手机实例。 使用该接口可以设置实例每一个清晰度对应的码率和出流的帧率。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。
Token可通过调用获取用户Token接口获取，调用本服务API需要project级别的Token，即调用接口时，请求body中auth.scope的取值需要选择project，如下所示。
API 实例管理
获取项目ID 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。项目ID获取步骤如下： 登录华为云管理控制台。 鼠标悬停在右上角的用户名，选择下拉列表中的“我的凭证”。 在“API凭证”页面的项目列表中查看项目ID。 图1 查看项目ID 父主题： 附录
429 Too Many Requests 服务器会对接口进行流控，超过了接口限流要求，服务器将无法处理。 500 Internal Server Error 服务器遇到了一个未曾预料的状况，导致了它无法完成对请求的处理。
如何调用API 构造请求 认证鉴权 返回结果
实例管理 实例执行同步命令 实例执行异步命令 实例执行任务查询 实例视频设置 实例状态批量查询 实例批量重置 租户实例串流前获取设备的device_token 父主题： API
状态码 错误码 错误信息 描述 处理措施 400 KOOPHONE.API.1000 请求参数错误 请求参数错误 检查请求参数类型及范围是否如何接口定义 400 KOOPHONE.API.1002 实例非同一个大区 实例非同一个大区 修改请求实例为同一个大区 401 KOOPHONE.API
实例批量重置 功能介绍 实例批量重置， 调用此api的前提条件是租户需要先购买koophone云手机实例。 调用该接口后，当前实例会被初始化。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。
实例执行同步命令 功能介绍 实例执行同步命令接口。调用此api的前提条件是租户需要先购买koophone云手机实例。可以通过调用该接口实现对自己的koophone云手机实例进行adb指令操作。 该接口是同步操作接口，如果有耗时adb操作建议使用实例执行异步命令接口。
部署并管理通用云手机应用 管理通用云手机应用库 查询通用云手机应用部署详情
自定义查询条件。 可在“手动续费项”“自动续费项”“到期转按需项”“到期不续费项”页签查询全部待续费资源，对资源进行手动续费的操作。 图2 续费管理 所有需手动续费的资源都可归置到“手动续费项”页签，具体操作请参见如何恢复为手动续费。 手动续费资源。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
