文档中心

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字符,必须包含大小写英文字符和数字,支持其他可见字符
  • 是否可缺省: 是

Response Elements(返回值)

RequestId

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

Return

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

Examples(例子)

在默认region,为一个实例修改实例名称

Sample Request(请求)
http://kec.api.ksyun.com/?Action=ModifyInstanceAttribute&Version=2016-03-04
&InstanceId=e007579f-bea2-483e-bfcb-fec760c58167
&InstanceName=testmodifyname
&AUTHPARAMS
Sample Response(返回)
<?xml version="1.0" encoding="UTF-8"?>
<ModifyInstanceAttributeResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
    <RequestId>91c2d855-df39-457d-9e62-dd01e8e5fc62</RequestId>
    <Return>true</Return>
</ModifyInstanceAttributeResponse>