华为云用户手册

响应示例 状态码：200 实例鉴权接口返回设备信息 { "data" : { "resource" : { "sdk" : { "internal" : { "address" : null, "aport" : null, "atype" : null, "address_ipv6" : null }, "external" : { "address" : "10.83.71.187", "aport" : 10030, "atype" : 1, "address_ipv6" : null } }, "rtc" : { "ice_signaling" : { "signaling_url" : "http://100.93.2.248:18082", "expired_time" : null, "ice_servers" : [ ] } }, "device_id" : "7b0cd026df8d495b8a65d628d7bec433", "kp_id" : "Q39YyZvI" }, "device_token" : "dee5081f40c83ddea3ded91c387351e9" }, "error_code" : "0", "error_msg" : "ok"} 状态码：400 请求错误 { "error_code" : "string", "error_msg" : "string"} 状态码：500 内部错误 { "error_code" : "string", "error_msg" : "string"}

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 data data object 反参全部信息 error_code String 错误码 error_msg String 错误信息 表4 data 参数 参数类型 描述 resource resource object 资源集合 device_token String 设备鉴权token 表5 resource 参数 参数类型 描述 sdk sdk object sdk信息 rtc rtc object rtc信息 device_id String 设备id kp_id String 云机实例Id，如whklpuo1 表6 sdk 参数 参数类型 描述 internal internal object 内网信息 external external object 外网信息 表7 internal 参数 参数类型 描述 address String 内网ip地址 aport String 音频端口 atype String 音频类型 address_ipv6 String ipv6地址 表8 external 参数 参数类型 描述 address String 外网eip地址 aport Integer 音频端口 atype Integer 音频类型 address_ipv6 String 外网ipv6地址 表9 rtc 参数 参数类型 描述 ice_signaling ice_signaling object ice信令信息 表10 ice_signaling 参数 参数类型 描述 signaling_url String 信令服务访问地址 expired_time String streaming时长。单位秒 ice_servers Array of strings ICE 服务器 状态码：400 表11 响应Body参数 参数 参数类型 描述 error_code String 响应码，KOOPHONE.API.xxxx或者common.00000xxx error_msg String 响应描述 状态码：500 表12 响应Body参数 参数 参数类型 描述 error_code String 响应码，KOOPHONE.API.xxxx或者common.00000xxx error_msg String 响应描述

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 error_code String 响应码，错误码规范KooPhone.API.1001，数字递增 error_msg String 响应描述 data JobDetailWrapper object 根据task_id查询出的任务列表 表4 JobDetailWrapper 参数 参数类型 描述 jobs Array of JobDetail objects 根据task_id查询出的任务列表 表5 JobDetail 参数 参数类型 描述 job_id String 任务唯一标识 status Integer 任务状态。1 表示运行中，2表示成功，-1表示失败 error_code String 任务错误码 error_msg String 任务错误码说明 execute_msg String 任务执行返回内容，最长1024字节。命令执行成功和失败均将命令的输出返回 状态码：400 表6 响应Body参数 参数 参数类型 描述 error_code String 响应码，KOOPHONE.API.xxxx或者common.00000xxx error_msg String 响应描述 状态码：500 表7 响应Body参数 参数 参数类型 描述 error_code String 响应码，KOOPHONE.API.xxxx或者common.00000xxx error_msg String 响应描述

响应示例 状态码：200 正常响应 { "data" : { "jobs" : [ { "job_id" : "1564567b8bab40f34711234cb80d0123", "status" : -1, "error_code" : "CPS0005", "error_msg" : "Phone not found.", "execute_msg" : null }, { "job_id" : "1564567b8bab40f34711234cb80d0456", "status" : 2, "error_code" : "", "error_msg" : "", "execute_msg" : "xxxxxx" } ] }, "error_code" : "0", "error_msg" : "ok"}

