Obter a API de Ação Automática do Machine

Aplica-se a:

Quer experimentar o Microsoft Defender para Endpoint? Inscreva-se numa versão de avaliação gratuita.

Nota

Se for um cliente do Governo dos E.U.A., utilize os URIs listados no Microsoft Defender para o Endpoint para clientes do Governo dos EUA.

Dica

Para um melhor desempenho, pode utilizar o servidor mais perto da sua localização geográfica:

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

Descrição da API

Oltém a Ação automática específica através do res suas IDs.

Limitações

  • As limitações de tarifas desta API são de 100 chamadas por minuto e de 1500 chamadas por hora.

Permissões

É necessária uma das seguintes permissões para chamar esta API. Para saber mais, incluindo como escolher permissões, consulte Utilizar o Defender para APIs de Pontos Finais.

Tipo de permissão Permissão Nome a apresentar da permissão
Aplicação Machine.Read.All "Ler todos os perfis de máquina"
Aplicação Machine.ReadWrite.All "Ler e escrever todas as informações do máquina"
Delegado (conta escolar ou escolar) Machine.Read "Ler informações do máquina"
Delegado (conta escolar ou escolar) Machine.ReadWrite "Ler e escrever informações do máquina"

Nota

Ao obter um token com credenciais de utilizador:

  • O utilizador precisa de ter, pelo menos, a seguinte permissão de função: "Ver Dados" (Consulte Criar e gerir funções para obter mais informações)

Pedido HTTP

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

Pedir cabeçalhos

Name Tipo Descrição
Autorização Cadeia Bearer {token}. Obrigatório.

Pedir corpo

Vazio

Resposta

Se for bem-sucedido, este método devolve 200, Ok código de resposta com uma entidade de Ação Automática. Se a entidade de ação automática com o ID especificado não for encontrada - 404 Não Encontrado.

Exemplos:

Pedido de exemplo

Eis um exemplo do pedido.

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

Exemplo de resposta

Eis um exemplo da resposta.

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
}