İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

Aggrega Wasm Policy Socket şeması

Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.

Şema kimliği: https://aggrega.ai/schemas/wasm-policy-v1beta1.schema.json

Bir karar rolüne bağlanan bir yönetişim eklentisinin tükettiği (ir-verdict rolünde PolicyInput, render-verdict rolünde RenderPolicyInput) ve ürettiği (PolicyOutput) iletim biçimleri. halt önem derecesindeki bir karar, derleme zamanı tanılamasıyla derlemeyi durdurur; warn ya da info kararı bildirilir ve derleme devam eder. IR aşamasının girdi grafı, yeteneklerden bağımsız tam IR grafıdır ve burada yeniden bildirilmek yerine ir-v1beta1.schema.json’dan başvurulur; böylece policy eklentisi derleyicinin gördüğü düğüm, kenar ve ek ayrıntısının aynısını görür; eklenti yazarları IR şeması sürümünü takip eder. Render aşaması girdisi graf yerine render edilmiş çıktı dosyalarını taşır. Go, Rust ve TypeScript yük türleri bu şemadan plugin-ABI paketlerine üretilir; böylece üç dil tek bir iletim biçimini okur ve yazar; bir konuk bunları bu paketlerden ya da kit bunları yeniden dışa aktarıyorsa eklenti kiti üzerinden içe aktarır.

Aşağıdaki biçimlerden biri

  • PolicyInput
  • RenderPolicyInput
  • PolicyOutput

Tanımlar

PolicyInput

Statik analizin policy soketine verdiği yük: tam IR grafı (Topology Builder’ın ürettiği biçimin aynısı) ve analizcinin bunun yanında sıraladığı önceden hesaplanmış yönlendirme yolları.

ÖzellikTürZorunluAçıklama
graphIRGraphevetYeteneklerden bağımsız, tek kaynağı ir-v1beta1.schema.json olan tam IR grafı. Policy eklentisi dar bir izdüşüm yerine eksiksiz düğüm/kenar/ek ayrıntısı üzerinde akıl yürütür.
precalculated_pathsPrecalculatedPath[]evetPolicy’lerin grafı yeniden dolaşmadan erişilebilirlik hakkında akıl yürütebilmesi için analizcinin önceden sıraladığı yönlendirme yolları.
sourcesPolicySource[]hayırAna makinenin derleme zamanında okuyup eklentiye olduğu gibi verdiği, yola göre sıralanmış sıralı bir liste olarak tanım dosyaları. Ana makine baytları opak içerik olarak okur ve ayrıştırmaz. Ek hiçbir kaynak bildirmediğinde bulunmaz.
settingsobjecthayırAna makinenin eklentiye olduğu gibi verdiği serbest biçimli bir ayarlar nesnesi. Ana makine içeriğini ayrıştırmaz ve ona göre işlem yapmaz. Ek hiçbir ayar bildirmediğinde bulunmaz.

Ek özelliklere izin verilmez.

PolicyOutput

Policy eklentisinin ürettiği yanıt biçimi: değerlendirme sırasında tetiklenen kararlar, tetiklenen her karar için bir tanılama. İzin veren bir kural hiçbir şey üretmez; bu nedenle boş bir results dizisi hiçbir kararın tetiklenmediği anlamına gelir.

ÖzellikTürZorunluAçıklama
resultsDiagnostic[]evetEklentinin ürettiği sırayla, her biri için bir tanılama olacak şekilde tetiklenen kararlar. Hiçbir karar tetiklenmediğinde boştur.
errorstringhayırKonuk çalıştığı hâlde işlemi tamamlayamadığında ayarlanan bir hata mesajı; başarı durumunda bulunmaz. Çıktının taşıdığı tanılamalardan farklıdır: tanılamalar yine de bir sonuç üreten bir çalıştırma sırasında bulunan sorunları bildirirken error, işlemin kendisinin tamamlanmadığını bildirir. Ana makine, mevcut bir error’u başarısız bir eklenti çağrısı olarak yansıtır.

Ek özelliklere izin verilmez.

