Aggiungere o rimuovere un tag per più computer
Si applica a:
Se si desidera provare Microsoft Defender per endpoint, iscriversi a una versione di valutazione gratuita.
Nota
Se si è un cliente del governo degli Stati Uniti, usare gli URI elencati in Microsoft Defender per endpoint per i clienti del governo degli Stati Uniti.
Suggerimento
Per ottenere prestazioni migliori, è possibile usare il server più vicino alla posizione geografica:
- 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
Aggiunge o rimuove un tag per il set di computer specificato.
- È possibile pubblicare nei computer visualizzati per l'ultima volta in base al periodo di conservazione configurato.
- Le limitazioni di frequenza per questa API sono 100 chiamate al minuto e 1.500 chiamate all'ora.
- È possibile aggiungere o rimuovere un tag per un massimo di 500 computer per ogni chiamata API.
Per chiamare questa API è necessaria una delle autorizzazioni seguenti. Per altre informazioni, incluso come scegliere le autorizzazioni, vedere Usare le API di Defender per endpoint.
Tipo di autorizzazione | Autorizzazione | Nome visualizzato autorizzazioni |
---|---|---|
Applicazione | Machine.ReadWrite.All | 'Leggere e scrivere tutte le informazioni del computer' |
Delegato (account aziendale o dell'istituto di istruzione) | Machine.ReadWrite | 'Leggere e scrivere informazioni sulla macchina' |
Nota
Quando si ottiene un token usando le credenziali utente:
- L'utente deve disporre almeno dell'autorizzazione del ruolo seguente: "Gestisci impostazione di sicurezza". Per altre informazioni, vedere Creare e gestire ruoli.
- L'utente deve avere accesso al computer in base alle impostazioni del gruppo di computer.Per altre informazioni, vedere Creare e gestire gruppi di computer .
POST https://api.securitycenter.microsoft.com/api/machines/AddOrRemoveTagForMultipleMachines
Nome | Tipo | Descrizione |
---|---|---|
Autorizzazione | Stringa | Bearer {token}. Obbligatorio. |
Content-Type | stringa | application/json. Obbligatorio. |
Nel corpo della richiesta specificare un oggetto JSON con i parametri seguenti:
Parametro | Tipo | Descrizione |
---|---|---|
Valore | Stringa | Nome del tag. Obbligatorio. |
Azione | Enumerazione | Aggiungere o rimuovere. I valori consentiti sono: 'Add' o 'Remove'. Obbligatorio. |
MachineIds | List (String) | Elenco di ID computer da aggiornare. Obbligatorio. |
In caso di esito positivo, questo metodo restituisce il codice di risposta 200 - Ok e i computer aggiornati nel corpo della risposta.
Ecco un esempio di richiesta che aggiunge un tag a più computer.
POST https://api.securitycenter.microsoft.com/api/machines/AddOrRemoveTagForMultipleMachines
{
"Value" : "Tag",
"Action": "Add",
"MachineIds": ["34e83ca3feea4dae2353006ba389262c033a025e",
"2a398439b4975924e87a65943972bc702469b329",
"a610c00c65fdf79960cc0077d9d8c569d23f09a5"]
}
Per rimuovere i tag del computer, impostare Action su 'Remove' anziché su 'Add' nel corpo della richiesta.
Suggerimento
Per saperne di più, Collaborare con la community di Microsoft Security nella community tech: Microsoft Defender per endpoint Tech Community.