Přidání nebo odebrání značky pro více počítačů

Článek
08/14/2024

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 programu 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í:

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

Popis rozhraní API

Přidá nebo odebere značku pro zadanou sadu počítačů.

Omezení

Podle nakonfigurované doby uchovávání můžete publikovat na počítačích, které byly naposledy zobrazeny.
Omezení rychlosti pro toto rozhraní API jsou 100 volání za minutu a 1 500 volání za hodinu.
Na jedno volání rozhraní API můžeme přidat nebo odebrat značku až pro 500 počítačů.

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í DEFENDER for Endpoint API.

Typ oprávnění	Povolení	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 Vytváření 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 Vytvoření a správa skupin počítačů ).

Požadavek HTTP

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

Hlavičky požadavků

Name (Název)	Typ	Popis
Oprávnění	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	String	Název značky. Povinné.
Akce	Výčet	Přidat nebo odebrat. Povolené hodnoty jsou: Přidat nebo Odebrat. Povinné.
Id počítače	Seznam (řetězec)	Seznam ID počítačů, která se mají aktualizovat Požadovaný.

Odpověď

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

Příklad požadavku

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

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

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

Pokud chcete odebrat značky počítače, nastavte v textu požadavku akci na Odebrat místo na Přidat.

Tip

Chcete se dozvědět více? Spojte se s komunitou zabezpečení Microsoftu v naší technické komunitě: Technická komunita Microsoft Defenderu for Endpoint.

Sdílet prostřednictvím