Tenant Cloud Compute Cloud Virtual Machine Key APIs DisassociateInstancesKeyPairs

DisassociateInstancesKeyPairs

Last Updated At: 2026-08-02 00:05:21

1. Interface Description

Interface request domain name: cvm.api3.convergecloud.com.

This API (DisassociateInstancesKeyPairs) is used to disassociate a key from an instance.

  • Only instances in the STOPPED state in the Linux operating system are supported.
  • After dissociating the key, you can log in to the instance with the previously set password.
  • If no password was previously set, you cannot log in via an SSH key after dissociation. You can call the API ResetInstancesPassword to set a login password.
  • Batch operations are supported. A maximum of 100 batch instances per request are allowed. If there are instances in the batch that are not allowed to be operated, operations will be returned with a specific error code.

Default interface request rate limit: 10 times per second.

Interface update time: 2022-10-28 03:52:02.

The interface only verifies the signature but does not authenticate.

2. Input Parameters

The following list of request parameters only lists interface request parameters and some public parameters, For a complete list of public parameters see public request parameters.

Parameter name Required Allow NULL Type Description
Action Yes No String Public parameter, The value of this interface: DisassociateInstancesKeyPairs
Version Yes No String Public parameter, The value of this interface: 2017-03-12
Region No No String Public parameter,Regional information A list of supported geographies is available through the DescribeRegions interface
InstanceIds Yes No Array of String One or more instance IDs to be operated. A maximum of 100 batch instances per request are allowed.

You can obtain an available instance ID in the following ways:
  • By querying the instance ID by logging in to the Console.
  • Obtain the key pair ID by calling the InstanceId in the returned information from the API DescribeInstances.
    Example: ["ins-w34e5rl9"]
    		•
    KeyIds Yes No Array of String List of key pair IDs. A maximum of 100 batch key pairs per request are allowed. The key pair ID is in the format of skey-11112222.

    You can obtain the available key pair ID in the following ways:
  • By querying the key ID by logging in to the Console.
  • By calling the KeyId in the returned information from the API DescribeKeyPairs.
    Example: ["skey-e3r6y7ji"]
    		•
    ForceStop No No Bool Whether to perform forced shutdown on the running instance. It is recommended to perform manual shutdown on the running instance first, and then reset the user password. Value Range:
  • TRUE: Indicates forced shutdown performed after normal shutdown fails.
  • FALSE: Indicates no forced shutdown performed after normal shutdown fails.

    Default value: FALSE.
    Example: true
    		•

    3. Output Parameters

    Parameter name Type Description
    TaskId String Task ID
    Example: 432322
    flowId Int64 Task Flow ID
    Example: 2
    RequestId String Unique request id, Each request will return. The RequestId of the request needs to be provided when locating the problem.

    4. Error Code

    The following lists only the error codes related to the interface business logic, For other error codes, see public ErrorCode.

    Error Code Description
    InvalidInstanceId.NotFound No corresponding instance was found.
    InvalidInstance.NotSupported Unsupported instance.
    InvalidParameterValue Invalid parameter value. The format of the parameter value is incorrect or not supported, etc.
    InvalidKeyPairId.Malformed Invalid key pair ID. The format of the specified key pair ID is incorrect, for example, an ID length error skey-1122.
    InternalServerError Internal operation error.
    InvalidParameterValue.LimitExceeded The parameter value is out of range
    InvalidInstanceId.Malformed Invalid Instance ID. The format of the specified instance ID is incorrect, for example, an instance ID length error ins-1122.
    InvalidKeyPairId.NotFound Invalid key pair ID. The specified key pair ID does not exist.
    MissingParameter Parameters are missing. The request did not include mandatory parameters.