getRelatedAppStates-Funktion
Namespace: microsoft.graph
Wichtig: Microsoft Graph-APIs unter der /beta-Version können sich ändern. Die Verwendung in der Produktion wird nicht unterstützt.
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
## Permissions
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.
Berechtigungstyp | Berechtigungen (von der Berechtigung mit den meisten Rechten zu der mit den wenigsten Rechten) |
---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | |
Apps) | DeviceManagementApps.ReadWrite.All, DeviceManagementApps.Read.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
Anwendung | |
Apps) | DeviceManagementApps.ReadWrite.All, DeviceManagementApps.Read.All |
HTTP-Anforderung
GET /deviceAppManagement/mobileApps/{mobileAppId}/getRelatedAppStates
GET /deviceAppManagement/mobileApps/{mobileAppId}/userStatuses/{userAppInstallStatusId}/app/getRelatedAppStates
GET /deviceAppManagement/mobileApps/{mobileAppId}/deviceStatuses/{mobileAppInstallStatusId}/app/getRelatedAppStates
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Annehmen | application/json |
Anforderungstext
Stellen Sie in der URL der Anforderung die folgenden Abfrageparameter mit Werten bereit. In der folgenden Tabelle sind die Parameter aufgeführt, die mit dieser Funktion verwendet werden können.
Eigenschaft | Typ | Beschreibung |
---|---|---|
userPrincipalName | Zeichenfolge | |
deviceId | Zeichenfolge |
Antwort
Bei erfolgreicher Ausführung gibt diese Funktion einen 200 OK
Antwortcode und eine mobileAppRelationshipState-Auflistung im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
GET https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}/getRelatedAppStates(userPrincipalName='parameterValue',deviceId='parameterValue')
Antwort
Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 481
{
"value": [
{
"@odata.type": "microsoft.graph.mobileAppRelationshipState",
"sourceIds": [
"Source Ids value"
],
"targetId": "Target Id value",
"targetDisplayName": "Target Display Name value",
"deviceId": "Device Id value",
"installState": "failed",
"installStateDetail": "dependencyFailedToInstall",
"errorCode": 9,
"targetLastSyncDateTime": "2017-01-01T00:02:09.7809949-08:00"
}
]
}