Käyttäjään liittyvien koneiden ohjelmointirajapinnan hankkiminen
Koskee seuraavia:
Haluatko kokeilla Defender for Endpointia? Rekisteröidy maksuttomaan kokeiluversioon.
Huomautus
Jos olet Yhdysvaltain valtionhallinnon asiakas, käytä Microsoft Defender for Endpoint for Us Government -asiakkaille lueteltuja URI-osoitteita.
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
Hakee tiettyyn käyttäjätunnukseen liittyvien laitteiden kokoelman.
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, mukaan lukien käyttöoikeuksien valitseminen, on artikkelissa Microsoft Defenderin käyttö päätepisteiden ohjelmointirajapinnoille
| 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:
- 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, joita käyttäjä voi käyttää 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/users/{id}/machines
Tunnus ei ole täydellinen täydellinen käyttäjätunnus, vaan vain käyttäjänimi. (esimerkiksi koneiden noutaminen käytettäviksi user1@contoso.com /api/users/user1/machines)
Pyynnön otsikot
| Nimi | Kirjoita | Kuvaus |
|---|---|---|
| Lupa | Merkkijono | Haltija {token}. Pakollinen. |
Pyynnön leipäteksti
Tyhjä
Vastaus
Jos onnistui ja käyttäjä on olemassa - 200 OK ja koneentiteettien luettelo leipätekstissä. Jos käyttäjää ei ole - 200 OK ja tyhjä joukko.
Esimerkki
Pyytää
Tässä on esimerkki pyynnöstä.
GET https://api.securitycenter.microsoft.com/api/users/user1/machines
Vihje
Haluatko tietää lisää? Ole yhteydessä Microsoft Security -yhteisöön teknologiayhteisössämme: Microsoft Defender for Endpoint Tech -yhteisössä.