全部产品
云服务器 ECS

AttachKeyPair

更新时间:2017-09-13 14:33:58   分享:   

描述

加载密钥对到实例。仅适用于 Linux 实例,Windows 实例不能执行 attach 操作。

如果原来是使用密码方式登录的,将关闭密码登录的方式。

如果实例已停止,加载的密钥对在实例启动后即可生效;如果实例正在运行中,加载的密钥对无需重启即可生效。

若实例已有密钥对,再次加载密钥对后,新的密钥对会替换原来的密钥对。

请求参数

名称 类型 是否必须 描述
Action String 操作接口名,系统规定参数,取值:AttachKeyPair。
RegionId String 密钥对所在的地域 ID。RegionId 的列表详见 地域列表
KeyPairName String 需要加载的密钥对名称。
InstanceIds String 需要加载密钥对的实例 ID 集合。
一个带有格式的 Json Array:[“instanceid1”,“instanceid2”, … “instanceidn”]。

返回参数

公共参数

错误代码

错误代码 描述 HTTP 状态码 语义
MissingParameter The input parameter “RegionId” that is mandatory for processing this request is not supplied. 400 缺少 RegionId 值(实际情况也可能是该用户无权使用此 Region)。RegionId 的列表详见 地域列表
DependencyViolation.WindowsInstance The instance creating is window, cannot use ssh key pair to login 403 Windows 实例不能使用 SSH 密钥对。
InvalidKeyPairName.NotFound The specified KeyPairName does not exist in our records. 404 指定的 KeyPairName 不存在。
InvalidRegionId.NotFound The specified RegionId does not exist. 404 指定的 RegionId 不存在。RegionId 的列表详见 地域列表

示例

请求示例

  1. https://ecs.aliyuncs.com/?action= AttachKeyPair
  2. &RegionId=cn-qingdao
  3. & InstanceId.1=xxxxxxx
  4. & KeyPairName=test
  5. &<公共请求参数>

返回示例

XML 格式

  1. < AttachKeyPairResponse>
  2. <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
  3. </ AttachKeyPairResponse>

JSON 格式

  1. {
  2. "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
  3. }
本文导读目录
本文导读目录
以上内容是否对您有帮助?