接口请求域名: cvm.tencentcloudapi.com 。
本接口 (AssociateInstancesKeyPairs) 用于将密钥绑定到实例上。
SSH
配置当中,用户就可以通过该密钥的私钥来登录实例。默认接口请求频率限制:10次/秒。
注意:本接口支持金融区地域。由于金融区和非金融区是隔离不互通的,因此当公共参数 Region 为金融区地域(例如 ap-shanghai-fsi)时,需要同时指定带金融区地域的域名,最好和 Region 的地域保持一致,例如:cvm.ap-shanghai-fsi.tencentcloudapi.com。
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
Action | 是 | String | 公共参数,本接口取值:AssociateInstancesKeyPairs。 |
Version | 是 | String | 公共参数,本接口取值:2017-03-12。 |
Region | 是 | String | 公共参数,详见产品支持的 地域列表。 |
InstanceIds.N | 是 | Array of String | 一个或多个待操作的实例ID,每次请求批量实例的上限为100。 可以通过以下方式获取可用的实例ID: InstanceId 获取实例ID。 |
KeyIds.N | 是 | Array of String | 一个或多个待操作的密钥对ID,每次请求批量密钥对的上限为100。密钥对ID形如:skey-3glfot13 。可以通过以下方式获取可用的密钥ID: KeyId 获取密钥对ID。 |
ForceStop | 否 | Boolean | 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机,然后再绑定密钥。取值范围: 默认取值:FALSE。 |
参数名称 | 类型 | 描述 |
---|---|---|
RequestId | String | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
GET https://cvm.tencentcloudapi.com/?Action=AssociateInstancesKeyPairs
&InstanceIds.0=ins-1e4r6y8i
&InstanceIds.1=ins-3e56fg78
&KeyIds.0=skey-4e5ty7i8
&<公共请求参数>
{
"Response": {
"RequestId": "6ef60bec-0242-43af-bb20-270359fb54a7"
}
}
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 描述 |
---|---|
InternalServerError | 操作内部错误。 |
InvalidInstance.NotSupported | 不被支持的实例。 |
InvalidInstanceId.Malformed | 无效实例ID 。指定的实例ID 格式错误。例如实例ID 长度错误ins-1122 。 |
InvalidInstanceId.NotFound | 没有找到相应实例。 |
InvalidKeyPairId.Malformed | 无效密钥对ID。指定的密钥对ID格式错误,例如 ID 长度错误skey-1122 。 |
InvalidKeyPairId.NotFound | 无效密钥对ID。指定的密钥对ID不存在。 |
InvalidParameterValue | 参数取值错误。 |
InvalidParameterValue.KeyPairNotSupported | 指定的密钥不支持当前操作。 |
InvalidParameterValue.LimitExceeded | 参数值数量超过限制。 |
MissingParameter | 缺少参数错误。 |
OperationDenied.InstanceOperationInProgress | 实例正在执行其他操作,请稍后再试。 |
UnauthorizedOperation.MFAExpired | 您无法进行当前操作,请确认多因子认证(MFA)是否失效。 |
UnauthorizedOperation.MFANotFound | 没有权限进行此操作,请确认是否存在多因子认证(MFA)。 |
UnsupportedOperation.InstanceOsWindows | 请求不支持操作系统为Xserver windows2012cndatacenterx86_64 的实例ins-xxxxxx 。 |
UnsupportedOperation.InstanceStateExitRescueMode | 请求不支持正在退出救援模式的实例 |
UnsupportedOperation.InstanceStateIsolating | 请求不支持正在隔离状态的实例。 |
UnsupportedOperation.InstanceStateRescueMode | 请求不支持救援模式的实例 |
UnsupportedOperation.InstanceStateRunning | 请求不支持开机状态的实例 |
UnsupportedOperation.InstanceStateShutdown | 请求不支持隔离状态的实例 |
UnsupportedOperation.InstanceStateStopping | 请求不支持正在关机的实例 |
UnsupportedOperation.StoppedModeStopCharging | 不支持关机不收费特性 |
排查思路 无法通过远程桌面连接裸金属服务器时,我们推荐您按照以下思路排查问题...
案例背景 高校健康打卡项目发起于北京大学软件与微电子学院,是该学院张齐勋老师...
注册了 域名 不备案可以吗?可以的。 注册域名 并不是一定要备案的,只有搭 建网...
3月24日,腾讯发布2020年Q4及全年财报,其中金融科技及企业服务第四季收入385亿...
客户简介 全民直播是一家涵盖游戏、娱乐、户外等多领域泛娱乐的直播平台。2015年...
公司介绍 我们公司是全球法律服务整合平台,已有的4万多名律师遍布全国359个城市...
??提到慕尼黑,大家第一个想到总是啤酒节,其实慕尼黑的文化同样闻名世界。慕尼...
云虚拟主机 可以干什么?云 虚拟主机 可以是搭 建网站 的重要产品,可用来存放网...
API风格说明 当前ECS服务对外开放两类风格的API: ECS服务自定义规范的API(以下...
客户简介 趣医网(quyiyuan.com)创立于2014年,为京颐集团重要成员企业之一,是...