创建 deviceManagementExportJob

命名空间：microsoft.graph

注意： 适用于 Intune 的 Microsoft Graph API 需要适用于租户的 活动 Intune 许可证。

创建新的 deviceManagementExportJob 对象。

先决条件

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementApps.ReadWrite.All、DeviceManagementManagedDevices.ReadWrite.All
委派（个人 Microsoft 帐户）	不支持。
应用程序	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementApps.ReadWrite.All、DeviceManagementManagedDevices.ReadWrite.All

HTTP 请求

POST /deviceManagement/reports/exportJobs

请求标头

标头	值
Authorization	Bearer <token>。必需。
接受	application/json

请求正文

在请求正文中，为 deviceManagementExportJob 对象提供 JSON 表示形式。

下表显示了创建 deviceManagementExportJob 时所需的属性。

属性	类型	说明
id	String	此实体的唯一标识符
reportName	字符串	报表的名称
filter	字符串	对报表应用的筛选器
select	字符串集合	从报表中选择的列
format	deviceManagementReportFileFormat	导出的报表的格式。 可取值为：csv、pdf。
snapshotId	String	快照是由 ReportName 表示的数据集的可识别子集。 可以在此处使用 sessionId 或 CachedReportConfiguration ID。 如果指定了 sessionId，则会将 Filter、Select 和 OrderBy 应用到由 sessionId 表示的数据。 无法将 Filter、Select 和 OrderBy 与 CachedReportConfiguration ID 一起指定。
localizationType	deviceManagementExportJobLocalizationType	配置请求的导出作业的本地化方式。 可取值为：localizedValuesAsAdditionalColumn、replaceLocalizableValues。
status	deviceManagementReportStatus	导出作业的状态。 可取值为：unknown、notStarted、inProgress、completed、failed。
url	String	导出报表的临时位置
requestDateTime	DateTimeOffset	请求导出报表的时间
expirationDateTime	DateTimeOffset	导出的报表过期的时间

响应

如果成功，此方法在响应正文中返回 201 Created 响应代码和 deviceManagementExportJob 对象。

示例

请求

下面是一个请求示例。

POST https://graph.microsoft.com/v1.0/deviceManagement/reports/exportJobs
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 201 Created
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"
}