IP-statisztika API lekérése

API-leírás

Lekéri a megadott IP-cím statisztikáit. Ezek a statisztikai adatok az elmúlt 30 nap adatain alapulnak.

Korlátozások

• Az API sebességkorlátozásai percenként 100 hívás és óránként 1500 hívás.
• A visszatekintők maximális értéke 720 óra (30 nap).

Engedélyek

Jogkivonat felhasználói hitelesítő adatokkal történő beszerzésekor:

• A felhasználónak legalább a következő szerepköri engedéllyel kell rendelkeznie: "Adatok megtekintése". További információ: Szerepkörök létrehozása és kezelése.

Az API meghívásához az alábbi engedélyek egyikére van szükség. További információ, többek között az engedélyek kiválasztása: Végponthoz készült Microsoft Defender API-k használata

Engedély típusa	Engedély	Engedély megjelenítendő neve
Alkalmazás	Ip.Read.All	"Ip-címprofilok olvasása"
Delegált (munkahelyi vagy iskolai fiók)	Ip.Read.All	"Ip-címprofilok olvasása"

HTTP-kérés

GET /api/ips/{ip}/stats

Kérelemfejlécek

Name (Név)	Típus	Leírás
Engedélyezési	Karakterlánc	Tulajdonos : {token}. Kötelező megadni.

URI-paraméterek kérése

Name (Név)	Típus	Leírás
lookBackHours	Int32	Meghatározza az órákat, amikor visszakeresünk a statisztikák lekéréséhez. Az alapértelmezett érték 30 nap. Nem kötelező.

Kérelem törzse

Üres

Válasz

Ha sikeres, és az IP létezik - 200 OK statisztikai adatokkal a törzsben. Az IP-cím érvényes, de nem létezik – organizationPrevalence 0, IP is invalid - HTTP 400.

Példa

Példa kérésre

Íme egy példa a kérésre.

GET https://api.security.microsoft.com/api/ips/10.209.67.177/stats?lookBackHours=48

Példa válaszra

Íme egy példa a válaszra.

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#microsoft.windowsDefenderATP.api.InOrgIPStats",
    "ipAddress": "10.209.67.177",
    "organizationPrevalence": 63515,
    "orgFirstSeen": "2017-07-30T13:36:06Z",
    "orgLastSeen": "2017-08-29T13:32:59Z"
}

Name (Név)	Leírás
Szervezet elterjedtsége	Az ip-címhez hálózati kapcsolatot megnyitó eszközök eltérő száma.
A szervezet először látható	Az IP-cím első kapcsolata a szervezetben.
Org last seen	Az IP-cím utolsó kapcsolata a szervezetben.