华为云用户手册

修订记录 发布日期 修订记录 2023-05-29 第五次正式发布。 修改： 智能信息，修改产品特点，当前支持华为（含荣耀）、小米、OPPO、VIVO等540多种型号手机终端，共计7亿以上手机终端。 2023-03-13 第四次正式发布。 修改： 计费说明，修改智能短信计费方式；修改智能信息基础版计费方式和计费规则。 2023-01-09 第三次正式发布。 新增： 图解 云消息 服务，增加图解云消息服务。 2022-12-12 第二次正式发布。 新增： 产品优势 修改： 什么是云消息服务，增加产品架构图片。 智能信息，增加智能短信核心产品功能；修改智能短信产品优势；修改智能短信产品特点。 智能信息服务号，修改智能信息服务号核心产品功能；修改智能信息服务号产品优势；修改智能信息服务号产品特点。 智能信息基础版，修改智能信息基础版产品功能；修改智能信息基础版产品优势；修改智能信息基础版产品特点。 2022-11-04 第一次正式发布。

智能信息基础版 表2 KooMessage 智能信息基础版操作与系统策略关系 操作 KooMessage FullAccess KooMessage ReadOnlyAccess KooMessage CommonOperations KooMessage Development KooMessage Basic Edition FullAccess KooMessage Basic Edition ReadOnlyAccess KooMessage Basic Edition CommonOperations KooMessage Basic Edition Development 上传智能信息基础版手机号码文件 √ × √ × √ × √ × 下载智能信息基础版手机号码样例 √ × √ × √ × √ × 查询智能信息基础版发送任务明细 √ √ √ × √ √ √ × 创建智能信息基础版发送任务 √ × √ √ √ × √ √ 查询智能信息基础版模板 √ √ √ × √ √ √ × 查询智能信息基础版发送任务 √ √ √ √ √ √ √ √ 查询智能信息基础版模板 √ √ √ √ √ √ √ √ 创建智能信息基础版模板 √ × √ √ √ × × √

智能信息服务号 表3 KooMessage智能信息服务号操作与系统策略关系 操作 KooMessage FullAccess KooMessage ReadOnlyAccess KooMessage CommonOperations KooMessage SA FullAccess KooMessage SA ReadOnlyAccess KooMessage SA CommonOperations 查询企业基本信息 √ √ √ √ √ √ 创建企业 √ × √ √ × √ 企业资料管理 √ × √ √ × √ 更新企业 √ × √ √ × √ 查询智能信息服务号的资源 √ √ √ √ √ √ 上传智能信息服务号的资源 √ × √ √ × √ 创建智能信息服务号的菜单 √ × √ √ × √ 查询智能信息服务号的菜单 √ √ √ √ √ √ 更新智能信息服务号的菜单 √ × √ √ × √ 查询智能信息服务号的商家 √ √ √ √ √ √ 创建智能信息服务号的商家 √ × √ √ × √ 更新智能信息服务号的商家 √ × √ √ × √ 查询智能信息服务号的主页 √ √ √ √ √ √ 创建智能信息服务号的主页 √ × √ √ × √ 更新智能信息服务号的主页 √ × √ √ × √ 查询智能信息服务号的端口号 √ √ √ √ √ √ 创建智能信息服务号的端口号 √ × √ √ × √ 绑定服务号到通道号 √ × √ √ × √ 解绑服务号的通道号 √ × × √ × × 删除通道号 √ × × √ × × 查询服务号 √ √ √ √ √ √ 创建服务号 √ × √ √ × √ 更新服务号 √ × √ √ × √ 冻结服务号 √ × × √ × ×

智能信息 表1 KooMessage智能信息操作与系统策略关系 操作 KooMessage FullAccess KooMessage ReadOnlyAccess KooMessage CommonOperations KooMessage Development 查询智能信息模板 √ √ √ √ 查询智能信息模板报表 √ √ √ √ 查询智能信息解析任务 √ √ √ √ 生成智能信息解析任务 √ × √ √ 查询手机号码智能信息解析能力 √ × √ √ 查询智能信息发送任务 √ √ √ √ 发送智能信息 √ × √ √ 上传手机号码文件 √ × √ × 查询手机号码文件的智能信息解析能力检查结果 √ √ √ × 生成个性化短链 √ × √ × 下载个性化短链列表文件 √ × √ × 根据上传的手机号码文件发送智能信息 √ × √ × 查询智能信息发送任务列表 √ √ √ × 查询模板列表 √ √ √ × 查询个人模板列表 √ √ √ × 查询公共模板列表 √ √ √ × 生成群发短链 √ × √ × 查询短链生成明细列表 √ √ √ × 查询短链生成任务列表 √ √ √ ×

