Atualizar androidManagedAppProtection
Namespace: microsoft.graph
Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; a utilização de produção não é suportada.
Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.
Atualizar as propriedades de um objeto androidManagedAppProtection.
## Permissions
Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.
| Tipo de permissão | Permissões (de privilégios máximos a mínimos) |
|---|---|
| Delegado (conta corporativa ou de estudante) | |
| Gerenciamento de aplicativo móvel (GAM) | DeviceManagementApps.ReadWrite.All |
| Conjunto de Políticas | DeviceManagementApps.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. |
| Application | |
| Gerenciamento de aplicativo móvel (GAM) | DeviceManagementApps.ReadWrite.All |
| Conjunto de Políticas | DeviceManagementApps.ReadWrite.All |
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Solicitação HTTP
PATCH /deviceAppManagement/androidManagedAppProtections/{androidManagedAppProtectionId}
Cabeçalhos de solicitação
| Cabeçalho | Valor |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Aceitar | application/json |
Corpo da solicitação
No corpo da solicitação, forneça uma representação JSON do objeto androidManagedAppProtection.
A tabela a seguir mostra as propriedades que são necessárias ao criar androidManagedAppProtection.
| Propriedade | Tipo | Descrição |
|---|---|---|
| displayName | String | Nome para exibição da política. Herdado de managedAppPolicy |
| description | String | A descrição da política. Herdado de managedAppPolicy |
| createdDateTime | DateTimeOffset | A data e a hora da criação da política. Herdado de managedAppPolicy |
| lastModifiedDateTime | DateTimeOffset | Última vez em que a política foi modificada. Herdado de managedAppPolicy |
| roleScopeTagIds | Coleção String | Lista de Etiquetas de Âmbito para esta Instância de entidade. Herdado de managedAppPolicy |
| id | String | Chave da entidade. Herdado de managedAppPolicy |
| version | String | Versão da entidade. Herdado de managedAppPolicy |
| periodOfflineBeforeAccessCheck | Duração | Período após o qual o acesso é verificado quando o dispositivo não está conectado à Internet. Herdado de managedAppProtection |
| periodOnlineBeforeAccessCheck | Duração | Período após o qual o acesso é verificado quando o dispositivo está conectado à Internet. Herdado de managedAppProtection |
| allowedInboundDataTransferSources | managedAppDataTransferLevel | Fontes das quais os dados podem ser transferidos. Herdado de managedAppProtection. Os valores possíveis são: allApps, managedApps, none. |
| allowedOutboundDataTransferDestinations | managedAppDataTransferLevel | Destinos para os quais os dados podem ser transferidos. Herdado de managedAppProtection. Os valores possíveis são: allApps, managedApps, none. |
| organizationalCredentialsRequired | Boolean | Indica se as credenciais organizacionais são obrigatórias para o uso do aplicativo. Herdado de managedAppProtection |
| allowedOutboundClipboardSharingLevel | managedAppClipboardSharingLevel | O nível em que a área de transferência pode ser compartilhada entre os aplicativos no dispositivo gerenciado. Herdado de managedAppProtection. Os valores possíveis são: allApps, managedAppsWithPasteIn, managedApps, blocked. |
| dataBackupBlocked | Boolean | Indica se o backup de dados de um aplicativo gerenciado está bloqueado. Herdado de managedAppProtection |
| deviceComplianceRequired | Boolean | Indica se a compatibilidade de dispositivos é necessária. Herdado de managedAppProtection |
| managedBrowserToOpenLinksRequired | Boolean | Indica se os links da Internet devem ser abertos no aplicativo de navegador gerenciado. Herdado de managedAppProtection |
| saveAsBlocked | Boolean | Indica se os usuários podem usar o item de menu "Salvar como" para salvar uma cópia dos arquivos protegidos. Herdado de managedAppProtection |
| periodOfflineBeforeWipeIsEnforced | Duração | A quantidade de tempo que um aplicativo pode permanecer desconectado da Internet antes que todos os dados gerenciados sejam apagados. Herdado de managedAppProtection |
| pinRequired | Boolean | Indica se é necessário um pin no nível do aplicativo. Herdado de managedAppProtection |
| maximumPinRetries | Int32 | Número máximo de tentativas incorretas de repetição de pin antes de a aplicação gerida ser bloqueada ou apagada. Herdado de managedAppProtection |
| simplePinBlocked | Boolean | Indica se simplePin está bloqueado. Herdado de managedAppProtection |
| minimumPinLength | Int32 | Tamanho mínimo de pin necessário para um pin no nível do aplicativo se PinRequired estiver definido como True Herdado de managedAppProtection |
| pinCharacterSet | managedAppPinCharacterSet | Conjunto de caracteres que poderá ser usado para um pin no nível do aplicativo se PinRequired estiver definido como True. Herdado de managedAppProtection. Os valores possíveis são: numeric e alphanumericAndSymbol. |
| periodBeforePinReset | Duração | TimePeriod antes que o pin em todos os níveis tenha que ser redefinido, caso PinRequired esteja definido como True. Herdado de managedAppProtection |
| allowedDataStorageLocations | coleção managedAppDataStorageLocation | Locais de armazenamento de dados em que um usuário pode armazenar dados gerenciados. Herdado de managedAppProtection. Os valores possíveis são: oneDriveForBusiness, sharePoint, localStorage. |
| contactSyncBlocked | Boolean | Indica se os contatos podem ser sincronizados com o dispositivo do usuário. Herdado de managedAppProtection |
| printBlocked | Boolean | Indica se a impressão a partir de aplicativos gerenciados é permitida. Herdado de managedAppProtection |
| fingerprintBlocked | Boolean | Indica se será permitido o uso do leitor de impressão digital em vez de um pin se PinRequired estiver definido como True. Herdado de managedAppProtection |
| disableAppPinIfDevicePinIsSet | Boolean | Indica se o uso do pin do aplicativo será obrigatório se o pin do dispositivo estiver definido. Herdado de managedAppProtection |
| minimumRequiredOsVersion | String | Versões anteriores à versão especificada impedirão o aplicativo gerenciado de acessar dados da empresa. Herdado de managedAppProtection |
| minimumWarningOsVersion | String | Versões anteriores à versão especificada resultarão em uma mensagem de aviso no aplicativo gerenciado ao acessar dados da empresa. Herdado de managedAppProtection |
| minimumRequiredAppVersion | String | Versões anteriores à versão especificada impedirão o aplicativo gerenciado de acessar dados da empresa. Herdado de managedAppProtection |
| minimumWarningAppVersion | String | Versões anteriores à versão especificada resultarão em uma mensagem de aviso no aplicativo gerenciado. Herdado de managedAppProtection |
| minimumWipeOsVersion | Cadeia de caracteres | As versões inferiores ou iguais à versão especificada apagarão a aplicação gerida e os dados da empresa associados. Herdado de managedAppProtection |
| minimumWipeAppVersion | Cadeia de caracteres | As versões inferiores ou iguais à versão especificada apagarão a aplicação gerida e os dados da empresa associados. Herdado de managedAppProtection |
| appActionIfDeviceComplianceRequired | managedAppRemediationAction | Define um comportamento de aplicação gerida, quer bloqueie ou elimine, quando o dispositivo tem root ou jailbreak, se DeviceComplianceRequired estiver definido como verdadeiro. Herdado de managedAppProtection. Os valores possíveis são: block, wipe, warn. |
| appActionIfMaximumPinRetriesExceeded | managedAppRemediationAction | Define um comportamento de aplicação gerida, quer bloqueie ou elimine, com base no número máximo de tentativas de repetição de pin incorretas. Herdado de managedAppProtection. Os valores possíveis são: block, wipe, warn. |
| pinRequiredInsteadOfBiometricTimeout | Duração | Tempo limite em minutos para um pin de aplicação em vez de código de acesso não biométrico Herdado de managedAppProtection |
| allowedOutboundClipboardSharingExceptionLength | Int32 | Especifique o número de carateres que podem ser cortados ou copiados de contas e dados da Organização para qualquer aplicação. Esta definição substitui a restrição AllowedOutboundClipboardSharingLevel. O valor predefinido de "0" significa que não é permitida nenhuma exceção. Herdado de managedAppProtection |
| notificationRestriction | managedAppNotificationRestriction | Especifique a restrição de notificação da aplicação Herdada de managedAppProtection. Os valores possíveis são: allow, blockOrganizationalData, block. |
| isAssigned | Boolean | Indica se a política foi implantada a grupos de inclusão ou não. Herdado de targetedManagedAppProtection |
| targetedAppManagementLevels | appManagementLevel | Os níveis de gestão de aplicações pretendidos para esta política Herdado de targetedManagedAppProtection. Os valores possíveis são: unspecified, unmanaged, mdm, androidEnterprise. |
| screenCaptureBlocked | Boolean | Indica se um usuário gerenciado pode fazer capturas de tela dos aplicativos gerenciados |
| disableAppEncryptionIfDeviceEncryptionIsEnabled | Boolean | Quando essa configuração estiver habilitada, a criptografia no nível do aplicativo será desabilitada se a criptografia no nível do dispositivo for habilitada |
| encryptAppData | Boolean | Indica se os dados de aplicativos gerenciados devem ser criptografados |
| deployedAppCount | Int32 | Contagem de aplicativos em que a política atual é implantada. |
| minimumRequiredPatchVersion | String | Define o nível mais antigo de patch de segurança do Android necessário que um usuário pode ter para obter acesso seguro ao aplicativo. |
| minimumWarningPatchVersion | String | Define o nível mais antigo de patch de segurança do Android recomendado que um usuário pode ter para obter acesso seguro ao aplicativo. |
| exemptedAppPackages | Coleção keyValuePair | Os pacotes de aplicações nesta lista ficarão isentos da política e poderão receber dados de aplicações geridas. |
| minimumWipePatchVersion | Cadeia de caracteres | O nível de patch de segurança do Android inferior ou igual ao valor especificado irá apagar a aplicação gerida e os dados da empresa associados. |
| allowedAndroidDeviceManufacturers | Cadeia de caracteres | A lista com ponto e vírgula dos fabricantes de dispositivos permitiu, como cadeia, que a aplicação gerida funcionasse. |
| appActionIfAndroidDeviceManufacturerNotAllowed | managedAppRemediationAction | Define um comportamento de aplicação gerida, quer bloqueie ou elimine, se o fabricante do dispositivo especificado não for permitido. Os valores possíveis são: block, wipe, warn. |
| requiredAndroidSafetyNetDeviceAttestationType | androidManagedAppSafetyNetDeviceAttestationType | Define o requisito de Atestado de Dispositivos Android SafetyNet para que uma aplicação gerida funcione. Os valores possíveis são: none, basicIntegrity, basicIntegrityAndDeviceCertification. |
| appActionIfAndroidSafetyNetDeviceAttestationFailed | managedAppRemediationAction | Define um comportamento de aplicação gerida, avisar ou bloquear, se a necessidade especificada do Atestado da Android SafetyNet falhar. Os valores possíveis são: block, wipe, warn. |
| requiredAndroidSafetyNetAppsVerificationType | androidManagedAppSafetyNetAppsVerificationType | Define o requisito de Verificação de Aplicações SafetyNet do Android para que uma aplicação gerida funcione. Os valores possíveis são: none e enabled. |
| appActionIfAndroidSafetyNetAppsVerificationFailed | managedAppRemediationAction | Define um comportamento de aplicação gerida, aviso ou bloqueio, se a necessidade de Verificação de Aplicações Android especificada falhar. Os valores possíveis são: block, wipe, warn. |
| customBrowserPackageId | Cadeia de caracteres | Identificador exclusivo de um browser personalizado para abrir a weblink no Android. |
| customBrowserDisplayName | Cadeia de caracteres | Nome amigável do browser personalizado preferencial para abrir a weblink no Android. |
Resposta
Se bem-sucedido, este método retornará um código de resposta 200 OK e um objeto androidManagedAppProtection atualizado no corpo da resposta.
Exemplo
Solicitação
Este é um exemplo da solicitação.
PATCH https://graph.microsoft.com/beta/deviceAppManagement/androidManagedAppProtections/{androidManagedAppProtectionId}
Content-type: application/json
Content-length: 2967
{
"@odata.type": "#microsoft.graph.androidManagedAppProtection",
"displayName": "Display Name value",
"description": "Description value",
"roleScopeTagIds": [
"Role Scope Tag Ids 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",
"minimumWipeOsVersion": "Minimum Wipe Os Version value",
"minimumWipeAppVersion": "Minimum Wipe App Version value",
"appActionIfDeviceComplianceRequired": "wipe",
"appActionIfMaximumPinRetriesExceeded": "wipe",
"pinRequiredInsteadOfBiometricTimeout": "-PT3M9.8396734S",
"allowedOutboundClipboardSharingExceptionLength": 14,
"notificationRestriction": "blockOrganizationalData",
"isAssigned": true,
"targetedAppManagementLevels": "unmanaged",
"screenCaptureBlocked": true,
"disableAppEncryptionIfDeviceEncryptionIsEnabled": true,
"encryptAppData": true,
"deployedAppCount": 0,
"minimumRequiredPatchVersion": "Minimum Required Patch Version value",
"minimumWarningPatchVersion": "Minimum Warning Patch Version value",
"exemptedAppPackages": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "Name value",
"value": "Value value"
}
],
"minimumWipePatchVersion": "Minimum Wipe Patch Version value",
"allowedAndroidDeviceManufacturers": "Allowed Android Device Manufacturers value",
"appActionIfAndroidDeviceManufacturerNotAllowed": "wipe",
"requiredAndroidSafetyNetDeviceAttestationType": "basicIntegrity",
"appActionIfAndroidSafetyNetDeviceAttestationFailed": "wipe",
"requiredAndroidSafetyNetAppsVerificationType": "enabled",
"appActionIfAndroidSafetyNetAppsVerificationFailed": "wipe",
"customBrowserPackageId": "Custom Browser Package Id value",
"customBrowserDisplayName": "Custom Browser Display Name value"
}
Resposta
Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 3139
{
"@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",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"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",
"minimumWipeOsVersion": "Minimum Wipe Os Version value",
"minimumWipeAppVersion": "Minimum Wipe App Version value",
"appActionIfDeviceComplianceRequired": "wipe",
"appActionIfMaximumPinRetriesExceeded": "wipe",
"pinRequiredInsteadOfBiometricTimeout": "-PT3M9.8396734S",
"allowedOutboundClipboardSharingExceptionLength": 14,
"notificationRestriction": "blockOrganizationalData",
"isAssigned": true,
"targetedAppManagementLevels": "unmanaged",
"screenCaptureBlocked": true,
"disableAppEncryptionIfDeviceEncryptionIsEnabled": true,
"encryptAppData": true,
"deployedAppCount": 0,
"minimumRequiredPatchVersion": "Minimum Required Patch Version value",
"minimumWarningPatchVersion": "Minimum Warning Patch Version value",
"exemptedAppPackages": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "Name value",
"value": "Value value"
}
],
"minimumWipePatchVersion": "Minimum Wipe Patch Version value",
"allowedAndroidDeviceManufacturers": "Allowed Android Device Manufacturers value",
"appActionIfAndroidDeviceManufacturerNotAllowed": "wipe",
"requiredAndroidSafetyNetDeviceAttestationType": "basicIntegrity",
"appActionIfAndroidSafetyNetDeviceAttestationFailed": "wipe",
"requiredAndroidSafetyNetAppsVerificationType": "enabled",
"appActionIfAndroidSafetyNetAppsVerificationFailed": "wipe",
"customBrowserPackageId": "Custom Browser Package Id value",
"customBrowserDisplayName": "Custom Browser Display Name value"
}
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de