调用ModifyInstanceAttribute修改一台实例的部分信息，包括实例密码、名称。

说明
  • 实例状态为启动中（Starting）时，无法重置实例密码。
  • 实例状态为运行中（Running）时，无法修改实例密码。
  • 重置密码后，您需要在控制台重启实例或者调用RebootInstance接口使更改生效，在实例内部重启将不会生效。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ModifyInstanceAttribute

系统规定参数。取值：ModifyInstanceAttribute。
InstanceId String 是 i-instanc****

要修改实例的ID，仅支持修改单个。
Password String 否 yourPassword

实例的密码。
InstanceName String 否 i-instanceidname

实例的名称。

长度为2~128个英文或中文字符。必须以大小字母或中文开头，不能以http://和https://开头。可以包含数字、冒号（:）、下划线（_）或者连接号（-）。
HostName String 否 testHostName

云服务器的主机名。 长度为2-64个字符，允许使用半角句号（.）分隔字符成多段，每段允许使用大小写字母、数字或连字符（-），但不能连续使用半角句号（.）或短划线（-）。不能以半角句号（.）或短划线（-）开头或结尾。
UserData String 否 /9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgK****

实例自定义数据，需要以Base64编码。

编码前，原始数据不能超过16 KB。建议不要明文传入敏感信息，例如密码和私钥等。如果必须传入敏感信息，建议您加密后再以Base64编码传入，在实例内部以同样的方式解密。

返回数据

名称 类型 示例值 描述
Code Integer 200

业务返回码，成功返回0。
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

示例

请求示例

http(s)://ens.aliyuncs.com/?Action=ModifyInstanceAttribute
&InstanceId=i-instanc****
&Password=yourPassword
&InstanceName=i-instanceidname
&HostName=testHostName
&UserData=/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgK****
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyInstanceAttributeResponse>
   <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</ModifyInstanceAttributeResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

错误码

HttpCode 错误码 错误信息 描述
400 NoPermission Permission denied. 没有足够的权限，请联系云账号管理员授予您相应权限。

访问错误中心查看更多错误码。