Přidání nebo odebrání značky pro počítač
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 konkrétní zařízení.
Poznámka
Pokud hledáte postup hromadného označování počítačů prostřednictvím rozhraní API, přečtěte si téma Přidání nebo odebrání více značek 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 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í 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/{id}/tags
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é. |
Odpověď
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žadavku
Tady je příklad požadavku, který přidá značku počítače.
POST https://api.securitycenter.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/tags
{
"Value" : "test Tag 2",
"Action": "Add"
}
Pokud chcete odebrat značku 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.