链接复制成功!
导入私钥
功能介绍
导入私钥到指定密钥对。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v3/{project_id}/keypairs/private-key/import
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
keypair |
是 |
ImportPrivateKeyKeypairBean object |
- |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
SSH密钥对的名称。 - 新创建的密钥对名称不能和已有密钥对的名称相同。 - SSH密钥对名称由英文字母、数字、下划线、中划线组成,长度不能超过64个字节 |
user_id |
否 |
String |
SSH密钥对所属的用户信息 |
key_protection |
是 |
ImportPrivateKeyProtection object |
SSH密钥对私钥托管与保护。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
private_key |
是 |
String |
导入SSH密钥对的私钥。 |
encryption |
是 |
Encryption object |
对私钥进行加密存储的方式。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
keypair |
ImportPrivateKeyKeypairBean object |
- |
参数 |
参数类型 |
描述 |
---|---|---|
name |
String |
SSH密钥对的名称。 - 新创建的密钥对名称不能和已有密钥对的名称相同。 - SSH密钥对名称由英文字母、数字、下划线、中划线组成,长度不能超过64个字节 |
user_id |
String |
SSH密钥对所属的用户信息 |
key_protection |
ImportPrivateKeyProtection object |
SSH密钥对私钥托管与保护。 |
参数 |
参数类型 |
描述 |
---|---|---|
private_key |
String |
导入SSH密钥对的私钥。 |
encryption |
Encryption object |
对私钥进行加密存储的方式。 |
参数 |
参数类型 |
描述 |
---|---|---|
type |
String |
取值范围:“kms”或“default”。
|
kms_key_name |
String |
kms密钥的名称。
|
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误描述 |
请求示例
{
"keypair" : {
"name" : "demo2",
"key_protection" : {
"private_key" : "-----BEGIN RSA PRIVATE KEY-----...",
"encryption" : {
"type" : "kms",
"kms_key_name" : "kps/default"
}
}
}
}
响应示例
状态码: 200
请求已成功
{
"keypair" : {
"name" : "demo2"
}
}
状态码: 400
Error response
{
"error_code" : "KPS.XXX",
"error_msg" : "XXX"
}
状态码
状态码 |
描述 |
---|---|
200 |
请求成功 |
400 |
Error response |
错误码
请参见错误码。