Gỡ interface của router

PUT/v2.0/routers/{router_id}/remove_router_interface

Xoá interface nội bộ theo ID được chỉ định khỏi virtual router (tháo subnet khỏi router). Nếu subnet ID được chỉ định là subnet cuối cùng trên port, port cũng bị xoá.

Bạn phải chỉ định subnet_id hoặc port_id trong request body để xác định interface router cần xoá. Bạn cũng có thể chỉ định cả hai. Nếu chỉ định cả hai, subnet_id phải trùng với subnet ID của địa chỉ IP đầu tiên trên port; nếu không, thao tác trả về 409 Conflict kèm chi tiết.

Nếu interface router bạn muốn xoá đang được một hoặc nhiều route sử dụng, thao tác trả về 409 Conflict. Hãy xoá các route đó khỏi router trước rồi thử lại.

Nếu router, subnet hoặc port không tồn tại hoặc không hiển thị, thao tác trả về 404 Not Found. Sau thao tác này, port kết nối router với subnet sẽ bị gỡ khỏi subnet của mạng nếu áp dụng.

info

Nguồn: remove-interface-from-router

Request

Tham số

router_idstringbắt buộcpath

ID của router.

subnet_idstringbody

ID của subnet. Phải chỉ định một trong subnet_id hoặc port_id.

port_idstringbody

ID của port. Phải chỉ định một trong subnet_id hoặc port_id.

Request mẫu

Dùng curl

curl -ks -X PUT -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' -d '{
    "subnet_id": "b367fdf4-d111-4c4c-b8c2-ea5d484ac0fb"
}' https://api.vietnix.cloud:9696/v2.0/routers/66fa6a3b-4b3a-485f-819d-c671765eb915/remove_router_interface/

HTTP request

PUT https://api.vietnix.cloud:9696/v2.0/routers/{router_id}/remove_router_interface
Content-Type: application/json
X-Auth-Token: gAAAAA<...>

{
    "subnet_id": "b367fdf4-d111-4c4c-b8c2-ea5d484ac0fb"
}

Response

Tham số response

idstringbắt buộc

ID của tài nguyên.

subnet_idstringbắt buộc

ID của subnet mà interface router thuộc về.

subnet_idsarraybắt buộc

Danh sách chứa ID subnet mà interface router thuộc về. Chỉ có một phần tử.

network_idstringbắt buộc

ID của mạng được gắn.

port_idstringbắt buộc

ID của port đại diện cho interface router.

project_idstringbắt buộc

ID của project.

tenant_idstringbắt buộc

ID của project.

tagsarraybắt buộc

Danh sách tag trên tài nguyên.

Response mẫu

Response body

{
    "id": "66fa6a3b-4b3a-485f-819d-c671765eb915",
    "tenant_id": "f33507157a634f1cac71e06a70fb558e",
    "port_id": "a60d084b-5bac-489c-b549-7e651b577e36",
    "network_id": "36a3666a-8ed4-48bf-9528-15f573c4a4f0",
    "subnet_id": "b367fdf4-d111-4c4c-b8c2-ea5d484ac0fb",
    "subnet_ids": [
        "b367fdf4-d111-4c4c-b8c2-ea5d484ac0fb"
    ]
}

Mã trạng thái

Thành công

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

Lỗi

Mã	Mô tả
400 - Bad Request	Nội dung request không hợp lệ.
401 - Unauthorized	Cần xác thực trước khi gửi request.
404 - Not Found	Không tìm thấy tài nguyên.
409 - Conflict	Thao tác xung đột với một thao tác khác trên tài nguyên.