Поделиться через


Обновление androidManagedAppProtection

Пространство имен: microsoft.graph

Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.

Обновление свойств объекта androidManagedAppProtection.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись) DeviceManagementApps.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается.
Приложение DeviceManagementApps.ReadWrite.All

HTTP-запрос

PATCH /deviceAppManagement/androidManagedAppProtections/{androidManagedAppProtectionId}

Заголовки запроса

Заголовок Значение
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Accept application/json

Текст запроса

В тексте запроса добавьте представление объекта androidManagedAppProtection в формате JSON.

В приведенной ниже таблице показаны свойства, которые необходимо указывать при создании объекта androidManagedAppProtection.

Свойство Тип Описание
displayName String Отображаемое имя политики. Наследуется от объекта managedAppPolicy.
description String Описание политики. Наследуется от объекта managedAppPolicy.
createdDateTime DateTimeOffset Дата и время создания политики. Наследуется от объекта managedAppPolicy.
lastModifiedDateTime DateTimeOffset Время последнего изменения политики. Наследуется от объекта managedAppPolicy.
id String Ключ объекта. Наследуется от объекта managedAppPolicy.
version String Версия объекта. Наследуется от объекта managedAppPolicy.
periodOfflineBeforeAccessCheck Duration Время до проверки доступа, когда устройство не подключено к Интернету. Наследуется от managedAppProtection.
periodOnlineBeforeAccessCheck Duration Время до проверки доступа, когда устройство подключено к Интернету. Наследуется от managedAppProtection.
allowedInboundDataTransferSources managedAppDataTransferLevel Источники, из которых разрешена передача данных. Наследуется от managedAppProtection. Возможные значения: allApps, managedApps, none.
allowedOutboundDataTransferDestinations managedAppDataTransferLevel Назначения, в которые разрешена передача данных. Наследуется от managedAppProtection. Возможные значения: allApps, managedApps, none.
organizationalCredentialsRequired Boolean Указывает, необходимы ли для использования приложения учетные данные организации. Наследуется от managedAppProtection.
allowedOutboundClipboardSharingLevel managedAppClipboardSharingLevel Разрешенный уровень совместного использования буфера обмена для приложений на управляемом устройстве. Наследуется от managedAppProtection. Возможные значения: allApps, managedAppsWithPasteIn, managedApps, blocked.
dataBackupBlocked Boolean Указывает, заблокировано ли резервное копирование данных управляемого приложения. Наследуется от managedAppProtection.
deviceComplianceRequired Boolean Указывает, обязательно ли соответствие устройства требованиям. Наследуется от managedAppProtection.
managedBrowserToOpenLinksRequired Логический Указывает, следует ли открывать интернет-ссылки в приложении управляемого браузера или в любом пользовательском браузере, заданном параметром CustomBrowserProtocol (для iOS) или CustomBrowserPackageId/CustomBrowserDisplayName (для Android), унаследованным от managedAppProtection.
saveAsBlocked Boolean Указывает, могут ли пользователи сохранять копии защищенных файлов, используя пункт меню "Сохранить как". Наследуется от managedAppProtection.
periodOfflineBeforeWipeIsEnforced Duration Время до удаления всех управляемых данных после отключения приложения от Интернета. Наследуется от managedAppProtection.
pinRequired Boolean Указывает, обязательно ли использовать ПИН-код на уровне приложения. Наследуется от managedAppProtection.
maximumPinRetries Int32 Максимальное количество попыток неправильного закрепления перед блокировкой или очисткой управляемого приложения. Наследуется от managedAppProtection.
simplePinBlocked Boolean Указывает, заблокирован ли простой ПИН-код. Наследуется от managedAppProtection.
minimumPinLength Int32 Минимальная длина ПИН-кода на уровне приложения, если для параметра PinRequired установлено значение True. Наследуется от managedAppProtection.
pinCharacterSet managedAppPinCharacterSet Разрешенный набор символов ПИН-кода на уровне приложения, если для параметра PinRequired установлено значение True. Наследуется от managedAppProtection. Возможные значения: numeric, alphanumericAndSymbol.
periodBeforePinReset Duration Время до сброса универсального ПИН-кода, если для параметра PinRequired установлено значение True. Наследуется от managedAppProtection.
allowedDataStorageLocations Коллекция managedAppDataStorageLocation Разрешенные места хранения управляемых данных. Наследуется от managedAppProtection. Возможные значения: oneDriveForBusiness, sharePoint, box, localStorage.
contactSyncBlocked Boolean Указывает, можно ли синхронизировать контакты с устройством пользователя. Наследуется от managedAppProtection.
printBlocked Boolean Указывает, разрешена ли печать из управляемых приложений. Наследуется от managedAppProtection.
fingerprintBlocked Boolean Указывает, можно ли использовать сканер отпечатков пальцев вместо ПИН-кода, если для параметра PinRequired установлено значение True. Наследуется от managedAppProtection.
disableAppPinIfDevicePinIsSet Boolean Указывает, обязательно ли использовать ПИН-код приложения, если установлен ПИН-код устройства. Наследуется от managedAppProtection.
minimumRequiredOsVersion String В более старых версиях управляемое приложение не сможет получить доступ к данным компании. Наследуется от managedAppProtection.
minimumWarningOsVersion String В более старых версиях в управляемом приложении будет отображаться предупреждающее сообщение о невозможности получить доступ к данным компании. Наследуется от managedAppProtection.
minimumRequiredAppVersion String В более старых версиях управляемое приложение не сможет получить доступ к данным компании. Наследуется от managedAppProtection.
minimumWarningAppVersion String В более старых версиях в управляемом приложении будет отображаться предупреждающее сообщение. Наследуется от managedAppProtection.
managedBrowser managedBrowserType Указывает, в каких управляемых браузерах должны быть открыты интернет-ссылки. Если это свойство настроено, значение ManagedBrowserToOpenLinksRequired должно иметь значение true. Наследуется от managedAppProtection. Возможные значения: notConfigured, microsoftEdge.
isAssigned Boolean Указывает, применена ли политика к группам включения. Наследуется от targetedManagedAppProtection.
screenCaptureBlocked Boolean Указывает, может ли управляемый пользователь делать снимки экрана управляемых приложений.
disableAppEncryptionIfDeviceEncryptionIsEnabled Boolean Когда этот параметр включен, шифрование на уровне приложения отключается, если включено шифрование на уровне устройства.
encryptAppData Boolean Указывает, следует ли шифровать данные управляемых приложений.
deployedAppCount Int32 Количество приложений, к которым применена текущая политика.
minimumRequiredPatchVersion String Определите самый старый уровень обновления для системы безопасности Android, необходимый для безопасного доступа к приложению.
minimumWarningPatchVersion String Определите самый старый уровень обновления для системы безопасности Android, рекомендуемый для безопасного доступа к приложению.
customBrowserPackageId String Уникальный идентификатор предпочтительного пользовательского браузера для открытия веб-ссылки на Android. Если это свойство настроено, значение ManagedBrowserToOpenLinksRequired должно иметь значение true.
customBrowserDisplayName String Понятное имя предпочитаемого пользовательского браузера для открытия веб-ссылки на Android. Если это свойство настроено, значение ManagedBrowserToOpenLinksRequired должно иметь значение true.

