Obtener api machineActionGet machineAction API

Se aplica a: Microsoft Defender para endpointApplies to: Microsoft Defender for Endpoint

Nota

Si es un cliente del Gobierno de Estados Unidos, use los URI que aparecen en Microsoft Defender para endpoints para clientes de US Government.If you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

Sugerencia

Para un mejor rendimiento, puede usar el servidor más cerca de la ubicación 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

Descripción de la APIAPI description

Recupera una acción de máquina específica por su identificador.Retrieves specific Machine Action by its ID.

LimitacionesLimitations

  1. Las limitaciones de velocidad para esta API son 100 llamadas por minuto y 1500 llamadas por hora.Rate limitations for this API are 100 calls per minute and 1500 calls per hour.

PermisosPermissions

Se requiere uno de los siguientes permisos para llamar a esta API.One of the following permissions is required to call this API. Para obtener más información, incluido cómo elegir permisos, consulte Use Defender for Endpoint APITo learn more, including how to choose permissions, see Use Defender for Endpoint APIs

Tipo de permisoPermission type PermisoPermission Nombre para mostrar de permisosPermission display name
AplicaciónApplication Machine.Read.AllMachine.Read.All 'Leer todos los perfiles de máquina''Read all machine profiles'
AplicaciónApplication Machine.ReadWrite.AllMachine.ReadWrite.All 'Leer y escribir toda la información de la máquina''Read and write all machine information'
Delegado (cuenta profesional o educativa)Delegated (work or school account) Machine.ReadMachine.Read 'Leer información de máquina''Read machine information'
Delegado (cuenta profesional o educativa)Delegated (work or school account) Machine.ReadWriteMachine.ReadWrite 'Leer y escribir información de máquina''Read and write machine information'

Nota

Al obtener un token con credenciales de usuario:When obtaining a token using user credentials:

  • El usuario debe tener al menos el siguiente permiso de función: "Ver datos" (vea Crear y administrar roles para obtener más información)The user needs to have at least the following role permission: 'View Data' (See Create and manage roles for more information)

Solicitud HTTPHTTP request

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

Encabezados de solicitudRequest headers

NombreName TipoType DescripciónDescription
AuthorizationAuthorization CadenaString Portador {token}.Bearer {token}. Necesario.Required.

Cuerpo de la solicitudRequest body

En blancoEmpty

RespuestaResponse

Si se realiza correctamente, este método devuelve 200, código de respuesta Ok con una entidad Machine Action.If successful, this method returns 200, Ok response code with a Machine Action entity. Si no se encontró la entidad de acción de la máquina con el identificador especificado: 404 No encontrado.If machine action entity with the specified id was not found - 404 Not Found.

EjemploExample

SolicitudRequest

Aquí tiene un ejemplo de la solicitud.Here is an example of the request.

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

RespuestaResponse

Aquí tiene un ejemplo de la respuesta.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
}