Elastic Compute Service:ModifyInstanceAttribute

The instance ID.

The password of the instance. The password must be 8 to 30 characters in length and contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters. Special characters include ( ) ` ~ ! @ # $ % ^ & * - _ + = | { } [ ] : ; ' < > , . ? / The password of a Windows instance cannot start with a forward slash (/). Take note of the following items:

• The instance cannot be in the Starting (Starting) state.
• The parameter takes effect after the instance is restarted. You can restart an instance in the ECS console. For more information, see Restart an instance. You can also call the RebootInstance operation to restart the instance. The parameter cannot take effect if you restart an instance within the operating system.

The hostname of the instance. Take note of the following items:

• The instance cannot be in the Creating (Pending) or Starting (Starting) state. Otherwise, the new hostname and the configurations in the /etc/hosts file may not take effect. You can call the DescribeInstances operation to query the status of the instance.
• The parameter takes effect after the instance is restarted. You can restart an instance in the ECS console. For more information, see Restart an instance. You can also call the RebootInstance operation to restart the instance. The parameter cannot take effect if you restart an instance within the operating system.

The following limits apply to the hostnames of instances that run different operating systems:

• For Windows Server, the hostname must be 2 to 15 characters in length and can contain letters, digits, and hyphens (-). The hostname cannot start or end with a hyphen (-), contain consecutive hyphens (-), or contain only digits.
• For other operating systems such as Linux, the hostname must be 2 to 64 characters in length. You can use periods (.) to separate a hostname into multiple segments. Each segment can contain letters, digits, and hyphens (-). The hostname cannot contain consecutive periods (.) or hyphens (-). The hostname cannot start or end with a period (.) or a hyphen (-).

The name of the instance. The name must be 2 to 128 characters in length. The name must start with a letter and cannot start with http:// or https://. The name can contain letters, digits, colons (:), underscores (_), and hyphens (-).

The description of the instance. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

The user data of the instance. We recommend that you encode the data in Base64. Take note of the following items:

• The instance must meet the limits for user data. For more information, see Initialize an instance by using instance user data.
• After you restart the instance, the new user data is displayed but not run as scripts.

The performance mode of the burstable instance. Valid values:

• Standard
• Unlimited

For more information about the performance modes of burstable instances, see Overview .

The release protection attribute of the instance. This parameter specifies whether you can use the ECS console or call the DeleteInstance operation to release the instance.

The number of queues supported by the primary elastic network interface (ENI) of the instance. Take note of the following items:

• The instance must be in the Stopped (Stopped) state.
• The number of queues supported by an ENI cannot exceed the maximum number of queues that the instance type allows for each ENI. The total number of queues on all ENIs on the instance cannot exceed the queue quota that the instance type supports. To query the maximum number of queues that an instance type allows for each ENI and the queue quota for the instance type, call the DescribeInstanceTypes operation.
• If you set this parameter to -1, the value is reset to the default value for the instance type. To query the default number of queues of an ENI of each instance type, call the DescribeInstanceTypes operation.

The IDs of the new security groups to which to assign the instance. Take note of the following items:

• The security group IDs in the array cannot be duplicate. The length of the array is related to the quota of security groups to which the instance can be assigned. For more information, see the Security group limits section in the "Limits and quotas" topic.
• The instance is moved from the current security groups to the replacement security groups. If you want the instance to remain in the current security groups, add the IDs of the current security groups to the array.
• You can move the instance to security groups of a different type. However, the array cannot contain the IDs of both basic and advanced security groups.
• The security groups and the instance must belong to the same VPC.
• Security groups of instances in the classic network cannot be changed.

Specifies whether to enable the Jumbo Frames feature for the instance. Valid values:

• true: The Jumbo Frame feature is enabled for the instance.
• false: The Jumbo Frame feature is disabled for the instance.

Take note of the following items:

• The instance must be in the Running (Running) or Stopped (Stopped) state.
• The instance must reside in a VPC.
• After the Jumbo Frames feature is enabled, the MTU value of the instance is set to 8500. After the Jumbo Frames feature is disabled, the MTU value of the instance is set to 1500. You can enable the Jumbo Frames feature only for specific instance types. For more information, see Jumbo Frames.

The CPU topology type of the instance. Valid values:

• ContinuousCoreToHTMapping: The Hyper-Threading (HT) technology allows continuous threads to run on the same core in the CPU topology of the instance.
• DiscreteCoreToHTMapping: The HT technology allows discrete threads to run on the same core.

This parameter is left empty by default.

Take note of the following items:

• The instance must be in the Stopped (Stopped) state.