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.
Actualice las propiedades de un objeto managedAppLogCollectionRequest .
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, DeviceManagementApps.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
Solicitud HTTP
PATCH /deviceAppManagement/managedAppRegistrations/{managedAppRegistrationId}/managedAppLogCollectionRequests/{managedAppLogCollectionRequestId}
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 managedAppLogCollectionRequest .
En la tabla siguiente se muestran las propiedades necesarias al crear managedAppLogCollectionRequest.
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | Cadena | Identificador único de la solicitud de recopilación de registros de aplicaciones administradas. Este identificador se asigna durante el tiempo de creación de la solicitud. Solo lectura. |
| managedAppRegistrationId | Cadena | Identificador único de la instancia de la aplicación para la que se recopilaron los registros de diagnóstico. Solo lectura. |
| status | Cadena | Indica el estado de la solicitud de recopilación de registros de aplicaciones: pendiente, completada o con errores. El valor predeterminado está pendiente. |
| requestedBy | Cadena | Nombre principal de usuario asociado a la solicitud para la recopilación de registros de aplicaciones administradas. Solo lectura. |
| requestedByUserPrincipalName | Cadena | Nombre principal de usuario asociado a la solicitud para la recopilación de registros de aplicaciones administradas. Solo lectura. |
| requestedDateTime | DateTimeOffset | DateTime de cuándo se recibió la solicitud de carga del registro. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, medianoche UTC del 1 de enero de 2014 sería así: "2014-01-01T00:00:00Z". Se devuelve de forma predeterminada. Solo lectura. |
| completedDateTime | DateTimeOffset | DateTime de cuándo se completó la solicitud de carga del registro. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, medianoche UTC del 1 de enero de 2014 sería así: "2014-01-01T00:00:00Z". Se devuelve de forma predeterminada. Solo lectura. |
| userLogUploadConsent | managedAppLogUploadConsent | Indica si el usuario asociado al dispositivo proporcionó el consentimiento para la recopilación de registros. El usuario debe dar su consentimiento antes de que se puedan recopilar los registros de diagnóstico. aceptado significa que el usuario ha consentido. rechazado significa que el usuario se ha rechazado. unknown es el valor predeterminado. La solicitud de recopilación de registros debe completarse en un plazo de 24 horas o se abandonará y eliminará. Solo lectura. Los valores posibles son: unknown, declined, accepted y unknownFutureValue. |
| uploadedLogs | colección managedAppLogUpload | La colección de resultados de carga de registros según lo notificado por cada componente del dispositivo. Estos componentes pueden ser la propia aplicación, el SDK de administración de aplicaciones móviles (MAM) y otros componentes en el dispositivo que se solicitan para cargar registros de diagnóstico. Solo lectura. |
| version | Cadena | Versión de la entidad. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto managedAppLogCollectionRequest actualizado en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
PATCH https://graph.microsoft.com/beta/deviceAppManagement/managedAppRegistrations/{managedAppRegistrationId}/managedAppLogCollectionRequests/{managedAppLogCollectionRequestId}
Content-type: application/json
Content-length: 799
{
"@odata.type": "#microsoft.graph.managedAppLogCollectionRequest",
"managedAppRegistrationId": "Managed App Registration Id value",
"status": "Status value",
"requestedBy": "Requested By value",
"requestedByUserPrincipalName": "Requested By User Principal Name value",
"requestedDateTime": "2017-01-01T00:01:49.2071853-08:00",
"completedDateTime": "2016-12-31T23:58:52.3534526-08:00",
"userLogUploadConsent": "declined",
"uploadedLogs": [
{
"@odata.type": "microsoft.graph.managedAppLogUpload",
"managedAppComponent": "Managed App Component value",
"managedAppComponentDescription": "Managed App Component Description value",
"status": "inProgress",
"referenceId": "Reference Id value"
}
],
"version": "Version 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 200 OK
Content-Type: application/json
Content-Length: 848
{
"@odata.type": "#microsoft.graph.managedAppLogCollectionRequest",
"id": "95b5bd26-bd26-95b5-26bd-b59526bdb595",
"managedAppRegistrationId": "Managed App Registration Id value",
"status": "Status value",
"requestedBy": "Requested By value",
"requestedByUserPrincipalName": "Requested By User Principal Name value",
"requestedDateTime": "2017-01-01T00:01:49.2071853-08:00",
"completedDateTime": "2016-12-31T23:58:52.3534526-08:00",
"userLogUploadConsent": "declined",
"uploadedLogs": [
{
"@odata.type": "microsoft.graph.managedAppLogUpload",
"managedAppComponent": "Managed App Component value",
"managedAppComponentDescription": "Managed App Component Description value",
"status": "inProgress",
"referenceId": "Reference Id value"
}
],
"version": "Version value"
}