Обновление mobileAppSupersedence
Пространство имен: microsoft.graph
Важный: API Microsoft Graph в версии /beta могут быть изменены; Использование в рабочей среде не поддерживается.
Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.
Обновите свойства объекта mobileAppSupersedence .
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
| Тип разрешения | Разрешения (в порядке повышения привилегий) |
|---|---|
| Делегированные (рабочая или учебная учетная запись) | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. |
| Приложение | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
HTTP-запрос
PATCH /deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId}
PATCH /deviceAppManagement/mobileApps/{mobileAppId}/relationships/{mobileAppRelationshipId}
Заголовки запроса
| Заголовок | Значение |
|---|---|
| Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
| Accept | application/json |
Текст запроса
В тексте запроса укажите представление объекта mobileAppSupersedence в формате JSON.
В следующей таблице показаны свойства, необходимые при создании mobileAppSupersedence.
| Свойство | Тип | Описание |
|---|---|---|
| id | String | Уникальный идентификатор сущности связи мобильного приложения. Он назначается при создании сущности MobileAppRelationship. Например: 2dbc75b9-e993-4e4d-a071-91ac5a218672_43aaaf35-ce51-4695-9447-5eac6df31161. Только для чтения. Возвращается по умолчанию. Поддерживает: $select. Не поддерживает $search, $filter $orderBy. Наследуется от mobileAppRelationship |
| targetId | String | Уникальный идентификатор приложения целевого объекта связи мобильного приложения. Например: 2dbc75b9-e993-4e4d-a071-91ac5a218672. Только для чтения. Возвращается по умолчанию. Поддерживает: $select. Не поддерживает $search, $filter $orderBy. Наследуется от mobileAppRelationship |
| targetDisplayName | String | Отображаемое имя приложения, которое является целевым объектом сущности связи с мобильным приложением. Например: Firefox Setup 52.0.2 32bit.intunewin. Максимальная длина — 500 символов. Только для чтения. Возвращается по умолчанию. Поддерживает: $select. Не поддерживает $search, $filter $orderBy. Это свойство доступно только для чтения. Наследуется от mobileAppRelationship |
| targetDisplayVersion | String | Отображаемая версия приложения, которая является целевой для сущности связи мобильного приложения. Например, 1.0 или 1.2203.156. Только для чтения. Возвращается по умолчанию. Поддерживает: $select. Не поддерживает $search, $filter $orderBy. Это свойство доступно только для чтения. Наследуется от mobileAppRelationship |
| targetPublisher | String | Издатель приложения, который является целевым объектом сущности связи с мобильным приложением. Например: Fabrikam. Максимальная длина — 500 символов. Только для чтения. Возвращается по умолчанию. Поддерживает: $select. Не поддерживает $search, $filter $orderBy. Это свойство доступно только для чтения. Наследуется от mobileAppRelationship |
| targetPublisherDisplayName | String | Отображаемое имя издателя приложения, которое является целевым объектом сущности связи с мобильным приложением. Например: Fabrikam. Максимальная длина — 500 символов. Только для чтения. Поддерживает: $select. Не поддерживает $search, $filter $orderBy. Это свойство доступно только для чтения. Наследуется от mobileAppRelationship |
| sourceId | String | Уникальный идентификатор приложения источника сущности связи мобильного приложения. Например: 2dbc75b9-e993-4e4d-a071-91ac5a218672. Если значение null во время создания связи, оно будет заполнено родительским идентификатором. Только для чтения. Поддерживает: $select. Не поддерживает $search, $filter $orderBy. Это свойство доступно только для чтения. Наследуется от mobileAppRelationship |
| sourceDisplayName | String | Отображаемое имя приложения, которое является источником сущности связи с мобильным приложением. Например: Косатка. Максимальная длина — 500 символов. Только для чтения. Поддерживает: $select. Не поддерживает $search, $filter $orderBy. Это свойство доступно только для чтения. Наследуется от mobileAppRelationship |
| sourceDisplayVersion | String | Отображаемая версия приложения, которая является источником сущности связи с мобильным приложением. Например, 1.0.12 или 1.2203.156 или 3. Только для чтения. Поддерживает: $select. Не поддерживает $search, $filter $orderBy. Это свойство доступно только для чтения. Наследуется от mobileAppRelationship |
| sourcePublisherDisplayName | String | Отображаемое имя издателя приложения, которое является источником сущности связи с мобильным приложением. Например: Fabrikam. Максимальная длина — 500 символов. Только для чтения. Поддерживает: $select. Не поддерживает $search, $filter $orderBy. Это свойство доступно только для чтения. Наследуется от mobileAppRelationship |
| targetType | mobileAppRelationshipType | Тип связи, указывающий, является ли целевое приложение связи родительским или дочерним в связи. Возможные значения: родительский, дочерний. Только для чтения. Возвращается по умолчанию. Поддерживает: $select, $filter. Не поддерживает $search, $orderBy. Это свойство доступно только для чтения. Наследуется от mobileAppRelationship. Возможные значения: child, parent, unknownFutureValue. |
| supersedenceType | mobileAppSupersedenceType | Тип отношения замены между родительским и дочерним приложениями. Возможные значения: update, replace. Только для чтения. Возможные значения: update, replace, unknownFutureValue. |
| supersededAppCount | Int32 | Общее количество приложений, прямо или косвенно заменяемых дочерним приложением. Только для чтения. Это свойство доступно только для чтения. |
| supersedingAppCount | Int32 | Общее количество приложений, прямо или косвенно заменяющих родительское приложение. Только для чтения. Это свойство доступно только для чтения. |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 200 OK и обновленный объект mobileAppSupersedence в теле отклика.
Пример
Запрос
Ниже приведен пример запроса.
PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId}
Content-type: application/json
Content-length: 665
{
"@odata.type": "#microsoft.graph.mobileAppSupersedence",
"targetId": "Target Id value",
"targetDisplayName": "Target Display Name value",
"targetDisplayVersion": "Target Display Version value",
"targetPublisher": "Target Publisher value",
"targetPublisherDisplayName": "Target Publisher Display Name value",
"sourceId": "Source Id value",
"sourceDisplayName": "Source Display Name value",
"sourceDisplayVersion": "Source Display Version value",
"sourcePublisherDisplayName": "Source Publisher Display Name value",
"targetType": "parent",
"supersedenceType": "replace",
"supersededAppCount": 2,
"supersedingAppCount": 3
}
Отклик
Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 714
{
"@odata.type": "#microsoft.graph.mobileAppSupersedence",
"id": "c0254204-4204-c025-0442-25c0044225c0",
"targetId": "Target Id value",
"targetDisplayName": "Target Display Name value",
"targetDisplayVersion": "Target Display Version value",
"targetPublisher": "Target Publisher value",
"targetPublisherDisplayName": "Target Publisher Display Name value",
"sourceId": "Source Id value",
"sourceDisplayName": "Source Display Name value",
"sourceDisplayVersion": "Source Display Version value",
"sourcePublisherDisplayName": "Source Publisher Display Name value",
"targetType": "parent",
"supersedenceType": "replace",
"supersededAppCount": 2,
"supersedingAppCount": 3
}