Obtener deviceManagement
Espacio de nombres: microsoft.graph
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Lea las propiedades y las relaciones del objeto deviceManagement.
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.Read.All, DeviceManagementManagedDevices.ReadWrite.All |
Delegado (cuenta personal de Microsoft) | No admitida. |
Aplicación | DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All |
Solicitud HTTP
GET /deviceManagement
Parámetros de consulta opcionales
Este método admite los parámetros de consulta de OData a modo de ayuda para personalizar la respuesta.
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
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK
y el objeto deviceManagement en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
GET https://graph.microsoft.com/v1.0/deviceManagement
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: 2854
{
"value": {
"@odata.type": "#microsoft.graph.deviceManagement",
"id": "0b283420-3420-0b28-2034-280b2034280b",
"subscriptionState": "active",
"deviceProtectionOverview": {
"@odata.type": "microsoft.graph.deviceProtectionOverview",
"totalReportedDeviceCount": 8,
"inactiveThreatAgentDeviceCount": 14,
"unknownStateThreatAgentDeviceCount": 2,
"pendingSignatureUpdateDeviceCount": 1,
"cleanDeviceCount": 0,
"pendingFullScanDeviceCount": 10,
"pendingRestartDeviceCount": 9,
"pendingManualStepsDeviceCount": 13,
"pendingOfflineScanDeviceCount": 13,
"criticalFailuresDeviceCount": 11,
"pendingQuickScanDeviceCount": 11
},
"windowsMalwareOverview": {
"@odata.type": "microsoft.graph.windowsMalwareOverview",
"malwareDetectedDeviceCount": 10,
"totalMalwareCount": 1,
"totalDistinctMalwareCount": 9,
"malwareStateSummary": [
{
"@odata.type": "microsoft.graph.windowsMalwareStateCount",
"state": "actionFailed",
"deviceCount": 11,
"malwareDetectionCount": 5,
"distinctMalwareCount": 4,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00"
}
],
"malwareSeveritySummary": [
{
"@odata.type": "microsoft.graph.windowsMalwareSeverityCount",
"severity": "low",
"malwareDetectionCount": 5,
"distinctMalwareCount": 4,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00"
}
],
"malwareExecutionStateSummary": [
{
"@odata.type": "microsoft.graph.windowsMalwareExecutionStateCount",
"executionState": "blocked",
"deviceCount": 11,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00"
}
],
"malwareCategorySummary": [
{
"@odata.type": "microsoft.graph.windowsMalwareCategoryCount",
"category": "adware",
"deviceCount": 11,
"activeMalwareDetectionCount": 11,
"distinctActiveMalwareCount": 10,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00"
}
],
"malwareNameSummary": [
{
"@odata.type": "microsoft.graph.windowsMalwareNameCount",
"malwareIdentifier": "Malware Identifier value",
"name": "Name value",
"deviceCount": 11,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00"
}
],
"osVersionsSummary": [
{
"@odata.type": "microsoft.graph.osVersionCount",
"osVersion": "Os Version value",
"deviceCount": 11,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00"
}
]
}
}
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de