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

Xoá network port

DELETE/v2.0/ports/{port_id}

Xoá (gỡ) một network port theo ID. Các địa chỉ fixed IP gắn với port sẽ được trả lại pool cấp phát của subnet tương ứng.

Theo policy mặc định, bạn chỉ có thể xoá các port thuộc project của mình (trừ khi bạn có quyền admin). Một số port hệ thống hoặc service (ví dụ DHCP, router interface) có thể được policy bảo vệ.

Request​

Tham số path​

port_idstringbắt buộc

ID của port cần xoá.

Request mẫu​

curl -ks -X DELETE -H 'Content-Type: application/json' \
     -H 'X-Auth-Token: gAAAAA<...>' \
https://<node_IP_addr>:9696/v2.0/ports/2d74fa0c-3e43-4fd9-a234-cbb4996cc684

Response​

Nếu thành công, server không trả về nội dung body.

Mã trạng thái​

Thành công​

MãMô tả
204 - No ContentPort đã được xoá thành công.

Lỗi​

MãMô tả
401 - UnauthorizedCần xác thực trước khi gửi request.
403 - ForbiddenPolicy không cho phép user hiện tại thực hiện thao tác này.
404 - Not FoundKhông tìm thấy port được chỉ định.
412 - Precondition FailedServer không đáp ứng điều kiện tiên quyết của request.

Lưu ý​

  • Xoá port đang gắn với thiết bị (ví dụ instance hoặc router) có thể thất bại với lỗi conflict tuỳ policy của deployment. Hãy gỡ thiết bị trước nếu cần.
  • Sau khi xoá, các địa chỉ IP được giải phóng sẽ có thể cấp phát lại ngay trong subnet tương ứng.
  • Việc xoá các port thuộc service (DHCP, router interface, SNAT) thường cần quyền admin.

Xem thêm​