帮助与文档

搜索
  • 云服务器
  • 弹性IP
  • VPC
  • CDN
  • IAM

文档中心

云服务器(KEC)

金山云 > 文档中心 > 云服务器(KEC) > API文档 > 实例

修改实例属性信息

最近更新时间：2019-10-30 18:02:57

ModifyInstanceAttribute（修改实例属性信息）

修改指定实例的实例名称或者开机密码；一次调用只能修改一个实例属性；修改实例密码必须关机操作，且后台为异步操作，需要等待时间较长（大约7秒）。

Request Parameters（请求参数）

InstanceId

  • 待修改属性的实例ID
  • 类型: String
  • 有效值：标准UUID格式，形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
  • 是否可缺省: 否

InstanceName

  • 实例名称，修改实例名称不需要关闭实例
  • 类型: String
  • 有效值：最短2字符，最长64字符，支持中英文
  • 是否可缺省: 是

InstancePassword

  • 实例开机密码，修改实例开机密码需要关闭实例
  • 类型: String
  • 有效值：最短8字符，最长32字符，必须包含大小写英文字符和数字，支持其他可见字符
  • 是否可缺省: 是

HostName

  • 操作系统内部的计算机名
  • 类型：String
  • 有效值：字符长度为[2, 64]，不支持点号（.），每段允许字母（不限制大小写）、数字和短横线（-）组成
  • 是否可缺省: 是，重启后生效

Response Elements（返回值）

RequestId

  • 请求ID
  • 类型: String
  • 是否可缺省: 否

Return

  • 修改实例属性信息成功与否
  • 类型: String
  • 有效值：true（成功）| false（失败）
  • 是否可缺省: 否

Examples（例子）

在cn-beijing-6这个region，为一个实例修改实例名称

Sample Request(请求)
http://kec.cn-beijing-6.api.ksyun.com/?Action=ModifyInstanceAttribute&Version=2016-03-04
&InstanceId=e007579f-bea2-483e-bfcb-fec760c58167
&InstanceName=testmodifyname
Sample Response（返回）
{
   "RequestId":"7a6fa859-85e6-40ba-95d2-69deb5e43b6a",
   "Return":true
}

金山云，开启您的云计算之旅

免费注册