Actualizar androidDeviceOwnerCompliancePolicy
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 androidDeviceOwnerCompliancePolicy .
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 androidDeviceOwnerCompliancePolicy .
En la tabla siguiente se muestran las propiedades necesarias al crear androidDeviceOwnerCompliancePolicy.
| Propiedad | Tipo | Descripción |
|---|---|---|
| roleScopeTagIds | Colección string | 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. |
| 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, notSet. |
| advancedThreatProtectionRequiredSecurityLevel | deviceThreatProtectionLevel | MDATP requiere un nivel de riesgo mínimo de Mobile Threat Protection para notificar el incumplimiento. Los valores posibles son: unavailable, secured, low, medium, high, notSet. |
| 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. |
| 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. |
| 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 |
| passwordMinimumLetterCharacters | Int32 | Indica el número mínimo de caracteres de letra necesarios para la contraseña del dispositivo. Valores válidos de 1 a 16 |
| passwordMinimumLowerCaseCharacters | Int32 | Indica el número mínimo de caracteres en minúsculas necesarios para la contraseña del dispositivo. Valores válidos de 1 a 16 |
| passwordMinimumNonLetterCharacters | Int32 | Indica el número mínimo de caracteres que no son de letra necesarios para la contraseña del dispositivo. Valores válidos de 1 a 16 |
| passwordMinimumNumericCharacters | Int32 | Indica el número mínimo de caracteres numéricos necesarios para la contraseña del dispositivo. Valores válidos de 1 a 16 |
| passwordMinimumSymbolCharacters | Int32 | Indica el número mínimo de caracteres de símbolo necesarios para la contraseña del dispositivo. Valores válidos de 1 a 16 |
| passwordMinimumUpperCaseCharacters | Int32 | Indica el número mínimo de caracteres de letra mayúscula necesarios para la contraseña del dispositivo. Valores válidos de 1 a 16 |
| passwordRequiredType | androidDeviceOwnerRequiredPasswordType | Tipo de caracteres en la contraseña. Los valores posibles son: deviceDefault, required, numeric, numericComplex, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric y customPassword. |
| 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. |
| passwordPreviousPasswordCountToBlock | Int32 | Número de contraseñas anteriores que bloquear. Valores válidos de 1 a 24. |
| storageRequireEncryption | Booleano | Exigir cifrado en dispositivos Android. |
| securityRequireIntuneAppIntegrity | Booleano | Si la configuración está establecida en true, comprueba que la aplicación de Intune instalada en dispositivos inscritos android enterprise de perfil de trabajo totalmente administrados, dedicados o corporativos, es la proporcionada por Microsoft desde Google Playstore administrado. Si se produce un error en la comprobación, el dispositivo se notificará como no compatible. |
| requireNoPendingSystemUpdates | Booleano | Requerir que el dispositivo no tenga actualizaciones pendientes del sistema Android. |
| securityRequiredAndroidSafetyNetEvaluationType | androidSafetyNetEvaluationType | Requerir un tipo de evaluación de integridad de reproducción 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 androidDeviceOwnerCompliancePolicy 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: 1382
{
"@odata.type": "#microsoft.graph.androidDeviceOwnerCompliancePolicy",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"deviceThreatProtectionEnabled": true,
"deviceThreatProtectionRequiredSecurityLevel": "secured",
"advancedThreatProtectionRequiredSecurityLevel": "secured",
"securityRequireSafetyNetAttestationBasicIntegrity": true,
"securityRequireSafetyNetAttestationCertifiedDevice": true,
"osMinimumVersion": "Os Minimum Version value",
"osMaximumVersion": "Os Maximum Version value",
"minAndroidSecurityPatchLevel": "Min Android Security Patch Level value",
"passwordRequired": true,
"passwordMinimumLength": 5,
"passwordMinimumLetterCharacters": 15,
"passwordMinimumLowerCaseCharacters": 2,
"passwordMinimumNonLetterCharacters": 2,
"passwordMinimumNumericCharacters": 0,
"passwordMinimumSymbolCharacters": 15,
"passwordMinimumUpperCaseCharacters": 2,
"passwordRequiredType": "required",
"passwordMinutesOfInactivityBeforeLock": 5,
"passwordExpirationDays": 6,
"passwordPreviousPasswordCountToBlock": 4,
"storageRequireEncryption": true,
"securityRequireIntuneAppIntegrity": true,
"requireNoPendingSystemUpdates": 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: 1554
{
"@odata.type": "#microsoft.graph.androidDeviceOwnerCompliancePolicy",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"id": "be2464b4-64b4-be24-b464-24beb46424be",
"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,
"deviceThreatProtectionEnabled": true,
"deviceThreatProtectionRequiredSecurityLevel": "secured",
"advancedThreatProtectionRequiredSecurityLevel": "secured",
"securityRequireSafetyNetAttestationBasicIntegrity": true,
"securityRequireSafetyNetAttestationCertifiedDevice": true,
"osMinimumVersion": "Os Minimum Version value",
"osMaximumVersion": "Os Maximum Version value",
"minAndroidSecurityPatchLevel": "Min Android Security Patch Level value",
"passwordRequired": true,
"passwordMinimumLength": 5,
"passwordMinimumLetterCharacters": 15,
"passwordMinimumLowerCaseCharacters": 2,
"passwordMinimumNonLetterCharacters": 2,
"passwordMinimumNumericCharacters": 0,
"passwordMinimumSymbolCharacters": 15,
"passwordMinimumUpperCaseCharacters": 2,
"passwordRequiredType": "required",
"passwordMinutesOfInactivityBeforeLock": 5,
"passwordExpirationDays": 6,
"passwordPreviousPasswordCountToBlock": 4,
"storageRequireEncryption": true,
"securityRequireIntuneAppIntegrity": true,
"requireNoPendingSystemUpdates": true,
"securityRequiredAndroidSafetyNetEvaluationType": "hardwareBacked"
}