Laitteiden etsiminen tunnisteen ohjelmointirajapinnan mukaan
Koskee seuraavia:
Haluatko kokea Microsoft Defender for Endpointin? Rekisteröidy maksuttomaan kokeiluversioon.
Huomautus
Jos olet Yhdysvaltain valtionhallinnon asiakas, käytä Microsoft Defender for Endpoint lueteltuja URI-tunnuksia Yhdysvaltain valtionhallinnon asiakkaille.
Vihje
Suorituskyvyn parantamiseksi voit käyttää palvelinta lähempänä maantieteellistä sijaintiasi:
- us.api.security.microsoft.com
- eu.api.security.microsoft.com
- uk.api.security.microsoft.com
- au.api.security.microsoft.com
- swa.api.security.microsoft.com
- ina.api.security.microsoft.com
Ohjelmointirajapinnan kuvaus
Etsi koneitatunnisteen mukaan.
startswith
kyselyä tuetaan.
Rajoitukset
- Tämän ohjelmointirajapinnan nopeusrajoitukset ovat 100 puhelua minuutissa ja 1 500 puhelua tunnissa.
Käyttöoikeudet
Tämän ohjelmointirajapinnan kutsumiseen tarvitaan jokin seuraavista käyttöoikeuksista. Lisätietoja ja käyttöoikeuksien valitseminen on artikkelissa Microsoft Defender for Endpoint ohjelmointirajapintoja
Käyttöoikeustyyppi | Lupa | Käyttöoikeuden näyttönimi |
---|---|---|
Sovellus | Machine.Read.All | "Kaikkien koneprofiilien lukuoikeudet" |
Sovellus | Machine.ReadWrite.All | "Kaikkien konetietojen luku- ja kirjoitusoikeudet" |
Delegoitu (työpaikan tai oppilaitoksen tili) | Machine.Read | 'Konetietojen lukeminen' |
Delegoitu (työpaikan tai oppilaitoksen tili) | Machine.ReadWrite | "Konetietojen lukeminen ja kirjoittaminen" |
Huomautus
Kun hankit tunnuksen käyttäjän tunnistetiedoilla:
- Vastaus sisältää vain laitteita, joihin käyttäjällä on käyttöoikeus laiteryhmän asetusten perusteella (lisätietoja on kohdassa Laiteryhmien luominen ja hallinta)
- Käyttäjällä on oltava vähintään seuraava roolioikeus: Näytä tiedot (lisätietoja on artikkelissa Roolien luominen ja hallinta)
- Vastaus sisältää vain laitteita, joihin käyttäjällä on käyttöoikeus laiteryhmän asetusten perusteella (lisätietoja on kohdassa Laiteryhmien luominen ja hallinta)
Laiteryhmän luontia tuetaan Defender for Endpoint -palvelupaketti 1:ssä ja palvelupakettissa 2.
HTTP-pyyntö
GET /api/machines/findbytag?tag={tag}&useStartsWithFilter={true/false}
Pyynnön otsikot
Nimi | Kirjoita | Kuvaus |
---|---|---|
Lupa | Merkkijono | Haltija {token}. Pakollinen. |
Pyynnön URI-parametrit
Nimi | Kirjoita | Kuvaus |
---|---|---|
tag | Merkkijono | Tunnisteen nimi. Pakollinen. |
useStartsWithFilter | Totuusarvo | Kun asetuksena on tosi, haku etsii kaikki laitteet, joiden tunnisteen nimi alkaa määritetyllä tunnisteella kyselyssä. Oletusarvo on epätosi. Valinnainen. |
Pyynnön leipäteksti
Tyhjä
Vastaus
Jos tämä onnistuu - 200 OK ja koneiden luettelo vastauksen leipätekstissä.
Esimerkki
Pyytää
Tässä on esimerkki pyynnöstä.
GET https://api.securitycenter.microsoft.com/api/machines/findbytag?tag=testTag&useStartsWithFilter=true
Vihje
Haluatko tietää lisää? Engage Microsoft security -yhteisön kanssa teknologiayhteisössämme: Microsoft Defender for Endpoint Tech Community.