API概览

本产品(无影云手机/2023-09-30)的OpenAPI采用RPC签名风格,签名细节参见签名机制说明我们已经为开发者封装了常见编程语言的SDK,开发者可通过下载SDK直接调用本产品OpenAPI而无需关心技术细节。如果现有SDK不能满足使用需求,可通过签名机制进行自签名对接。由于自签名细节非常复杂,需花费 5个工作日左右。因此建议加入我们的服务钉钉群(78410016550),在专家指导下进行签名对接。
在使用API前,您需要准备好身份账号及访问密钥(AccessKey),才能有效通过客户端工具(SDK、CLI等)访问API。细节请参见获取AccessKey

实例组

API标题API概述
DescribeRegions查询可用地域查询地域。
DescribeSpec查询可用规格查询云手机可用规格。
CheckResourceStock检查资源库存状态检查云手机资源库存状态。
CreateAndroidInstanceGroup创建实例组创建按量付费或包年包月的云手机实例组。
DescribeAndroidInstanceGroups查询实例组详细信息查询云手机实例组的详细信息。
ModifyAndroidInstanceGroup修改实例组信息修改云手机实例组的信息。
UpgradeAndroidInstanceGroup升级实例组升级实例组。目前仅支持增加实例组中的实例数量。
DowngradeAndroidInstanceGroup降级实例组降级实例组。目前仅支持删除实例组中的指定实例。
RenewAndroidInstanceGroups续费实例组续费云手机实例组。
DeleteAndroidInstanceGroup删除实例组删除云手机实例组。

实例

API标题API概述
DescribeAndroidInstances查询实例详细信息查询云手机实例的详情信息。
ModifyAndroidInstance修改实例信息修改云手机实例信息。目前仅支持修改实例名称。
AuthorizeAndroidInstance实例分配用户&取消分配为云手机实例分配用户或者取消已分配用户。目前一台云手机实例仅支持分配一个用户。
StartAndroidInstance启动实例启动云手机实例。
StopAndroidInstance停止实例停止云手机实例。
RebootAndroidInstancesInGroup重启实例重启云手机实例。
ResetAndroidInstancesInGroup重置实例(初始化系统)重置云手机实例,即初始化系统。
远程命令远程命令
RunCommand执行命令在云手机实例中执行命令。
DescribeInvocations查询命令执行结果查询RunCommand接口命令执行结果。
文件上传下载文件上传下载
SendFile文件上传到云手机将OSS文件推送到云手机。
FetchFile从云手机拉取文件调用Fetch接口云手机拉取文件到OSS。

镜像

API标题API概述
CreateCustomImage创建自定义镜像根据云手机实例创建自定义镜像。
DescribeImageList查询镜像列表查询镜像列表。
UpdateInstanceGroupImage变更实例组镜像变更实例组镜像。
UpdateCustomImageName更新自定义镜像名称更新自定义镜像名称。
DistributeImage分发镜像分发镜像。
DeleteImages删除自定义镜像删除自定义镜像。

应用

API标题API概述
CreateApp创建应用创建Android应用。
DescribeApps查询应用信息查询已经创建的应用信息。
ModifyApp修改应用信息修改应用信息。
DeleteApps删除应用删除应用。 删除时需保证该应用未安装在任何实例组。
InstallApp安装应用批量在无影云手机实例组的实例中安装应用。 此接口为异步接口,安装结果可以通过查询应用安装历史查看。
UninstallApp卸载应用批量从无影云手机实例组中卸载应用。卸载时需保证应用已经安装在云手机实例组中。 此接口为异步接口,卸载结果可以通过查询应用安装历史查看。

密钥

API标题API概述
CreateKeyPair创建ADB密钥对调用CreateKeyPair创建一对ADB密钥对。系统会为您保管密钥的公钥部分,并返回符合ADB连接规范的PEM编码的PKCS#8格式私钥。您需要自行妥善保管私钥部分。
ImportKeyPair导入ADB密钥对导入由ADB工具产生的ADB密钥对的公钥部分。
DescribeKeyPairs查询ADB密钥对查询一个或多个密钥对。
ModifyKeyPairName修改ADB密钥对名称调用本接口修改ADB密钥对的名称。
DeleteKeyPairs删除ADB密钥对调用本接口删除云手机密钥对。
AttachKeyPair绑定ADB密钥对调用AttachKeyPair绑定一个ADB密钥对到一台或多台云手机实例。
DetachKeyPair解绑ADB密钥对调用本接口解除ADB密钥对到一台或多台云手机实例的绑定关系。

备份

API标题API概述
BackupFile创建备份文件生成并上传备份文件。
RecoveryFile恢复备份文件调用RecoveryFile接口恢复备份文件。
DescribeBackupFiles查询备份文件列表调用DescribeBackupFiles接口查询备份文件列表。

策略

API标题API概述
CreatePolicyGroup创建策略创建策略。
ListPolicyGroups查询策略详细信息查询策略的详细信息。
ModifyPolicyGroup修改策略信息修改策略。
DeletePolicyGroup删除策略删除策略。

任务

API标题API概述
DescribeTasks查询任务获取云手机实例当前任务列表。