Rajoita sovelluksen suorittamisen ohjelmointirajapintaa

Ohjelmointirajapinnan kuvaus

Rajoita kaikkien sovellusten suorittamista laitteessa esimääritettyä joukkoa lukuun ottamatta.

Rajoitukset

Tämän ohjelmointirajapinnan nopeusrajoitukset ovat 100 puhelua minuutissa ja 1 500 puhelua tunnissa.

Ennakkovaatimukset

• Tämä toiminto on käytettävissä laitteissa, Windows 10 versiossa 1709 tai uudemmassa sekä Windows 11.
• Tämä ominaisuus on käytettävissä, jos organisaatiosi käyttää Microsoft Defender virustentorjuntaohjelmaa.
• Tämän toiminnon on täytettävä Windows Defenderin sovellusohjausobjektin koodin eheyskäytäntömuodot ja allekirjoitusvaatimukset. Lisätietoja: Koodin eheyskäytännön muodot ja allekirjoittaminen.

Käyttöoikeudet

Kun hankit tunnuksen käyttäjän tunnistetiedoilla:

• Käyttäjällä on oltava vähintään seuraava roolioikeus: Aktiiviset korjaustoiminnot. Lisätietoja on ohjeaiheessa Roolien luominen ja hallinta.
• Käyttäjällä on oltava laitteen käyttöoikeus laiteryhmän asetusten perusteella. Lisätietoja on kohdassa Laiteryhmien luominen ja hallinta.

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.RestrictExecution	'Rajoita koodin suorittamista'
Delegoitu (työpaikan tai oppilaitoksen tili)	Machine.RestrictExecution	'Rajoita koodin suorittamista'

HTTP-pyyntö

POST https://api.security.microsoft.com/api/machines/{id}/restrictCodeExecution

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
Kommentoi	Merkkijono	Toimintoon liitettävä kommentti. Pakollinen.

Vastaus

Jos tämä menetelmä onnistuu, se palauttaa arvon 201 – Luotu vastauskoodi ja konetoiminto vastauksen leipätekstissä.

Jos lähetät useita ohjelmointirajapintakutsuja sovelluksen suorittamisen rajoittamiseksi samassa laitteessa, se palauttaa "odottavan konetoiminnon" tai HTTP 400:n, jossa on viesti "Toiminto on jo käynnissä".

Esimerkki

Pyyntö

Tässä on esimerkki pyynnöstä.

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

{
  "Comment": "Restrict code execution due to alert 1234"
}