Actualizar androidForWorkCompliancePolicy
Espacio de nombres: microsoft.graph
Importante: Las API de Microsoft Graph en la versión /beta están sujetas a cambios; no se admite el uso de producción.
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Actualice las propiedades de un objeto androidForWorkCompliancePolicy .
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) | DeviceManagementConfiguration.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | DeviceManagementConfiguration.ReadWrite.All |
Solicitud HTTP
PATCH /deviceManagement/deviceCompliancePolicies/{deviceCompliancePolicyId}
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, proporcione una representación JSON para el objeto androidForWorkCompliancePolicy .
En la tabla siguiente se muestran las propiedades necesarias al crear androidForWorkCompliancePolicy.
| Propiedad | Tipo | Descripción |
|---|---|---|
| roleScopeTagIds | Colección de cadenas | Lista de etiquetas de ámbito para esta instancia de entity. Heredado de deviceCompliancePolicy. |
| id | Cadena | Clave de la entidad. Heredado de deviceCompliancePolicy. |
| createdDateTime | DateTimeOffset | Fecha y hora en la que se creó el objeto. Heredado de deviceCompliancePolicy. |
| description | Cadena | Descripción proporcionada por el administrador de la configuración del dispositivo. Heredado de deviceCompliancePolicy. |
| lastModifiedDateTime | DateTimeOffset | Fecha y hora en la que se modificó el objeto por última vez. Heredado de deviceCompliancePolicy. |
| displayName | Cadena | Nombre proporcionado por el administrador de la configuración del dispositivo. Heredado de deviceCompliancePolicy. |
| version | Int32 | Versión de la configuración del dispositivo. Heredado de deviceCompliancePolicy. |
| passwordRequired | Booleano | Exigir una contraseña para desbloquear el dispositivo. |
| passwordMinimumLength | Int32 | Longitud mínima de la contraseña. Valores válidos de 4 a 16 |
| passwordRequiredType | androidRequiredPasswordType | Tipo de caracteres en la contraseña. Los valores posibles son: deviceDefault, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, numeric, numericComplex y any. |
| requiredPasswordComplexity | androidRequiredPasswordComplexity | Indica la complejidad de la contraseña del dispositivo necesaria en Android. Uno de ellos: NONE, LOW, MEDIUM, HIGH. Se trata de una nueva API destinada a Android API 12+. Los valores posibles son: none, low, medium y high. |
| passwordMinutesOfInactivityBeforeLock | Int32 | Minutos de inactividad antes de que sea necesaria una contraseña. |
| passwordExpirationDays | Int32 | Número de días antes de que expire la contraseña. Valores válidos de 1 a 365 |
| passwordPreviousPasswordBlockCount | Int32 | Número de contraseñas anteriores que bloquear. Valores válidos de 1 a 24. |
| passwordSignInFailureCountBeforeFactoryReset | Int32 | Número de errores de inicio de sesión permitidos antes del restablecimiento de fábrica. Valores válidos de 1 a 16 |
| workProfilePasswordExpirationInDays | Int32 | Número de días antes de que expire la contraseña del perfil de trabajo. Valores válidos de 1 a 365. |
| workProfilePasswordMinimumLength | Int32 | Longitud mínima de la contraseña del perfil de trabajo. Valores válidos de 4 a 16 |
| workProfileInactiveBeforeScreenLockInMinutes | Int32 | Minutos de inactividad antes de que se agote el tiempo de espera de la pantalla. |
| workProfilePreviousPasswordBlockCount | Int32 | Número de contraseñas de perfil de trabajo anteriores que se van a bloquear. Valores válidos de 0 a 24. |
| workProfilePasswordRequiredType | androidForWorkRequiredPasswordType | Tipo de contraseña de perfil de trabajo necesaria. Los valores posibles son: deviceDefault, lowSecurityBiometric, required, atLeastNumeric, numericComplex, atLeastAlphabetic, atLeastAlphanumeric y alphanumericWithSymbols. |
| workProfileRequiredPasswordComplexity | androidRequiredPasswordComplexity | Indica la complejidad necesaria de la contraseña del perfil de trabajo en Android. Uno de ellos: NONE, LOW, MEDIUM, HIGH. Se trata de una nueva API destinada a Android 12+. Los valores posibles son: none, low, medium y high. |
| workProfileRequirePassword | Booleano | La contraseña es necesaria o no para el perfil de trabajo |
| securityPreventInstallAppsFromUnknownSources | Booleano | Exigir que los dispositivos impidan la instalación de aplicaciones de orígenes desconocidos. |
| securityDisableUsbDebugging | Booleano | Deshabilitar la depuración USB en dispositivos Android. |
| securityRequireVerifyApps | Booleano | Requerir que la característica Verificar aplicaciones de Android esté activada. |
| deviceThreatProtectionEnabled | Booleano | Exigir que los dispositivos hayan habilitado la protección contra amenazas de dispositivo. |
| deviceThreatProtectionRequiredSecurityLevel | deviceThreatProtectionLevel | Exigir que el nivel de riesgo mínimo de Mobile Threat Protection informe del no cumplimiento. Los valores posibles son: unavailable, secured, low, medium, high y notSet. |
| securityBlockJailbrokenDevices | Booleano | No pueden usarse dispositivos con jailbreak o rooting. |
| osMinimumVersion | Cadena | Versión mínima de Android. |
| osMaximumVersion | Cadena | Versión máxima de Android. |
| minAndroidSecurityPatchLevel | Cadena | Nivel de revisión de seguridad mínimo de Android. |
| storageRequireEncryption | Booleano | Exigir cifrado en dispositivos Android. |
| securityRequireSafetyNetAttestationBasicIntegrity | Booleano | Requerir que el dispositivo pase la comprobación de integridad básica de play integrity. |
| securityRequireSafetyNetAttestationCertifiedDevice | Booleano | Requerir que el dispositivo pase la comprobación de integridad del dispositivo play integrity. |
| securityRequireGooglePlayServices | Booleano | Exigir que Google Play Services esté instalado y habilitado en el dispositivo. |
| securityRequireUpToDateSecurityProviders | Booleano | Exigir que el dispositivo tenga los proveedores de seguridad actualizados. El dispositivo requerirá que Google Play Services esté instalado y habilitado. |
| securityRequireCompanyPortalAppIntegrity | Booleano | Exigir que el dispositivo supere la comprobación de integridad en tiempo de ejecución de la aplicación cliente del Portal de empresa. |
| securityRequiredAndroidSafetyNetEvaluationType | androidSafetyNetEvaluationType | Requerir un tipo de evaluación de SafetyNet específico para el cumplimiento. Los valores posibles son basic y hardwareBacked. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto androidForWorkCompliancePolicy actualizado en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceCompliancePolicies/{deviceCompliancePolicyId}
Content-type: application/json
Content-length: 1735
{
"@odata.type": "#microsoft.graph.androidForWorkCompliancePolicy",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"passwordRequired": true,
"passwordMinimumLength": 5,
"passwordRequiredType": "alphabetic",
"requiredPasswordComplexity": "low",
"passwordMinutesOfInactivityBeforeLock": 5,
"passwordExpirationDays": 6,
"passwordPreviousPasswordBlockCount": 2,
"passwordSignInFailureCountBeforeFactoryReset": 12,
"workProfilePasswordExpirationInDays": 3,
"workProfilePasswordMinimumLength": 0,
"workProfileInactiveBeforeScreenLockInMinutes": 12,
"workProfilePreviousPasswordBlockCount": 5,
"workProfilePasswordRequiredType": "lowSecurityBiometric",
"workProfileRequiredPasswordComplexity": "low",
"workProfileRequirePassword": true,
"securityPreventInstallAppsFromUnknownSources": true,
"securityDisableUsbDebugging": true,
"securityRequireVerifyApps": true,
"deviceThreatProtectionEnabled": true,
"deviceThreatProtectionRequiredSecurityLevel": "secured",
"securityBlockJailbrokenDevices": true,
"osMinimumVersion": "Os Minimum Version value",
"osMaximumVersion": "Os Maximum Version value",
"minAndroidSecurityPatchLevel": "Min Android Security Patch Level value",
"storageRequireEncryption": true,
"securityRequireSafetyNetAttestationBasicIntegrity": true,
"securityRequireSafetyNetAttestationCertifiedDevice": true,
"securityRequireGooglePlayServices": true,
"securityRequireUpToDateSecurityProviders": true,
"securityRequireCompanyPortalAppIntegrity": true,
"securityRequiredAndroidSafetyNetEvaluationType": "hardwareBacked"
}
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: 1907
{
"@odata.type": "#microsoft.graph.androidForWorkCompliancePolicy",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"id": "a8d667bd-67bd-a8d6-bd67-d6a8bd67d6a8",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"description": "Description value",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"displayName": "Display Name value",
"version": 7,
"passwordRequired": true,
"passwordMinimumLength": 5,
"passwordRequiredType": "alphabetic",
"requiredPasswordComplexity": "low",
"passwordMinutesOfInactivityBeforeLock": 5,
"passwordExpirationDays": 6,
"passwordPreviousPasswordBlockCount": 2,
"passwordSignInFailureCountBeforeFactoryReset": 12,
"workProfilePasswordExpirationInDays": 3,
"workProfilePasswordMinimumLength": 0,
"workProfileInactiveBeforeScreenLockInMinutes": 12,
"workProfilePreviousPasswordBlockCount": 5,
"workProfilePasswordRequiredType": "lowSecurityBiometric",
"workProfileRequiredPasswordComplexity": "low",
"workProfileRequirePassword": true,
"securityPreventInstallAppsFromUnknownSources": true,
"securityDisableUsbDebugging": true,
"securityRequireVerifyApps": true,
"deviceThreatProtectionEnabled": true,
"deviceThreatProtectionRequiredSecurityLevel": "secured",
"securityBlockJailbrokenDevices": true,
"osMinimumVersion": "Os Minimum Version value",
"osMaximumVersion": "Os Maximum Version value",
"minAndroidSecurityPatchLevel": "Min Android Security Patch Level value",
"storageRequireEncryption": true,
"securityRequireSafetyNetAttestationBasicIntegrity": true,
"securityRequireSafetyNetAttestationCertifiedDevice": true,
"securityRequireGooglePlayServices": true,
"securityRequireUpToDateSecurityProviders": true,
"securityRequireCompanyPortalAppIntegrity": true,
"securityRequiredAndroidSafetyNetEvaluationType": "hardwareBacked"
}