功能介绍
修改云服务器信息，目前支持修改云服务器名称及描述。
调试
您可以在ＡＰＩ Ｅｘｐｌｏｒｅｒ中调试该接口。
ＵＲＩ
ＰＵＴ ／ｖ２．１／｛ｐｒｏｊｅｃｔ＿ｉｄ｝／ｓｅｒｖｅｒｓ／｛ｓｅｒｖｅｒ＿ｉｄ｝
参数说明请参见表１。
表１ 参数说明
参数
是否必选
描述
ｐｒｏｊｅｃｔ＿ｉｄ
是
项目ＩＤ。
获取方法请参见获取项目ＩＤ。
ｓｅｒｖｅｒ＿ｉｄ
是
云服务器ＩＤ。
请求消息
请求参数如表２所示。
表２ 请求参数
参数
是否必选
参数类型
描述
ｓｅｒｖｅｒ
是
Ｏｂｊｅｃｔ
云服务器数据结构，详情请参见表３
表３ ｓｅｒｖｅｒ字段数据结构说明
参数
是否必选
参数类型
描述
ｎａｍｅ
否
Ｓｔｒｉｎｇ
修改后的云服务器名称，字符长度范围为１－２５５。
ｄｅｓｃｒｉｐｔｉｏｎ
否
Ｓｔｒｉｎｇ
对弹性云服务器的任意描述，更大２５５字节。
微版本２．１９及以上版本支持。
响应消息
响应参数如表４所示。
表４ 响应参数
参数
参数类型
描述
ｓｅｒｖｅｒ
Ｏｂｊｅｃｔ
云服务器信息，详情请参见表５。
表５ ｓｅｒｖｅｒ字段数据结构说明
参数
参数类型
描述
ｔｅｎａｎｔ＿ｉｄ
Ｓｔｒｉｎｇ
租户ＩＤ或项目ＩＤ。
ｉｍａｇｅ
Ｓｔｒｉｎｇ
镜像ＩＤ。
ａｃｃｅｓｓＩＰｖ４
Ｓｔｒｉｎｇ
预留属性。
ａｄｄｒｅｓｓｅｓ
Ｏｂｊｅｃｔ
弹性云服务器所属网络信息。
属性为Ｍａｐ＜Ｓｔｒｉｎｇ， Ｏｂｊｅｃｔ＞结构。
网络详细信息请参见表６。
ｍｅｔａｄａｔａ
Ｏｂｊｅｃｔ
云服务器元数据。
ａｃｃｅｓｓＩＰｖ６
Ｓｔｒｉｎｇ
预留属性。
ｃｒｅａｔｅｄ
Ｓｔｒｉｎｇ
云服务器创建时间。时间格式例如：２０１９－０５－２２Ｔ０３：１９：１９Ｚ
ｈｏｓｔＩｄ
Ｓｔｒｉｎｇ
云服务器对应的主机ＩＤ。
ｆｌａｖｏｒ
Ｏｂｊｅｃｔ
云服务器类型，详情请参见表７。
ＯＳ－ＤＣＦ：ｄｉｓｋＣｏｎｆｉｇ
Ｓｔｒｉｎｇ
扩展属性，磁盘配置方式。对镜像启动云服务器生效。
ｕｓｅｒ＿ｉｄ
Ｓｔｒｉｎｇ
云服务器所属用户ＩＤ。
ｎａｍｅ
Ｓｔｒｉｎｇ
修改后的云服务器名称。
ｐｒｏｇｒｅｓｓ
Ｉｎｔｅｇｅｒ
预留属性。
ｌｉｎｋｓ
Ａｒｒａｙ ｏｆ Ｏｂｊｅｃｔ
云服务器相关快捷链接信息，详情请参见表８。
ｉｄ
Ｓｔｒｉｎｇ
云服务器标识。
ｕｐｄａｔｅｄ
Ｓｔｒｉｎｇ
云服务器上一次更新时间。
时间格式例如：２０１９－０５－２２Ｔ０３：１９：１９Ｚ
ｌｏｃｋｅｄ
Ｂｏｏｌｅａｎ
当云服务器被锁时为Ｔｒｕｅ，否则为Ｆａｌｓｅ。
微版本２．９及以上版本支持。
ｄｅｓｃｒｉｐｔｉｏｎ
Ｓｔｒｉｎｇ
弹性云服务器的描述信息。
微版本２．１９及以上版本支持。
ｔａｇｓ
Ａｒｒａｙ ｏｆ ｓｔｒｉｎｇｓ
云服务器的标签列表。
微版本２．２６及以上版本支持，如果不使用微版本查询，响应中无ｔａｇｓ字段。
系统近期对标签功能进行了升级，升级后，返回的ｔａｇ值遵循如下规则：
ｋｅｙ与ｖａｌｕｅ使用“＝”连接，如“ｋｅｙ＝ｖａｌｕｅ”。
如果ｖａｌｕｅ为空字符串，则仅返回ｋｅｙ。
ｋｅｙ与ｖａｌｕｅ使用“＝”连接，如“ｋｅｙ＝ｖａｌｕｅ”。
如果ｖａｌｕｅ为空字符串，则仅返回ｋｅｙ。
ｓｔａｔｕｓ
Ｓｔｒｉｎｇ
云服务器状态。
取值范围：
ＡＣＴＩＶＥ， ＢＵＩＬＤ，ＥＲＲＯＲ，ＨＡＲＤ＿ＲＥＢＯＯＴ，ＭＩＧＲＡＴＩＮＧ，ＲＥＢＯＯＴ，ＲＥＳＩＺＥ，ＲＥＶＥＲＴ＿ＲＥＳＩＺＥ，ＳＨＥＬＶＥＤ，ＳＨＥＬＶＥＤ＿ＯＦＦＬＯＡＤＥＤ，ＳＨＵＴＯＦＦ，ＵＮＫＮＯＷＮ，ＶＥＲＩＦＹ＿ＲＥＳＩＺＥ
弹性云服务器状态说明请参考云服务器状态
表６ 弹性云服务器所属网络信息数据结构说明
参数
参数类型
描述
ａｄｄｒ
Ｓｔｒｉｎｇ
ＩＰ地址信息。
ｖｅｒｓｉｏｎ
Ｉｎｔｅｇｅｒ
ＩＰ地址类型，值为４或６。
４：ＩＰ地址类型是ＩＰｖ４
６：ＩＰ地址类型是ＩＰｖ６
表７ ｆｌａｖｏｒ字段数据结构说明
参数
参数类型
描述
ｉｄ
Ｓｔｒｉｎｇ
云服务器类型ＩＤ。
微版本２．４７及以上版本不支持。
ｌｉｎｋｓ
Ａｒｒａｙ ｏｆ ｏｂｊｅｃｔｓ
云服务器类型相关快捷链接信息，详情请参见表８。
微版本２．４７及以上版本不支持。
ｖｃｐｕｓ
Ｉｎｔｅｇｅｒ
该云服务器规格对应的ＣＰＵ核数。
在微版本２．４７及以上版本支持。
ｒａｍ
Ｉｎｔｅｇｅｒ
该云服务器规格对应的内存大小，单位为ＭＢ。
在微版本２．４７及以上版本支持。
ｄｉｓｋ
Ｉｎｔｅｇｅｒ
该云服务器规格对应要求系统盘大小，０为不限制。
在微版本２．４７及以上版本支持。
ｅｐｈｅｍｅｒａｌ
Ｉｎｔｅｇｅｒ
未使用。
在微版本２．４７及以上版本支持。
ｓｗａｐ
Ｉｎｔｅｇｅｒ
未使用。
在微版本２．４７及以上版本支持。
ｏｒｉｇｉｎａｌ＿ｎａｍｅ
Ｓｔｒｉｎｇ
云服务器规格名称。
在微版本２．４７及以上版本支持。
ｅｘｔｒａ＿ｓｐｅｃｓ
Ｏｂｊｅｃｔ
ｆｌａｖｏｒ扩展字段请参考：ｏｓ＿ｅｘｔｒａ＿ｓｐｅｃｓ（ｆｌａｖｏｒ）字段数据结构说明
在微版本２．４７及以上版本支持。
表８ ｌｉｎｋｓ字段数据结构说明
参数
参数类型
描述
ｒｅｌ
Ｓｔｒｉｎｇ
快捷链接标记名称。
ｈｒｅｆ
Ｓｔｒｉｎｇ
对应快捷链接。
请求示例
修改指定云服务器的名称为“ｎｅｗ－ｓｅｒｖｅｒ－ｔｅｓｔ”。
ＰＵＴ ｈｔｔｐｓ：／／｛ｅｎｄｐｏｉｎｔ｝／ｖ２．１／｛ｐｒｏｊｅｃｔ＿ｉｄ｝／ｓｅｒｖｅｒｓ／｛ｓｅｒｖｅｒ＿ｉｄ｝
｛
＂ｓｅｒｖｅｒ＂： ｛
＂ｎａｍｅ＂： ＂ｎｅｗ－ｓｅｒｖｅｒ－ｔｅｓｔ＂
｝
｝
响应示例
｛
＂ｓｅｒｖｅｒ＂： ｛
＂ｔｅｎａｎｔ＿ｉｄ＂： ＂７９１０ａ６ｅ５０ｂ８０４０２ｂａ０２８ｃ８ｄ９６ｃ１ｂ３１ｆｅ＂，
＂ｉｍａｇｅ＂： ＂＂，
＂ａｃｃｅｓｓＩＰｖ４＂： ＂＂，
＂ａｄｄｒｅｓｓｅｓ＂： ｛
＂０３ｂｅ５ｃ１ｅ－ｅ０５ｄ－４９０５－ａ１０５－ｃ３ｂｄ９ｂ７３０ｂｄｃ＂： ［
｛
＂ａｄｄｒ＂： ＂１９２．１６８．０．７２＂，
＂ｖｅｒｓｉｏｎ＂： ４
｝
］
｝，
＂ｍｅｔａｄａｔａ＂： ｛｝，
＂ａｃｃｅｓｓＩＰｖ６＂： ＂＂，
＂ｃｒｅａｔｅｄ＂： ＂２０１８－０５－１７Ｔ０３：１５：４８Ｚ＂，
＂ｈｏｓｔＩｄ＂： ＂７ｄｃ８２ｆ６ｂ１ｄ４０６２００ｆｃ６３ｅ３９５ｃｆ４８２９ｃｂｆｆｃｂ４９ｄｅ０ｅ９ｃ７５ｃ５７７３ｆ２０１ｆ＂，
＂ｆｌａｖｏｒ＂： ｛
＂ｌｉｎｋｓ＂： ［
｛
＂ｒｅｌ＂： ＂ｂｏｏｋｍａｒｋ＂，
＂ｈｒｅｆ＂： ＂ｈｔｔｐｓ：／／Ｎｏｎｅ／７９１０ａ６ｅ５０ｂ８０４０２ｂａ０２８ｃ８ｄ９６ｃ１ｂ３１ｆｅ／ｆｌａｖｏｒｓ／ｃ３．１Ｕ１Ｇ＂
｝
］，
＂ｉｄ＂： ＂ｃ３．１Ｕ１Ｇ＂
｝，
＂ＯＳ－ＤＣＦ：ｄｉｓｋＣｏｎｆｉｇ＂： ＂ＭＡＮＵＡＬ＂，
＂ｕｓｅｒ＿ｉｄ＂： ＂ｄ６９８ａ７８５３２ｃａ４３０ｆ８ｄａｅｃ１８５８ｆ２ｂ５００ｅ＂，
＂ｎａｍｅ＂： ＂ｎｅｗ－ｓｅｒｖｅｒ－ｔｅｓｔ＂，
＂ｐｒｏｇｒｅｓｓ＂： ０，
＂ｌｉｎｋｓ＂： ［
｛
＂ｒｅｌ＂： ＂ｓｅｌｆ＂，
＂ｈｒｅｆ＂： ＂ｈｔｔｐｓ：／／Ｎｏｎｅ／ｖ２／７９１０ａ６ｅ５０ｂ８０４０２ｂａ０２８ｃ８ｄ９６ｃ１ｂ３１ｆｅ／ｓｅｒｖｅｒｓ／１ａ１９ｅｆ４ｆ－ｂｅ０ａ－４５２６－ｂｆ２ｆ－１４ｂ４４６４ｄ５３６ａ＂
｝，
｛
＂ｒｅｌ＂： ＂ｂｏｏｋｍａｒｋ＂，
＂ｈｒｅｆ＂： ＂ｈｔｔｐｓ：／／Ｎｏｎｅ／７９１０ａ６ｅ５０ｂ８０４０２ｂａ０２８ｃ８ｄ９６ｃ１ｂ３１ｆｅ／ｓｅｒｖｅｒｓ／１ａ１９ｅｆ４ｆ－ｂｅ０ａ－４５２６－ｂｆ２ｆ－１４ｂ４４６４ｄ５３６ａ＂
｝
］，
＂ｉｄ＂： ＂１ａ１９ｅｆ４ｆ－ｂｅ０ａ－４５２６－ｂｆ２ｆ－１４ｂ４４６４ｄ５３６ａ＂，
＂ｕｐｄａｔｅｄ＂： ＂２０１８－０５－２１Ｔ００：３６：２７Ｚ＂，
＂ｓｔａｔｕｓ＂： ＂ＡＣＴＩＶＥ＂
｝
｝
返回值
请参考通用请求返回值
华为云共建智能世界云底座[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]