产品优势 全场景、全终端用户触达 平台融合不同用户触达渠道，包含智能信息、智能信息基础版（视频短信）、服务号、Push消息、媒体投放、一体化智能营销发送等能力，帮助企业客户实现全场景、全终端用户触达。 内容创意便捷个性化 客户可通过积木式、图形化的内容创意工具自助组装生成内容创意，也可通过用户行为数据和素材模板库的人群定位，智能化、自动化组装生成个性化内容，并通过个性化参数为企业客户提供千人千面的内容&创意。 流量分发高效可靠 通过南向通道的智能调度进行流量分发，实现1000TPS的分发能力，并通过全链路监测保障流量分发高效可靠。 用户分析精准智能 整合企业内外部数据，通过用户画像及构建用户标签体系实现用户360度洞察。 安全可信 KooMessage整体云服务设计和开发遵从华为云整体安全隐私保护机制，包括《华为 云安全 白皮书》、《华为云数据安全白皮书》、《华为云可信白皮书》、《华为云隐私保护白皮书》。KooMessage的安全隐私保护策略采取严格的安全措施来保护数据隐私安全并按照客户要求使用。

责任共担 华为云秉承“将公司对网络和业务安全性保障的责任置于公司的商业利益之上”。针对层出不穷的云安全挑战和无孔不入的云安全威胁与攻击，华为云在遵从法律法规业界标准的基础上，以安全生态圈为护城河，依托华为独有的软硬件优势，构建面向不同区域和行业的完善云服务安全保障体系。 安全性是华为云与您的共同责任，如图1所示。 华为云：负责云服务自身的安全，提供安全的云。华为云的安全责任在于保障其所提供的IaaS、PaaS和SaaS类云服务自身的安全，涵盖华为云数据中心的物理环境设施和运行其上的基础服务、平台服务、应用服务等。这不仅包括华为云基础设施和各项云服务技术的安全功能和性能本身，也包括运维运营安全，以及更广义的安全合规遵从。 租户：负责云服务内部的安全，安全地使用云。 华为云租户的安全责任在于对使用的IaaS、PaaS和SaaS类云服务内部的安全以及对租户定制配置进行安全有效的管理，包括但不限于虚拟网络、 虚拟主机 和访客虚拟机的操作系统，虚拟防火墙、API网关和高级安全服务，各项云服务，租户数据，以及身份账号和密钥管理等方面的安全配置。 《华为云安全白皮书》详细介绍华为云安全性的构建思路与措施，包括云安全战略、责任共担模型、合规与隐私、安全组织与人员、基础设施安全、租户服务与租户安全、工程安全、运维运营安全、生态安全。 图1 华为云安全责任共担模型 父主题： 安全

身份认证 KooMessage提供的身份认证可以分为控制台和云服务两个层面： 控制台层面 您可以使用华为云用户名与密码登录，实现用户的认证与鉴权，未授权的不能访问。 云服务层面 您可通过开放的API网关，实现智能信息、智能信息基础版（视频短信）、服务号等能力的访问和集成，具体操作和描述请参考KooMessage服务的《API参考》。 KooMessage调用接口支持Token认证鉴权，请参考认证鉴权。

