Aztertu azterketa

Analisi-lana hastea a. Bidaliz egiten da POST eskaera analyze ibilbidea. Analisia iraupen luzeko prozesua izan daiteke eta normalean minutu bat baino gehiago irauten du. APIak lehenengo balioztapen batzuk egiten ditu, eskaera abian jarriko du backend lan bat bidaliz eta gero 202 egoera kodearekin erantzuten du eta Location goiburua edo akatsen xehetasunekin. Location goiburuko balioa eskaeraren egoera ikusteko eta emaitzen URLak lortzeko erabil daitekeen URL bat da. Sarbideen bidez hainbat aukera daude POST lana zure irizpideen arabera egokitzeko ekintza, hala nola arau edo erregelen zerrenda, azterketatik kanpo uzteko fitxategiak eta beste. Analisia abiaraz dezakezu ondorengoak erabiliz [Geographical URL]/api/analyze?api-version=1.0.

Oharra

Egoera kontrolen artean 15 eta 60 segundo artean itxaron behar da. Analisiak 1 eta 5 minutu artean izaten ditu normalean.
API honek token bat behar du. OAuth

Goiburuak

Izena Mota Esperotako balioa Beharrezkoa?
Baimena kate OAuth 1 eramailearen tokena Microsoft Entra ID aplikazioaren IDaren erreklamazioarekin. bai
x-ms-tenant-id GUID Eskabidearen maizteraren NANa. bai
x-ms-correlation-id GUID Azterketarako identifikatzailea. ID bera eman beharko zenuke exekuzio osorako (kargatu, aztertu, egoera). bai
Onartu objektua application/json, application/x-ms-sarif-v2 bai
Onartu-Hizkuntza kate Hizkuntza kodea edo kodeak (adibidez. en-US). Balio lehenetsia en-US da. Hainbat hizkuntza ematen badira, lehenengoa izango da lehena. Hala ere, itzulpen guztiak (hizkuntza onartzen bada) sartuko dira. ez

Gorputza

Erabilitako aukerak:

Propietatea Mota Esperotako balioa Beharrezkoa?
sasUriList Kate sorta Irtenbide bakarra eskaintzen duen URIen zerrenda irtenbide bakarra deskargatzeko, irtenbide bat baino gehiago dituzten zip fitxategiak edo pakete bat. Bai
ruleSets Ohitura sorta 0 edo gehiago Ez
ruleSets.id Guid Arau-erregimenaren IDa, erregelen APIa kontsultatuz aurki daitekeena. Ez, baina hori da normalean erabili beharko zenukeena. Hau edo regulaCodes erabili behar duzu.
ruleCodes.code kate Desiratutako arau-erregimenaren IDa, eta erregelen APIa kontsultatuz aurki daitekeena. Ez, hori erabili behar duzu edo ruleSets.
fileExclusions Kate sorta Baztertu beharreko fitxategi-izenen edo fitxategi-izenen zerrenda. Laguntza "*" komodina gisa erabiltzea fitxategi izen baten hasieran edo / eta amaieran (adibidez.,*jquery.dll and *jquery*). Ez

Espero diren erantzunak

HTTP egoera-kodea Egoera Result
202 Azterketarako eskaera onartu zen eta egoera kontrolatu URI-n itzuli zen Location goiburua Ez dago gorputz-emaitza
400 Zip ez den fitxategia bidali zen, parametro okerrak edo fitxategi bat birus batekin sartu zen Ez dago gorputz-emaitza
409 Bikoiztua duen eskaera x-ms-correlation-id goiburuko balioa bidali da Ez dago gorputz-emaitza

Aurreikusitako erantzun goiburuak

Izena Mota Esperotako balioa Beharrezkoa?
Kokalekua URIa URL erabiltzeko eskatzeko uneko egoerarako eta emaitzak lortzeko bai

Adibidea: azterketa hastea

Hau Marketplace Ziurtagiriaren arau-multzoarekin analisi-lan bat abiaraztearen adibide bat da, fitxategi bakar batekin, eta izenean jquery eta json testua dituzten fitxategiak baztertzea.

Eskaera

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*"]
}

Erantzuna

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

Ikusi ere bai

Erabili Power Apps egiaztatzailearen web APIa
Arau-multzoen zerrenda berreskuratu
Arauen zerrenda berreskuratu
Fitxategi bat igo
Egiaztatu analisi egoera