ModifyInstanceVncPasswd

Last Updated: Jan 29, 2018

Description

Change the password of management terminal used to connect a specified ECS instance. When you call this interface, consider the following:

  • The password must be six characters in length, and can contain uppercase or lowercase English letters and digits. The password cannot contain special characters.

  • After you change the password:

    • For an I/O Optimized instances, the new password takes effect immediately.
    • For a non-I/O Optimized instances, you must restart the instance in the console or by calling API RebootInstance to make the change take effect.

Request parameters

Name Type Required Description
Action String Yes The name of this interface. Value: ModifyInstanceVncPasswd.
RegionId String Yes The region of the ECS instance. For more information, see Regions and zones.
InstanceId String Yes The ECS instance.
VncPassword String Yes The new password of management terminal used to connect the specified ECS instance.

Response parameters

All parameters are common response parameters. For more information, see Common parameters.

Examples

Request example

  1. https://ecs.aliyuncs.com/?Action=ModifyInstanceVncPasswd
  2. &DescribeInstanceVncUrl
  3. &InstanceId=AY121018033933eae8689
  4. &VncPassword=123456
  5. &<Common Request Parameters>

Response example

XML format

  1. <ModifyInstanceVncPasswdResponse>
  2. <RequestId>FDB6C963-9CE8-4B7F-BCA3-845F6BD29AFC</RequestId>
  3. </ModifyInstanceVncPasswdResponse>

JSON format

  1. {
  2. "RequestId": "FDB6C963-9CE8-4B7F-BCA3-845F6BD29AFC",
  3. }

Error codes

Error code Error message HTTP status code Meaning
IncorrectVncPassword.Malformed The specified parameter VncPassword is not valid. 400 The specified VncPassword is invalid, it must be six characters in length, and can only contain uppercase or lowercase English letters and digits.
IncorrectInstanceStatus The current status of the resource does not support this operation. 403 The specified instance must be in the Running status.
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 The specified ECS instance does not exist.
InvalidRegionId.NotFound The specified RegionId does not exist. 404 The specified RegionId does not exist.
Thank you! We've received your feedback.