RDS for MySQL哪些高危操作会影响DDM RDS for MySQL相关高危操作如表1所示。 表1 RDS for MySQL高危操作 操作类别 操作 操作影响 RDS for MySQL控制台操作类 删除RDS for MySQL实例 RDS for MySQL实例删除后，DDM关联该RDS for MySQL实例的逻辑库、逻辑表都无法使用。 切换RDS for MySQL主备实例 切换主备实例可能造成短时间内的RDS for MySQL服务闪断，并有可能在主备同步时延过大的情况下，导致少量数据丢失。 RDS for MySQL实例主备切换过程中，DDM将无法进行创建逻辑库、创建表等操作。 RDS for MySQL实例主备切换后，DDM中RDS for MySQL实例ID不变。 重启实例 重启过程中，RDS for MySQL实例将不可用，DDM业务将会受影响。 重置密码 RDS for MySQL重置密码后，DDM这边创建逻辑库时输入重置后的密码即可。 修改参数模板 其中如下参数为固定值，如果修改，将会影响DDM正常运行。 数据表名和序列名称不区分大小写，“lower_case_table_names”固定为“1”。 扩容场景，必须将“local_infile”配置为“ON”。 修改安全组 将导致DDM服务无法连接RDS for MySQL实例。 修改VPC DDM实例与RDS for MySQL实例不在同一VPC中将导致无法互通。 恢复 恢复数据可能会破坏数据完整性。 RDS for MySQL客户端类 删除DDM创建的物理库 删除物理库后，原数据将会丢失，新数据将无法写入。 删除DDM创建的物理账号 删除物理账号后将无法在DDM上创建逻辑表。 删除DDM创建的物理表 删除物理表后，将导致DDM数据丢失，DDM后续无法正常使用该逻辑表。 修改DDM创建的物理表名 将导致DDM无法获取该逻辑表的数据，且后续无法正常使用。 修改记录 如修改全局表记录，将会影响各分片数据一致性。 修改白名单 需要确保DDM服务在RDS for MySQL实例的白名单内，否则DDM服务将无法访问RDS for MySQL实例。 父主题： RDS相关类

通过VPC内网访问DDM实例 DDM实例的访问和使用，包括客户端所在E CS 访问DDM实例，以及DDM实例访问其关联的数据节点。 除了ECS、DDM实例、数据节点必须处于相同VPC之外，还需要安全组分别配置了正确的规则，允许网络访问。 建议ECS、DDM、数据节点配置相同的安全组。安全组创建后，默认包含同一安全组内网络访问不受限制的规则。 如果配置了不同安全组，可参考如下配置方式： 例如ECS、DDM、RDS分别配置了安全组：sg-ECS、sg-DDM、sg-RDS。 例如DDM实例服务端口为5066，RDS for MySQL实例服务端口为3306。 以下规则，远端可使用安全组，也可以使用具体的IP地址。 ECS所在安全组需要增加下图中的入方向规则，以保证客户端能正常访问DDM实例： 图1 ECS安全组策略 DDM所在安全组需要增加下图中的入方向和出方向规则，以保证能访问数据节点，且被客户端访问。 图2 DDM安全组入方向配置 图3 DDM安全组出方向配置 数据节点所在安全组需要增加下图中的入方向和出方向规则，以保证能被DDM访问。 图4 RDS安全组入方向配置 图5 RDS安全组出方向配置

处理方法 登录云服务管理控制台。 在RDS for MySQL的“实例管理”页面，查找DDM实例对应的RDS for MySQL实例，单击目标RDS for MySQL实例名称，进入实例的“基本信息”页面。 在基本信息页面的左侧导航栏中选择“参数修改”。 在“参数”页签搜索“sql_mode”，单击“值”列中的下拉框，勾选“STRICT_ALL_TABLES”或“STRICT_TRANS_TABLES”方式，单击“保存”。 “STRICT_ALL_TABLES”和“STRICT_TRANS_TABLES”方式属于严格模式。严格模式控制MySQL如何处理非法或丢失的输入值。 非法：数据类型错误或超出范围。 丢失：如果某列定义为非空列且没有DEFAULT值，当新插入的行不包含该列时，该行记录丢失。 在进行扩容时，如果DDM的实例版本低于2.4.1.3。在选择MySQL实例的参数sql_mode时，请不要选择ANSI_QUOTES。不能使用双引号来引用文字字符串，因为它们被解释为标识符。 例如：select * from test where tb = "logic"。 关于“sql_mode”更多信息，请参考Server SQL Modes。 图1 修改实例参数 在“DDM实例管理”页面，重启DDM实例。

DDM如何进行分片 在 分布式数据库 中，可以通过分片存储方式，轻松解决大数据量单表容量达到单机数据库存储上限的瓶颈，因此创建逻辑库和逻辑表时，需要根据实际情况确定逻辑表是否进行分片以及逻辑表的分片规则。 分片存储后，需要尽量避免跨库JOIN操作带来的性能与资源消耗问题。 逻辑表是否分片 DDM逻辑表支持全局表、拆分表、单表三种类型。用户可以按照数据表的实际使用需求，选择最合适的逻辑表类型创建，实际操作请参考创建表。 单表只在第一个分片创建表以及存储数据。 全局表在每一个分片创建表并且存储全量数据。 拆分表在每一个分片创建表，数据按照拆分规则分散存储在分片中。 逻辑表的分片规则 逻辑表的拆分键选择非常重要。建议按实际业务场景选择拆分键，不同逻辑表，如果具有E-R关系，建议选择相同字段做拆分键，避免跨库JOIN操作。 在实际使用中，请结合以下建议评估是否进行分片： 数据量在1000万条以下的表，不建议分片。 数据量在1000万条以上的表，建议分片。将数据分片存储后，既能解决单张表容量过大带来的性能瓶颈，同时提高并发支持。注意要选择合适的拆分键，提前做好规划。 业务读取尽量少用多表JOIN，同一个事务避免跨分片。 查询条件尽量带上拆分键，避免全拆分表扫描。 父主题： DDM使用类

