接口说明

当您使用该接口时，需要注意：

• Windows实例不支持SSH密钥对。
• 绑定SSH密钥对后，将禁用用户名加密码的验证方式。
• 如果实例处于运行中（Running）状态，重启实例（RebootInstance）后，SSH密钥对生效。
• 如果实例处于已停止（Stopped）状态，启动实例（StartInstance）后，SSH密钥对生效。
• 如果实例已经绑定了SSH密钥对，新的SSH密钥对自动替换原来的SSH密钥对。

请求参数

返回数据

示例

请求示例

https://ecs.aliyuncs.com/?Action=AttachKeyPair
&InstanceIds=["i-bp1gtjxuuvwj17zr****", "i-bp17b7zrsbjwvmfy****", … "i-bp1h6jmbefj1ytos****"]
&KeyPairName=testKeyPairName
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML 格式

<AttachKeyPairResponse>
	  <TotalCount>2</TotalCount>
	  <RequestId>4ADF7A06-66BD-4FBF-A2ED-2364E41D8C06</RequestId>
	  <Results>
		    <Result>
			      <Message>successful</Message>
			      <InstanceId>i-m5eg7be9ndloji64****</InstanceId>
			      <Success>true</Success>
			      <Code>200</Code>
		    </Result>
		    <Result>
			      <Message>successful</Message>
			      <InstanceId>i-m5e25x2mwr0hk33d****</InstanceId>
			      <Success>true</Success>
			      <Code>200</Code>
		    </Result>
	  </Results>
	  <FailCount>0</FailCount>
</AttachKeyPairResponse>

JSON 格式

{
    "TotalCount": 2,
    "RequestId": "4ADF7A06-66BD-4FBF-A2ED-2364E41D8C06",
    "Results": {
        "Result": [
            {
                "Message": "successful",
                "InstanceId": "i-m5eg7be9ndloji64****",
                "Success": true,
                "Code": "200"
            },
            {
                "Message": "successful",
                "InstanceId": "i-m5e25x2mwr0hk33d****",
                "Success": true,
                "Code": "200"
            }
        ]
    },
    "FailCount": 0
}

错误码

访问错误中心查看更多错误码。