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"
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de