如何选择数据节点RDS for MySQL的规格 数据节点RDS for MySQL的规格建议不小于DDM的规格，否则会产生木桶效应，影响性能。 示例： Q：例如DDM是8核16GB，那么RDS for MySQL的规格应该选多少？应该选择主备还是单机架构？ A：根据最佳实践结果，一般建议DDM和RDS for MySQL的资源比保持在1:2。如果DDM是8核16GB，需要选择2个或以上8核16GB的RDS for MySQL实例，RDS for MySQL的具体数量还需参考业务整体数据量综合考虑。 对于生产业务使用的实例，RDS for MySQL需选择主备架构来保证高可用。 父主题： RDS相关类

MySQL连接DDM时出现乱码如何解决 MySQL连接的编码和实际的编码不一致，可能导致DDM解析时出现乱码。 通过“default-character-set=utf8”指定客户端连接的编码即可。 如下所示： mysql -h 127.0.0.1 -P 5066 -D database --default-character-set=utf8 -u ddmuser –p password 父主题： 连接管理类

解决方法 在连接DDM的URL添加loadBalanceAutoCommitStatementThreshold=5&retriesAllDown=10参数。 //使用负载均衡的连接示例 //jdbc:mysql:loadbalance://ip1:port1,ip2:port2..ipN:portN/{db_name} String url = "jdbc:mysql:loadbalance://192.168.0.200:5066,192.168.0.201:5066/db_5133?loadBalanceAutoCommitStatementThreshold=5&retriesAllDown=10"; loadBalanceAutoCommitStatementThreshold：表示连接上执行多少个语句后会重新选择连接。 假设loadBalanceAutoCommitStatementThreshold设为5，则当执行5个sql后（Queries或者updates等），将会重新选择连接。如果为0表示“粘性连接，不重新选择连接”。关闭自动提交时（autocommit=false）会等待事务完成再考虑是否重新选择连接。

冻结、解冻、释放资源时对业务的影响 资源冻结时： 资源将被限制访问和使用，会导致您的业务中断。例如DDM被冻结时，会使得用户无法再连接至数据库。 包周期资源被冻结后，将被限制进行变更操作。 资源被冻结后，可以手动进行退订/删除。 DDM底层的DN节点被冻结会导致DDM与DN节点无法正常通信，进而使DDM功能不可用。 资源解冻时：资源将被解除限制，用户可以连接至数据库。 资源释放时：资源将被释放，实例将被删除。

原因分析 JDBC驱动连接DDM时会向DDM查询数据库时区设置，DDM返回时区为CST(中国标准时间)。 CST有4种含义： 美国中部时间 Central Standard Time (USA) UTC-06:00 澳大利亚中部时间 Central Standard Time (Australia) UTC+09:30 中国标准时 China Standard Time UTC+08:00 古巴标准时 Cuba Standard Time UTC-04:00 在JDBC驱动中，会将CST时间解析为美国中部时间，与北京时间相差了13或14个小时。

如何通过show full innodb status指令查询RDS for MySQL相关信息 通过MySQL客户端连接DDM实例后，可直接输入show full innodb status指令查询该DDM实例所关联的RDS for MySQL实例信息。可查询信息如： 当前的时间及自上次输出以来经过的时长。 可以使用命令show full innodb status来查看master thread的状态信息。 如果有高并发的工作负载，您需关注SEMAPHORES信号量，它包含了两种数据：事件计数器以及可选的当前等待线程的列表，如果有性能上的瓶颈，可使用这些信息来找出瓶颈。 父主题： RDS相关类

可用区管理 权限 对应的API接口 授权项（Action） 依赖的授权项 IAM 项目 (Project) 企业项目 (Enterprise Project) 实例授权 标签授权 查询可用区列表（OpenStack原生） GET /v2.1/{project_id}/os-availability-zone ecs:availabilityZones:list - √ × × × 父主题： 权限和授权项

