5.7 ENDPOINT nesneleri (REST işlemcisi)

<< İçindekileri Görüntülemek İçin Tıklayın >>

Yer:  Teknik Kılavuzlar > Netsim System Agent Kurulum ve Yönetim Kılavuzu > 5. Servis yüzeyleri >

5.7 ENDPOINT nesneleri (REST işlemcisi)

Motorun ENDPOINT nesnesi bir HTTP yöntemi ve yolunu bir PSQL yordamına bağlar; uç CREATE ENDPOINT ile SQL'den tanımlanır, REST işlemcisi conf'ta verilen veritabanının kataloğundan okur ve istek geldiğinde yordamı çağırır. Uç COMMIT anında yayındadır — hizmet yeniden başlatılmaz, RELOADENDPOINTS gerekmez. Sözdizimi ve kipler SQL kılavuzunun "ENDPOINT — HTTP uçları" bölümündedir.

{
  "name": "REST", "active": true, "processor": "REST", "path": "/api",
  "database": "NETSIM", "sessionManager": "default",
  "statementTimeoutMs": 30000, "maxBodyBytes": 16777216, "reloadIntervalSec": 60
}
AlanNe yapar
databaseZorunlu: uçları sunulacak veritabanının MASTER'daki kayıt adı (düz tanımlayıcı).
statementTimeoutMsUç yordamının süre sınırı; aşan istek 500 alır. 0 = sınırsız.
maxBodyBytesKabul edilen en büyük istek gövdesi; aşan 413 alır (öndeğer 16 MB).
reloadIntervalSecUç listesi DDL COMMIT'inde kendiliğinden yenilenir; ek olarak en çok bu kadar saniyede bir kataloğu yeniden okur (öndeğer 60, 0 = yalnız DDL ve RELOADENDPOINTS).

Kimlik kipleri: ANONYMOUS kimliksiz; LOGIN HTTP Basic ile bir MASTER login'i ve ucun EXECUTE hakkı (sahip, SYSDBA, SYSADMIN ya da GRANT EXECUTE ON <uç>); ROLE rol Basic ve MASTER'daki rol üyeliği. ALLOW FROM IP süzgeci 403, RATE LIMIT … BY IP 429 + Retry-After verir; sayaçlar bütün işçi süreçlerinde ortaktır. Yordamın yakalanmayan istisnası 500 ve genel bir iletidir; ayrıntı günlüktedir.

Yönetim arayüzünün “WS Uç Noktaları” sayfasındaki Motor uçları sekmesi seçilen veritabanının uçlarını (IVD$V_ENDPOINTS) listeler, tanımını gösterir ve işlemci yoluna test isteği gönderir (yöntem, başlıklar, gövde, isteğe bağlı Basic kimlik). GET /AdminREST/SITE conf'taki REST işlemcilerini restProcessors alanında verir.