通过阿里云CLI调用ModifyInstanceAttribute API修改一台ECS实例的信息。

背景信息

您可以调用ModifyInstanceAttribute接口修改一台ECS实例的部分信息,包括实例密码、名称、描述、主机名和自定义数据等。如果是突发性能实例,可以切换这台实例的性能突发模式。相关API文档详情请参见ModifyInstanceAttribute

通过阿里云CLI调用API时,不同数据类型的请求参数取值必须遵循格式要求,详情请参见参数格式说明

接口说明

安全控制的ECS实例的OperationLocks不能标记为"LockReason" : "security"

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

  • 重置密码(Password):
    • 实例状态不能为启动中Starting)。
    • 重置密码后,您需要在控制台重启实例或者调用RebootInstance使更改生效,在操作系统内部重启不会生效。
  • 修改自定义数据(UserData):
    • 实例状态必须为已停止Stopped
    • 实例必须满足自定义数据使用限制。详情请参见生成实例自定义数据
  • 更换实例安全组(SecurityGroupIds.N):
    • 支持切换安全组类型。

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

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

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

CLI请求示例

  1. 调用DescribeInstances API查询您需要修改信息的ECS实例ID。

    本示例中通过实例名称查询。

    aliyun ecs DescribeInstances --RegionId cn-hangzhou --InstanceName wpdemo --output cols=Instances.Instance[].InstanceId
    返回结果示例:
    Instances.Instance[].InstanceId
    -------------------------------
    [i-bp14a7xie8erwsvo****]
  2. 根据您的需求修改ECS实例。

    本示例中,修改ECS实例i-bp14a7xie8erwsvo****的实例名称、描述信息及操作系统的计算机名。

    aliyun ecs ModifyInstanceAttribute --InstanceId i-bp14a7xie8erwsvo**** --HostName newDemo --InstanceName newInsName --Description DescriptionDemo

执行结果

{
        "RequestId": "0363E731-19E2-4C94-9C5E-A1F3D6842B9D"
}