云手机属性列表 属性参数都为非必选且可以修改，说明如下： 以aphs1开头和rx1.cp.c60.d32.e1v1.qemu规格的云手机仅支持少量属性的修改。 部分属性可能需要最新的镜像才能支持，如有需要请您更新手机镜像。 名称 参数类型 说明 约束 com.cph.mainkeys Integer 是否隐藏虚拟按键，默认为0，即不隐藏 说明：com.cph.mainkeys和qemu.hw.mainkeys均可用来隐藏/显示虚拟按键，后者现已弃用。 0表示不隐藏，即显示虚拟按键；1表示隐藏，即不显示虚拟按键。 disable.status.bar Integer 是否禁用状态栏，默认为0。 0表示不禁用，即显示状态栏；1表示禁用，即不显示状态栏。 ro.permission.changed Integer 是否在安装app时自动赋予App请求的所有权限，默认为0。 0表示不自动赋予App请求的所有权限，1表示自动赋予App请求的所有权限。 ro.install.auto Integer 是否在App安装时自动确认安装，默认为0。 0表示App安装时不自动确认安装，1表示App安装时自动确认安装。 ro.com.cph.non_root Integer 是否非root，默认为1。 0表示root，1表示非root。 ro.com.cph.notification_disable Integer 是否禁用 消息通知 ，默认为0。 0表示不禁用，1表示禁用。 com.cph.disable_fb_permission Integer 是否关闭App截图隐私保护功能，默认为0, 不关闭。 0 表示不关闭App截图隐私保护功能，对APP设置保护的界面无法进行截图。 1 表示关闭App截图隐私保护功能, 允许对App已设置保护的界面截图。 com.cph.bandwidth_limit String 限制手机公网下载速度。 取值范围：1~99999999，单位kbit/s。-1表示不限速。 注意： 手机速度达到的上限不超过带宽上限。 rx1.cp.c60.d32.e1v1.qemu规格的手机不支持限速。 ro.com.cph.toast_enable Integer 当设置ro.com.cph.non_root=1时，是否启用Toast消息提示框，默认为0 0表示不启用，1表示启用。 com.cph.cam_local_pic_path String 摄像头读取本地图片的路径。摄像头自动加载对应地址的图片。 非空，不多于90个字符，只能由数字、大小写字母、中划线-、下划线_、中文、@、#、点.、冒号:、斜线/和空格组成。 persist.sys.locale String 首次启动时系统的语言识别标签。 非空，不多于64个字符，只能由数字、大小写字母、中划线组成。 sys.prop.writeimsi String IMSI（International Mobile Subscriber Identity，国际移动用户识别码）。 不多于15个字符，只能由十进制数字组成。 sys.prop.writephonenum String 手机号码。 不多于20个字符，只能由十进制数字组成。 sys.prop.writewifissid String 无线网络名称，默认为cloudphone_wifi。 非空，不多于64个字符，只能由数字、大小写字母、中划线-、下划线_、点.、斜线/组成。 gsm.sim.operator.iso-country String SIM卡归属国家，默认为cn。 不多于10个字符，只能由大小写英文字母、英文逗号组成。 gsm.sim.operator.numeric String SIM卡提供商的标识码，默认为46000。 不多于10个字符，只能由大小写英文字母、英文逗号组成。 gsm.sim.operator.alpha String SIM卡的运营商，默认为CMCC。 不多于90个字符，只能由数字、大小写字母、中划线-、下划线_、中文、@、#、点.、逗号, 、冒号:、斜线/、反斜线\、英文左括号(、英文右括号)和空格组成。 gsm.operator.iso-country String 网络运营商国家，默认为cn。 不多于10个字符，只能由大小写英文字母、英文逗号组成。 gsm.operator.numeric String 网络提供商的标识码，默认为46000。 不多于10个字符，只能由大小写英文字母、英文逗号组成。 gsm.operator.alpha String 网络运营商，默认为CMCC。 不多于90个字符，只能由数字、大小写字母、中划线-、下划线_、中文、@、#、点.、逗号, 、冒号:、斜线/、反斜线\、英文左括号(、英文右括号)和空格组成。 ro.hardware.gpurenderer String GPU型号 已弃用 ro.board.platform String 平台型号，默认为hi3660。 已弃用 ro.build.product String 产品型号，默认为STF。 已弃用 ro.product.device String 设备型号，默认为HWSTF。 已弃用 ro.com.cph.sfs_enable String 是否禁用SFS，默认为0。 已弃用 ro.product.manufacturer String 制造商，默认为Huawei。 已弃用 ro.product.name String 产品名称，默认为monbox。 已弃用 qemu.hw.mainkeys Integer 是否隐藏虚拟按键，默认为0，即不隐藏。 已弃用 ro.horizontal.screen String 是否横屏显示，默认为0。 0表示竖屏显示，1表示横屏显示。 com.cph.cg.sign_check_url String 云手游实例签名校验url。 http或者https开头，包含[a-zA-Z0-9_.,/:-]，长度不超过256。 com.cph.cg.event_notify_url String 云手游实例事件上报回调url。 http或者https开头，包含[a-zA-Z0-9_.,/:-]，长度不超过256。 com.cph.cg.heartbeat_url String 云手游实例心跳上报url。 http或者https开头，包含[a-zA-Z0-9_.,/:-]，长度不超过256。 com.cph.cg.heartbeat_interval String 云手游实例心跳上报间隔，单位秒。 1~10个字符，只能由数字组成。 com.cph.cg.app_port String 云游戏应用接入端口。 10000~11000之间的整数。 com.cph.cg.h5_port String 云游戏H5接入端口。 10000~11000之间的整数 ro.com.cph.cloud_app_engine String 是否启用端云推流引擎。 0表示不启用，1表示启用。 父主题： 附录

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 package_name 是 String 合法的应用包名。 pre_install_app 否 Integer 是否预装应用。 1：预装 0：不预装；默认不预装 bucket_name 是 String 合法的OBS桶名，3-63个字符，只能由小写字母、数字、中划线（-）和小数点组成 object_path 是 String 合法的OBS对象key，最大长度1024字符。仅支持大小写字母、数字、小数点（.）、斜线（/）、中划线（-）、下划线（_）、加号（+）、井号（#）、等号等这些字符。 推送的文件只支持tar文件类型。推送时，按tar文件解压后的文件目录结构推送到手机。 server_ids 是 Array of strings 云手机服务器ID列表。

