绑定SSH密钥对 - AssociateKeypair

功能介绍

给指定的虚拟机绑定（替换或重置，替换需提供虚拟机已配置的SSH密钥对私钥；重置不需要提供虚拟机的SSH密钥对私钥）新的SSH密钥对。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

• 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
• 如果使用身份策略授权，需具备如下身份策略权限。

  授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
  kps:SSHKeyPair:bind	Write	SSHKeyPair *	-	kps:domainKeypairs:bind	ecs:cloudServers:createServers ecs:cloudServers:deleteServers ecs:cloudServers:showServer ecs:cloudServers:attach ecs:cloudServers:listServerBlockDevices ecs:cloudServers:showServerBlockDevice ecs:cloudServers:detachVolume ecs:cloudServers:listServerInterfaces ecs:cloudServers:listServersDetails ecs:cloudServerFlavors:get ecs:cloudServerQuotas:get evs:types:get evs:volumes:use ims:images:get vpc:subnets:list

URI

POST /v3/{project_id}/keypairs/associate

请求参数

响应参数

状态码：202

状态码：400

请求示例

• {
    "keypair_name" : "newkeypair1",
    "server" : {
      "id" : "d76baba7-ef09-40a2-87ff-3eafec0696e7",
      "auth" : {
        "type" : "keypair",
        "key" : "-----BEGINRSAPRIVATEKEY-----M..."
      }
    }
  }

• {
    "keypair_name" : "newkeypair2",
    "server" : {
      "id" : "d76baba7-ef09-40a2-87ff-3eafec0696e7"
    }
  }

响应示例

状态码：202

OK

{
  "task_id" : "aee8d2fe-5484-4753-9177-5a38dc15546c"
}

状态码：400

Error response

{
  "error_code" : "KPS.XXX",
  "error_msg" : "XXX"
}

状态码

错误码

请参见错误码。