Gắn interface vào virtual router
/v2.0/routers/{router_id}/add_router_interfaceThêm interface nội bộ vào virtual router bằng cách gắn một subnet hoặc port được chỉ định.
- Nếu bạn chỉ định subnet, IP gateway của subnet được dùng làm IP interface theo mặc định. Bạn có thể truyền IP tuỳ chỉnh trong subnet qua
ip_address. - Nếu bạn chỉ định port, fixed IP của port được dùng làm IP interface.
- Chỉ được cung cấp một trong hai:
subnet_idhoặcport_id.
Khi chỉ định subnet IPv6, subnet được thêm vào port nội bộ có sẵn trên cùng mạng, hoặc tạo port mới nếu chưa có. Một port có thể có nhiều subnet IPv6 dùng chung mạng, nhưng chỉ cho phép một subnet IPv4 trên mỗi port.
Nguồn: add-interface-to-router
Request
Tham số
router_idstringbắt buộcpathID của router.
subnet_idstringbodyID của subnet. Phải chỉ định một trong subnet_id hoặc port_id.
port_idstringbodyID của port. Phải chỉ định một trong subnet_id hoặc port_id.
ip_addressstringbodyĐịa chỉ IP tuỳ chỉnh trong subnet dùng cho interface của router. Chỉ hợp lệ khi chỉ định subnet_id.
Request mẫu
Dùng curl
curl -ks -X PUT -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' -d '{
"subnet_id": "86c2b30c-8ee2-4a0c-828f-c7218dfa522c"
}' https://api.vietnix.cloud:9696/v2.0/routers/02542148-44cb-470d-a551-58f370c47b83/add_router_interface
HTTP request
PUT https://api.vietnix.cloud:9696/v2.0/routers/02542148-44cb-470d-a551-58f370c47b83/add_router_interface
Content-Type: application/json
X-Auth-Token: gAAAAA<...>
{
"subnet_id": "86c2b30c-8ee2-4a0c-828f-c7218dfa522c",
}
Response
Tham số response
idstringbắt buộcID của router.
subnet_idstringbắt buộcID của subnet mà interface router thuộc về.
subnet_idsarraybắt buộcDanh sách chứa ID subnet mà interface router thuộc về. Chỉ có một phần tử.
network_idstringbắt buộcID của mạng được gắn.
port_idstringbắt buộcID của port đại diện cho interface router.
project_idstringbắt buộcID của project.
tenant_idstringbắt buộcID của project.
tagsarraybắt buộcDanh sách tag trên tài nguyên.
Response mẫu
Response body
{
"id": "66d0c3df-8b49-45ee-b153-54817fa62be2",
"tenant_id": "f33507157a634f1cac71e06a70fb558e",
"port_id": "ce3ed34b-ecb4-4e9a-958c-374054ed0e5c",
"network_id": "4ca57e10-f17f-4609-b8e4-ece4193f0a4b",
"subnet_id": "86c2b30c-8ee2-4a0c-828f-c7218dfa522c",
"subnet_ids": [
"86c2b30c-8ee2-4a0c-828f-c7218dfa522c"
]
}
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. |