功能介绍 推送应用tar文件至共享应用存储目录中，该功能仅在支持共享应用的云手机规格上可实现。接口调用前请先确保已完成CPH服务操作OBS桶的委托授权。委托CPH操作OBS桶请参见委托CPH操作OBS桶。 注意：不能向低版本服务器推送高版本手机导出的应用包，否则可能会造成兼容性问题。如果您使用的是physical.kg1.4xlarge.a.cp服务器规格，请确保共享应用的可用空间大于两倍的tar包

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 jobs Array of ServerJob objects 任务列表。 表5 ServerJob 参数 参数类型 描述 server_id String 云手机服务器的唯一标识ID，云手机服务器相关任务包含此字段。 job_id String 任务的唯一标识。 error_code String 错误码。 error_msg String 错误说明。

请求示例 将应用推送到服务器列表中的服务器上，应用来自于obs桶中 POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/share-apps { "package_name" : "com.miniteck.miniworld", "bucket_name" : "bucket", "object_path" : "my_apps/test.tar", "server_ids" : [ "1234567b8bab40ffb711234cb80d0234", "1678567b8bab40f93711234cb80d0764" ] }

响应示例 状态码： 200 OK { "request_id" : "6837531fd3f54550927b930180a706bf", "jobs" : [ { "server_id" : "1234567b8bab40ffb711234cb80d0234", "job_id" : "1564567b8bab40f34711234cb80d0123" }, { "server_id" : "1678567b8bab40f93711234cb80d0764", "job_id" : "1564567b8bab40f34711234cb80d5678" } ] }

响应示例 状态码： 200 OK { "request_id" : "6a63a18b8bab40ffb71ebd9cb80d0085", "count" : 1, "phones" : [ { "phone_name" : "mobile-0001", "server_id" : "88b8449b896f3a4f0ad57222dd91909", "phone_id" : "1234567b8bab40ffb711234cb80d0234", "phone_model_name" : "AOSP-1U4G15G-001", "image_version" : "AOSP 7.0", "image_id" : "88b8449b896f3a4f0ad57222dd91909", "vnc_enable" : "true", "status" : 2, "type" : 0, "imei" : "869287243397729", "availability_zone" : "cn-southwest-242b", "traffic_type" : "direct", "volume_mode" : 0, "metadata" : { "order_id" : "CS1710111105S8IPB", "product_id" : "00301-25217-0--0" }, "create_time" : "2017-10-10T00:00:00Z", "update_time" : "2018-10-10T00:00:00Z" } ] }

