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

Gắn interface vào virtual router

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

Thê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_id hoặc port_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.

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.

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ộc

ID của router.

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": "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 - OKRequest thành công.

Lỗi​

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