# 修改云手机

更新一台或多台云手机的配置。
- **前置条件**：云手机必须属于你的团队。地区、语言和坐标会按机型校验，规则与创建时一致。把云手机移入你没有权限的分组会被拒绝。
- **副作用**：覆盖云手机设置并刷新 GPS 配置；可能创建标签绑定。不扣费，不影响并发额度。
- **完成信号**：同步，相同请求体幂等。

Endpoint: POST /cloudphone/edit/batch
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (array, required)
    云手机 ID 列表

  - `envName` (string)
    云手机名称（不超过 64 字符）

  - `phoneNumber` (string)
    自定义手机号。格式要求：必须以 + 号开头，国家代码为 1-3 位数字（不含 86），总长度 8-14 位，且只能包含 + 与数字。

  - `powerOnBillingStrategy` (integer)
    非月付云手机的计费方式（0：默认，1：仅并行包）
    Enum: 0, 1

  - `proxyId` (string)
    代理 ID

  - `groupId` (string)
    环境分组 ID

  - `groupName` (string)
    已有分组名称；若没有匹配的分组，则按该名称新建。

  - `tags` (array)
    替换后的标签名称。空值会被忽略。

  - `envRemark` (string)
    环境备注（不超过 1500 字符，支持换行）

  - `automaticGeo` (boolean)
    自动匹配地理位置

  - `automaticLanguage` (boolean)
    自动匹配语言

  - `automaticLocation` (boolean)
    自动匹配位置（时区与国家）

  - `country` (string)
    国家

  - `timezone` (string)
    时区

  - `language` (string)
    语言

  - `latitude` (number)
    纬度

  - `longitude` (number)
    经度

  - `enableRoot` (boolean)
    开启全局 ROOT

## Response 200:

  - `200` (unknown)
    好的

## Response 200 fields (application/json):

  - `code` (integer, required)
    返回结果代码：0，正常；其他代码为例外情况。

  - `msg` (string | null, required)
    错误信息

  - `requestId` (string, required)
    操作请求 ID