Share via

Tunnisteen lisääminen tai poistaminen laitteelle

  • Artikkeli

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

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

  1. Voit julkaista tietokoneissa, jotka on viimeksi nähty määritetyn säilytysajan mukaan.

  2. 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 Lupaa 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:

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 Enum 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ää? Engage Microsoft security -yhteisön kanssa teknologiayhteisössämme: Microsoft Defender for Endpoint Tech Community.