Actualizar androidManagedAppProtection

Espacio de nombres: microsoft.graph

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.

Actualiza las propiedades de un objeto androidManagedAppProtection.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) DeviceManagementApps.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación DeviceManagementApps.ReadWrite.All

Solicitud HTTP

PATCH /deviceAppManagement/androidManagedAppProtections/{androidManagedAppProtectionId}

Encabezados de solicitud

Encabezado Valor
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Aceptar application/json

Cuerpo de la solicitud

En el cuerpo de la solicitud, especifique una representación JSON del objeto androidManagedAppProtection.

En la tabla siguiente se muestran las propiedades necesarias para crear el objeto androidManagedAppProtection.

Propiedad Tipo Descripción
displayName Cadena Nombre para mostrar de la directiva. Heredado de managedAppPolicy.
description Cadena Descripción de la directiva. Heredado de managedAppPolicy.
createdDateTime DateTimeOffset Fecha y hora de creación de la directiva. Heredado de managedAppPolicy.
lastModifiedDateTime DateTimeOffset Última vez que se modificó la directiva. Heredado de managedAppPolicy.
id Cadena Clave de la entidad. Heredado de managedAppPolicy.
version Cadena Versión de la entidad. Heredado de managedAppPolicy.
periodOfflineBeforeAccessCheck Duración Período tras el cual se comprueba el acceso cuando el dispositivo no está conectado a Internet. Heredado de managedAppProtection.
periodOnlineBeforeAccessCheck Duración Período tras el cual se comprueba el acceso cuando el dispositivo está conectado a Internet. Heredado de managedAppProtection.
allowedInboundDataTransferSources managedAppDataTransferLevel Orígenes desde los que se permite la transferencia de datos. Se hereda de managedAppProtection. Los valores posibles son: allApps, managedApps y none.
allowedOutboundDataTransferDestinations managedAppDataTransferLevel Destinos a los que se permite la transferencia de datos. Se hereda de managedAppProtection. Los valores posibles son: allApps, managedApps y none.
organizationalCredentialsRequired Booleano Indica si son necesarias las credenciales de la organización para usar la aplicación. Heredado de managedAppProtection.
allowedOutboundClipboardSharingLevel managedAppClipboardSharingLevel Nivel al que puede compartirse el Portapapeles entre aplicaciones en el dispositivo administrado. Se hereda de managedAppProtection. Los valores posibles son: allApps, managedAppsWithPasteIn, managedApps y blocked.
dataBackupBlocked Booleano Indica si se bloquea la copia de seguridad de los datos de una aplicación administrada. Heredado de managedAppProtection.
deviceComplianceRequired Booleano Indica si se requiere el cumplimiento del dispositivo. Heredado de managedAppProtection.
managedBrowserToOpenLinksRequired Booleano Indica si los vínculos a Internet deben abrirse en la aplicación del explorador administrado, o cualquier explorador personalizado especificado por CustomBrowserProtocol (para iOS) o CustomBrowserPackageId/CustomBrowserDisplayName (para Android) heredado de managedAppProtection
saveAsBlocked Booleano Indica si los usuarios pueden usar el elemento de menú "Guardar como" para guardar una copia de los archivos protegidos. Heredado de managedAppProtection.
periodOfflineBeforeWipeIsEnforced Duración Cantidad de tiempo que una aplicación puede estar desconectada de Internet antes de que se borren los datos administrados. Heredado de managedAppProtection.
pinRequired Booleano Indica si se requiere un PIN de nivel de aplicación. Heredado de managedAppProtection.
maximumPinRetries Int32 Número máximo de intentos de reintento de pin incorrectos antes de que la aplicación administrada se bloquee o borre. Heredado de managedAppProtection.
simplePinBlocked Booleano Indica si simplePin está bloqueado. Heredado de managedAppProtection.
minimumPinLength Int32 Longitud mínima de PIN necesaria para un PIN de nivel de aplicación si PinRequired se establece en True. Heredado de managedAppProtection.
pinCharacterSet managedAppPinCharacterSet Conjunto de caracteres que se puede usar para un PIN de nivel de aplicación si PinRequired se establece en True. Se hereda de managedAppProtection. Los valores posibles son numeric y alphanumericAndSymbol.
periodBeforePinReset Duración TimePeriod antes de que se deba restablecer el PIN de todos los niveles si PinRequired se establece en True. Heredado de managedAppProtection.
allowedDataStorageLocations colección managedAppDataStorageLocation Ubicaciones de almacenamiento de datos en las que un usuario puede almacenar datos administrados. Se hereda de managedAppProtection. Los valores posibles son: oneDriveForBusiness, sharePoint, box y localStorage.
contactSyncBlocked Booleano Indica si se pueden sincronizar los contactos en el dispositivo del usuario. Heredado de managedAppProtection.
printBlocked Booleano Indica si se puede imprimir desde las aplicaciones administradas. Heredado de managedAppProtection.
fingerprintBlocked Booleano Indica si se permite el uso del lector de huellas digitales en lugar de un PIN si PinRequired se establece en True. Heredado de managedAppProtection.
disableAppPinIfDevicePinIsSet Booleano Indica si es necesario el uso del PIN de la aplicación si se establece el PIN del dispositivo. Heredado de managedAppProtection.
minimumRequiredOsVersion Cadena Las versiones anteriores a la versión especificada impedirán que la aplicación administrada obtenga acceso a los datos de la compañía. Heredado de managedAppProtection.
minimumWarningOsVersion Cadena Las versiones anteriores a la versión especificada provocarán un mensaje de advertencia en la aplicación administrada que intenta obtener acceso a los datos de la compañía. Heredado de managedAppProtection.
minimumRequiredAppVersion Cadena Las versiones anteriores a la versión especificada impedirán que la aplicación administrada obtenga acceso a los datos de la compañía. Heredado de managedAppProtection.
minimumWarningAppVersion Cadena Las versiones anteriores a la versión especificada provocarán un mensaje de advertencia en la aplicación administrada. Heredado de managedAppProtection.
managedBrowser managedBrowserType Indica en qué exploradores administrados se deben abrir vínculos a Internet. Cuando se configura esta propiedad, ManagedBrowserToOpenLinksRequired debe ser true. Se hereda de managedAppProtection. Los valores posibles son notConfigured y microsoftEdge.
isAssigned Booleano Indica si la directiva se implementará en los grupos de inclusión. Heredado de targetedManagedAppProtection.
screenCaptureBlocked Boolean Indica si un usuario administrado puede realizar capturas de pantalla de las aplicaciones administradas.
disableAppEncryptionIfDeviceEncryptionIsEnabled Booleano Cuando se habilita esta configuración, el cifrado de nivel de aplicación está deshabilitado si el cifrado de nivel de dispositivo está activado.
encryptAppData Boolean Indica si se deben cifrar los datos de aplicaciones para las aplicaciones administradas.
deployedAppCount Int32 Número de aplicaciones en las que se implementará la directiva actual.
minimumRequiredPatchVersion Cadena Definir el nivel más antiguo de revisión de seguridad de Android necesario para que un usuario pueda tener acceso seguro a la aplicación.
minimumWarningPatchVersion Cadena Definir el nivel más antiguo de revisión de seguridad de Android recomendado para que un usuario pueda tener acceso seguro a la aplicación.
customBrowserPackageId Cadena Identificador único del explorador personalizado preferido para abrir el vínculo web en Android. Cuando se configura esta propiedad, ManagedBrowserToOpenLinksRequired debe ser true.
customBrowserDisplayName Cadena Nombre descriptivo del explorador personalizado preferido para abrir el vínculo web en Android. Cuando se configura esta propiedad, ManagedBrowserToOpenLinksRequired debe ser true.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y un objeto androidManagedAppProtection actualizado en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

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"
}

Respuesta

Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.

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"
}