状态码 常用状态码请参见表1。 表1 请求状态返回码 状态码 描述 说明 200 OK 资源获取成功。 201 Created 资源创建成功。 202 Accepted 已经接受处理。 204 No Content 操作成功，但无数据。 400 Bad Request 请求内容缺失或无效的请求内容。 401 Unauthorized 权限无效。 403 Forbidden 不允许执行当前请求。 404 Not Found 请求的资源没有找到。 405 Method Not Allowed 对资源的操作不允许。 406 Not Acceptable 请求的资源的内容特性无法满足请求头中的条件，因而无法生成响应实体。 409 Conflict 由于和被请求的资源的当前状态之间存在冲突，请求无法完成。 411 Missing Content-Length 请求的报文中缺少http content-length头域。 413 Request Entity Too Large 服务器拒绝处理当前请求，因为该请求提交的实体数据大小超过了服务器愿意或者能够处理的范围。 416 Requested range not satisfiable 如果请求中包含了Range请求头，并且 Range中指定的任何数据范围都与当前资源的可用范围不重合，同时请求中又没有定义 If-Range 请求头，那么服务器就应当返回416状态码。 429 Too Many Requests 服务器会对接口进行流控，超过了接口限流要求，服务器将无法处理。 500 Internal Server Error 服务器遇到了一个未曾预料的状况，导致了它无法完成对请求的处理。 501 Not Implemented 请求中所涉及到的操作和元数据，系统未实现，不能处理。 503 Service Unavailable 用户发起太频繁请求，系统暂时不能为该用户提供服务。 父主题： 附录

