更新时间：2025-10-29 GMT+08:00
查询密钥对列表 - ListKeypairs
功能介绍
查询密钥对信息列表。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
GET /v1/os-keypairs
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
limit |
否 |
Integer |
查询返回keypair列表当前页面的数量。 取值范围：0~1000。 |
|
name |
否 |
String |
根据名称查询keypair列表。 |
|
offset |
否 |
Integer |
偏移量。 当前偏移量，默认为0。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
请求示例
GET https://{endpoint}/v1/os-keypairs
响应示例
状态码：200
OK
[ {
"name" : "KeyPair-3c5d",
"public_key" : "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCmXY7YzR4A8PFU6xHn2EHyqQOClpX6E1RU+eWNXZ2MJzQz8g/uH0C5JCozraM3WzISAnYGO7dgGRs+6jB+m8fA4gZi4SDobII2FrOUmf48UDYyqgFPUlCEHLbbEDp//DtR/d9hrjW7YRn0ppUhlbmYGuO6oWdGRXwXBbW1ieZaVIZA+pem/Hl4AmhrQVVBNqYL419ZNW235t7JDcgLa6ie6A0JKdYhsuKg7KyCEZt+5oc6LmS+aeDQP/zW3HUhE919Y9QQGhvx3lgXtQeCMn/0PbuBK+nzixL2+8Resz6g22n/SiAP8pnfpacJZysmHTF6Qikwmkpf/UU//SiZ0bIp Generated-by-Nova",
"fingerprint" : "SHA256:FXPuVsVDpXn9Ce3BJz4qVgMso4U+Ehn2GkioiFdSfsA",
"user_id" : "dc36c78ad96f42e394f3221bf7c17166"
} ]
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
错误码
请参见错误码。
父主题： 密钥对