Отклик

В случае успешного выполнения этот метод возвращает код ответа 200 OK и обновленный объект androidManagedAppProtection в тексте ответа.

Пример

Запрос

Ниже приведен пример запроса.

PATCH https://graph.microsoft.com/v1.0/deviceAppManagement/androidManagedAppProtections/{androidManagedAppProtectionId}
Content-type: application/json
Content-length: 1862

{
  "@odata.type": "#microsoft.graph.androidManagedAppProtection",
  "displayName": "Display Name value",
  "description": "Description value",
  "version": "Version value",
  "periodOfflineBeforeAccessCheck": "-PT17.1357909S",
  "periodOnlineBeforeAccessCheck": "PT35.0018757S",
  "allowedInboundDataTransferSources": "managedApps",
  "allowedOutboundDataTransferDestinations": "managedApps",
  "organizationalCredentialsRequired": true,
  "allowedOutboundClipboardSharingLevel": "managedAppsWithPasteIn",
  "dataBackupBlocked": true,
  "deviceComplianceRequired": true,
  "managedBrowserToOpenLinksRequired": true,
  "saveAsBlocked": true,
  "periodOfflineBeforeWipeIsEnforced": "-PT3M22.1587532S",
  "pinRequired": true,
  "maximumPinRetries": 1,
  "simplePinBlocked": true,
  "minimumPinLength": 0,
  "pinCharacterSet": "alphanumericAndSymbol",
  "periodBeforePinReset": "PT3M29.6631862S",
  "allowedDataStorageLocations": [
    "sharePoint"
  ],
  "contactSyncBlocked": true,
  "printBlocked": true,
  "fingerprintBlocked": true,
  "disableAppPinIfDevicePinIsSet": true,
  "minimumRequiredOsVersion": "Minimum Required Os Version value",
  "minimumWarningOsVersion": "Minimum Warning Os Version value",
  "minimumRequiredAppVersion": "Minimum Required App Version value",
  "minimumWarningAppVersion": "Minimum Warning App Version value",
  "managedBrowser": "microsoftEdge",
  "isAssigned": true,
  "screenCaptureBlocked": true,
  "disableAppEncryptionIfDeviceEncryptionIsEnabled": true,
  "encryptAppData": true,
  "deployedAppCount": 0,
  "minimumRequiredPatchVersion": "Minimum Required Patch Version value",
  "minimumWarningPatchVersion": "Minimum Warning Patch Version value",
  "customBrowserPackageId": "Custom Browser Package Id value",
  "customBrowserDisplayName": "Custom Browser Display Name value"
}

