修改实例属性
1. 接口描述
调用 ModifyInstanceAttribute 接口修改一台实例的部分信息,包括实例密码、名称等。
注意:修改实例属性时,实例状态必须是已启动(STARTED)或已关机(STOPPED)。
2. 请求参数
参数名 | 类型 | 是否必选 | 描述 |
---|---|---|---|
Action | String | 是 | 固定取值:ModifyInstanceAttribute |
InstanceUUID | String | 是 | 实例ID |
InstanceName | String | 否 | 实例名称,长度为2~128个英文或中文字符 |
Password | String | 否 | 实例密码,8-30个字符,必须同时包含大写字母、小写字母,以及数字和特殊符号 特殊字符可以是 ()`~!@#$*-+={}[]:;,.?/ |
3. 返回数据
参数名 | 类型 | 说明 |
---|---|---|
RequestId | String | 请求ID |
4. 示例
请求示例
https://openapi.kaopuyun.com/?SignatureVersion=1.0
&Action=ReleaseInstance
&Format=JSON
&InstanceUUID=ecs-3m0000gftg8m
&SignatureNonce=fad368fd-b5e3-476b-903b-2ef34e0e9fba
&Version=2014-05-26
&AccessKeyId=hfWkfqG6a794
&Signature=IcyHYfUBWSzJauAbDaqniNSNE94=
&SignatureMethod=HMAC-SHA1
&Timestamp=2023-02-25T15:29:21Z
&Password=12345678aA!
正常返回示例
{
"RequestId":"742fbe80-0ea9-11eb-9b36-0208cb7f7896"
}
5. 错误码
错误码 | 错误信息 |
---|---|
AvailableInstanceNotFound | 可用实例未找到 |
IncorrectInstanceStatus | 该实例目前的状态不支持此操作 |
InstanceModifyPasswordFail | 实例密码修改失败:xxx |
InstanceRenameFail | 实例修改名称失败:xxx |