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 OAuth token bat behar du.

Goiburuak

Izena	Mota	Esperotako balioa	Beharrezkoa?
Baimena	katea	OAuth 1 eramazlearen tokenak, aplikazioaren identifikatzaile-jakinarazpena Microsoft Entra duenak.	bai
x-ms-tenant-id	GUIDa	Eskabidearen maizteraren NANa.	bai
x-ms-correlation-id	GUIDa	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	katea	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.	Yes
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	katea	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*).	No

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?
Kokapena	URIa	URL erabiltzeko eskatzeko uneko egoerarako eta emaitzak lortzeko	bai

Adibidea: azterketa hastea

Honekin batera analisi lanarekin hasteko adibidea da AppSource Ziurtagiria araua, fitxategi bakarra eta testua duten fitxategiak baztertu jquery eta json izenean.

Eskaera

POST [Geographical URI]/api/analyze?api-version=1.0
Accept: application/json
Content-Type: application/json; charset=utf-8
x-ms-correlation-id: 9E378E56-6F35-41E9-BF8B-C0CC88E2B832
x-ms-tenant-id: F2E60E49-CB87-4C24-8D4F-908813B22506

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

Response

HTTP/1.1 202 Accepted
Content-Type: application/json; charset=utf-8
Location: [Geographical URI]/api/status/9E378E56-6F35-41E9-BF8B-C0CC88E2B832&api-version=1.0

Ikus baita ere

Erabili Power Apps egiaztatzailea web API
Berreskuratu arauen zerrenda
Berreskuratu arauen zerrenda
Fitxategiak kargatu
Egiaztatu analisiaren egoera zein den