Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Actualice las propiedades de un objeto windowsMalwareInformation .
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permisos
Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | DeviceManagementManagedDevices.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | DeviceManagementManagedDevices.ReadWrite.All |
Solicitud HTTP
PATCH /deviceManagement/windowsMalwareInformation/{windowsMalwareInformationId}
Encabezados de solicitud
| Encabezado | Valor |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| Aceptar | application/json |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON para el objeto windowsMalwareInformation .
En la tabla siguiente se muestran las propiedades necesarias al crear windowsMalwareInformation.
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | Cadena | Identificador único. Este es el identificador de malware. |
| displayName | Cadena | Indica el nombre del malware |
| additionalInformationUrl | Cadena | Indica una dirección URL informativa para obtener más información sobre el malware. |
| severity | windowsMalwareSeverity | Gravedad del malware. Los valores posibles son: desconocido, bajo, moderado, alto, grave. el valor predeterminado es desconocido. Los valores posibles son: unknown, low, moderate, high, severe. |
| categoría | windowsMalwareCategory | Categoría del malware. Los valores posibles son: invalid, adware, spyware, passwordStealer, trojanDownloader, worm, backdoor, remoteAccessTrojan, trojan, emailFlooder, keylogger, dialer, monitoringSoftware, browserModifier, cookie, browserPlugin, aolExploit, nuker, securityDisabler, jokeProgram, hostileActiveXControl, softwareBundler, stealthNotifier, settingsModifier, toolBar, remoteControlSoftware, trojanFtp, potentialUnwantedSoftware, icqExploit, trojanTelnet, exploit, filesharingProgram, malwareCreationTool, remote_Control_Software, tool, trojanDenialOfService, trojanDropper, trojanMassMailer, trojanMonitoringSoftware, trojanProxyServer, virus, known, unknown, spp, behavior, vulnerability, policy, enterpriseUnwantedSoftware, ransom, hipsRule. el valor predeterminado no es válido. Los valores posibles son: invalid, adware, , spyware, trojanDownloaderpasswordStealer, worm, backdoor, remoteAccessTrojanmalwareCreationToolbrowserPluginhipsRuleaolExploitransomcookieenterpriseUnwantedSoftwarenukerpolicybrowserModifiervulnerabilitysecurityDisablerbehaviormonitoringSoftwaresppjokeProgramunknowndialerknownhostileActiveXControlkeyloggerremote_Control_SoftwaresoftwareBundlertoolstealthNotifiertrojanDenialOfServicetrojanProxyServerfilesharingProgramvirustrojanMonitoringSoftwaretrojanMassMailertrojanDropperexploittrojanTelneticqExploitpotentialUnwantedSoftwareremoteControlSoftwaresettingsModifiertrojanFtptrojanemailFloodertoolBar. |
| lastDetectionDateTime | DateTimeOffset | Indica la última vez que se detectó el malware en UTC. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto windowsMalwareInformation actualizado en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
PATCH https://graph.microsoft.com/v1.0/deviceManagement/windowsMalwareInformation/{windowsMalwareInformationId}
Content-type: application/json
Content-length: 299
{
"@odata.type": "#microsoft.graph.windowsMalwareInformation",
"displayName": "Display Name value",
"additionalInformationUrl": "https://example.com/additionalInformationUrl/",
"severity": "low",
"category": "adware",
"lastDetectionDateTime": "2016-12-31T23:59:27.3805104-08:00"
}
Respuesta
Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 348
{
"@odata.type": "#microsoft.graph.windowsMalwareInformation",
"id": "8ebd2b9b-2b9b-8ebd-9b2b-bd8e9b2bbd8e",
"displayName": "Display Name value",
"additionalInformationUrl": "https://example.com/additionalInformationUrl/",
"severity": "low",
"category": "adware",
"lastDetectionDateTime": "2016-12-31T23:59:27.3805104-08:00"
}