修改实例属性信息

最近更新时间: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
}

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

注册有礼