Obtener recomendación por identificadorGet recommendation by ID

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

Importante

Parte de la información se refiere a productos preliminares que pueden ser modificados sustancialmente antes de su lanzamiento comercial.Some information relates to prereleased product which may be substantially modified before it's commercially released. Microsoft no otorga garantías, expresas o implícitas, con respecto a la información que aquí se proporciona.Microsoft makes no warranties, express or implied, with respect to the information provided here.

Recupera una recomendación de seguridad por su identificador.Retrieves a security recommendation by its ID.

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 Microsoft Defender for Endpoint API para obtener más información.To learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs for details.

Tipo de permisoPermission type PermisoPermission Nombre para mostrar de permisosPermission display name
AplicaciónApplication SecurityRecommendation.Read.AllSecurityRecommendation.Read.All 'Leer información de recomendación de seguridad de administración de amenazas y vulnerabilidades''Read Threat and Vulnerability Management security recommendation information'
Delegado (cuenta profesional o educativa)Delegated (work or school account) SecurityRecommendation.ReadSecurityRecommendation.Read 'Leer información de recomendación de seguridad de administración de amenazas y vulnerabilidades''Read Threat and Vulnerability Management security recommendation information'

Solicitud HTTPHTTP request

GET /api/recommendations/{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 Aceptar con las recomendaciones de seguridad del cuerpo.If successful, this method returns 200 OK with the security recommendations in the body.

EjemploExample

SolicitudRequest

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

GET https://api.securitycenter.microsoft.com/api/recommendations/va-_-google-_-chrome

RespuestaResponse

Aquí tiene un ejemplo de la respuesta.Here is an example of the response.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Recommendations/$entity",
    "id": "va-_-google-_-chrome",
    "productName": "chrome",
    "recommendationName": "Update Chrome",
    "weaknesses": 38,
    "vendor": "google",
    "recommendedVersion": "",
    "recommendationCategory": "Application",
    "subCategory": "",
    "severityScore": 0,
    "publicExploit": false,
    "activeAlert": false,
    "associatedThreats": [],
    "remediationType": "Update",
    "status": "Active",
    "configScoreImpact": 0,
    "exposureImpact": 3.9441860465116285,
    "totalMachineCount": 6,
    "exposedMachinesCount": 5,
    "nonProductivityImpactedAssets": 0,
    "relatedComponent": "Chrome"
}