🤖🔧 CLI’den API’ye: Cisco IOS-XE Cihazlarını RESTCONF ile 5 Adımda Yönetin

Related Articles

Cisco HSRP Troubleshooting: Gateway Yedekliliği Neden Çalışmıyor?

7 gün ago

Cisco NAT Troubleshooting: NAT Çalışmıyorsa Nereden Başlanmalı?

2 hafta ago

Cisco BGP Best Path Selection: BGP En İyi Rotayı Nasıl Seçer?

3 hafta ago

Manuel CLI yerine YANG model-tabanlı yönetim (RESTCONF/NETCONF) kullanmak; hata riskini düşürür, otomasyonu hızlandırır ve ölçek kazandırır. IOS-XE’de RESTCONF; HTTPS üzerinden YANG-tanımlı config + state verisine erişmenizi sağlar.

---

1) RESTCONF’i etkinleştir (minimum konfig)

Cisco dokümantasyonundaki minimum adımlar: restconf + ip http secure-server.

conf t
  restconf
  ip http secure-server
end

Üretim notu: AAA/rol bazlı yetkilendirme, TLS sertifikası, management VRF ve ACL kısıtlarını ekleyin. Cisco, RESTCONF hazır olma durumunu nginx/DMI süreçleri ve NETCONF/RESTCONF session komutlarıyla doğrulamayı önerir.

---

2) “Çalışıyor mu?” doğrula (2 komut)

show platform software yang-management process
show netconf-yang sessions

• yang-management process çıktısında nginx ve DMI süreçlerinin running olması beklenir.
• show netconf-yang sessions ile RESTCONF/NETCONF oturumlarını görürsünüz.

---

3) GET ile veri çek (curl)

Cisco örneklerinde JSON için Accept: application/yang-data+json kullanılıyor.

curl -k -u "<USER>:<PASS>" \
  -H "Accept: application/yang-data+json" \
  "https://<DEVICE-IP>/restconf/data/ietf-interfaces:interfaces"

İpucu: Interface adı içinde / varsa URL’de encode gerekir (örn. GigabitEthernet1%2F0%2F1). Aksi halde 404 alabilirsiniz.

---

4) Değişiklik yap (PUT yerine PATCH daha güvenli)

Cisco dokümanında RESTCONF’un HTTP method eşlemesi var ve PUT “create/replace”, PATCH “update” mantığında.
Bu yüzden tek bir leaf güncellemek için PATCH genelde daha güvenlidir (PUT tüm node’u replace edebilir).

✅ PATCH ile sadece “description” güncelle (önerilen)

curl -k -u "<USER>:<PASS>" \
  -H "Accept: application/yang-data+json" \
  -H "Content-Type: application/yang-data+json" \
  -X PATCH \
  -d '{
    "ietf-interfaces:interface": {
      "name": "GigabitEthernet1",
      "description": "Managed-by-RESTCONF"
    }
  }' \
  "https://<DEVICE-IP>/restconf/data/ietf-interfaces:interfaces/interface=GigabitEthernet1"

🟡 PUT ile replace (dikkat!)

curl -k -u "<USER>:<PASS>" \
  -H "Accept: application/yang-data+json" \
  -H "Content-Type: application/yang-data+json" \
  -X PUT \
  -d '{
    "ietf-interfaces:interface": {
      "name": "GigabitEthernet1",
      "description": "Managed-by-RESTCONF"
    }
  }' \
  "https://<DEVICE-IP>/restconf/data/ietf-interfaces:interfaces/interface=GigabitEthernet1"

Hangi method’lar izinli? Hızlı kontrol için Cisco örneğindeki gibi OPTIONS çağrısı atabilirsiniz (Allow/Accept-Patch header’larını döner).

---

5) Python ile 10 satırda çek (requests)

import os
import requests
from requests.auth import HTTPBasicAuth

DEV = os.environ.get("IOSXE_URL", "https://10.1.1.1")
USER = os.environ["IOSXE_USER"]
PASS = os.environ["IOSXE_PASS"]

headers = {"Accept": "application/yang-data+json"}
url = f"{DEV}/restconf/data/ietf-interfaces:interfaces"

r = requests.get(url, auth=HTTPBasicAuth(USER, PASS), headers=headers, timeout=10, verify=False)
r.raise_for_status()

data = r.json()
for intf in data.get("ietf-interfaces:interfaces", {}).get("interface", []):
    print(intf["name"], intf.get("description", ""))

Üretimde: verify=True + kurumsal CA (verify="/path/ca.pem"), parolaları Vault/Secrets Manager’da tutun, rate-limit/timeouts ekleyin.

---

Operasyonel “best practice” (kısa)

• YANG-first düşün: CLI parsing yerine YANG path + JSON schema. RESTCONF’un YANG ile config/state/RPC erişimi sağladığı Cisco dokümanında net.
• TLS/mTLS & sertifika yönetimi: -k sadece lab içindir.
• Yetkilendirme & RBAC: TACACS+/AAA, role-based erişim; API kullanıcılarını ayrı yönet.
• Canary & rollback: önce 1–2 cihaz; “commit sonrası doğrulama” (GET ile state validate).
• Hata ayıklama hızlılığı: show platform software yang-management process + show netconf-yang sessions ilk bakacağın yerler.