调用 AttachKeyPair 绑定一个密钥对到一台或多台Linux实例。

请求说明

• 仅安装了密码插件的实例支持绑定密钥对，请先安装密码插件。
• 当前密钥对仅支持绑定 运行中 、 已停止 两种状态的实例。
• 如果您已通过控制台为实例绑定密钥对，本次新绑定的密钥对会覆盖已有密钥对，但对您手动在实例内部添加的密钥对无影响。
• 绑定密钥对后密码登录方式自动失效，即如果您的实例已设置密码登录，绑定密钥对后，将无法再使用密码方式登录。
• 绑定密钥对后需重启实例后，密钥对方可生效。

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

请求示例

GET /?Action=AttachKeyPair&Version=2020-04-01&KeyPairName=ssh_key_pair1&InstanceIds.1=i-ahipakt2gcg95jpv****&InstanceIds.2=i-ahipakt2gdg95lbe**** HTTP/1.1
Host: open.volcengineapi.com
Region: cn-beijing
Service: ecs

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202106111445100102252431000052****",
        "Action": "AttachKeyPair",
        "Version": "2020-04-01",
        "Service": "ecs",
        "Region": "cn-beijing"
    },
    "Result": {
        "OperationDetails": [
            {
                "InstanceId": "i-ahipakt2gcg95jpv****",
                "Error": null
            },
            {
                "InstanceId": "i-ahipakt2gdg95lbe****",
                "Error": {
                    "Code": "InvalidInstance.NotFound",
                    "Message": "The specified instance does not exist."
                }
            }
        ]
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。