Giải phẩu URI

[dangquangminh]

hắc hẳn bạn từng nghe đến RESTCONF – một giao thức RESTful giúp tương tác cấu hình mạng qua API. Trong hình ảnh bạn cung cấp, chúng ta sẽ giải phẫu URI để hiểu cách định vị tài nguyên cấu hình (configuration resource) trên thiết bị mạng. Đây là kiến thức cực kỳ nền tảng cho anh em DevNet, DevOps, Automation Engineer khi làm việc với API mạng như RESTCONF.

---

🔍 URI: Bạn Đang Yêu Cầu Gì?

Ví dụ URI:

https://router-01.example.com/restconf/data/Cisco-IOS-XE-native:native/hostname

1️⃣ Phần Server hoặc Host (https://router-01.example.com)

• Đây là địa chỉ thiết bị bạn muốn tương tác – có thể là IP hoặc hostname.
• Thường dùng HTTPS (bảo mật), và phải xác thực bằng tài khoản quản trị.
• Có thể cấu hình để truy cập qua cổng mặc định 443 hoặc tùy chỉnh.

📌 Ví dụ thực tế:

https://10.10.20.30/restconf/data/...

→ Yêu cầu RESTCONF được gửi đến switch hoặc router tại IP 10.10.20.30.

---

2️⃣ Phần Resource (tài nguyên)

/restconf/data/Cisco-IOS-XE-native:native/hostname

• /restconf/data/ là tiền tố để báo hiệu RESTCONF đang làm việc với dữ liệu (data).
• Cisco-IOS-XE-native:native/hostname là đường dẫn đến tài nguyên cụ thể, dựa theo mô hình YANG.

📌 Giải thích chi tiết:

• Cisco-IOS-XE-native là tên module YANG do Cisco cung cấp.
• native/hostname là cây cấu trúc (data tree) dẫn đến hostname của thiết bị.

---

✅ Phản Hồi Nhận Được:

Dữ liệu trả về thường là JSON, ví dụ:

{ "Cisco-IOS-XE-native:hostname": "csr1000v-1" }

🎯 Tức là hostname hiện tại của router là csr1000v-1.

---

🔧 YANG Model là gì?

• YANG là ngôn ngữ mô hình hoá dữ liệu mạng (data modeling language).
• RESTCONF chỉ là giao thức truyền/nhận dữ liệu, còn cấu trúc dữ liệu phụ thuộc vào YANG model.
• Mỗi nhà sản xuất (Cisco, Juniper...) sẽ có các YANG module riêng.

---

💡 Tổng Kết Cho DevOps/NetOps:

• Muốn tự động hóa thiết bị mạng bằng Python, Postman, Ansible... thì URI trong RESTCONF chính là địa chỉ đích đến của mọi cấu hình.
• Hiểu rõ cấu trúc URI = làm chủ được cách viết script, playbook, và API calls.
• URI được xây dựng dựa trên mô hình dữ liệu chuẩn → dễ mở rộng, dễ đọc, dễ debug.

---

📚 Gợi ý học tiếp:

• Làm lab với Postman để gửi GET/PUT/POST đến RESTCONF.
• Khám phá mô hình YANG trên Cisco DevNet (https://developer.cisco.com).
• Kết hợp RESTCONF với Ansible module restconf_config.

---

Nếu bạn thấy bài viết hữu ích, hãy lưu lại và chia sẻ cho anh em cùng học nhé. Series “Tự động hóa mạng bằng API” sẽ còn nhiều chủ đề hấp dẫn sắp lên sóng 💻🔥
restconf devnet automation yang cisco #URI #APINetworking #VnProDevOps