修改实例属性

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
kaopuyun all right reserved,powered by GitbookUpdated Time: 2024-10-09 06:22:14

results matching ""

    No results matching ""