Compartir vía

Obtener una actividad de corrección de acuerdo con su id

  • Artículo

Se aplica a:

¿Quiere experimentar Microsoft Defender para punto de conexión? Regístrese para obtener una evaluación gratuita.

¿Desea experimentar la administración de vulnerabilidades de Microsoft Defender? Obtenga más información sobre cómo puede registrarse en la versión preliminar pública de Microsoft Defender Vulnerability Management.

Importante

Parte de la información contenida en este artículo se refiere a un producto preliminar que puede sufrir modificaciones sustanciales antes de su lanzamiento comercial. Microsoft no otorga garantías, expresas o implícitas, con respecto a la información que aquí se proporciona.

Nota:

Si es un cliente del Gobierno de EE. UU., use los URI que aparecen en Microsoft Defender para punto de conexión para clientes del Gobierno de EE. UU.

Sugerencia

Para mejorar el rendimiento, puede usar el servidor más cercano a la ubicación geográfica:

  • us.api.security.microsoft.com
  • eu.api.security.microsoft.com
  • uk.api.security.microsoft.com
  • au.api.security.microsoft.com
  • swa.api.security.microsoft.com
  • ina.api.security.microsoft.com

Descripción de la API

Devuelve información para la actividad de corrección especificada. Presenta las mismas columnas que Get all remediation activity", pero devuelve los resultados solo para la actividad de corrección especificada.

Obtenga más información sobre las actividades de corrección.

Enumerar una actividad de corrección especificada para (id.)

URL: GET: /api/remediationTasks/{id}

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, consulte Uso de Las API de Microsoft Defender para punto de conexión para obtener más información.

Tipo de permiso Permiso Nombre para mostrar del permiso
Aplicación RemediationTasks.Read.All "Leer información sobre vulnerabilidades de administración de amenazas y vulnerabilidades"
Delegado (cuenta profesional o educativa) RemediationTask.Read.Read "Leer información sobre vulnerabilidades de administración de amenazas y vulnerabilidades"

Propiedades

Propiedad (ID) Tipo de datos Descripción Ejemplo de un valor devuelto
Categoría Cadena Categoría de la actividad de corrección (configuración de software/seguridad) Software
completerEmail Cadena Si alguien completó manualmente la actividad de corrección, esta columna contiene su correo electrónico. Null
completerId Cadena Si alguien completó manualmente la actividad de corrección, esta columna contiene su identificador de objeto. Null
completionMethod Cadena Una actividad de corrección se puede completar "automáticamente" (si todos los dispositivos están revisados) o "manualmente" por una persona que selecciona "marcar como completado" Automático
createdOn DateTime Hora en que se creó esta actividad de corrección 2021-01-12T18:54:11.5499478Z
Descripción Cadena Descripción de esta actividad de corrección Actualice Microsoft Silverlight a una versión posterior para mitigar las vulnerabilidades conocidas que afectan a los dispositivos.
dueOn DateTime Fecha de vencimiento establecida por el creador para esta actividad de corrección 2021-01-13T00:00:00Z
fixedDevices Número de dispositivos que se han corregido 2
Id. Cadena Identificador de esta actividad de corrección 097d9735-5479-4899-b1b7-77398899df92
nameId Cadena Nombre del producto relacionado Microsoft Silverlight
Prioridad Cadena Prioridad del creador establecido para esta actividad de corrección (Alto\Medio\Bajo) Alto
Productid Cadena Identificador de producto relacionado microsoft-_-silverlight
productivityImpactRemediationType Cadena Solo se pueden solicitar algunos cambios de configuración para los dispositivos que no afectan a los usuarios. Este valor indica la selección entre "todos los dispositivos expuestos" o "solo los dispositivos sin ningún impacto en el usuario". AllExposedAssets
rbacGroupNames Cadena Nombres de grupos de dispositivos relacionados [ "Servidores Windows", "Windows 11", "Windows 10" ]
recommendedProgram Cadena Programa recomendado para actualizar a Null
recommendedVendor Cadena Proveedor recomendado para actualizar a Null
recommendedVersion Cadena Versión recomendada para actualizar o actualizar a Null
relatedComponent Cadena Componente relacionado de esta actividad de corrección (similar al componente relacionado para una recomendación de seguridad) Microsoft Silverlight
requesterEmail Cadena Dirección de correo electrónico de Creator globaladmin@UserName.contoso.com
requesterId Cadena Identificador de objeto de Creator r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes Cadena Las notas (texto libre) que el creador agregó para esta actividad de corrección Null
Scid Cadena SCID de la recomendación de seguridad relacionada Null
Estado Cadena Estado de la actividad de corrección (activo/completado) Activo
statusLastModifiedOn DateTime Fecha en que se actualizó el campo de estado 2021-01-12T18:54:11.5499487Z
targetDevices Long Número de dispositivos expuestos a los que se aplica esta corrección 43
Título Cadena Título de esta actividad de corrección Microsoft Silverlight
Tipo Cadena Tipo de corrección Actualizar
vendorId Cadena Nombre del proveedor relacionado Microsoft

Ejemplo

Ejemplo de solicitud

GET https://api.securitycenter.windows.com/api/remediationtasks/03942ef5-aecb-4c6e-b555-d6a97013844c

Ejemplo de respuesta

{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#RemediationTasks/$entity",
    "id": "03942ef5-aecb-4c6e-b555-d6a97013844c",
    "title": "Update Microsoft Silverlight",
    "createdOn": "2021-02-10T13:20:36.4718166Z",
    "requesterId": "65548a1d-efo0-4a7a-8d19-1b967b5c36f4",
    "requesterEmail": "user1@contoso.com",
    "status": "Active",
    "statusLastModifiedOn": "2021-02-10T13:20:36.4719698Z",
    "description": "Update Silverlight to a later version to mitigate 55 known vulnerabilities affecting your devices. Doing so can help lessen the security risk to your organization due to versions which have reached their end-of-support.",
    "relatedComponent": "Microsoft Silverlight",
    "targetDevices": 18511,
    "rbacGroupNames": [
        "UnassignedGroup",
        "hhh"
    ],
    "fixedDevices": 2866,
    "requesterNotes": "test",
    "dueOn": "2021-02-11T00:00:00Z",
    "category": "Software",
    "productivityImpactRemediationType": null,
    "priority": "Medium",
    "completionMethod": null,
    "completerId": null,
    "completerEmail": null,
    "scid": null,
    "type": "Update",
    "productId": "microsoft-_-silverlight",
    "vendorId": "microsoft",
    "nameId": "silverlight",
    "recommendedVersion": null,
    "recommendedVendor": null,
    "recommendedProgram": null
}

Vea también

Sugerencia

¿Desea obtener más información? Interactúe con la comunidad de seguridad de Microsoft en nuestra comunidad tecnológica: Microsoft Defender para punto de conexión Tech Community.