Atualizar androidManagedAppProtection

Namespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; não há suporte para uso de produção.

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.

Pré-requisitos

Uma das seguintes permissões é obrigató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)
Delegada (conta corporativa ou de estudante)
Gerenciamento de aplicativo móvel (GAM)	DeviceManagementApps.ReadWrite.All
Conjunto de Políticas	DeviceManagementApps.ReadWrite.All
Delegada (conta pessoal da Microsoft)	Sem suporte.
Aplicativo
Gerenciamento de aplicativo móvel (GAM)	DeviceManagementApps.ReadWrite.All
Conjunto de Políticas	DeviceManagementApps.ReadWrite.All

Solicitação HTTP

PATCH /deviceAppManagement/androidManagedAppProtections/{androidManagedAppProtectionId}

Cabeçalhos de solicitação

Cabeçalho	Valor
Autorização	<Token> de portador obrigatório.
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	Cadeia de caracteres	Nome para exibição da política. Herdado de managedAppPolicy
descrição	Cadeia de caracteres	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 marcas de escopo para esta instância de entidade. Herdado de managedAppPolicy
id	Cadeia de caracteres	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 de repetição de pino incorretas antes que o aplicativo gerenciado seja bloqueado ou apagado. 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, 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	Versões menores ou iguais à versão especificada apagarão o aplicativo gerenciado e os dados da empresa associados. Herdado de managedAppProtection
minimumWipeAppVersion	Cadeia de caracteres	Versões menores ou iguais à versão especificada apagarão o aplicativo gerenciado e os dados da empresa associados. Herdado de managedAppProtection
appActionIfDeviceComplianceRequired	managedAppRemediationAction	Define um comportamento de aplicativo gerenciado, seja bloquear ou apagar, quando o dispositivo estiver com raiz ou com jailbreak, se DeviceComplianceRequired estiver definido como true. Herdado de managedAppProtection. Os valores possíveis são: block, wipe, warn.
appActionIfMaximumPinRetriesExceeded	managedAppRemediationAction	Define um comportamento de aplicativo gerenciado, seja bloquear ou apagar, com base no número máximo de tentativas de repetição de pino incorretas. Herdado de managedAppProtection. Os valores possíveis são: block, wipe, warn.
pinRequiredInsteadOfBiometricTimeout	Duration	Tempo limite em minutos para um pin de aplicativo em vez de senha não biométrica Herdada de managedAppProtection
allowedOutboundClipboardSharingExceptionLength	Int32	Especifique o número de caracteres que podem ser cortados ou copiados de dados e contas da organização para qualquer aplicativo. Essa configuração substitui a restrição AllowedOutboundClipboardSharingLevel. O valor padrão de '0' significa que nenhuma exceção é permitida. Herdado de managedAppProtection
notificationRestriction	managedAppNotificationRestriction	Especifique a restrição de notificação de aplicativo 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 gerenciamento de aplicativo pretendido para essa política Herdados 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 aplicativos nesta lista serão isentos da política e poderão receber dados de aplicativos gerenciados.
minimumWipePatchVersion	Cadeia de caracteres	O nível de patch de segurança do Android menor ou igual ao valor especificado apagará o aplicativo gerenciado e os dados da empresa associados.
allowedAndroidDeviceManufacturers	String	A lista separada por ponto e vírgula de fabricantes de dispositivos permitiu, como uma cadeia de caracteres, que o aplicativo gerenciado funciona.
appActionIfAndroidDeviceManufacturerNotAllowed	managedAppRemediationAction	Define um comportamento de aplicativo gerenciado, seja bloquear ou apagar, 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 Dispositivo Do Android SafetyNet para que um aplicativo gerenciado funcione. Os valores possíveis são: none, basicIntegrity, basicIntegrityAndDeviceCertification.
appActionIfAndroidSafetyNetDeviceAttestationFailed	managedAppRemediationAction	Define um comportamento de aplicativo gerenciado, aviso ou bloqueio, se o requisito de atestado do Android SafetyNet especificado falhar. Os valores possíveis são: block, wipe, warn.
requiredAndroidSafetyNetAppsVerificationType	androidManagedAppSafetyNetAppsVerificationType	Define o requisito de Verificação de Aplicativos SafetyNet do Android para que um aplicativo gerenciado funcione. Os valores possíveis são: none e enabled.
appActionIfAndroidSafetyNetAppsVerificationFailed	managedAppRemediationAction	Define um comportamento de aplicativo gerenciado, aviso ou bloqueio, se o requisito de Verificação de Aplicativo Android especificado falhar. Os valores possíveis são: block, wipe, warn.
customBrowserPackageId	Cadeia de caracteres	Identificador exclusivo de um navegador personalizado para abrir o weblink no Android.
customBrowserDisplayName	Cadeia de caracteres	Nome amigável do navegador personalizado preferencial para abrir o 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"
}