Chuyển tới nội dung chính

Liệt kê SSH key pair

GET/v2.1/{project_id}/os-keypairs

Lấy tất cả key pair SSH (hoặc X.509) thuộc project đang xác thực. Mỗi phần tử trong kết quả được bọc trong một object keypair.

info

Nguồn: list-keypairs

Request​

Tham số​

project_idstringbắt buộcpath

UUID của project (tenant).

user_idstringquery

Dành cho admin: liệt kê key pair thuộc user ID được chỉ định. Mới trong phiên bản 2.10

limitintegerquery

Số item tối đa trả về. Dùng kèm marker để phân trang. Mới trong phiên bản 2.35

markerstringquery

ID (tên) của item cuối cùng đã thấy, dùng để phân trang. Mới trong phiên bản 2.35

Request mẫu​

Dùng curl​

curl -ks \
  -H 'Content-Type: application/json' \
  -H 'X-Auth-Token: gAAAAA<...>' \
  -H 'X-OpenStack-Nova-API-Version: 2.72' \
  https://api.vietnix.cloud:8774/v2.1/os-keypairs

HTTP request​

GET https://api.vietnix.cloud:8774/v2.1/f5d834d636c642c7bfe8af86139c6f26/os-keypairs

Response​

Trường trong response​

keypairsarraybắt buộc

Mảng các object bọc key pair. Mỗi phần tử chứa một object keypair.

keypairobjectbắt buộc

Object bọc key pair.

5 trường
namestringbắt buộc

Tên key pair, dùng để đọc (không trùng trong cùng user).

public_keystringbắt buộc

Nội dung public key.

fingerprintstringbắt buộc

Fingerprint MD5 của public key (hex, phân tách bằng dấu hai chấm).

typestringbắt buộc

Kiểu key. Giá trị hợp lệ: ssh hoặc x509. Mới trong phiên bản 2.2

created_atstringbắt buộc

Thời điểm tạo key pair (ISO 8601).

keypairs_linksarray

Link phân trang hoặc link liên quan (xuất hiện khi dùng phân trang). Mới trong phiên bản 2.35

Mã trạng thái​

Thành công​

MãMô tả
200 - OKRequest thành công.

Lỗi​

MãMô tả
401 - UnauthorizedCần xác thực hoặc xác thực thất bại.
403 - ForbiddenPolicy không cho phép user hiện tại thực hiện thao tác này.

Response mẫu​

Response body
{
    "keypairs": [
        {
            "keypair": {
                "name": "Docs Writter",
                "public_key": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIDAbqUDd3jvW3fA49sJWv5+iTQR8uPDCx3lt7Y6qcFT9 rumiaxolotl@gmail.com",
                "fingerprint": "07:8a:eb:63:6a:4b:b4:fd:be:c9:77:c2:58:da:84:fb",
                "created_at": "2025-09-03T09:50:28.194592"
            }
        }
    ]
}