功能介绍
修改云服务器信息，目前支持修改云服务器名称及描述和ｈｏｓｔｎａｍｅ。
该接口支持企业项目细粒度权限的校验，具体细粒度请参见 ｅｃｓ：ｃｌｏｕｄＳｅｒｖｅｒｓ：ｕｐｄａｔｅＳｅｒｖｅｒ
接口约束
云服务器ｈｏｓｔｎａｍｅ修改后，需要重启云服务器后才会生效。
调试
您可以在ＡＰＩ Ｅｘｐｌｏｒｅｒ中调试该接口。
ＵＲＩ
ＰＵＴ ／ｖ１／｛ｐｒｏｊｅｃｔ＿ｉｄ｝／ｃｌｏｕｄｓｅｒｖｅｒｓ／｛ｓｅｒｖｅｒ＿ｉｄ｝
参数说明如表１所示。
表１ 参数说明
参数
是否必选
描述
ｐｒｏｊｅｃｔ＿ｉｄ
是
项目ＩＤ。
获取方法请参见获取项目ＩＤ。
ｓｅｒｖｅｒ＿ｉｄ
是
云服务器ＩＤ。
请求消息
请求参数如表２所示。
表２ 请求参数
参数
是否必选
参数类型
描述
ｓｅｒｖｅｒ
是
Ｏｂｊｅｃｔ
云服务器数据结构。
详情请参见表３。
表３ ｓｅｒｖｅｒ字段数据结构说明
参数
是否必选
参数类型
描述
ｎａｍｅ
否
Ｓｔｒｉｎｇ
修改后的云服务器名称。
只能由中文字符、英文字母、数字及“＿”、“－”、“．”组成，且长度为［１－１２８］个英文字符或［１－６４］个中文字符。
ｄｅｓｃｒｉｐｔｉｏｎ
否
Ｓｔｒｉｎｇ
对弹性云服务器的任意描述。
不能包含“＜”，“＞”，且长度范围为［０－８５］个字符。
ｈｏｓｔｎａｍｅ
否
Ｓｔｒｉｎｇ
修改云服务器的ｈｏｓｔｎａｍｅ。
命令规范：长度为 ［１－６４］ 个字符，允许使用点号（．）分隔字符成多段，每段允许使用大小写字母、数字或连字符（－），但不能连续使用点号（．）或连字符（－），不能以点号（．）或连字符（－）开头或结尾，不能出现（．－）和（－．）。
说明：
该字段已废弃，如需修改云服务器的ｈｏｓｔｎａｍｅ，请参考怎样使修改的静态主机名生效？。
ｕｓｅｒ＿ｄａｔａ
否
Ｓｔｒｉｎｇ
修改云服务器过程中待注入实例自定义数据。支持注入文本、文本文件。
说明：
ｕｓｅｒ＿ｄａｔａ的值为ｂａｓｅ６４编码之后的内容。
注入内容（编码之前的内容）更大长度为３２Ｋ。
更多关于待注入实例自定义数据的信息，请参见《弹性云服务器用户指南 》的“用户数据注入”章节。
示例：
ｂａｓｅ６４编码前：
Ｌｉｎｕｘ服务器：
＃！／ｂｉｎ／ｂａｓｈ
ｅｃｈｏ ｕｓｅｒ＿ｔｅｓｔ ＞ ／ｈｏｍｅ／ｕｓｅｒ．ｔｘｔ
Ｗｉｎｄｏｗｓ服务器：
ｒｅｍ ｃｍｄ
ｅｃｈｏ １１１ ＞ ｃ：＼ａａａ．ｔｘｔ
ｂａｓｅ６４编码后：
Ｌｉｎｕｘ服务器：
ＩｙＥｖＹｍｌｕＬ２Ｊｈｃ２ｇＫＺＷＮｏｂｙＢ１ｃ２ＶｙＸ３Ｒｌｃ３ＱｇＰｉＡｖａＧ９ｔＺＳ９１ｃ２ＶｙＬｎＲ４ｄＡ＝＝
Ｗｉｎｄｏｗｓ服务器：
ｃｍＶｔＩＧＮｔＺＡ０ＫＺＷＮｏｂｙＡｘＭＴＥｇＪｍｄ０ＯｙＢｊＯｌｘｈＹＷＥｕｄＨｈ０
响应消息
响应参数如表４所示。
表４ 响应参数
参数
参数类型
描述
ｓｅｒｖｅｒ
Ｏｂｊｅｃｔ
云服务器信息。
详情请参见表５。
表５ ｓｅｒｖｅｒ字段数据结构说明
参数
参数类型
描述
ｔｅｎａｎｔ＿ｉｄ
Ｓｔｒｉｎｇ
租户ＩＤ或项目ＩＤ。
ｉｍａｇｅ
Ｓｔｒｉｎｇ
镜像ＩＤ。
ａｃｃｅｓｓＩＰｖ４
Ｓｔｒｉｎｇ
预留属性。
ａｄｄｒｅｓｓｅｓ
Ｏｂｊｅｃｔ
云服务器属性网络信息。
属性为Ｍａｐ＜Ｓｔｒｉｎｇ， Ｏｂｊｅｃｔ＞结构。
网络详细信息请参见表６。
ｍｅｔａｄａｔａ
Ｏｂｊｅｃｔ
云服务器元数据。
ａｃｃｅｓｓＩＰｖ６
Ｓｔｒｉｎｇ
预留属性。
ｃｒｅａｔｅｄ
Ｓｔｒｉｎｇ
云服务器创建时间。时间格式例如：２０１９－０５－２２Ｔ０３：１９：１９Ｚ
ＯＳ－ＥＸＴ－ＳＲＶ－ＡＴＴＲ：ｕｓｅｒ＿ｄａｔａ
Ｓｔｒｉｎｇ
创建弹性云服务器时指定的ｕｓｅｒ＿ｄａｔａ（编码过后的信息）。
ｈｏｓｔＩｄ
Ｓｔｒｉｎｇ
云服务器对应的主机ＩＤ。
ｆｌａｖｏｒ
Ｏｂｊｅｃｔ
云服务器类型，详情请参见表７。
ＯＳ－ＤＣＦ：ｄｉｓｋＣｏｎｆｉｇ
Ｓｔｒｉｎｇ
扩展属性，磁盘配置方式。对镜像启动云服务器生效。
ｕｓｅｒ＿ｉｄ
Ｓｔｒｉｎｇ
云服务器所属用户ＩＤ。
ｎａｍｅ
Ｓｔｒｉｎｇ
修改后的云服务器名称。
ｐｒｏｇｒｅｓｓ
Ｉｎｔｅｇｅｒ
预留属性。
ｌｉｎｋｓ
Ａｒｒａｙ ｏｆ Ｏｂｊｅｃｔ
云服务器相关快捷链接信息，详情请参见表８。
ｉｄ
Ｓｔｒｉｎｇ
云服务器标识。
ｕｐｄａｔｅｄ
Ｓｔｒｉｎｇ
云服务器上一次更新时间。
时间格式例如：２０１９－０５－２２Ｔ０３：１９：１９Ｚ
ｌｏｃｋｅｄ
Ｂｏｏｌｅａｎ
当云服务器被锁时为Ｔｒｕｅ，否则为Ｆａｌｓｅ。
微版本２．９及以上版本支持。
ｄｅｓｃｒｉｐｔｉｏｎ
Ｓｔｒｉｎｇ
弹性云服务器的描述信息。
微版本２．１９及以上版本支持。
ｔａｇｓ
Ａｒｒａｙ ｏｆ ｓｔｒｉｎｇｓ
云服务器的标签列表。
微版本２．２６及以上版本支持，如果不使用微版本查询，响应中无ｔａｇｓ字段。
系统近期对标签功能进行了升级，升级后，返回的ｔａｇ值遵循如下规则：
ｋｅｙ与ｖａｌｕｅ使用“＝”连接，如“ｋｅｙ＝ｖａｌｕｅ”。
如果ｖａｌｕｅ为空字符串，则仅返回ｋｅｙ。
ｓｔａｔｕｓ
Ｓｔｒｉｎｇ
云服务器状态。
取值范围：
ＡＣＴＩＶＥ， ＢＵＩＬＤ，ＥＲＲＯＲ，ＨＡＲＤ＿ＲＥＢＯＯＴ，ＭＩＧＲＡＴＩＮＧ，ＲＥＢＯＯＴ，ＲＥＳＩＺＥ，ＲＥＶＥＲＴ＿ＲＥＳＩＺＥ，ＳＨＥＬＶＥＤ，ＳＨＥＬＶＥＤ＿ＯＦＦＬＯＡＤＥＤ，ＳＨＵＴＯＦＦ，ＵＮＫＮＯＷＮ，ＶＥＲＩＦＹ＿ＲＥＳＩＺＥ
弹性云服务器状态说明请参考云服务器状态
ＯＳ－ＥＸＴ－ＳＲＶ－ＡＴＴＲ：ｈｏｓｔｎａｍｅ
Ｓｔｒｉｎｇ
弹性云服务器的主机名。
表６ 弹性云服务器所属网络信息数据结构说明
参数
参数类型
描述
ａｄｄｒ
Ｓｔｒｉｎｇ
ＩＰ地址信息。
ｖｅｒｓｉｏｎ
Ｉｎｔｅｇｅｒ
ＩＰ地址类型，值为４或６。
４：ＩＰ地址类型是ＩＰｖ４
６：ＩＰ地址类型是ＩＰｖ６
表７ ｆｌａｖｏｒ字段数据结构说明
参数
参数类型
描述
ｉｄ
Ｓｔｒｉｎｇ
云服务器类型ＩＤ。
ｌｉｎｋｓ
Ａｒｒａｙ ｏｆ ｏｂｊｅｃｔｓ
云服务器类型相关快捷链接信息，详情请参见表８。
表８ ｌｉｎｋｓ字段数据结构说明
参数
参数类型
描述
ｒｅｌ
Ｓｔｒｉｎｇ
快捷链接标记名称。
ｈｒｅｆ
Ｓｔｒｉｎｇ
对应快捷链接。
请求示例
修改云服务器的名称为“ｎｅｗ－ｓｅｒｖｅｒ－ｔｅｓｔ”。
ＰＵＴ ｈｔｔｐｓ：／／｛ｅｎｄｐｏｉｎｔ｝／ｖ１／｛ｐｒｏｊｅｃｔ＿ｉｄ｝／ｃｌｏｕｄｓｅｒｖｅｒｓ／｛ｓｅｒｖｅｒ＿ｉｄ｝
｛
＂ｓｅｒｖｅｒ＂： ｛
＂ｎａｍｅ＂： ＂ｎｅｗ－ｓｅｒｖｅｒ－ｔｅｓｔ＂
｝
｝
响应示例
｛
＂ｓｅｒｖｅｒ＂： ｛
＂ｔｅｎａｎｔ＿ｉｄ＂： ＂６６ｃ８６０ｃｂ１３０ｂ４６５ｆｂａｆｃｄｅｅ４３ｆｂ０９ｃ６４＂，
＂ｉｍａｇｅ＂： ＂＂，
＂ａｃｃｅｓｓＩＰｖ４＂： ＂＂，
＂ａｄｄｒｅｓｓｅｓ＂： ｛
＂０１ｄ７ａｅｆ８－４４２ｂ－４０８ｅ－ｂ８２ｆ－１３ａｆｆｆ５１ｅ４ｅ４＂： ［
｛
＂ａｄｄｒ＂： ＂１９２．１６８．２６．２２＂，
＂ｖｅｒｓｉｏｎ＂： ４
｝
］
｝，
＂ｍｅｔａｄａｔａ＂： ｛
＂ｖｉｒｔｕａｌ＿ｅｎｖ＿ｔｙｐｅ＂： ＂ＦｕｓｉｏｎＣｏｍｐｕｔｅ＂
｝，
＂ｄｅｓｃｒｉｐｔｉｏｎ＂： ＂＂，
＂ａｃｃｅｓｓＩＰｖ６＂： ＂＂，
＂ｃｒｅａｔｅｄ＂： ＂２０１９－０４－２５Ｔ１１：５２：５３Ｚ＂，
＂ＯＳ－ＥＸＴ－ＳＲＶ－ＡＴＴＲ：ｕｓｅｒ＿ｄａｔａ＂： ＂＂，
＂ｈｏｓｔＩｄ＂： ＂５７ｄ２７８ｅ７ｃ５３ｄ０７ｃｄ３４ｆａｄ３ｂａ４ｆｄｃ９ｆ３ｄ７７９０１７ｄ０８７９７２６ｄ８３ｂ４５ａ２２ａ＂，
＂ＯＳ－ＥＸＴ－ＳＲＶ－ＡＴＴＲ：ｈｏｓｔｎａｍｅ＂： ＂ｎｅｗ－ｔｅｓｔ－ｈｏｓｔｎａｍｅ＂，
＂ｆｌａｖｏｒ＂： ｛
＂ｌｉｎｋｓ＂： ［
｛
＂ｒｅｌ＂： ＂ｂｏｏｋｍａｒｋ＂，
＂ｈｒｅｆ＂： ＂ｈｔｔｐｓ：／／Ｎｏｎｅ／６６ｃ８６０ｃｂ１３０ｂ４６５ｆｂａｆｃｄｅｅ４３ｆｂ０９ｃ６４／ｆｌａｖｏｒｓ／ｓ２．ｌａｒｇｅ．２＂
｝
］，
＂ｉｄ＂： ＂ｓ２．ｌａｒｇｅ．２＂
｝，
＂ＯＳ－ＤＣＦ：ｄｉｓｋＣｏｎｆｉｇ＂： ＂ＭＡＮＵＡＬ＂，
＂ｕｓｅｒ＿ｉｄ＂： ＂ｆ８８５８１ｄ５３ｂｅ６４７１６ａ９８５ｃ６６ｃａ２８ｃ７５ｆ６＂，
＂ｎａｍｅ＂： ＂ｎｅｗ－ｔｅｓｔ－ｈｏｓｔｎａｍｅ＂，
＂ｐｒｏｇｒｅｓｓ＂： ０，
＂ｌｉｎｋｓ＂： ［
｛
＂ｒｅｌ＂： ＂ｓｅｌｆ＂，
＂ｈｒｅｆ＂： ＂ｈｔｔｐｓ：／／Ｎｏｎｅ／ｖ２／６６ｃ８６０ｃｂ１３０ｂ４６５ｆｂａｆｃｄｅｅ４３ｆｂ０９ｃ６４／ｓｅｒｖｅｒｓ／２４９３０ｄｆ０－ｄｂ４ｃ－４ａ８ｂ－８９１４－ｄ０ｂｄ５５８５６４ｂ０＂
｝，
｛
＂ｒｅｌ＂： ＂ｂｏｏｋｍａｒｋ＂，
＂ｈｒｅｆ＂： ＂ｈｔｔｐｓ：／／Ｎｏｎｅ／６６ｃ８６０ｃｂ１３０ｂ４６５ｆｂａｆｃｄｅｅ４３ｆｂ０９ｃ６４／ｓｅｒｖｅｒｓ／２４９３０ｄｆ０－ｄｂ４ｃ－４ａ８ｂ－８９１４－ｄ０ｂｄ５５８５６４ｂ０＂
｝
］，
＂ｉｄ＂： ＂２４９３０ｄｆ０－ｄｂ４ｃ－４ａ８ｂ－８９１４－ｄ０ｂｄ５５８５６４ｂ０＂，
＂ｕｐｄａｔｅｄ＂： ＂２０１９－０４－２８Ｔ０８：１５：３６Ｚ＂，
＂ｓｔａｔｕｓ＂： ＂ＡＣＴＩＶＥ＂
｝
｝
返回值
请参考通用请求返回值。
错误码
请参考错误码。
华为云共建智能世界云底座[52] 华为公有云专属云主机DeH服务[51] 华为云场景化解决方案[49] 华为公有云产品[44] 华为云云主机[43] 华为云产品服务[43] 华为云服务器应用[43] 华为弹性云服务器[39] 华为公有云架构解决方案[38] 华为云提供的服务[37] 华为虚拟私有云vpc[37] 华为公有云介绍[32] 华为公有云提供哪些计算服务[30] 华为云漏洞扫描[27] 华为云软件开发服务[27] 华为公有云和私有云区别[27] 华为云域名注册[26] 华为云官网登陆[26] 华为公有云解决方案[26] 华为私有云产品有哪些[26] 华为私有云服务[25] 华为云数据库[23] 华为云安全[22] 华为公有云官网[22] 华为私有云的搭建方案[22] 华为云弹性云服务器应用[21] 华为公有云平台[20] 华为公有云行业解决方案[20] 华为私有云解决方案服务定制领导者[20] [19] 华为私有云服务器[19] 华为私有云网格结构[19] 华为公有云视讯解决方案[18] 华为云官网[17] 华为云速建站[17] 华为私有云架构[17] 华为云优势[16] 华为云服务器[16] 华为私有云部署架构[16] 华为云企业邮箱服务 (SAAS[15] 华为云邮箱[15] 华为公有云是什么[15] 华为公有云架构[15] 华为云迁移解决方案[14] 华为公有云解决方案服务定制领导者[14] 华为私有云解决方案[14] 云邮箱）[13] 华为云园区解决方案[13] 华为云服务总代理[13] 华为云速智能客服[13] 华为公有云服务[13] 华为私有云搭建方案[13] 云与计算咨询服务[12] 云与计算培训服务[11] 华为云备份[11] 华为云服务器配置[11] 华为云服务服务中心[11] 华为云服务核心分销商[11] 华为公有云[11] 华为私有云搭建[11] 云迁移与运营支撑服务[10] 公有云私有云混合云[10] 华为云服务器ECS[10] 华为云服务器成功案例[10] 华为云解决方案[10] 华为公有云通用解决方案[9] 华为智慧云课堂解决方案[9] 华为云数据解决方案[8] 华为云是什么[8] 华为私有云平台[8] 云与计算客户支持与运维使能服务[7] 华为云官网网站[7] 华为云智慧教育解决方案[7] 华为云智慧校园解决方案[7] 华为云桌面系统集成商[7] 华为云经销商[7] 华为代理公司有哪些[7] 华为私有云方案[7] 智慧教育云平台解决方案[7] 华为云服务器试用[6] 华为云网站建设服务器[6] 华为手机代理加盟[6] 华为私有云[6] 大数据使能服务[6] 智慧教育云计算解决方案[6] 华为云云主机 [5] 华为云智慧***解决方案[5] 华为云桌面总代理商[5] 云与计算客户支持服务[4] 华为云产品介绍[4] 华为云智慧制造解决方案[4] 华为云场景化解决方案[3] 华为公有云官网[3] 华为公有云通用解决方案[3] 华为弹性云服务器[3] 华为公有云产品 [3] 华为云产品服务[2] 华为云域名注册[2] 华为云数据库[2] 华为云智慧校园解决方案[2] 华为云服务器应用[2] 华为云服务器成功案例[2] 华为云软件开发服务[2] 华为公有云产品[2] 华为公有云介绍[2] 华为公有云和私有云区别[2] 华为公有云服务[2] 华为公有云架构[2] 华为公有云架构解决方案[2] 华为公有云视讯解决方案[2] 华为公有云解决方案[2] 华为私有云产品有哪些[2] 华为私有云服务[2] 华为私有云架构[2] 智慧教育云计算解决方案[2] 云规划设计与实施服务[2] 云邮箱[2] 华为云产品报价[2] 华为公有云通用解决方案 [2] 华为云服务器成功案例[1] 华为云桌面系统集成商[1] 云与计算客户支持与运维使能服务[1] 云迁移与运营支撑服务[1] 云迁移与运营支撑服务 [1] 华为云共建智能世界云底座[1] 华为云备份[1] 华为云安全[1] 华为云官网登陆[1] 华为云弹性云服务器应用[1] 华为云提供的服务[1] 华为云数据解决方案[1] 华为云智慧制造解决方案[1] 华为云服务器[1] 华为云服务核心分销商 [1] 华为云漏洞扫描[1] 华为云迁移解决方案 [1] 华为云速智能客服[1] 华为云邮箱[1] 华为公有云专属云主机DeH服务[1] 华为公有云是什么[1] 华为公有云行业解决方案[1] 华为私有云搭建[1] 华为私有云方案[1] 华为私有云服务.华为公有云专属云主机DeH服务.华为云产品报价[1] 华为私有云的搭建方案[1] 华为私有云网格结构[1] 华为私有云解决方案[1] 华为私有云部署架构[1] 为云产品服务[1] 云与计算咨询服务 [1] 云与计算客户支持与运维使能服务 [1] 云与计算客户支持与运维使能服务 云与计算客户支持服务[1] 华为云是什么 [1] 华为云软件开发服[1] 华为云速智能客服 [1] 华为代理加盟[1] 华为公有云架构解决方案 [1] 华为公有云解决方案服务定制领导者 [1] 华为弹性云[1] 华为弹性云服务器 华为云域名注册 华为云服务器应用[1] 华为私有云搭建 [1] 华为私有云搭建方案 [1] 华为私有云部署架构 [1] 大数据使能服务 [1] 撒[1]
