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 Intune API /beta, pero están sujetas a cambios más frecuentes. Microsoft recomienda usar la versión v1.0 siempre que sea posible. Compruebe la disponibilidad de una API en la versión v1.0 mediante el selector de versiones.
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Cree un nuevo objeto deviceLogCollectionResponse .
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) | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All |
Solicitud HTTP
POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/logCollectionRequests
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 deviceLogCollectionResponse.
En la tabla siguiente se muestran las propiedades necesarias al crear deviceLogCollectionResponse.
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | Cadena | Identificador único en forma de tenantId_deviceId_requestId. |
| status | appLogUploadState | Indica el estado de la solicitud de recopilación de registros de aplicaciones si está pendiente, completada o con errores, El valor predeterminado está pendiente. Los valores posibles son: pending, completed, failed y unknownFutureValue |
| managedDeviceId | Guid | Indica Intune identificador único del dispositivo. |
| errorCode | Int64 | El código de error, si existe. Valores válidos -9.22337203685478E+18 a 9.22337203685478E+18 |
| requestedDateTimeUTC | DateTimeOffset | DateTime de la solicitud. |
| receivedDateTimeUTC | DateTimeOffset | Fecha y hora en que se recibió la solicitud. |
| initiatedByUserPrincipalName | Cadena | UPN para quién inició la solicitud. |
| expirationDateTimeUTC | DateTimeOffset | DateTime de la expiración de los registros. |
| size | Doble | Tamaño de los registros. Valores válidos -1.79769313486232E+308 a 1.79769313486232E+308 |
| sizeInKB | Doble | Tamaño de los registros en KB. Valores válidos -1.79769313486232E+308 a 1.79769313486232E+308 |
| inscritoByUser | Cadena | Nombre principal de usuario (UPN) del usuario que inscribió el dispositivo. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto deviceLogCollectionResponse en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
POST https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/logCollectionRequests
Content-type: application/json
Content-length: 558
{
"@odata.type": "#microsoft.graph.deviceLogCollectionResponse",
"status": "completed",
"managedDeviceId": "3b336f00-6f00-3b33-006f-333b006f333b",
"errorCode": 9,
"requestedDateTimeUTC": "2016-12-31T23:57:40.7845755-08:00",
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00",
"initiatedByUserPrincipalName": "Initiated By User Principal Name value",
"expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
"size": 1.3333333333333333,
"sizeInKB": 2.6666666666666665,
"enrolledByUser": "Enrolled By User value"
}
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 201 Created
Content-Type: application/json
Content-Length: 607
{
"@odata.type": "#microsoft.graph.deviceLogCollectionResponse",
"id": "05fb97dc-97dc-05fb-dc97-fb05dc97fb05",
"status": "completed",
"managedDeviceId": "3b336f00-6f00-3b33-006f-333b006f333b",
"errorCode": 9,
"requestedDateTimeUTC": "2016-12-31T23:57:40.7845755-08:00",
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00",
"initiatedByUserPrincipalName": "Initiated By User Principal Name value",
"expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
"size": 1.3333333333333333,
"sizeInKB": 2.6666666666666665,
"enrolledByUser": "Enrolled By User value"
}