1. API Description

Domain name for API request: cvm.tencentcloudapi.com

This API (AssociateInstancesKeyPairs) is used to bind a key pair to an instance.

• When the public key of a key pair is written to the SSH configuration of the instance, you can log in to the instance through the private key of the key pair.
• If the instance has been bound with a key, the old key will become invalid.
• If the instance was originally logged in through a password, the password becomes unavailable after the key is bound to the instance.
• Batch operations are supported. A maximum of 100 instances are allowed in a batch for each request. If there is any instance that is unsupported for the operation in the batch of instances, an error code is returned.

A maximum of 10 requests can be initiated per second for this API.

Note: This API supports Finance regions. If the common parameter Region is a Finance region, a domain name with the Finance region needs to be specified, for example: cvm.ap-shanghai-fsi.tencentcloudapi.com

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

3. Output Parameters

4. Error Codes

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

5. Example

Example 1 Bind a key pair to a CVM

Input example

https://cvm.tencentcloudapi.com/?Action=AssociateInstancesKeyPairs
&InstanceIds.0=ins-1e4r6y8i
&InstanceIds.1=ins-3e56fg78
&KeyIds.0=skey-4e5ty7i8
&<Common request parameters>

Output example

{
  "Response": {
    "RequestId": "6ef60bec-0242-43af-bb20-270359fb54a7"
  }
}