Actualizar deviceManagementCachedReportConfiguration

Espacio de nombres: microsoft.graph

Importante: Las API Graph Microsoft en la versión /beta están sujetas a cambios; no se admite el uso de producció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 deviceManagementCachedReportConfiguration.

Requisitos previos

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, DeviceManagementManagedDevices.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All

Solicitud HTTP

PATCH /deviceManagement/reports/cachedReportConfigurations/{deviceManagementCachedReportConfigurationId}

Encabezados de solicitud

Encabezado Valor
Authorization Se requiere <token> de portador.
Aceptar application/json

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON para el objeto deviceManagementCachedReportConfiguration.

En la tabla siguiente se muestran las propiedades necesarias para crear el objeto deviceManagementCachedReportConfiguration.

Propiedad Tipo Descripción
id Cadena Identificador único de esta entidad
reportName Cadena Nombre del informe
filter Cadena Filtros aplicados al crear informes.
select Colección string Columnas seleccionadas del informe
orderBy Colección string Ordenación de columnas en el informe
metadatos Cadena Metadatos administrados por el autor de la llamada asociados al informe
status deviceManagementReportStatus Estado del informe almacenado en caché. Los valores posibles son: unknown, notStarted, inProgress, completed y failed.
lastRefreshDateTime DateTimeOffset Hora en que se actualizó por última vez el informe almacenado en caché
expirationDateTime DateTimeOffset Hora en que expira el informe almacenado en caché

Respuesta

Si se realiza correctamente, este método devuelve un código de respuesta y un 200 OK objeto deviceManagementCachedReportConfiguration actualizado en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

PATCH https://graph.microsoft.com/beta/deviceManagement/reports/cachedReportConfigurations/{deviceManagementCachedReportConfigurationId}
Content-type: application/json
Content-length: 418

{
  "@odata.type": "#microsoft.graph.deviceManagementCachedReportConfiguration",
  "reportName": "Report Name value",
  "filter": "Filter value",
  "select": [
    "Select value"
  ],
  "orderBy": [
    "Order By value"
  ],
  "metadata": "Metadata value",
  "status": "notStarted",
  "lastRefreshDateTime": "2016-12-31T23:58:49.97047-08:00",
  "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00"
}

Respuesta

Aquí tiene un ejemplo de la respuesta. Nota: Puede que el objeto de respuesta que aparece aquí se trunque para abreviar. Todas las propiedades se devolverán de una llamada real.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 467

{
  "@odata.type": "#microsoft.graph.deviceManagementCachedReportConfiguration",
  "id": "46947722-7722-4694-2277-944622779446",
  "reportName": "Report Name value",
  "filter": "Filter value",
  "select": [
    "Select value"
  ],
  "orderBy": [
    "Order By value"
  ],
  "metadata": "Metadata value",
  "status": "notStarted",
  "lastRefreshDateTime": "2016-12-31T23:58:49.97047-08:00",
  "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00"
}