Jaa

Tunnisteen lisääminen tai poistaminen useille koneille

  • 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 määritetyn laitejoukon tunnisteen.

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.
  3. Voimme lisätä tai poistaa tunnisteen enintään 500 koneelle ohjelmointirajapintakutsua kohden.

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:

  • Käyttäjällä on oltava vähintään seuraavat roolioikeudet: Suojausasetusten hallinta. Lisätietoja on artikkelissa roolien Create ja hallinta.
  • Käyttäjällä on oltava tietokoneen käyttöoikeus tietokoneryhmän asetusten perusteella (lisätietoja on kohdassa Create ja koneryhmien hallinta).

HTTP-pyyntö

POST https://api.securitycenter.microsoft.com/api/machines/AddOrRemoveTagForMultipleMachines

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.
Koneen tunnuksen Luettelo (merkkijono) Päivitettävien konenimien luettelo. Tarvitaan.

Vastaus

Jos tämä menetelmä onnistuu, se palauttaa arvon 200 – Ok-vastauskoodi ja päivitetyt koneet vastauksen leipätekstissä.

Esimerkkipyyntö

Tässä on esimerkki pyynnöstä, joka lisää tunnisteen useisiin koneisiin.

POST https://api.securitycenter.microsoft.com/api/machines/AddOrRemoveTagForMultipleMachines

{
  "Value" : "Tag",
  "Action": "Add",
  "MachineIds": ["34e83ca3feea4dae2353006ba389262c033a025e",
  "2a398439b4975924e87a65943972bc702469b329",
  "a610c00c65fdf79960cc0077d9d8c569d23f09a5"]
}

Jos haluat poistaa konetunnisteita, 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.