Nastavení rozhraní API pro hodnoty zařízení

  • Článek

Platí pro:

Chcete vyzkoušet Defender pro Endpoint? Zaregistrujte se a získejte bezplatnou zkušební verzi,

Poznámka

Pokud jste zákazníkem státní správy USA, použijte identifikátory URI uvedené v Microsoft Defender for Endpoint pro zákazníky státní správy USA.

Tip

Pro lepší výkon můžete použít server blíže k vašemu geografickému umístění:

  • api-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.com
  • api-au.securitycenter.microsoft.com

Popis rozhraní API

Nastavte hodnotu zařízení konkrétního počítače.
Další informace najdete v tématu Přiřazení hodnot zařízení .

Omezení

  1. Na zařízeních, která se naposledy zobrazila, můžete publikovat podle nakonfigurované doby uchovávání.
  2. Omezení rychlosti pro toto rozhraní API jsou 100 volání za minutu a 1500 volání za hodinu.

Oprávnění

K volání tohoto rozhraní API se vyžaduje jedno z následujících oprávnění. Další informace, včetně postupu výběru oprávnění, najdete v tématu Použití rozhraní MICROSOFT DEFENDER FOR ENDPOINT API.

Typ oprávnění Oprávnění Zobrazovaný název oprávnění
Application Machine.ReadWrite.All Čtení a zápis všech informací o počítači
Delegovaný (pracovní nebo školní účet) Machine.ReadWrite Čtení a zápis informací o počítači

Poznámka

Při získávání tokenu pomocí přihlašovacích údajů uživatele:

  • Uživatel musí mít alespoň následující oprávnění role: Spravovat nastavení zabezpečení. Další informace najdete v tématu Create a správa rolí.
  • Uživatel musí mít přístup k počítači na základě nastavení skupiny počítačů (další informace najdete v tématu Create a správa skupin počítačů).

Požadavek HTTP

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

Hlavičky požadavků

Name (Název) Typ Popis
Autorizace String Nosný {token}. Povinné.
Typ obsahu Řetězec application/json. Povinné.

Text požadavku

V textu požadavku zadejte objekt JSON s následujícími parametry:

Parametr Typ Popis
Hodnota zařízení Výčtu Hodnota zařízení. Povolené hodnoty jsou: "Normální", "Nízká" a "Vysoká". Povinné.

Reakce

V případě úspěchu vrátí tato metoda v těle odpovědi kód odpovědi 200 – Ok a aktualizovaný počítač.

Příklad

Požadavek

Tady je příklad požadavku, který přidává značku počítače.

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

{
  "DeviceValue" : "High"
}

Tip

Chcete se dozvědět více? Engage s komunitou Microsoft Security v naší technické komunitě: Microsoft Defender for Endpoint Tech Community.