Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Rufen Sie den rohen Echtzeit-Remoteverbindungsbericht für einen Cloud-PC ohne Berechnung ab, z. B. roundTripTime oder verfügbare Bandbreite, die stündlich aus den Ereignisrohdaten aggregiert werden.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service |
US Government L4 |
US Government L5 (DOD) |
China, betrieben von 21Vianet |
| ✅ |
✅ |
✅ |
❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
| Berechtigungstyp |
Berechtigungen mit den geringsten Berechtigungen |
Berechtigungen mit höheren Berechtigungen |
| Delegiert (Geschäfts-, Schul- oder Unikonto) |
CloudPC.Read.All |
CloudPC.ReadWrite.All |
| Delegiert (persönliches Microsoft-Konto) |
Nicht unterstützt |
Nicht unterstützt |
| Application |
CloudPC.Read.All |
CloudPC.ReadWrite.All |
HTTP-Anforderung
POST /deviceManagement/virtualEndpoint/reports/getRawRemoteConnectionReports
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung der Parameter an.
In der folgenden Tabelle sind die Parameter aufgeführt, die mit dieser Aktion verwendet werden können.
| Parameter |
Typ |
Beschreibung |
| filter |
Zeichenfolge |
OData-Filtersyntax. Unterstützte Filter sind and, or, lt, legt, ge und eq. |
| select |
Zeichenfolgensammlung |
OData-Auswahlsyntax. Die Spalten, die in den Bericht eingeschlossen werden sollen. |
| skip |
Int32 |
Die Anzahl der zu überspringenden Datensätze. |
| Nach oben |
Int32 |
Die höchste Anzahl der zurückzugebenden Datensätze. |
Antwort
Wenn die Aktion erfolgreich verläuft, werden der 200 OK Antwortcode und ein Stream im Antworttext zurückgegeben.
Beispiele
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/getRawRemoteConnectionReports
Content-Type: application/json
Content-length: 199
{
"filter": "ActivityId eq 'cb6ad4c4-8a17-4245-a644-e4436b1ee204'",
"select":["RoundTripTimeInMs", "AvailableBandwidthInMbps", "SignInDateTime"],
"skip": 0,
"top": 50
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.DeviceManagement.VirtualEndpoint.Reports.GetRawRemoteConnectionReports;
var requestBody = new GetRawRemoteConnectionReportsPostRequestBody
{
Filter = "ActivityId eq 'cb6ad4c4-8a17-4245-a644-e4436b1ee204'",
Select = new List<string>
{
"RoundTripTimeInMs",
"AvailableBandwidthInMbps",
"SignInDateTime",
},
Skip = 0,
Top = 50,
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.DeviceManagement.VirtualEndpoint.Reports.GetRawRemoteConnectionReports.PostAsync(requestBody);
mgc-beta device-management virtual-endpoint reports get-raw-remote-connection-reports post --body '{\
"filter": "ActivityId eq 'cb6ad4c4-8a17-4245-a644-e4436b1ee204'",\
"select":["RoundTripTimeInMs", "AvailableBandwidthInMbps", "SignInDateTime"],\
"skip": 0,\
"top": 50\
}\
'
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphdevicemanagement "github.com/microsoftgraph/msgraph-beta-sdk-go/devicemanagement"
//other-imports
)
requestBody := graphdevicemanagement.NewGetRawRemoteConnectionReportsPostRequestBody()
filter := "ActivityId eq 'cb6ad4c4-8a17-4245-a644-e4436b1ee204'"
requestBody.SetFilter(&filter)
select := []string {
"RoundTripTimeInMs",
"AvailableBandwidthInMbps",
"SignInDateTime",
}
requestBody.SetSelect(select)
skip := int32(0)
requestBody.SetSkip(&skip)
top := int32(50)
requestBody.SetTop(&top)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.DeviceManagement().VirtualEndpoint().Reports().GetRawRemoteConnectionReports().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.beta.devicemanagement.virtualendpoint.reports.getrawremoteconnectionreports.GetRawRemoteConnectionReportsPostRequestBody getRawRemoteConnectionReportsPostRequestBody = new com.microsoft.graph.beta.devicemanagement.virtualendpoint.reports.getrawremoteconnectionreports.GetRawRemoteConnectionReportsPostRequestBody();
getRawRemoteConnectionReportsPostRequestBody.setFilter("ActivityId eq 'cb6ad4c4-8a17-4245-a644-e4436b1ee204'");
LinkedList<String> select = new LinkedList<String>();
select.add("RoundTripTimeInMs");
select.add("AvailableBandwidthInMbps");
select.add("SignInDateTime");
getRawRemoteConnectionReportsPostRequestBody.setSelect(select);
getRawRemoteConnectionReportsPostRequestBody.setSkip(0);
getRawRemoteConnectionReportsPostRequestBody.setTop(50);
graphClient.deviceManagement().virtualEndpoint().reports().getRawRemoteConnectionReports().post(getRawRemoteConnectionReportsPostRequestBody);
const options = {
authProvider,
};
const client = Client.init(options);
const stream = {
filter: 'ActivityId eq \'cb6ad4c4-8a17-4245-a644-e4436b1ee204\'',
select: ['RoundTripTimeInMs', 'AvailableBandwidthInMbps', 'SignInDateTime'],
skip: 0,
top: 50
};
await client.api('/deviceManagement/virtualEndpoint/reports/getRawRemoteConnectionReports')
.version('beta')
.post(stream);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\DeviceManagement\VirtualEndpoint\Reports\GetRawRemoteConnectionReports\GetRawRemoteConnectionReportsPostRequestBody;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new GetRawRemoteConnectionReportsPostRequestBody();
$requestBody->setFilter('ActivityId eq \'cb6ad4c4-8a17-4245-a644-e4436b1ee204\'');
$requestBody->setSelect(['RoundTripTimeInMs', 'AvailableBandwidthInMbps', 'SignInDateTime', ]);
$requestBody->setSkip(0);
$requestBody->setTop(50);
$graphServiceClient->deviceManagement()->virtualEndpoint()->reports()->getRawRemoteConnectionReports()->post($requestBody)->wait();
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.devicemanagement.virtualendpoint.reports.get_raw_remote_connection_reports.get_raw_remote_connection_reports_post_request_body import GetRawRemoteConnectionReportsPostRequestBody
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = GetRawRemoteConnectionReportsPostRequestBody(
filter = "ActivityId eq 'cb6ad4c4-8a17-4245-a644-e4436b1ee204'",
select = [
"RoundTripTimeInMs",
"AvailableBandwidthInMbps",
"SignInDateTime",
],
skip = 0,
top = 50,
)
await graph_client.device_management.virtual_endpoint.reports.get_raw_remote_connection_reports.post(request_body)
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/octet-stream
{
"TotalRowCount": 1,
"Schema": [
{
"Column": "RoundTripTimeInMs",
"PropertyType": "Double"
}
{
"Column": "AvailableBandwidthInMbps",
"PropertyType": "Double"
},
{
"Column": "SignInDateTime",
"PropertyType": "DateTime"
}],
"Values": [
["316", "8", "2023-07-03T18:14:34Z"]
]
}