请求消息体 该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，xxxxxxxxxxxxxxxxxx为project的名称，如“cn-north-1”，您可以从地区和终端节点获取。 scope参数定义了Token的作用域，下面示例中获取的Token仅能访问project下的资源。您还可以设置Token的作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见获取用户Token。 1 2 3 4 5 6 7 8 91011121314151617181920212223242526 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokensContent-Type: application/json{ "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxxxxxxxxxxxx" } } }} 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中的“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint} / {resource-path} ? {query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 URL中的参数说明 参数 描述 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器 域名 或IP，不同服务不同区域的Endpoint不同，您可以从管理员处获取。 resource-path 资源路径，也即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。 例如您需要获取 IAM 在“华北-北京一”区域的Token，则需使用“华北-北京一”区域的Endpoint（iam.cn-north-1.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图 为查看方便，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。当资源不存在的时候，PATCH可能会去创建一个新的资源。 在获取用户Token的URI部分，您可以看到其请求方法为“POST”，则其请求为： POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443。 否 使用AK/SK认证时该字段必选。 code.test.com or code.test.com:443 Content-Type 消息体的类型（格式）。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。 否 application/json Content-Length 请求body长度，单位为Byte。 否 3495 X-Auth-Token 用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头（Headers）中包含的“X-Subject-Token”的值即为Token值。 否 使用Token认证时该字段必选。 注：以下仅为Token示例片段。 MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ API同时支持使用AK/SK认证，AK/SK认证使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见认证鉴权的“AK/SK认证”。 对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 12 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokensContent-Type: application/json

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 error_code String 响应码，错误码规范KooPhone.API.1001，数字递增 error_msg String 响应描述 data StatusResultWrapper object 状态查询结果 表4 StatusResultWrapper 参数 参数类型 描述 status_results Array of StatusResult objects 状态查询结果 表5 StatusResult 参数 参数类型 描述 instance_id String 实例id status Integer 云机状态，0：未知，1： 已停止，2：运行中，3：下线中，4：启动中， 5：已关机 状态码：400 表6 响应Body参数 参数 参数类型 描述 error_code String 响应码，KOOPHONE.API.xxxx或者common.00000xxx error_msg String 响应描述 状态码：500 表7 响应Body参数 参数 参数类型 描述 error_code String 响应码，KOOPHONE.API.xxxx或者common.00000xxx error_msg String 响应描述

基本概念 账号 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和IAM用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 详情请参见区域和可用区。 可用区（AZ，Availability Zone） 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。

响应消息体 响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。 对于获取用户Token接口，返回如下消息体。为篇幅起见，这里只展示部分内容。 { "token": { "expires_at": "2019-02-13T06:52:13.855000Z", "methods": [ "password" ], "catalog": [ { "endpoints": [ { "region_id": "az-01", ...... 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。 { "error_msg": "The format of message is error", "error_code": "AS.0001" } 其中，error_code表示错误码，error_msg表示错误描述信息。

错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 KOOPHONE.API.1000 请求参数错误 请求参数错误 检查请求参数类型及范围 400 KOOPHONE.API.1002 实例非同一个大区 实例非同一个大区 修改请求实例为同一个大区 401 KOOPHONE.API.1001 无实例权限 无实例权限 检查请求传入的实例id是否正确 500 KOOPHONE.API.9999 服务器内部错误 服务器内部错误 请联系华为侧运营人员检查系统是否正常 父主题： 附录

响应示例 状态码：200 正常响应 { "data" : { "cmd_results" : [ { "instance_id" : "a44uhlf7", "status" : -1, "error_code" : "CPS.0191", "error_msg" : "Run command failed.", "execute_msg" : "ls: cannot access '/system': No such file or directory" }, { "instance_id" : "efjy72gs", "status" : 2, "error_code" : "", "error_msg" : "", "execute_msg" : "xxxxxx" } ] }, "error_code" : "0", "error_msg" : "ok"}

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 x-request-id 是 String 消息跟踪唯一id X-Auth-Token 是 String 租户级Token 表2 请求Body参数 参数 是否必选 参数类型 描述 command 是 String 命令，最大长度为1024字节，只支持大小写字母、数字、下划线（_）、点（.）、斜线（/）、冒号（:）、中划线（-）。 instance_ids 是 Array of strings 实例列表

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 error_code String 响应码，错误码规范KP.API.0001，数字递增 error_msg String 响应描述 data CmdResultWrapper object 命令执行结果 表4 CmdResultWrapper 参数 参数类型 描述 cmd_results Array of CmdResult objects 命令执行结果 表5 CmdResult 参数 参数类型 描述 instance_id String 实例id status Integer 任务状态。1表示运行中，2表示成功，-1表示失败 error_code String 任务错误码 error_msg String 任务错误码说明 execute_msg String 任务执行返回内容，最长1024字节。命令执行成功和失败均将命令的输出返回 状态码：400 表6 响应Body参数 参数 参数类型 描述 error_code String 响应码，KOOPHONE.API.xxxx或者common.00000xxx error_msg String 响应描述 状态码：500 表7 响应Body参数 参数 参数类型 描述 error_code String 响应码，KOOPHONE.API.xxxx或者common.00000xxx error_msg String 响应描述

API概览 云手机服务接口的分类与说明如表1所示。 表1 KooPhone接口说明 类型 说明 实例执行同步命令 通过该接口可以指定云机实例同步执行adb shell命令。 实例执行异步命令 通过该接口可以指定云机实例异步执行adb shell命令。 实例执行任务查询 执行异步adb shell命令后，通过此接口查询执行结果。 实例视频设置 通过此接口可以设置串流的分辨率、码率以及对应的网络格式和FPS。 实例状态批量查询 通过该接口可以指定云机实例查询状态。 实例批量重置 通过该接口可以指定云机实例进行重置。 租户实例串流前获取设备的device_token 调用该接口获取云机实例的device_token后作为鉴权信息，携带云机实例的device_id去调用反参中的信令地址（signaling_url）。

相关操作 添加自定义配置：填写配置名然后选择自定义时间后，参考表1填写相关参数。 添加自定义配置前，需要先填写默认配置。 最多只可添加5个自定义配置。 预览快捷键：单击对应“操作”列下的“预览”按钮，弹出“预览”对话框，可进行左右横滑，查看默认配置和自定义配置。 修改快捷键：单击对应“操作”列下的“修改”按钮，进入到“修改快捷键名称”页面，修改完成后单击“申请”，弹出“预览”框，确认内容无误后，单击“确认”。 冻结快捷键：单击对应“操作”列下的“冻结”按钮，弹出“冻结”对话框，输入冻结原因，单击“确定”。 解冻快捷键：单击对应“操作”列下的“解冻”按钮，弹出“解冻”对话框，单击“确定”。

前提条件 给用户组授权之前，请您了解用户组可以添加的表1，并结合实际需求进行选择。若您需要对除 KooMessage 服务之外的其它服务授权，IAM支持服务的所有策略请参见权限策略。 表1 表1 KooMessage的系统角色或策略 系统角色/策略名称 描述 类别 依赖关系 KooMessage SA ReadOnlyAccess 智能消息服务号的只读权限。 系统策略 无。 KooMessage SA FullAccess 智能消息服务号的所有权限。 系统策略 无。 KooMessage Basic Edition CommonOperations 智能消息服务基础版的一般操作权限。 系统策略 无。 KooMessage Basic Edition Development 智能消息服务基础版的开发权限。 系统策略 无。 KooMessage Basic Edition ReadOnlyAccess 智能消息服务基础版的只读权限。 系统策略 无。 KooMessage Development 智能消息服务的开发权限。 系统策略 无。 KooMessage CommonOperations 智能消息服务的一般操作权限。 系统策略 无。 KooMessage FullAccess 智能消息服务的所有权限。 系统策略 无。 KooMessage ReadOnlyAccess 智能消息服务只读权限。 系统策略 无。 KooMessage SA CommonOperations 智能消息服务号的一般操作权限。 系统策略 无。 KooMessage Basic Edition FullAccess 智能消息服务基础版的所有权限。 系统策略 无。

开通KooMessage服务 进入KooMessage官网首页。 登录KooMessage控制台，进入开通KooMessage服务页面。 勾选“我已阅读并同意《KooMessage服务使用声明》《短信服务使用声明》”，单击“立即开通”。 KooMessage服务只向通过认证的企业提供开通，如还未完成企业用户认证，请单击“去认证企业用户”进行认证。 如果当前账号未绑定邮箱，请单击“去绑定”，可以快速地绑定邮箱，再继续开通KooMessage服务。 绑定邮箱后，需要3个工作日审核，请耐心等待。 图1 开通KooMessage服务 开通成功后进入控制台首页，且后续直接登录使用无需再开通。

创建模板 模板不能留有空帧。 短链前后都需加一个空格符号。 模板需包含文字，且不能为纯文字、纯图片、纯音频或纯视频。 根据运营商要求，模板需在0KB-1.9MB之间。 除签名外，内容中不能包含“【】”或“[]”符号。 免流、退订、取关、回退、关闭通知等贴尾信息由系统自动添加， 模板内不能含有贴尾字样。 主题中请勿输入【】或双引号，尽量避免使用特殊符号。 在“我的模板”页签，单击“新建模板”，进入到“创建模板”页面。可以单击“新建空白模板”，或选择其他9个不同的模板类型进行编辑。以下以“新建空白模板”为例。 在空白模板顶部输入框中，根据需要输入模板主题。 插入“文本”、“图片”、“音频”或“视频”。 最多可插入“文本”、“图片”、“音频”或“视频”的总数为8个。 单击页面左侧的“文本”按钮，单击“插入文本”，可以对模板进行文本插入。 在页面右侧，单击“插入参数”，可以在文本框内插入参数。 最多可插入12个参数。 需要几个参数，在此处插入几个参数，参数内容在发送信息时的手机号码Excel中进行设置。具体设置请参考：发送智能信息基础版中的说明内容。 单击文本框，左侧会出现操作栏： 单击文本框左侧，对文本内容进行位置调整； 单击文本框左侧，对文本框进行删除。 单击页面左侧的“图片”按钮，可以对模板进行图片插入。 在“公共”和“我的”列表中可以选择想要的图片。若没合适的图片，可在“我的”列，单击“网页提取”或“上传”，获取合适的图片。还可单击“批量操作”，对图片进行批量操作。 图片要求为： 最大文件大小2M 支持的格式：jpg/jpeg/png/gif 水平图像建议：1920*1080 垂直图像建议：962*1300 图片高度不应超过3000px 若为“网页提取”图片，则URL最大长度：1024个字符。 单击图片，在页面右侧会出现“编辑图片”，单击“从本地上传”可以从本地上传图片，单击“裁剪图片”，可对图片进行裁剪。 单击图片，左侧会出现操作栏： 单击图片左侧，对图片增加描述；再次单击图片左侧，对图片描述进行删除； 单击图片左侧，对增加的描述位置进行上下调整； 单击图片左侧，对图片位置进行调整； 单击图片左侧，对图片进行删除。 单击页面左侧的“音频”按钮，可以对模板进行音频插入。 在“公共”和“我的”列表中可以选择想要的音频。若没合适的音频，可在“我的”列，单击“从本地”，获取合适的音频。还可单击“批量操作”，对音频进行批量操作。 音频要求为： 最大文件大小2M 支持的格式：mp3/wav 文件名不能超过100个字符（包括扩展名） 单击音频，左侧会出现操作栏： 单击音频左侧，对音频增加描述；再次单击音频左侧，对音频描述进行删除； 单击音频左侧，对增加的描述位置进行上下调整； 单击音频左侧，对音频位置进行调整； 单击音频左侧，对音频进行删除。 单击页面左侧的“视频”按钮，可以对模板进行视频插入。 在“公共”和“我的”列表中可以选择想要的视频。若没合适的视频，可在“我的”列，单击“从本地上传视频”，获取合适的视频。还可单击“批量操作”，对视频进行批量操作。 视频要求为： 最大文件大小2M 支持的格式：mp4/3gp 视频长度建议不超过33秒 文件名不能超过100个字符（包括扩展名） 单击视频，在页面右侧会出现“编辑视频”，单击“上传本地视频”可以从本地上传视频；单击“裁切封面”，可以设置视频封面；单击“上传封面”，可以上传本地封面。 单击视频，左侧会出现操作栏： 单击视频左侧，对视频增加描述；再次单击视频左侧，对视频描述进行删除； 单击视频左侧，对增加的描述位置进行上下调整； 单击视频左侧，对视频位置进行调整； 单击视频左侧，对视频进行删除。 单击页面右上角的“预览”按钮，弹出“预览”框，在“预览”框处可查看“苹果”、“华为”、“小米”、“OPPO”或“vivo”的展示效果。 若创建模板出现问题，则会弹出“VMS自动检测”框，根据提示，单击“返回修改”，对创建的模板进行修改。 苹果机型不可显示详情页。 确认无误后，在“预览”框上单击“确定”。 单击页面右上角的“保存”按钮，可以对创建的个人模板进行保存。 单击页面右上角的“提交审核”按钮，输入“模版名称”、“ 有效期 (日)”并选择“签名”和“通道配置”，单击“确定”进行模板审核提交，完成模板创建。

认识KooMessage控制台 用户开通KooMessage服务后，进入KooMessage控制台，默认进入“总览”页面。 总览页面会显示： 购买套餐包：单击“购买套餐包”，进入购买页面，具体可参见购买KooMessage套餐包。 流程指引：显示智能信息、智能信息基础版、智能信息服务号等流程指引，根据需要，按照指引操作。 查看套餐包详情：页面显示各服务购买的套餐详情，可以查看套餐余量、可使用的套餐包信息等。更多信息请参考套餐包。 图1 总览 如果当前用户有正在使用的解析标识，会在页面顶部显示解析标识的使用信息，示例如图2，单击“查看详情”会跳转至“解析任务管理”页面。 图2 总览（解析标识）

查询模板 公共模板 方法一： 在页面右上角的选择框内，选择“模板名称”或“模板id”后，输入对应的内容进行筛选。 方法二： 根据“模板类型”进行筛选。 模板类型为：“全部”、“静态（不带参数）”和“动态（带参数）”。 鼠标移动到审核通过的模板上，会出现“发送信息”和“预览”这两个菜单，根据自己的需要进行选择。 选择“发送信息”，则可直接跳转到“发送信息”页面，然后根据3进行参数填写后，单击“发送”。 选择“预览”，弹出“预览模板”对话框，单击“发送信息”后跳转到“发送信息”页面，然后根据3进行参数填写后，单击“发送”。 我的模板 方法一： 在页面右上角的选择框内，选择“模板名称”或“模板id”后，输入对应的内容进行筛选。 方法二： 根据“模板类型”和“审核状态”进行筛选。 模板类型为：“全部”、“静态（不带参数）”和“动态（带参数）”。 审核状态为：“全部”、“审核中”、“已禁用”、“通过”、“审核不通过”、“已过期”和“草稿”。 仅显示过期6个月内模板，可进行复制、修改操作，重新进入审核流程。 鼠标移动到审核通过的模板上，会出现“发送信息”、“预览”、“复制”、和“删除”等菜单，根据自己的需要进行选择。 选择“发送信息”，则可直接跳转到“发送信息”页面，然后根据3进行参数填写后，单击“发送”。 选择“预览”，弹出“预览模板”对话框，单击“发送信息”后跳转到“发送信息”页面，然后根据3进行参数填写后，单击“发送”。 在“预览模板”对话框中可以查看“审核状态”，也可单击按钮，删除模板。 在“预览模板”对话框中可以查看“模板状态”，可以查看模板是否启用或禁用。 选择“复制”，可直接跳转到“创建模板”页面，复制此模板。 选择“删除”，弹出“删除模板确认提示”对话框，单击“确认”进行模板删除。 审核状态为“审核中”的模板，不能进行模板删除。

相关操作 服务号： 修改：在“服务号资料管理”界面的“服务号”页签，在“商家名称/ID”对应的“操作”列下，单击“修改”。 修改时，要写清楚修改原因，且不超过10个字符。 服务号冻结：在“服务号资料管理”界面的“服务号”页签，在“商家名称/ID”对应的“操作”列下，单击“服务号冻结”。 解冻：在“服务号资料管理”界面的“服务号”页签，在“商家名称/ID”对应的“操作”列下，单击“解冻”。 菜单： 预览：在“服务号资料管理”界面的“菜单”页签，在“商家名称/ID”对应的“操作”列，单击“预览”，弹出“预览”对话框。 修改：在“服务号资料管理”界面的“菜单”页签，在“商家名称/ID”对应的“操作”列，单击“修改”。 催审：在“服务号资料管理”界面的“菜单”页签，在“商家名称/ID”对应的“操作”列，单击“催审”。 主页： 预览：在“服务号资料管理”界面的“主页”页签，在“商家名称/ID”对应的“操作”列，单击“预览”，弹出“预览”对话框。 修改：在“服务号资料管理”界面的“主页”页签，在“商家名称/ID”对应的“操作”列，单击“修改”。 催审：在“服务号资料管理”界面的“主页”页签，在“商家名称/ID”对应的“操作”列，单击“催审”。

绑定通道号 通道号创建成功后，需要将服务号绑定通道号才可以正常使用。 在“通道号管理”界面，单击“通道号列表”，进入“通道号列表”界面。 在对应的“操作”列下单击“绑定”。 在“绑定”界面，配置信息请参考表1。 表1 通道号信息配置 参数 说明 商家名称 必填项。 系统自动显示。 服务号名称 必填项。 选择需要绑定的服务号的名称。 通道号 必填项。 系统自动显示。 通道号类型 必填项。 系统自动显示。 通道号签名 必选项。 选择通道号签名。 地区 必选项。 选择服务号的省份，可以精确至地级市。 单击“绑定”，完成服务号与通道号的绑定。

公共模板 系统内置各种模板文件可供参考和选择，可根据“模板类型”、“版式类型”、“模板行业”、“厂商名称”进行过滤筛选。鼠标移动到筛选后的模板上，会出现“发送信息”、“生成解析标识”、“测试发送”、“复制”和“预览”这五个菜单。 使用公共模板进行测试发送： 单击“测试发送”，弹出“测试发送”对话框，在对话框左侧“效果预览”处，可查看预览效果；在对话框右侧“发送对象”处，可选择“手动输入”或“文件上传”的方式填写需要的“手机号码”。 测试发送只支持发送10次。 若要直接使用公共模板发送信息： 方法一：将鼠标移动到筛选后的模板上，单击“发送信息”或“生成解析标识”，跳转到对应页面进行操作。 方法二：将鼠标移动到筛选后的模板上，单击“预览”，弹出“预览智能信息”对话框，单击“发送信息”或“生成解析标识”，跳转到对应页面进行操作。 在“预览智能信息模板”对话框上的“可用厂商”处，可查看哪些厂商模板审核是否通过。

操作步骤 参考获取云手机列表、为单台云手机安装应用在单台手机上安装应用最新的版本。 如果应用存在资源更新，请启动应用并完成资源文件的下载和更新。 参考生成应用版本tar包并推至OBS桶和推送应用tar包至服务器共享空间生成并推送tar包到服务器共享空间。 执行appctrl命令进行更新（参考appctrl命令）。 执行appctrl start 命令，云手机会安装该应用共享空间中最新版本并启动。 执行appctrl install命令，云手机会安装该应用共享空间中最新版本。 1. 当共享空间中某应用没有更新版本时，appctrl start和 appctrl install不会对已安装版本进行重复安装。 2. 对于采用共享方式安装的应用，如果启动应用后采用在线更新的方式更新资源，该更新后的资源会占用云手机的存储空间。因此当应用存在必要的在线更新时，建议提前对共享空间中的应用版本和在线资源进行更新。

升级AOSP版本 方法一（保留用户数据） 云手机重启接口支持切换AOSP镜像版本，同时保留用户数据，操作详情请参考重启云手机实例。 注意： 重启接口支持将低版本镜像升级成高版本，但不支持将高版本镜像降级为低版本。 如果您没有保留用户数据的强烈诉求，推荐您使用方法二切换AOSP版本，应用不兼容的风险更小。 方法二（不保留用户数据） 云手机重置接口支持切换AOSP镜像版本，操作详情请参考重置云手机实例。 注意： 重置接口支持将低版本镜像升级成高版本，也支持将高版本镜像回退为低版本。

KooMessage自定义策略样例 示例1：授权用户开通智能消息服务的所有权限 { "Version": "1.1", "Statement": [ { "Action": [ "KooMessage:*:*" ], "Effect": "Allow" } ]} 示例2：拒绝用户删除云服务 拒绝策略需要同时配合其他策略使用，否则没有实际作用。用户被授予的策略中，一个授权项的作用如果同时存在Allow和Deny，则遵循Deny优先。 如果您给用户授予KooMessage FullAccess的系统策略，但不希望用户拥有KooMessage FullAccess中定义的删除云服务权限，您可以创建一条拒绝删除云服务的自定义策略，然后同时将KooMessage FullAccess和拒绝策略授予用户，根据Deny优先原则，则用户可以对KooMessage执行除了删除云服务外的所有操作。拒绝策略示例如下： { "Version": "1.1", "Statement": [ { "Effect": "Deny", "Action": [ "kooMessage:devSendTask:create" ] } ]}

业务场景示例一 所有服务器需要预置公共文件，某些服务器需要预置特殊配置文件，处理不同业务。 例如：1.txt、2.txt为公共配置文件，需要预置到所有服务器的云手机中。同时需要预置特定配置文件a.txt，仅对服务器组A生效；特定配置文件b.txt，仅对服务器组B生效。 此时需将1.txt、2.txt打包，并以com.cph.config为包名推送到所有服务器； 将a.txt单独打包，并以com.cph.config.level1为包名推送到服务器组A的服务器； 将b.txt单独打包，并以com.cph.config.level1为包名推送到服务器组B的服务器； 如果需要更新1.txt、2.txt，则更新该文件后重新打包，并以com.cph.config为包名推送的服务器。 如果需要更新a.txt/b.txt，则更新该文件后重新打包，并以com.cph.config.level1为包名推送到对应服务器。