Tunnisteen lisääminen tai poistaminen useille koneille

Artikkeli
08/14/2024

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

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.
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	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/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	Luettelointi	Lisää tai poista. Sallitut arvot ovat Add tai Remove. Pakollinen.
Koneen tunnuksen	Luettelo (merkkijono)	Päivitettävien konenimien luettelo. Pakollinen.

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ä.