文档首页/ 密码安全中心 DEW/ API参考/ API/ 管理SSH密钥对/ 密钥对管理/ 查询SSH密钥对详细信息 - ListKeypairDetail
更新时间:2026-05-20 GMT+08:00
分享

查询SSH密钥对详细信息 - ListKeypairDetail

功能介绍

查询SSH密钥对详细信息

调用方法

请参见如何调用API

授权信息

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

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

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    kps:SSHKeyPair:get

    Read

    SSHKeyPair *

    -

    kps:domainKeypairs:get

    -

URI

GET /v3/{project_id}/keypairs/{keypair_name}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID。可参考获取项目ID获取。

约束限制:

不涉及

取值范围:

以IAM服务接口返回值为准,字符长度32-32

默认取值:

不涉及

keypair_name

String

参数解释:

密钥对名称

约束限制:

密钥对名称由英文字母、数字、下划线、中划线组成,长度不能超过255个字节

取值范围:

不涉及

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。通过调用IAM服务查询用户Token接口获取(响应消息头中X-Subject-Token的值)

约束限制:

不涉及

取值范围:

IAM服务查询用户Token接口为准

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

keypair

KeypairDetail object

参数解释:

密钥对详细信息

取值范围:

不涉及

表4 KeypairDetail

参数

参数类型

描述

name

String

参数解释:

密钥对名称由英文字母、数字、下划线、中划线组成,长度不能超过255个字节

取值范围:

不涉及

id

Long

参数解释:

密钥对ID

取值范围:

不涉及

type

String

参数解释:

密钥对类型

取值范围:

  • ssh

  • x509

scope

String

参数解释:

密钥对所属域,租户级或用户级

取值范围:

  • domain

  • user

public_key

String

参数解释:

SSH密钥对对应的公钥信息

取值范围:

不涉及

fingerprint

String

参数解释:

SSH密钥对应指纹信息

取值范围:

不涉及

is_key_protection

Boolean

参数解释:

是否托管密钥

取值范围:

true或false

deleted

Boolean

参数解释:

SH密钥对删除的标记

取值范围:

true或false

description

String

参数解释:

SSH密钥对的描述信息

取值范围:

不涉及

user_id

String

参数解释:

SSH密钥对所属的用户ID

取值范围:

不涉及

create_time

Long

参数解释:

SSH密钥对创建的时间,时间戳,即从1970年1月1日至该时间的总秒数

取值范围:

不涉及

delete_time

Long

参数解释:

SSH密钥对删除的时间,时间戳,即从1970年1月1日至该时间的总秒数

取值范围:

不涉及

update_time

Long

参数解释:

SSH密钥对的更新时间,时间戳,即从1970年1月1日至该时间的总秒数

取值范围:

不涉及

frozen_state

Integer

参数解释:

密钥冻结状态

取值范围:

  • 0:正常状态

  • 1:普通冻结

  • 2:公安冻结

  • 3:普通冻结及公安冻结

  • 4:违规冻结

  • 5:普通冻结及违规冻结

  • 6:公安冻结及违规冻结

  • 7:普通冻结、公安冻结及违规冻结

  • 8:未实名认证冻结

  • 9:普通冻结及未实名认证冻结

  • 10:公安冻结及未实名认证冻结

key_id

String

参数解释:

密钥ID

取值范围:

不涉及

algorithm

String

参数解释:

生成算法

取值范围:

不涉及

请求示例

响应示例

状态码:200

请求已成功

{
  "keypair" : {
    "name" : "1hprr3TI",
    "id" : 116248,
    "type" : "ssh",
    "scope" : "user",
    "public_key" : "ssh-rsa AAAGenerated-by-Nova",
    "fingerprint" : "65:ca:87:0a:16:86:59:ea:57:ea:18:37:58:e2:04:b0",
    "is_key_protection" : false,
    "deleted" : false,
    "description" : "12345",
    "user_id" : "6c2a33b1b8474d0dbac0a24297127525",
    "create_time" : 1581507580000,
    "delete_time" : null,
    "update_time" : null,
    "frozen_state" : 0
  }
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码

相关文档