调用ModifyInstanceAttribute修改一台ECS实例的部分信息,包括实例密码、名称、描述、主机名和自定义数据等。如果是t5突发性能实例,可以切换这台实例的性能突发模式。

接口说明

调用该接口时,您需要注意:

  • 实例状态为启动中Starting)时,无法重置实例密码。
  • 安全控制的ECS实例的OperationLocks不能标记为"LockReason" : "security"
  • 重置密码后,您需要在控制台重启实例或者调用API RebootInstance使更改生效,在实例内部重启将不会生效。
  • 实例状态为已停止Stopped)且满足实例自定义数据使用限制时,支持修改自定义数据。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
InstanceId String i-instance1

实例ID。

Action String ModifyInstanceAttribute

接口名称。对于您自行拼凑HTTP/HTTPS URL发起的API请求,Action为必选参数。取值:ModifyInstanceAttribute

CreditSpecification String Standard

修改t5突发性能实例的运行模式。取值范围:

默认值:无。

DeletionProtection Boolean false

实例释放保护属性,指定是否支持通过控制台或API(DeleteInstance)释放实例。

默认值:无。

说明 该属性仅适用于按量付费实例,且只能限制手动释放操作,对系统释放操作不生效。
Description String InstanceAttribute

实例描述。长度为2~256个英文或中文字符,不能以http://和https://开头。

默认值:无。

HostName String LocalHost

操作系统的计算机名。

  • 点号(.)和短横线(-)不能作为首尾字符,更不能连续使用。
  • Windows实例:字符长度为2~15,不支持点号(.),不能全是数字。允许大小写英文字母、数字和短横线(-)。
  • 其他类型实例(Linux 等):字符长度为2~64,支持多个点号(.),点之间为一段,每段允许大小写英文字母、数字和短横线(-)。
InstanceName String EcsInstance

实例名称。长度为2~128个英文或中文字符。必须以大小字母或中文开头,不能以http://和https://开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。

Password String EcsV587!

实例的密码。长度为8至30个字符,必须同时包含大小写英文字母、数字和特殊符号中的三类字符。特殊符号可以是:


()`~!@#$%^&*-_+=|{}[]:;'<>,.?/

其中,Windows实例不能以斜线号(/)为密码首字符。

说明 如果传入Password参数,建议您使用HTTPS协议发送请求,避免密码泄露。
Recyclable Boolean false

实例是否可以回收。

UserData String ZWNobyBoZWxsbyBlY3Mh

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

返回数据

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

示例

请求示例

https://ecs.aliyuncs.com/?Action=ModifyInstanceAttribute
/?InstanceId=i-instance1
&Action=ModifyInstanceAttribute
&CreditSpecification=Standard
&DeletionProtection=false
&Description=InstanceAttribute
&HostName=LocalHost
&InstanceName=EcsInstance
&Password=EcsV587!
&Recyclable=
&UserData=ZWNobyBoZWxsbyBlY3Mh
&<公共请求参数>

正常返回示例

XML 格式

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

JSON 格式

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

错误码

HttpCode 错误码 错误信息 描述
400 InvalidInstanceName.Malformed The specified parameter "InstanceName" is not valid. 指定的实例名称格式不合法。长度为2-128个字符,以英文字母或中文开头,可包含数字,".","_"或"-"。 不能以 http:// 和 https:// 开头。
400 InvalidDescription.Malformed The specified parameter "Description" is not valid. 指定的资源描述格式不合法。长度为2-256个字符,不能以 http:// 和 https:// 开头。
400 InvalidHostPassword.Malformed The specified parameter "Password" is not valid. 指定的实例密码格式不合法。
400 InvalidHostName.Malformed The specified parameter "HostName" is not valid. 指定的HostName格式不合法。
403 IncorrectInstanceStatus The current status of the resource does not support this operation. 该资源目前的状态不支持此操作。
403 InstanceLockedForSecurity The specified operation is denied as your instance is locked for security reasons. 实例被安全锁定,指定的操作无法完成。
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. 指定的实例不存在,请您检查实例ID是否正确。
404 InvalidSecurityGroupId.NotFound The specified SecurityGroupId does not exist. 指定的安全组在该用户账号下不存在,请您检查安全组id是否正确。
403 OperationDenied The instance amount in the specified SecurityGroup reach its limit. 指定安全组的实例数已达最大值。
403 OperationDenied The current status of the resource does not support this operation. 该资源状态不支持此类操作。
400 InvalidPassword.Malformed The specified parameter "Password" is not valid. 指定的 Password 参数不合法。
500 InternalError The request processing has failed due to some unknown error. 内部错误,请重试。如果多次尝试失败,请提交工单
403 InvalidUserData.Forbidden User not authorized to input the parameter "UserData"please apply for permission "UserData" 该用户无权输入 UserData。请先申请权限。
400 InvalidUserData.SizeExceeded The specified parameter "UserData" exceeds the size. 指定的 UserData 超过大小限制。
400 InvalidUserData.NotSupported TThe specified parameter "UserData" only support the vpc and IoOptimized Instance. 指定的 UserData 仅支持 VPC 和 I/O 优化型实例。
400 InvalidUserData.NotSupported The specified parameter "UserData" only support the vpc and IoOptimized Instance. 指定的 UserData 仅支持 VPC 和 I/O 优化型实例。
400 ImageNotSupportCloudInit The specified image does not support cloud-init. 指定的镜像不支持 cloud-init。
403 InvalidUserData.Base64FormatInvalid The specified UserData is not valid 指定的 UaseData 不合法。
400 ChargeTypeViolation Pay-As-You-Go instances do not support this operation. 按量付费实例不支持该操作,检查实例的付费类型是否与该操作冲突。
400 InvalidParameter.RecycleBin You do not have permission to set recyclable properties. 您未被授权执行该操作。
400 InvalidParameter.CreditSpecification The specified CreditSpecification is not supported in this region. 当前地域不支持指定的CreditSpecification。
400 InvalidInstanceStatus.CreditSpecRestricted The current status of the resource does not support this operation. 资源的当前状态不支持该操作。
400 InvalidInstanceStatus.NotRunning The current status of the resource is invalid, you can only do this operation when instance is running. 资源的当前状态无效。

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