RenderPolicyInput

render-verdict rolüne bağlanan bir yönetişim eklentisinin aldığı yük: IR grafı yerine, policy’nin üzerinde akıl yürüttüğü render edilmiş çıktı dosyaları.

ÖzellikTürZorunluAçıklama
artifactsRenderedArtifact[]evetPolicy’nin üzerinde akıl yürüttüğü render edilmiş çıktı dosyaları; aynı girdinin çalıştırmaları arasında iletimin bayt bayt aynı olması için yola göre sıralanmış sıralı bir liste olarak.
sourcesPolicySource[]hayırAna makinenin derleme zamanında okuyup eklentiye olduğu gibi verdiği, yola göre sıralanmış sıralı bir liste olarak tanım dosyaları. Ana makine baytları opak içerik olarak okur ve ayrıştırmaz. Ek hiçbir kaynak bildirmediğinde bulunmaz.
settingsobjecthayırAna makinenin eklentiye olduğu gibi verdiği serbest biçimli bir ayarlar nesnesi. Ana makine içeriğini ayrıştırmaz ve ona göre işlem yapmaz. Ek hiçbir ayar bildirmediğinde bulunmaz.

Ek özelliklere izin verilmez.

RenderedArtifact

Render edilmiş tek bir çıktı dosyası: yolu ve o yoldaki render edilmiş içerik.

ÖzellikTürZorunluAçıklama
pathstringevetRender edilmiş dosyanın, render köküne göreli çıktı yolu.
contentstringevetBu yoldaki render edilmiş içerik.
treeherhangihayırBu yapıtın ayrıştırılmış yapılandırılmış ağacı; ana makine içeriği eklentiye vermeden önce ayrıştırdığında bulunur — eklentinin doğal olarak okumadığı bir kaynak biçiminin kanonik JSON görünümü (örneğin JSON’a ayrıştırılmış bir HCL yapıtı). Üst düzey, ayrıştırılmış belgenin kendi biçimine uygun olarak bir nesne, bir dizi veya bir skaler olabilir. Ana makine yapıtı ayrıştırmadığında bulunmaz; bu durumda eklenti doğal içeriği doğrudan okur. Ana makine ağacı opak biçimde iletir; içeriğini yorumlamadan olduğu gibi taşır.
formatstringhayırYapıtın render edildiği biçim; üreten provider bunu bildirdiğinde bulunur. Üreten provider hiçbir biçim bildirmediğinde bulunmaz.

Ek özelliklere izin verilmez.

PolicySource

Eklentiye verilen tek bir tanım dosyası: temel ad yolu ve dosyanın içeriği. İkisi de olduğu gibi taşınır; ana makine içeriği ayrıştırmaz.

ÖzellikTürZorunluAçıklama
pathstringevetKaynak dosyanın temel adı. Ana makine hiçbir zaman mutlak bir ana makine yolu değil, yalnızca temel adı sağlar; böylece iletim taşınabilir ve belirlenimci olur.
contentstringevetKaynak dosyanın opak bir string olarak olduğu gibi taşınan içeriği.

Ek özelliklere izin verilmez.

PrecalculatedPath

Policy kurallarının grafı yeniden dolaşmadan erişilebilirlik hakkında akıl yürütebilmesi için analizcinin somutlaştırdığı, önceden sıralanmış tek bir yönlendirme yolu.

ÖzellikTürZorunluAçıklama
path_idstringevetBu yol için kararlı tanımlayıcı; aynı girdinin çalıştırmaları arasında belirlenimcidir.
nodesstring[]evetYolun kaynaktan uç noktaya kadar geçtiği düğüm kimliklerinin sıralı dizisi.
attached_featuresstring[]evetYol boyunca herhangi bir düğüme eklenmiş Feature tür URI’lerinin alfabetik olarak sıralanmış birleşimi. Küme üyeliği semantiği: bir Feature, birden çok düğüm taşısa bile bir kez görünür. Yol boyunca hiçbir düğüm herhangi bir Feature eki taşımadığında boştur.

Ek özelliklere izin verilmez.