Функция getRelatedAppStates
Пространство имен: microsoft.graph
Важно: API Microsoft Graph в версии /beta могут быть изменены; Использование в рабочей среде не поддерживается.
Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
Тип разрешения | Разрешения (в порядке убывания привилегий) |
---|---|
Делегированные (рабочая или учебная учетная запись) | |
Приложения) | DeviceManagementApps.ReadWrite.All, DeviceManagementApps.Read.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. |
Приложение | |
Приложения) | DeviceManagementApps.ReadWrite.All, DeviceManagementApps.Read.All |
HTTP-запрос
GET /deviceAppManagement/mobileApps/{mobileAppId}/getRelatedAppStates
GET /deviceAppManagement/mobileApps/{mobileAppId}/userStatuses/{userAppInstallStatusId}/app/getRelatedAppStates
GET /deviceAppManagement/mobileApps/{mobileAppId}/deviceStatuses/{mobileAppInstallStatusId}/app/getRelatedAppStates
Заголовки запроса
Заголовок | Значение |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Accept | application/json |
Текст запроса
В URL-адресе запроса укажите перечисленные ниже параметры запроса и их значения. В приведенной ниже таблице указаны параметры, которые можно использовать с этой функцией.
Свойство | Тип | Описание |
---|---|---|
userPrincipalName | String | |
deviceId | String |
Отклик
В случае успешного выполнения эта функция возвращает код отклика 200 OK
и коллекцию mobileAppRelationshipState в тексте отклика.
Пример
Запрос
Ниже приведен пример запроса.
GET https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}/getRelatedAppStates(userPrincipalName='parameterValue',deviceId='parameterValue')
Отклик
Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.
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"
}
]
}
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по