Määritä laitteen arvon ohjelmointirajapinta

Koskee seuraavia:

• Microsoft Defender for Endpoint Plan 1
• Microsoft Defender for Endpoint Plan 2
• Microsoft Defender XDR

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

Määritä tietyn koneen laitearvo.
Lisätietoja on kohdassa Laitearvojen määrittäminen .

Rajoitukset

1. Voit julkaista laitteissa, 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 ja käyttöoikeuksien valitseminen on artikkelissa Microsoft Defender for Endpoint ohjelmointirajapintoja

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 artikkelissa tietokoneryhmien Create ja hallinta)

HTTP-pyyntö

POST https://api.security.microsoft.com/api/machines/{machineId}/setDeviceValue

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
DeviceValue	Enum	Laitteen arvo. Sallitut arvot ovat : Normaali, Pieni ja Suuri. Pakollinen.

Vastaus

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

Esimerkki

Pyyntö

Tässä on esimerkki pyynnöstä, joka lisää konetunnisteen.

POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/setDeviceValue

{
  "DeviceValue" : "High"
}

Vihje

Haluatko tietää lisää? Engage Microsoft security -yhteisön kanssa teknologiayhteisössämme: Microsoft Defender for Endpoint Tech Community.