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

Xoá SSH key pair

DELETE/v2.1/{project_id}/os-keypairs/{keypair_name}

Xoá key pair theo keypair_name. Thao tác này idempotent: xoá một key pair không tồn tại sẽ trả về 404 (Not Found). Khi thành công, API không trả về body.

Source

delete-keypair

Request​

Tham số​

project_idstringbắt buộcpath

UUID của project (tenant).

keypair_namestringbắt buộcpath

Tên key pair cần xoá.

user_idstringbody

User ID của chủ key pair (chỉ admin mới xoá được cho user khác). Mới trong phiên bản 2.10

Request mẫu​

curl -ks -X DELETE \
  -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/{project_id}/os-keypairs/apikey1

Thay {project_id} bằng UUID project thực tế và apikey1 bằng tên key pair bạn muốn xoá.

Response​

Xoá thành công không trả về body. Tuỳ microversion và backend, bạn có thể nhận 202 Accepted (bất đồng bộ) hoặc 204 No Content.

Mã trạng thái​

Thành công​

MãMô tả
202 - AcceptedRequest đã được nhận để xử lý (có thể bất đồng bộ).
204 - No ContentĐã xoá key pair thành công.

Lỗi​

MãMô tả
401 - UnauthorizedXác thực thất bại hoặc thiếu.
403 - ForbiddenPolicy không cho phép thao tác này.
404 - Not FoundKhông tìm thấy key pair.

Lưu ý và best practice​

  • Kiểm tra key pair không còn được script tự động hoặc template orchestration tham chiếu trước khi xoá.
  • Xoá key pair không ảnh hưởng tới các máy ảo đã được inject public key trước đó; nó chỉ ngăn việc gán key trong tương lai.

Liên quan​