All Products
Document Center

Elastic Compute Service:ModifyInstanceVncPasswd

Last Updated:Apr 11, 2024

Modifies the Virtual Network Computing (VNC) password of an Elastic Compute Service (ECS) instance.

Operation description

  • The password must be six characters in length and can contain only uppercase letters, lowercase letters, and digits.

  • After you modify the VNC password of an instance, take note of the following items:

    • If the instance is I/O optimized, the new password takes effect immediately.
    • If the instance is not I/O optimized, you must restart the instance by using the ECS console or by calling the RebootInstance operation for the new password to take effect.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters


The ID of the instance.


The region ID of the instance. You can call the DescribeRegions operation to query the most recent region list.


The new VNC password of the instance.


Response parameters


The ID of the request.



Sample success responses


  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"

Error codes

HTTP status codeError codeError messageDescription
400IncorrectVncPassword.MalformedThe specified parameter VncPassword is not valid.The specified VNC password is invalid.
400IncorrectVncPassword.MalformedThe specified parameter VncPassword must be 6 characters, including uppercase characters, lowercase characters and numbers.-
403IncorrectInstanceStatusThe current status of the resource does not support this operation.The resource is in a state that does not support the current operation.
403InstanceNotReadyTemporarily unable to connect the specified instance,please try later.-
404InvalidInstanceId.NotFoundThe specified InstanceId does not exist.The specified instance does not exist.
404InvalidRegionId.NotFoundThe specified RegionId does not exist.The specified region ID does not exist.
404NoSuchResourceThe specified resource is not found.The specified resource does not exist.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history