Analüüsi käivitamine

Analüüsitöö algatamiseks esitatakse marsruudile POST taotlus analyze. Analüüs võib olla pikk protsess, mis kestab tavaliselt kauem kui minut. API viib esmalt läbi põhilise SIC-koodvalideerimise, algatab taotluse tagaserveris, esitades töö, ja vastab seejärel olekukoodiga 202 ja päisega Location või asjakohaste tõrke üksikasjadega. Päise Location väärtus on URL, mida saab kasutada taotluse oleku kontrollimiseks ja tulemuste URL-ide saamiseks. Toiming POST pakub mitmesuguseid võimalusi töö kohandamiseks teie kriteeriumide alusel (nt reeglite või reeglistiku loend, analüüsist välistatavad failid jne). Analüüsi saate käivitada järgmise funktsiooni abil: [Geographical URL]/api/analyze?api-version=1.0.

Märkus.

Olekukontrollide vahel on soovitatav oodata 15 kuni 60 sekundit. Analüüsimiseks kulub tavaliselt 1 kuni 5 minutit.
See API vajab tokenit. OAuth

Päised

Nimi	Tüüp	Eeldatav väärtus	Kas on nõutav?
Autoriseerimine	string	OAuth 1 kandja token Microsoft Entra ID rakenduse ID nõudega.	jah
x-ms-tenant-id	GUID	Rakenduse rentniku ID.	jah
x-ms-correlation-id	GUID	Analüüsi identifikaator. Peate sisestama sama ID kogu käitamise jaoks (üleslaadimine, analüüsimine, olek).	jah
Aktsepteerimine	ese	application/json, application/x-ms-sarif-v2	jah
Aktsepteeri – keel	string	Keele kood või koodid (nt et-EE). Vaikekeel on en-US. Kui on saadaval mitu keelt, siis esimene on peamine. Siiski kaasatakse kõik tõlked (kui keel on toetatud).	ei

Keha

Sagedamini kasutatavad suvandid.

Atribuut	Tüüp	Eeldatav väärtus	Kas on nõutav?
sasUriList	Stringide massiiv	URI-de loend, mis annab teenusele juurdepääsu ühe lahenduse, mitut lahenduse faili sisaldava ZIP-faili või paketi allalaadimiseks.	Jah
ruleSets	Kohandatud massiiv	0 või rohkem	Nr
ruleSets.id	Guid	Reeglistiku ID, mille leiate reeglistiku API päringu teel.	Ei, kuid tavaliselt soovite seda kasutada. Peate kasutama kas seda või ruleCodesi.
ruleCodes.code	string	Soovitud reegli ID, mille leiate reegli API päringu teel.	Ei, peate kasutama kas seda või ruleSetsi.
fileExclusions	Stringide massiiv	Välistatavate faili nimede või faili nime mustrite loend. Toetatakse „*” kasutamist metamärgina failinime alguses ja/või lõpus (nt *jquery.dll ja *jquery).	Nr

Eeldatavad vastused

HTTP-olekukood	Stsenaarium	Tulemus
202	Analüüsitaotlus võeti vastu ja olekukontrolli URI tagastati päises Location	Tulemeid pole
400	Saadeti mitte-zip-fail, lisati valed parameetrid või fail koos viirusega	Tulemeid pole
409	Saadeti taotlus päise x-ms-correlation-id topelt väärtustega	Tulemeid pole

Eeldatavad vastuse päised

Nimi	Tüüp	Eeldatav väärtus	Kas on nõutav?
Location	URI	Praeguse oleku kohta päringu esitamisel ja tulemuste hankimisel kasutatav URL	jah

Näide: analüüsi käivitamine

See on näide analüüsitöö alustamisest turu sertifitseerimise reeglistikuga, ühe failiga, ning failide välistamisest, mille nimes on tekstid jquery ja json .

Taotlus

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

Vastus

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

Vt ka

Kasuta Power Apps kontrollija veebi API-d
Reeglite loendi toomine
Reeglite loendi toomine
Laadi fail üles
Kontrollige analüüsi olekut