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

  • Č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í:

  • 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

Popis rozhraní API

Přidá nebo odebere značku pro konkrétní počítač.

Omezení

  1. Podle nakonfigurované doby uchovávání můžete publikovat na počítačích, které byly naposledy zobrazeny.

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

Požadavek HTTP

POST https://api.securitycenter.microsoft.com/api/machines/{id}/tags

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 String Název značky. Povinné.
Akce Výčtu Přidat nebo odebrat. Povolené hodnoty jsou: Přidat nebo Odebrat. 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ž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? Engage s komunitou Microsoft Security v naší technické komunitě: Microsoft Defender for Endpoint Tech Community.