URI GET /v1/{project_id}/cloud-phone/phones 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量为一个大于0小于资源总个数的整数，表示查询该偏移量后面的所有的资源数，默认值为0。 limit 否 Integer 每页返回的资源个数。取值范围：1~200（默认值为200），一般设置为10、20、50。 phone_name 否 String 云手机名称，支持模糊查询。 server_id 否 String 云手机服务器的唯一标识。 status 否 Integer 云手机状态。 1：创建中 2：运行中 3：重置中 4：重启中 6：冻结 7：正在关机 8：已关机 -5：重置失败 -6：重启失败 -7：手机异常 -8：创建失败 -9：关机失败 type 否 Integer 云手机类型。 0：普通云手机

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 phones Array of Phone objects 云手机信息。 request_id String 请求的唯一标识ID。 count Integer 实例总数。 表5 Phone 参数 参数类型 描述 phone_name String 云手机的名称，不超过65个字符。 server_id String 云手机所在的服务器ID，不超过32个字节。 phone_id String 云手机的唯一标识，不超过32个字节。 phone_model_name String 云手机规格名称，不超过64个字节。 image_id String 云手机镜像ID，不超过32个字节。 image_version String 镜像版本。 vnc_enable String 云手机是否开启VNC服务。 true：开启 false：不开启 status Integer 云手机状态。 0: 创建中 1：创建中 2：运行中 3：重置中 4：重启中 6：冻结 7：正在关机 8：已关机 -5：重置失败 -6：重启失败 -7：手机异常 -8：创建失败 -9：关机失败 type Integer 云手机类型。 0：普通云手机 1：试玩云手机 imei String imei码。 traffic_type String 手机路由类型。 direct：默认路由 routing：路由到编码容器 volume_mode Integer 手机物理磁盘是否独立。 0：不独立 1：独立 availability_zone String 云手机服务器所在的可用区。 metadata metadata object 订单以及产品相关信息。 create_time String 创建时间， 时间格式为UTC。 update_time String 更新时间， 时间格式为UTC。 表6 metadata 参数 参数类型 描述 order_id String 订单ID，不超过64个字节。 product_id String 产品ID，不超过64个字节。

请求示例 购买云手机服务器 POST https://{CPH Endpoint}/v2/{project_id}/cloud-phone/servers { "server_name" : "cph-kertus-1110", "server_model_name" : "physical.kg1.4xlarge.cp", "phone_model_name" : "kg1.cp.c20.d64SSD.e1v1", "image_id" : "20060220200717f201120a2300000e91", "count" : 1, "keypair_name" : "keypair", "ports" : [ { "name" : "myServer1", "listen_port" : 20000, "internet_accessible" : "false" }, { "name" : "myServer2", "listen_port" : 20001, "internet_accessible" : "true" } ], "extend_param" : { "charging_mode" : 0, "period_type" : 2, "period_num" : 1, "is_auto_pay" : 0 }, "tenant_vpc_id" : "fca063f6-b942-42a8-9004-e5545f58d6a2", "nics" : [ { "subnet_id" : "f1cbfc37-eb42-4357-a0ec-9e4f11950908" } ], "public_ip" : { "eip" : { "type" : "5_bgp" } }, "band_width" : { "band_width_share_type" : 0, "band_width_size" : 300, "band_width_charge_mode" : 1 } }

