Obter a API machineActionGet machineAction API

Aplica-se a: Microsoft Defender para Ponto de ExtremidadeApplies to: Microsoft Defender for Endpoint

Observação

Se você for um cliente do Governo dos EUA, use os URIs listados no Microsoft Defender for Endpoint para clientes do Governo dos EUA.If you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

Dica

Para melhorar o desempenho, você pode usar o servidor mais próximo de sua localização geográfica: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

Descrição da APIAPI description

Recupera a Ação do Computador específica por sua ID.Retrieves specific Machine Action by its ID.

LimitaçõesLimitations

  1. Limitações de taxa para essa API são 100 chamadas por minuto e 1500 chamadas por hora.Rate limitations for this API are 100 calls per minute and 1500 calls per hour.

PermissõesPermissions

Uma das seguintes permissões é necessária para chamar essa API.One of the following permissions is required to call this API. Para saber mais, incluindo como escolher permissões, consulte Use Defender for Endpoint APIsTo learn more, including how to choose permissions, see Use Defender for Endpoint APIs

Tipo de permissãoPermission type PermissãoPermission Nome de exibição de permissãoPermission display name
AplicativoApplication Machine.Read.AllMachine.Read.All 'Ler todos os perfis de máquina''Read all machine profiles'
AplicativoApplication Machine.ReadWrite.AllMachine.ReadWrite.All 'Ler e gravar todas as informações do computador''Read and write all machine information'
Delegado (conta corporativa ou de estudante)Delegated (work or school account) Machine.ReadMachine.Read 'Ler informações do computador''Read machine information'
Delegado (conta corporativa ou de estudante)Delegated (work or school account) Machine.ReadWriteMachine.ReadWrite 'Informações de máquina de leitura e gravação''Read and write machine information'

Observação

Ao obter um token usando credenciais de usuário:When obtaining a token using user credentials:

  • O usuário precisa ter pelo menos a seguinte permissão de função: 'Exibir Dados' (Consulte Criar e gerenciar funções para obter mais informações)The user needs to have at least the following role permission: 'View Data' (See Create and manage roles for more information)

Solicitação HTTPHTTP request

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

Cabeçalhos de solicitaçãoRequest headers

NomeName TipoType DescriçãoDescription
AutorizaçãoAuthorization Cadeia de caracteresString Portador {token}.Bearer {token}. Obrigatório.Required.

Corpo da solicitaçãoRequest body

VazioEmpty

RespostaResponse

Se tiver êxito, este método retornará 200, código de resposta Ok com uma entidade Ação de Máquina.If successful, this method returns 200, Ok response code with a Machine Action entity. Se a entidade de ação do computador com a id especificada não for encontrada - 404 Não Encontrado.If machine action entity with the specified id was not found - 404 Not Found.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

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

ResponseResponse

Veja a seguir um exemplo da resposta.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
}