Отклик

Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 2034

{
  "@odata.type": "#microsoft.graph.androidManagedAppProtection",
  "displayName": "Display Name value",
  "description": "Description value",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "id": "cf517ced-7ced-cf51-ed7c-51cfed7c51cf",
  "version": "Version value",
  "periodOfflineBeforeAccessCheck": "-PT17.1357909S",
  "periodOnlineBeforeAccessCheck": "PT35.0018757S",
  "allowedInboundDataTransferSources": "managedApps",
  "allowedOutboundDataTransferDestinations": "managedApps",
  "organizationalCredentialsRequired": true,
  "allowedOutboundClipboardSharingLevel": "managedAppsWithPasteIn",
  "dataBackupBlocked": true,
  "deviceComplianceRequired": true,
  "managedBrowserToOpenLinksRequired": true,
  "saveAsBlocked": true,
  "periodOfflineBeforeWipeIsEnforced": "-PT3M22.1587532S",
  "pinRequired": true,
  "maximumPinRetries": 1,
  "simplePinBlocked": true,
  "minimumPinLength": 0,
  "pinCharacterSet": "alphanumericAndSymbol",
  "periodBeforePinReset": "PT3M29.6631862S",
  "allowedDataStorageLocations": [
    "sharePoint"
  ],
  "contactSyncBlocked": true,
  "printBlocked": true,
  "fingerprintBlocked": true,
  "disableAppPinIfDevicePinIsSet": true,
  "minimumRequiredOsVersion": "Minimum Required Os Version value",
  "minimumWarningOsVersion": "Minimum Warning Os Version value",
  "minimumRequiredAppVersion": "Minimum Required App Version value",
  "minimumWarningAppVersion": "Minimum Warning App Version value",
  "managedBrowser": "microsoftEdge",
  "isAssigned": true,
  "screenCaptureBlocked": true,
  "disableAppEncryptionIfDeviceEncryptionIsEnabled": true,
  "encryptAppData": true,
  "deployedAppCount": 0,
  "minimumRequiredPatchVersion": "Minimum Required Patch Version value",
  "minimumWarningPatchVersion": "Minimum Warning Patch Version value",
  "customBrowserPackageId": "Custom Browser Package Id value",
  "customBrowserDisplayName": "Custom Browser Display Name value"
}