Tunnisteen lisääminen tai poistaminen laitteelle
Koskee seuraavia:
Haluatko kokea Microsoft Defender for Endpointin? 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
Lisää tai poistaa tunnisteen tietylle laitteelle.
Huomautus
Jos etsit, miten voit merkitä koneita joukkona ohjelmointirajapinnan kautta, katso Useiden konetunnisteiden lisääminen tai poistaminen.
Rajoitukset
Voit julkaista tietokoneissa, jotka on viimeksi nähty määritetyn säilytysajan mukaan.
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 käyttöoikeuksien valitsemisesta on artikkelissa Defenderin käyttö päätepisteen ohjelmointirajapinnoille.
| Käyttöoikeustyyppi | Lupa | Käyttöoikeuden näyttönimi |
|---|---|---|
| Sovellus | Machine.ReadWrite.All | "Kaikkien konetietojen luku- ja kirjoitusoikeudet" |
| 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 seuraavat roolioikeudet: Suojausasetusten hallinta. Lisätietoja on artikkelissa Roolien luominen ja hallinta .
- Käyttäjällä on oltava tietokoneen käyttöoikeus tietokoneryhmän asetusten perusteella (lisätietoja on kohdassa Koneryhmien luominen ja hallinta ).
HTTP-pyyntö
POST https://api.securitycenter.microsoft.com/api/machines/{id}/tags
Pyynnön otsikot
| Nimi | Kirjoita | Kuvaus |
|---|---|---|
| Lupa | Merkkijono | Haltija {token}. Pakollinen. |
| Sisältötyyppi | merkkijono | application/json. Pakollinen. |
Pyynnön leipäteksti
Anna pyynnön leipätekstissä JSON-objekti, jolla on seuraavat parametrit:
| Parametri | Kirjoita | Kuvaus |
|---|---|---|
| Arvo | Merkkijono | Tunnisteen nimi. Pakollinen. |
| Toiminta | Luettelointi | Lisää tai poista. Sallitut arvot ovat Add tai Remove. Pakollinen. |
Vastaus
Jos tämä menetelmä onnistuu, se palauttaa arvon 200 – Ok-vastauskoodi ja päivitetty kone vastauksen leipätekstissä.
Esimerkkipyyntö
Tässä on esimerkki pyynnöstä, joka lisää konetunnisteen.
POST https://api.securitycenter.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/tags
{
"Value" : "test Tag 2",
"Action": "Add"
}
Jos haluat poistaa konetunnisteen, määritä toiminnon arvoksi "Poista" eikä "Lisää" pyynnön leipätekstissä.
Vihje
Haluatko tietää lisää? Ole yhteydessä Microsoft Security -yhteisöön teknologiayhteisössämme: Microsoft Defender for Endpoint Tech -yhteisössä.