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

接口说明

调用该接口时，您需要注意：

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

调试

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

请求参数

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

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

InstanceId String 是 i-bp67acfmxazb4ph***

实例ID。
Password String 否 EcsV587!

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


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

其中，Windows实例不能以斜线号（/）为密码首字符。

说明 如果传入Password参数，建议您使用HTTPS协议发送请求，避免密码泄露。
HostName String 否 LocalHost

操作系统的计算机名。

  • Windows Server系统：长度为2-15个字符，允许使用大小写字母、数字或连字符（-）。不能以连字符（-）开头或结尾，不能连续使用连字符（-），也不能仅使用数字。
  • 其他类型实例（Linux等）：长度为2-64个字符，允许使用点号（.）分隔字符成多段，每段允许使用大小写字母、数字或连字符（-），但不能连续使用点号（.）或连字符（-）。不能以点号（.）或连字符（-）开头或结尾。
InstanceName String 否 EcsInstance

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

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

默认值：无。
UserData String 否 ZWNobyBoZWxsbyBlY3Mh

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

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

实例是否可以回收。
CreditSpecification String 否 Standard

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

默认值：无。
DeletionProtection Boolean 否 false

实例释放保护属性，指定是否支持通过控制台或API（DeleteInstance）释放实例。

默认值：无。

说明 该属性仅适用于按量付费实例，且只能限制手动释放操作，对系统释放操作不生效。
SecurityGroupIds.N RepeatList 否 sg-bp15ed6xe1yxeycg7o***

将实例同时加入多个安全组。N的取值范围与实例能够加入安全组配额有关，更多详情，请参见安全组限制。

返回数据

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

请求ID。

示例

请求示例

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

正常返回示例

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. 该地区不支持指定的信贷规范。
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. 当前实例的状态不支持此操作，当实例状态为“running”时再进行此操作。
404 Credit.NotFound The specified credit information does not exist. 指定的信用信息不存在。
500 InternalError The request processing has failed due to some unknown error, exception or failure. 内部错误，请重试。如果多次尝试失败，请提交工单。
403 InvalidUser.Unauthorized The user is not authorized 您当前使用的账号无权限。
403 SecurityGroupInstanceLimitExceed %s 该安全组内已有的实例数量已达到最大限制。
403 InstanceNotInSecurityGroup The instance not in the group. 指定的实例不在安全组内。
403 InvalidOperation.InvalidRegion %s 指定的参数“RegionId”无效。

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