更新云手机属性_云手机 CPH_API参考_云手机API_手机实例管理

（在说正事之前，我要推荐一个福利：你还在原价购买阿里云、腾讯云、华为云服务器吗？那太亏啦！来这里，新购、升级、续费都打折，能够为您省60%的钱呢！2核4G企业级云服务器低至69元/年，点击进去看看吧>>>)

功能介绍

接口名称
 UpdateCloudPhoneProperty
功能描述
 部分云手机属性开放更新能力，部分属性无法更新，部分属性需要重启手机生效，属性约束请参见云手机属性列表。如果手机处于异常状态，属性更新后需恢复手机状态为运行中才可生效。该接口为异步接口，可调用查询任务执行状态和查询任务执行状态列表查询任务执行结果。

URI

POST /v1/{project_id}/cloud-phone/phones/batch-update-property

参数说明请参见表1。

表1 参数说明
参数	是否必选	参数类型	描述
project_id	是	String	项目ID 获取方式请参见获取项目ID。

请求消息

请求参数

参数	是否必选	参数类型	描述
phones	是	Array of objects	云手机信息，详情请参见表2。

表2 phones数据结构说明
参数	是否必选	参数类型	描述
phone_id	是	String	云手机ID，不得超过32个字节。
property	是	jsonString	云手机属性列表，详细信息请参见云手机属性列表。

请求样例

POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/batch-update-property
{
    "phones": [
        {
            "phone_id": "a7f3a1c5258347d6b6f1def79e11f2bc", 
            "property": "{\"sys.prop.writephonenum\":\"13666666666\",\"sys.prop.writeimsi\":\"460021624617113,\"sys.prop.writewifissid\":\"test_wifi\",}" 
        },
        {
            "phone_id": "1678567b8bab40f93711234cb80d0764", 
            "property": "{\"sys.prop.writephonenum\":\"13666666666\",\"sys.prop.writeimsi\":\"460021624617113\",\"sys.prop.writewifissid\":\"test_wifi\",}" 
        }
    ]
}

响应消息

响应参数

参数	参数类型	描述
request_id	String	请求的唯一标识ID
jobs	Array of objects	任务信息，详情请参见表3。

表3 job结构体
参数	参数类型	描述
phone_id	String	云手机的唯一标识，云手机相关任务包含此字段。
job_id	String	任务的唯一标识
error_code	String	错误码，详情请参见错误码。
error_msg	String	错误说明

响应样例

{   
    "request_id": "6837531fd3f54550927b930180a706bf",
    "jobs": [
        {
             "phone_id": "1234567b8bab40ffb711234cb80d0234",
             "job_id": "1564567b8bab40f34711234cb80d0123"
        },
        {
             "phone_id": "1678567b8bab40f93711234cb80d0764",
             "error_code": "CPS.0004",
             "error_msg": "Parameter: phone_id is invalid."
        }
    ]
}

返回值

请参考返回值。

错误码

请参考错误码。