修改云主机名称

接口说明

本接口用于修改云主机名称信息。
说明:

  1. 云主机没有正在执行的任务,并且状态为ACTIVE的实例才可以进行此操作。
  2. 云主机名称长度为5~63位,可包含数字、英文或“-”,“-”不能在名称的开头和末尾。

推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

URL

PUT https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/name

请求参数

Body

参数名称
类型
必填
描述
serverUpdateNameReq
云主机名称更新请求体
是

云主机名称更新请求体。

name
string
是

云主机名称。

serverId
string
是

云主机ID。

请求示例

PUT https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/name
{
	"name":"ECS-test123",
	"serverId":"42fe7627-bf4b-4d82-bed4-1ed8775155r3"
}

返回参数

返回码:200
OK
参数名称
类型
描述
errorCode
string

统一错误码。

errorMessage
string

页面国际化错误提示。

errorParams
<string> array

统一错误码的自定义参数。

requestId
string

每个请求的序列号。

state
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)

返回状态码。返回正常:OK,返回错误:ERROR,返回异常:EXCEPTION,需要告警实现的:ALARM,禁止访问:FORBIDDEN。

返回示例

返回码:200
OK
{
	"requestId":"reqId-fe765bede04706bc6f45e-407351b4-9",
	"state":"OK",
	"body":null
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。