Compartir a través de


Actualizar managedAppLogCollectionRequest

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"
}