接口说明

查询ECS实例信息时，如果返回数据中包含{"OperationLocks": {"LockReason" : "security"}}，则禁止一切操作。

调用该接口完成以下操作时，您需要注意：

• 修改主机名（HostName）：重启实例后，修改生效，且必须是在ECS控制台重启（具体操作，请参见重启实例）或者调用RebootInstance重启，新主机名才能生效。在操作系统内部重启不保证能生效。
• 重置密码（Password）：
  • 实例状态不能为启动中（Starting）。
  • 重启实例后，重置生效，且必须是在ECS控制台重启（具体操作，请参见重启实例）或者调用RebootInstance重启，新密码才能生效。在操作系统内部重启不能生效。
• 修改自定义数据（UserData）：
  • 实例状态必须为已停止（Stopped）。
  • 实例必须满足自定义数据使用限制。更多信息，请参见生成实例自定义数据。
• 更换实例安全组（SecurityGroupIds.N）：

  • 支持切换安全组类型。

    当ECS实例跨类型切换安全组时，您需要充分了解两种安全组规则的配置区别，避免影响实例网络。

  • 不支持经典网络类型实例。

    其他注意事项请参见SecurityGroupIds.N的参数说明。

• 修改主网卡队列数（NetworkInterfaceQueueNumber）：
  • 实例必须为已停止（Stopped）状态。
  • 不能超过实例规格允许的单块网卡最大队列数。
  • 实例的所有网卡累加队列数不能超过实例规格允许的队列数总配额。实例规格的单块网卡最大队列数和总配额可以通过DescribeInstanceTypes查询MaximumQueueNumberPerEni、TotalEniQueueQuantity字段。
  • 当取值为-1时，将重置主网卡队列数为对应实例规格的默认值。实例规格的弹性网卡默认队列数可以通过DescribeInstanceTypes查询 PrimaryEniQueueNumber字段。

请求参数

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

返回数据

示例

请求示例

https://ecs.aliyuncs.com/?Action=ModifyInstanceAttribute
&InstanceId=i-bp67acfmxazb4ph****
&Action=ModifyInstanceAttribute
&CreditSpecification=Standard
&DeletionProtection=false
&Description=testInstanceDescription
&HostName=testHostName
&InstanceName=testInstanceName
&Password=Test123456
&SecurityGroupIds.1=sg-bp15ed6xe1yxeycg7o****
&SecurityGroupIds.2=sg-bp15ed6xe1yxeycg7p****
&SecurityGroupIds.3=sg-bp15ed6xe1yxeycg7q****
&<公共请求参数>

正常返回示例

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"
}

错误码

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