Aracılığıyla paylaş

Analiz çağırma

Analiz işi POST yoluna bir analyze isteği gönderilerek başlatılır. Analiz, genellikle bir dakikadan fazla zaman alır; uzun süre çalışan bir işlem olabilir. API, bazı temel doğrulamalar yapar, bir iş göndererek arka uçta isteği başlatır ve ardından 202 durum kodu ve Location başlığı veya uygun hata ayrıntılarıyla yanıt verir. Location başlık değeri, isteğin durumunu denetlemek ve sonuçların URL'lerini almak için kullanılabilen bir URL'dir. POST eyleminde işi ölçütlerinize uygun hale getirmek için kuralların veya kural kümelerinin listesi, analiz dışında bırakılacak dosyalar ve bunlar gibi çeşitli seçenekler vardır. Aşağıdaki [Geographical URL]/api/analyze?api-version=1.0 öğesini kullanarak analizi başlatabilirsiniz.

Not

Durum denetimleri arasında 15 - 60 saniye beklenilmesi önerilir. Analizin çalışması genellikle 1 - 5 dakika sürer.
Bu API bir OAuth belirteç gerektirir.

Üst Bilgiler

Adı Türü Beklenen değer Gerekli mi?
Yetkilendirme Diize Kimlik OAuth Uygulama Kimliği talebine sahip Microsoft Entra 1 taşıyıcı belirteci. yes
x-ms-tenant-id GUID Uygulama kiracısının kimliği. yes
x-ms-correlation-id GUID Analizi çalıştırma Tanımlayıcısı. Yürütmenin tamamı için aynı kimliği sağlamanız gerekir (yükleme, çözümleme, durum). yes
Kabul et nesne application/json, application/x-ms-sarif-v2 yes
Accept-Language Diize Dil kodu veya kodları (örn. en-US). Varsayılan en-US değeridir. Birden çok dil sağlanırsa ilk sağlanan dil birincil olur. Bununla beraber tüm çeviriler (dil destekleniyorsa) dahil edilir. hayır

Gövde

Sık kullanılan seçenekler:

Özellik Türü Beklenen değer Gerekli mi?
sasUriList dizeler dizisi Tek bir çözüm, birden çok çözüm dosyası içeren bir zip dosyası veya bir paket indirmek için hizmete erişim sağlayan URI'lerin listesi. Evet
ruleSets özel dizi 0 veya daha çok Hayır
ruleSets.id guid Kural kümesi API'si sorgulanarak bulunabilen kural kümesinin kimliği. Hayır ancak bu genellikle kullanmak istediğinizdir. Bunu veya ruleCodes'u kullanmanız gerekir.
ruleCodes.code Diize Kural kümesi ve kural API'si sorgulanarak bulunabilen, istenilen kuralın kimliği. Hayır, bunu veya ruleSets'i kullanmanız gerekir.
fileExclusions dizeler dizisi Dışlanacak dosya adları veya dosya adı kalıplarının listesi. Dosya adının başında ve/veya sonunda "*" karakterini joker karakteri olarak kullanma desteği vardır (örn *jquery.dll ve *jquery*). Hayır

Beklenen yanıtlar

HTTP durum kodu Senaryo Result
202 Analiz isteği kabul edildi ve durum denetimi URI'si Location başlığında döndürüldü Sonuç gövdesi yok
400 Zip olmayan bir dosya gönderildi, yanlış parametreler veya virüs olan bir dosya eklenmiş Sonuç gövdesi yok
409 Yinelenen x-ms-correlation-id başlık değerine sahip bir istek gönderildi Sonuç gövdesi yok

Beklenen yanıt üst bilgileri

Adı Türü Beklenen değer Gerekli mi?
Konum Uri Geçerli durumu sorgulamada ve sonuçları elde etmede kullanılacak URL yes

Örnek: analiz başlatma

Bu, Marketplace Sertifikasyonu kural kümesiyle, adında jquery ve json metnini içeren dosyaları dışlayarak, tek bir dosyayla bir analiz işi başlatmanın bir örneğidir.

İste

POST [Geographical URI]/api/analyze?api-version=1.0
Accept: application/json
Content-Type: application/json; charset=utf-8
x-ms-correlation-id: aaaa0000-bb11-2222-33cc-444444dddddd
x-ms-tenant-id: aaaabbbb-0000-cccc-1111-dddd2222eeee

{
    "ruleSets": [{
        "id": "0ad12346-e108-40b8-a956-9a8f95ea18c9"
    }],
    "sasUriList": ["https://testenvfakelocation.blob.core.windows.net/mySolution.zip"],
    "fileExclusions": ["*jquery*", "*json*"]
}

Yanıtla

HTTP/1.1 202 Accepted
Content-Type: application/json; charset=utf-8
Location: [Geographical URI]/api/status/aaaa0000-bb11-2222-33cc-444444dddddd&api-version=1.0

Ayrıca bkz.

Denetleyici web API'sini Power Apps kullanma
Kural kümeleri listesini alma
Kurallar listesini alma
Dosyayı karşıya yükleme
Analiz durumunu denetleme

  • Last updated on