Поделиться через


Обновление deviceManagementExportJob

Пространство имен: microsoft.graph

Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.

Обновите свойства объекта deviceManagementExportJob .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись) DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается.
Приложение DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All

HTTP-запрос

PATCH /deviceManagement/reports/exportJobs/{deviceManagementExportJobId}

Заголовки запроса

Заголовок Значение
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Accept application/json

Текст запроса

В тексте запроса укажите представление объекта deviceManagementExportJob в формате JSON.

В следующей таблице показаны свойства, необходимые при создании deviceManagementExportJob.

Свойство Тип Описание
id String Уникальный идентификатор для этой сущности
reportName String Имя отчета
filter String Фильтры, примененные к отчету
select Коллекция строк Столбцы, выбранные в отчете
format deviceManagementReportFileFormat Формат экспортированного отчета. Возможные значения: csv, pdf, json, unknownFutureValue.
snapshotId String Snapshot — это идентифицируемое подмножество набора данных, представленного reportName. Здесь можно использовать идентификатор sessionId или CachedReportConfiguration. Если задан идентификатор сеанса, к данным, представленным sessionId, применяются Filter, Select и OrderBy. Filter, Select и OrderBy нельзя указать вместе с идентификатором CachedReportConfiguration.
localizationType deviceManagementExportJobLocalizationType Настраивает способ локализации запрошенного задания экспорта. Возможные значения: localizedValuesAsAdditionalColumn, replaceLocalizableValues.
status deviceManagementReportStatus Состояние задания экспорта. Возможные значения: unknown, notStarted, inProgress, completed, failed.
url String Временное расположение экспортированного отчета
requestDateTime DateTimeOffset Время запроса экспортированного отчета
expirationDateTime DateTimeOffset Время истечения срока действия экспортированного отчета

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и обновленный объект deviceManagementExportJob в тексте отклика.

Пример

Запрос

Ниже приведен пример запроса.

PATCH https://graph.microsoft.com/v1.0/deviceManagement/reports/exportJobs/{deviceManagementExportJobId}
Content-type: application/json
Content-length: 455

{
  "@odata.type": "#microsoft.graph.deviceManagementExportJob",
  "reportName": "Report Name value",
  "filter": "Filter value",
  "select": [
    "Select value"
  ],
  "format": "pdf",
  "snapshotId": "Snapshot Id value",
  "localizationType": "replaceLocalizableValues",
  "status": "notStarted",
  "url": "Url value",
  "requestDateTime": "2017-01-01T00:03:07.1589002-08:00",
  "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00"
}

Отклик

Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.

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

{
  "@odata.type": "#microsoft.graph.deviceManagementExportJob",
  "id": "9ddfb995-b995-9ddf-95b9-df9d95b9df9d",
  "reportName": "Report Name value",
  "filter": "Filter value",
  "select": [
    "Select value"
  ],
  "format": "pdf",
  "snapshotId": "Snapshot Id value",
  "localizationType": "replaceLocalizableValues",
  "status": "notStarted",
  "url": "Url value",
  "requestDateTime": "2017-01-01T00:03:07.1589002-08:00",
  "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00"
}