Abrufen von cloudPcOnPremisesConnection
Namespace: microsoft.graph
Lesen der Eigenschaften und Beziehungen des cloudPcOnPremisesConnection-Objekts .
Wichtig
Die lokale Netzwerkverbindung wurde in Azure-Netzwerkverbindung umbenannt. cloudPcOnPremisesConnection-Objekte entsprechen hier der Azure-Netzwerkverbindung für das Cloud-PC-Produkt.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. 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 |
Anwendung | CloudPC.Read.All | CloudPC.ReadWrite.All |
HTTP-Anforderung
GET /deviceManagement/virtualEndpoint/onPremisesConnections/{id}
Optionale Abfrageparameter
Diese Methode unterstützt $select
den OData-Abfrageparameter, um die Antwort anzupassen. Allgemeine Informationen finden Sie unter OData-Abfrageparameter.
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen 200 OK
Antwortcode und ein cloudPcOnPremisesConnection-Objekt im Antworttext zurück.
Beispiele
Beispiel 1: Abrufen der Standardeigenschaften einer Azure-Netzwerkverbindung
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/onPremisesConnections/{id}
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/json
{
"@odata.type": "#microsoft.graph.cloudPcOnPremisesConnection",
"id": "9ec90ff8-fd63-4fb9-ab5a-aa4fdccffff",
"connectionType": "hybridAzureADJoin",
"displayName": "Display Name value",
"subscriptionId": "0ac520ee-14c0-480f-b6c9-0a90c585ffff",
"subscriptionName": "Subscription Name value",
"adDomainName": "Active Directory Domain Name value",
"adDomainUsername": "Active Directory Domain User Name value",
"organizationalUnit": "Organization Unit value",
"resourceGroupId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ffff/resourceGroups/ExampleRG",
"virtualNetworkId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet",
"subnetId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ffff/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet/subnets/default",
"healthCheckStatus": "running",
"virtualNetworkLocation": "westus2"
}
Beispiel 2: Abrufen der ausgewählten Eigenschaften einer Azure-Netzwerkverbindung, einschließlich healthCheckStatusDetail
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/onPremisesConnections/{id}?$select=id,displayName,healthCheckStatus,healthCheckStatusDetail,inUse
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/json
{
"@odata.type": "#microsoft.graph.cloudPcOnPremisesConnection",
"id": "9ec90ff8-fd63-4fb9-ab5a-aa4fdccffff",
"displayName": "Display Name value",
"healthCheckStatus": "failed",
"healthCheckStatusDetail": {
"@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetail",
"startDateTime": "2020-11-03T12:43:14Z",
"endDateTime": "2020-11-03T12:43:32Z",
"healthChecks": [
{
"@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionHealthCheck",
"status": "failed",
"displayName": "Display Name value",
"startDateTime": "2020-11-03T12:43:14Z",
"endDateTime": "2020-11-03T12:43:15Z",
"errorType": "dnsCheckFqdnNotFound",
"recommendedAction": "We did not find the provided domain name; please re-enter",
"additionalDdetail": null,
"correlationId": "992e64f0-231c-46b0-8918-c5aed0585f53"
},
{
"@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionHealthCheck",
"status": "passed",
"displayName": "Display Name value",
"startDateTime": "2020-11-03T12:43:15Z",
"endDateTime": "2020-11-03T12:43:26Z",
"errorType": null,
"recommendedAction": null,
"additionalDetail": null,
"correlationId": null
},
{
"@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionHealthCheck",
"status": "failed",
"displayName": "Display Name value",
"startDateTime": "2020-11-03T12:43:27Z",
"endDateTime": "2020-11-03T12:43:32Z",
"errorType": "endpointConnectivityCheckUrlNotWhitelisted",
"recommendedAction": "Recommended Action value",
"additionaldDetail": "Additional Details value",
"correlationId": "119f8363-ace2-412b-a79a-867dc0737db0"
},
{
"@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionHealthCheck",
"status": "passed",
"displayName": "Display Name value",
"startDateTime": null,
"endDateTime": null,
"errorType": null,
"recommendedAction": null,
"additionaldDetail": null,
"correlationId": "119f8363-ace2-412b-a79a-867dc0737db0"
}
]
},
"inUse": false
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für