更新时间：2026-03-27 GMT+08:00
修改云手机名称 - UpdatePhoneName
功能介绍
根据phoneId修改phoneName。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
PUT /v1/{project_id}/cloud-phone/phones/{phone_id}
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 项目id。 |
phone_id | 是 | String | 云手机id。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
phone_name | 是 | String | 云手机名称，必须为小写字母（a-z）、大写字母（A-Z）、数字（0-9）、中文字符、中划线-、下划线_，且不得超过60个字符。 |
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
request_id | String | 请求的唯一标识ID。 |
请求示例
修改云手机名称
PUT https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/1564567b8bab40f34711234cb80d8574
{
"phone_name" : "newName"
} 响应示例
状态码：200
OK
{
"request_id" : "135d898e69344a13925a0899e1a4ac53"
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
错误码
请参见错误码。
父主题：手机实例管理
