Prije nekoliko dana pojavilo se novo izvješće na stranici dnevnika promjena Graph API-ja i ispod /beta stranice dokumentacije, naime Izvješće o korištenju SharePoint API-ja. U to je vrijeme krajnja točka vratila a 403 Zabranjeno pogreška s “Stanar {tenantId} nije omogućen za ovu značajku pregleda.”, vrlo slična onoj prikazanoj u Primjer 10 dokumentacije ili zaslona u nastavku, pa sam zaključio da bih to dodao na svoj popis “završiti” i obradio to kasnije.
Pa, čini se da je došao taj dan, jer mogu dobiti odgovarajuće podatke unutar svog stanara. Prije nego što progovorimo o tome što se može dobiti radom s novim izvješćem, moramo spomenuti još jednu novost. Naime, izvješće se prvo mora omogućiti, preko novouvedenog apiUsageReportMetrics kontrola postavki izvješća. Tek nakon što omogućite prikupljanje podataka unutar svog stanara, možete očekivati da će izvješće otkriti stvarne podatke o korištenju. Dok se to ne dogodi, naletjet ćete na drugoga 403 Zabranjeno greška, kao što je prikazano u nastavku:
Sadržaj objave
Kako omogućiti metriku izvješća o upotrebi SharePoint API-ja
Dakle, prije svega, morate uključiti/isključiti prikupljanje podataka za ovo izvješće putem enableApiUsageReport krajnja točka. Za prebacivanje trebat će vam administratorski račun i aplikacija s ReportSettings.ReadWrite.All dopuštenje delegata dodano. Trenutačno nema podrške za dopuštenja aplikacija, prema dokumentaciji. S druge strane, čini se da krajnje točke trenutačno ne provode potrebna dopuštenja, a uspio sam ih prebaciti putem Globalnog administratora samo s Izvješća.Čitajte.Sve opseg dodijeljen u Graph Exploreru. Unatoč tome, svakako slijedite službena dokumentacija na ovome.
Da biste omogućili prikupljanje podataka za izvješće o korištenju SharePoint API-ja, izdajte POST zahtjev prema enableApiUsageReport krajnju točku i pružiti sljedeće korisno opterećenje:
POST https://graph.microsoft.com/beta/admin/reportSettings/sharePoint/enableApiUsageReport
{
"metric": "EgressReport"
}
Uspješno izvršenje rezultirat će a 200 OK odgovor, s onboardingStatus vratio kao omogućavanje.
Za provjeru statusa upotrijebite GET zahtjev protiv /admin/reportSettings/sharePoint/apiUsageReportMetrics krajnja točka:
GET https://graph.microsoft.com/beta/admin/reportSettings/sharePoint/apiUsageReportMetrics
Zanimljivo, čini se da metoda GET ne provodi odgovarajuće ReportSettings.Read.All dopuštenje bilo 🙂
Nakon što omogućite prikupljanje podataka za SharePoint API izvješće o upotrebi i prođe dovoljno vremena, odgovarajući podaci o upotrebi bit će izloženi pod /beta/reports/getSharePointApiUsage krajnja točka. Moja preporuka je da to pričekate nekoliko dana jer se podaci izvješća ionako generiraju na dnevnoj osnovi. Dok podaci ne postanu dostupni, očekujte da ćete vidjeti 403 pogreške poput onih prikazanih u prethodnim odjeljcima.
Što se tiče dozvola, trebat će vam “standard” Izvješća.Čitajte.Sve opseg i korisnički račun s odgovarajućim dopuštenjima (na primjer uloga čitača izvješća). Opet, podržana su samo ovlaštenja delegata. Imajte na umu da je izvješće trenutno u pregledu i dostupno je samo pod /beta endpoint, tako da bi vaši zahtjevi trebali biti crafter u skladu s tim.
Za dobivanje podataka izvješća za zadnjih 30 dana upotrijebite sljedeći upit:
GET https://graph.microsoft.com/beta/reports/getSharePointApiUsage(period='D30')
Kao što možete vidjeti na gornjoj snimci zaslona, izlaz je vrlo sličan izlazu izvješća o upotrebi Graph API-ja koje prethodno pokriveno. Trenutno su izloženi sljedeći stupci:
- UsageDateTime – datum za koji je trenutni unos izvješća, jedan po danu.
- ServiceArea – uslugu, jednu od četiri gore navedene.
- StanarId – GUID stanara… što samo dodaje buku IMO.
- AppId – GUID za aplikaciju, svaka aplikacija treba imati svoj unos po danu.
- Upotreba MB – količina podataka (u MB) koju koriste API operacije koje izvodi određena aplikacija za taj dan.
- UsageRequests – broj API operacija koje je određena aplikacija izvršila za taj dan.
- ActiveApps – ovo polje je navedeno u dokumentaciji, ali se trenutno ne vraća. Čini se da pokazuje broj jedinstvenih aplikacija s aktivnostima za taj dan i vjerojatno će biti dostupan samo na “kumulativnim” unosima.
Ponovno slično izvješću o upotrebi Graph API-ja, podržan je sljedeći skup parametara upita:
- appId – filtrirajte izvješće prema, na primjer, određenoj vrijednosti AppID-a appId=’972bb84a-1d27-4bd3-8306-6b8e57679e8c′ (odgovara Microsoft Defender za aplikacije u oblaku – API-ji).
- razdoblje – dobiti podatke izvješća za određeno vremensko razdoblje. Za razliku od drugih krajnjih točaka izvješća, trenutno su podržane samo sljedeće vrijednosti: D1, D7, D30. Na primjer: period=’D30′.
- datum – dobiti podatke izvješća za određene datume, u formatu GGGG-MM-DD. Na primjer: datum=2026-02-04.
Izvješće također podržava $format parametar koji kontrolira izlazni format. Zadana vrijednost je JSON i ne biste trebali koristiti nikakvu drugu vrijednost. Za dodatne informacije i primjere svakako provjerite službena dokumentacija.
Sažetak
Ukratko, sada imamo dostupno izvješće o metrici korištenja SharePoint API-ja, koje nam daje iste podatke kao i izvješće o korištenju Graph API-ja, ali za SPO uslugu. Nije mi jasno zašto je Microsoftu za to bila potrebna zasebna krajnja točka, a isto vrijedi i za zahtjev da se prvo omogući prikupljanje podataka za izvješće. Samo još jedan primjer da je Graph “labavo povezana” kolekcija krajnjih točaka, pri čemu svaki tim unutar Microsofta radi svoje i zanemaruje svaku ideju o uniformnosti.
Osim toga, prošlo je više od godinu dana otkako smo dobili izvješća o korištenju Graph API-ja, a nismo čuli ništa od Microsofta u vezi s njihovim planovima. Hoće li uvesti novi oblik kontrole prigušivanja ili će izvješća biti samo informativna? Pitanje koje u ovom trenutku nitko ne želi odgovoriti.
U svakom slučaju, imati više izvješća uvijek je dobra stvar u mojoj knjizi, tako da radim svoj dio u širenju vijesti.