响应示例 状态码： 200 OK { "request_id" : "1564567b8bab40f34711234cb80d8574", "order_id" : "CS1710111105S8IPB", "product_id" : "00301-25217-0--0", "server_ids" : [ "1234567b8bab40ffb711234cb80d0234", "1678567b8bab40f93711234cb80d0764" ] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 server_name 是 String 云手机服务器名称，不超过60个字符，只支持英文字母、数字、汉字、下划线和中划线。批量购买会在服务器名称后自动添加序号，比如设置此参数为server-1，那么创建的云手机服务器名称会自动按序增加数字后缀，比如为server-1-0001。 server_model_name 是 String 云手机服务器规格，不超过64个字节。 phone_model_name 是 String 云手机规格，不超过64个字节。 image_id 是 String 云手机镜像ID，不超过32个字节。 count 是 Integer 购买的云手机服务器个数，最多可购买10台。 keypair_name 否 String 密钥对名称，不超过64个字节，用于云手机ADB登录。 ports 否 Array of Port objects 云手机启用的应用端口，云手机服务会做端口转发。 extend_param 是 extend_param object 计费模式参数。 tenant_vpc_id 是 String 租户自定义的VPC ID，为待创建的云服务器所属的虚拟私有云（简称VPC），需要指定已创建VPC的ID，UUID格式。 nics 是 Array of Nic objects 租户自定义的网卡的结构体，为待创建的云服务器的网卡信息。 public_ip 是 public_ip object 租户自定义的弹性公网IP结构体。 配置云服务器的弹性IP信息的方式， 自动分配，需要指定新创建弹性IP的信息； 使用已有，需要指定已经购买的EIP ID。 phone_count_per_ip 否 Integer 多少个手机共用一个vip。默认为手机开数，表示所有手机共享1个vip。取值范围：1到手机规格开数。 phone_data_volume 否 phone_data_volume object 手机磁盘结构体，2.0规格必选。 server_share_data_volume 否 server_share_data_volume object 共享存储磁盘结构体，2.0规格可选。 band_width 是 band_width object 云手机使用的带宽信息。 availability_zone 否 String 待创建云服务器所在的可用区，需要指定可用区（AZ）的名称。如上海一可用区1为cn-east-3a。 表4 Port 参数 是否必选 参数类型 描述 name 是 String 应用端口名称，不超过16个字节，系统关键服务名称不能使用"adb"和"vnc"。 listen_port 是 Integer 端口号，大于等于10000，小于等于50000。 internet_accessible 是 String 为"true"则映射出公网访问（忽略大小写）。 为其他则不映射。 表5 extend_param 参数 是否必选 参数类型 描述 charging_mode 是 Integer 计费类型。 0：包周期 period_type 是 Integer 订购周期类型。 2：月 3：年 period_num 是 Integer 订购周期数。 当订购周期为月时，取值范围[1, 9]。 当订购周期为年时，取值范围[1,10]。 is_auto_pay 否 Integer 是否自动付款。默认不自动付款。 1：自动付款 0：不自动付款 is_auto_renew 否 Integer 是否自动续订。默认不自动续订。 1：自动续订 0：不自动续订 enterprise_project_id 否 String 企业项目ID。 该字段不传（或传为字符串“0”），则将资源绑定给默认企业项目。 表6 Nic 参数 是否必选 参数类型 描述 subnet_id 是 String 租户自定义的子网 ID，为待创建的云服务器所属的子网。 需要指定tenant_vpc_id对应VPC下已创建的子网（subnet）的网络ID，UUID格式。 ipv6_enable 否 Boolean 是否支持ipv6。 取值为true时，标识此网卡支持ipv6。 ipv6_bandwidth 否 ipv6_bandwidth object 绑定的共享带宽信息，详情请参见 ipv6_bandwidth数据结构说明。 表7 ipv6_bandwidth 参数 是否必选 参数类型 描述 band_width_id 是 String ipv6绑定的共享带宽ID。 表8 public_ip 参数 是否必选 参数类型 描述 ids 否 Array of strings 指定已有的EIP进行服务器创建，当前只支持传入一个已有的EIP ID。 eip 否 eip object 配置服务器自动分配弹性IP时，创建弹性IP的配置参数，详情见 eip 结构体。 count 否 Integer Eip数量。默认为1，不需要Eip可设置为0，取值范围为0到手机IP数。 表9 eip 参数 是否必选 参数类型 描述 type 是 String 弹性公网IP的类型。 5_telcom：电信 5_union：联通 5_bgp：全动态BGP 5_sbgp：静态BGP 表10 phone_data_volume 参数 是否必选 参数类型 描述 volume_type 是 String 磁盘类型，只支持如下类型： SSD GPSSD size 是 Integer 磁盘大小，单位GB，取值范围[0，32768]。 表11 server_share_data_volume 参数 是否必选 参数类型 描述 volume_type 是 String 磁盘类型，只支持如下类型： SSD GPSSD size 是 Integer 磁盘大小，单位GB，取值范围[0，32768]。 表12 band_width 参数 是否必选 参数类型 描述 band_width_id 否 String 云手机服务器的带宽唯一标识。 band_width_size 否 Integer 云手机服务器的带宽大小。 band_width_charge_mode 是 Integer 云手机服务器带宽的计费方式。 0：bandwidth, 按带宽计费 1：traffic, 按流量计费 band_width_share_type 是 Integer 云手机服务器的带宽类型。 0：per，独享带宽 1：whole，共享带宽