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
Importante: Microsoft admite las API de Intune/beta, pero están sujetas a cambios más frecuentes. Microsoft recomienda usar la versión v1.0 siempre que sea posible. Comprobar la disponibilidad de una API en la versión v1.0 mediante el selector de versión.
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Actualice las propiedades de un objeto deviceConfigurationDeviceOverview.
Esta API está disponible en las siguientes implementaciones en la nube nacional.
| Servicio global | Administración pública de EE. UU. | Gobierno de EE. UU. L5 (DOD) | China operado 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) | DeviceManagementConfiguration.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | DeviceManagementConfiguration.ReadWrite.All |
Solicitud HTTP
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/deviceStatusOverview
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/rootCertificate/deviceStatusOverview
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.iosScepCertificateProfile/rootCertificate/deviceStatusOverview
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.macOSScepCertificateProfile/rootCertificate/deviceStatusOverview
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsPhone81SCEPCertificateProfile/rootCertificate/deviceStatusOverview
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsWifiEnterpriseEAPConfiguration/identityCertificateForClientAuthentication/deviceStatusOverview
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsWifiEnterpriseEAPConfiguration/rootCertificatesForServerValidation/{windows81TrustedRootCertificateId}/deviceStatusOverview
Encabezados de solicitud
| Encabezado | Valor |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización. |
| Aceptar | application/json |
Cuerpo de la solicitud
En el cuerpo de la solicitud, especifique una representación JSON del objeto deviceConfigurationDeviceOverview.
En la tabla siguiente se muestran las propiedades necesarias para crear el objeto deviceConfigurationDeviceOverview.
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | Cadena | Clave de la entidad. |
| pendingCount | Int32 | Número de dispositivos pendientes |
| notApplicableCount | Int32 | Número de dispositivos no aplicables |
| notApplicablePlatformCount | Int32 | Número de dispositivos no aplicables debido a que la plataforma y la directiva no coinciden |
| successCount | Int32 | Número de dispositivos correctos |
| errorCount | Int32 | Número de dispositivos con error |
| failedCount | Int32 | Número de dispositivos erróneos |
| conflictCount | Int32 | Número de dispositivos en conflicto |
| lastUpdateDateTime | DateTimeOffset | Última hora de actualización |
| configurationVersion | Int32 | Versión de la directiva para esa información general |
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y un objeto deviceConfigurationDeviceOverview actualizado en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}/deviceStatusOverview
Content-type: application/json
Content-length: 345
{
"@odata.type": "#microsoft.graph.deviceConfigurationDeviceOverview",
"pendingCount": 12,
"notApplicableCount": 2,
"notApplicablePlatformCount": 10,
"successCount": 12,
"errorCount": 10,
"failedCount": 11,
"conflictCount": 13,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00",
"configurationVersion": 4
}
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: 394
{
"@odata.type": "#microsoft.graph.deviceConfigurationDeviceOverview",
"id": "62d48e3a-8e3a-62d4-3a8e-d4623a8ed462",
"pendingCount": 12,
"notApplicableCount": 2,
"notApplicablePlatformCount": 10,
"successCount": 12,
"errorCount": 10,
"failedCount": 11,
"conflictCount": 13,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00",
"configurationVersion": 4
}