ModifyInstanceAttribute

The operation that you want to perform. If you use a custom HTTP URL or HTTPS URL to make an API request, you must specify the Action parameter. Set the value to ModifyInstanceAttribute.

The ID of the instance.

The password of the instance. The password must be 8 to 30 characters in length and contain characters from at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters. Special characters include:

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

Passwords of Windows instances cannot start with a forward slash (/).

The hostname of the instance. After the hostname is modified, call the RebootInstance operation for the new hostname to take effect.

• Windows Server: The hostname must be 2 to 15 characters in length and can contain letters, digits, and hyphens (-). It cannot start or end with a hyphen (-), contain consecutive hyphens (-), or contain only digits.
• Other operating systems such as Linux: The hostname must be 2 to 64 characters in length. You can use periods (.) to separate a name into multiple segments. Each segment can contain letters, digits, and hyphens (-). However, the hostname cannot contain consecutive periods (.) or hyphens (-). It 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. It can contain letters, digits, colons (:), underscores (_), and hyphens (-). It must start with a letter but cannot start with http:// or https://.

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

This parameter is empty by default.

The user data of the instance, which must be encoded in Base64.

The size of your user data must be no greater than 16 KB before Base64 encoding. Because user data is imported in plaintext, we recommend that you do not contain confidential information such as passwords and private keys in the user data. If confidential information is required, we recommend that you encrypt it and encode it in Base64 before you import it. You can decrypt the information within your ECS instance in the same mode after the information is transmitted.

Specifies whether the instance can be recycled.

The running mode of the burstable instance. Valid values:

• Standard: the standard mode. For more information, see the "Standard mode" section in Burstable instances.
• Unlimited: the unlimited mode. For more information, see the "Unlimited mode" section in Burstable instances.

This parameter is empty by default.

The release protection property of the instance. It specifies whether you can use the ECS console or call the DeleteInstance operation to release the instance.

This parameter is empty by default.

The ID of replacement security group N.

• All security group IDs must be unique.
• The instance is removed from the current security group. If you want to retain the ECS instance in the current group, you must add the current security group ID to the list.
• You can switch the ECS instance to security groups of a different type. However, the security group list cannot contain both basic security groups and advanced security groups at the same time.
• The specified security group and instance must belong to the same VPC.
• The valid values of N are based on the maximum number of security groups to which an instance can belong. For more information, see the Security groups section in Limits.
• New security groups will become valid for corresponding instances after a short delay.