Get machineAction APIGet machineAction API

Si applica a: Microsoft Defender for EndpointApplies to: Microsoft Defender for Endpoint

Nota

Se sei un cliente us government, usa gli URI elencati in Microsoft Defender for Endpoint per i clienti del governo statunitense.If you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

Suggerimento

Per ottenere prestazioni migliori, è possibile utilizzare il server più vicino alla posizione geografica:For better performance, you can use server closer to your geo location:

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

Descrizione APIAPI description

Recupera un'azione del computer specifica in base al relativo ID.Retrieves specific Machine Action by its ID.

LimitazioniLimitations

  1. I limiti di frequenza per questa API sono 100 chiamate al minuto e 1500 chiamate all'ora.Rate limitations for this API are 100 calls per minute and 1500 calls per hour.

AutorizzazioniPermissions

Per chiamare questa API è necessaria una delle autorizzazioni seguenti.One of the following permissions is required to call this API. Per altre informazioni, incluso come scegliere le autorizzazioni, vedi Usare Defender per le API endpointTo learn more, including how to choose permissions, see Use Defender for Endpoint APIs

Tipo di autorizzazionePermission type AutorizzazionePermission Nome visualizzato autorizzazionePermission display name
ApplicazioneApplication Machine.Read.AllMachine.Read.All "Leggi tutti i profili computer"'Read all machine profiles'
ApplicazioneApplication Machine.ReadWrite.AllMachine.ReadWrite.All "Leggere e scrivere tutte le informazioni sul computer"'Read and write all machine information'
Delegato (account aziendale o dell'istituto di istruzione)Delegated (work or school account) Machine.ReadMachine.Read "Leggere le informazioni sul computer"'Read machine information'
Delegato (account aziendale o dell'istituto di istruzione)Delegated (work or school account) Machine.ReadWriteMachine.ReadWrite "Leggere e scrivere informazioni sul computer"'Read and write machine information'

Nota

Quando si ottiene un token utilizzando le credenziali utente:When obtaining a token using user credentials:

  • L'utente deve disporre almeno dell'autorizzazione di ruolo seguente: 'Visualizza dati' (per ulteriori informazioni, vedere Creare e gestire ruoli)The user needs to have at least the following role permission: 'View Data' (See Create and manage roles for more information)

Richiesta HTTPHTTP request

GET https://api.securitycenter.microsoft.com/api/machineactions/{id}

Intestazioni di richiestaRequest headers

NameName TipoType DescrizioneDescription
AutorizzazioneAuthorization StringaString Bearer {token}.Bearer {token}. Obbligatorio.Required.

Corpo della richiestaRequest body

VuotoEmpty

RispostaResponse

Se ha esito positivo, questo metodo restituisce 200 codice di risposta Ok con un'entità Machine Action.If successful, this method returns 200, Ok response code with a Machine Action entity. Se l'entità azione del computer con l'ID specificato non è stata trovata - 404 Non trovato.If machine action entity with the specified id was not found - 404 Not Found.

EsempioExample

RichiestaRequest

Ecco un esempio della richiesta.Here is an example of the request.

GET https://api.securitycenter.microsoft.com/api/machineactions/2e9da30d-27f6-4208-81f2-9cd3d67893ba

RispostaResponse

Ecco un esempio di risposta.Here is an example of the response.

HTTP/1.1 200 Ok
Content-type: application/json
{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#MachineActions/$entity",
    "id": "5382f7ea-7557-4ab7-9782-d50480024a4e",
    "type": "Isolate",
    "scope": "Selective",
    "requestor": "Analyst@TestPrd.onmicrosoft.com",
    "requestorComment": "test for docs",
    "status": "Succeeded",
    "machineId": "7b1f4967d9728e5aa3c06a9e617a22a4a5a17378",
    "computerDnsName": "desktop-test",
    "creationDateTimeUtc": "2019-01-02T14:39:38.2262283Z",
    "lastUpdateDateTimeUtc": "2019-01-02T14:40:44.6596267Z",
    "relatedFileInfo": null
}