title | description | author | ms.localizationpriority | ms.subservice | doc_type |
---|---|---|---|---|---|
Get cloudPcExportJob |
Read the properties and relationships of a cloudPcExportJob object. |
AshleyYangSZ |
medium |
cloud-pc |
apiPageType |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
Read the properties and relationships of a cloudPcExportJob object.
You can download a report by first creating a new cloudPcExportJob resource to initiate downloading.
Use this GET operation to verify the exportJobStatus property of the cloudPcExportJob resource. The property becomes completed
when the report finishes downloading in the location specified by the exportUrl property.
[!INCLUDE national-cloud-support]
Choose the least privileged permission or permissions to download reports with this API. Delegated access require read access to the report that you need to export. App-only tokens with CloudPC.ReadWrite.All have permission or permissions to download all reports without specific permission. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.
[!INCLUDE permissions-table]
The following permissions in the in the Cloud PC admin portal provide access to specific kinds of reports:
- ActionStatus/Read
- DeviceRecommendation/Read
- CrossRegionDisasterRecovery/Read
- FrontlineReports/Read
- InaccessibleReports/Read
- PerformanceReports/Read
GET /deviceManagement/virtualEndpoint/reports/exportJobs/{cloudPcExportJobId}
This method supports some of the OData query parameters to help customize the response. For general information, see OData query parameters.
Name | Description |
---|---|
Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
Don't supply a request body for this method.
If successful, this method returns a 200 OK
response code and a cloudPcExportJob object in the response body.
The following example shows how to get an export job that a POST request for the TotalAggregatedRemoteConnectionReports
report created.
The following example shows a request.
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/exportJobs/TotalAggregatedRemoteConnectionReports__d39979c9-a0a2-4916-a158-1b984742ffff
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
The following example shows the response.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": {
"@odata.type": "#microsoft.graph.cloudPcExportJob",
"id": "TotalAggregatedRemoteConnectionReports__d39979c9-a0a2-4916-a158-1b984742ffff",
"reportName": "totalAggregatedRemoteConnectionReports",
"format": "csv",
"select": ["CloudPcId", "ManagedDeviceName", "UserPrincipalName", "DaysSinceLastSignIn", "TotalUsageInHour"],
"filter": null,
"requestDateTime": "2022-09-16T12:00:06.5137388Z",
"expirationDateTime": "0001-01-01T00:00:00Z",
"exportJobStatus": "completed",
"exportUrl": "https://westus01repexpstorage.blob.core.windows.net/599fe3a3-0285-4e7f-9c83-ffdf37914e27/remoteConnectionEvents_af34378a-cf5a-418d-b735-54b0ee155118.zip"
}
}
The following example shows how to get an export job that a POST request for the RemoteConnectionQualityReports
report created.
The following example shows a request.
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/exportJobs/RemoteConnectionQualityReports__85678957-6202-4e29-97e6-eb26ef07f330
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
The following example shows the response.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": {
"@odata.type": "#microsoft.graph.cloudPcExportJob",
"id": "RemoteConnectionQualityReports__85678957-6202-4e29-97e6-eb26ef07f330",
"reportName": "remoteConnectionQualityReports",
"format": "csv",
"select": ["CloudPcId", "ManagedDeviceName", "UserPrincipalName", "DaysSinceLastSignIn", "TotalUsageInHour"],
"filter": null,
"requestDateTime": "2023-06-14T07:40:41.694Z",
"expirationDateTime": "",
"exportJobStatus": "completed",
"exportUrl": "https://westus01repexpstorage.blob.core.windows.net/599fe3a3-0285-4e7f-9c83-ffdf37914e27/remoteConnectionHistoricalReports_af34378a-cf5a-418d-b735-54b0ee155118.zip"
}
}