Atualizar androidDeviceOwnerCompliancePolicy
Namespace: microsoft.graph
Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; a utilização de produção não é suportada.
Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.
Atualize as propriedades de um objeto androidDeviceOwnerCompliancePolicy .
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissões
Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.
| Tipo de permissão | Permissões (da com menos para a com mais privilégios) |
|---|---|
| Delegado (conta corporativa ou de estudante) | DeviceManagementConfiguration.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. |
| Application | DeviceManagementConfiguration.ReadWrite.All |
Solicitação HTTP
PATCH /deviceManagement/deviceCompliancePolicies/{deviceCompliancePolicyId}
Cabeçalhos de solicitação
| Cabeçalho | Valor |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Aceitar | application/json |
Corpo da solicitação
No corpo do pedido, forneça uma representação JSON para o objeto androidDeviceOwnerCompliancePolicy .
A tabela seguinte mostra as propriedades necessárias quando cria androidDeviceOwnerCompliancePolicy.
| Propriedade | Tipo | Descrição |
|---|---|---|
| roleScopeTagIds | Coleção String | Lista de Etiquetas de Âmbito para esta Instância de entidade. Herdada de deviceCompliancePolicy |
| id | String | Chave da entidade. Herdada de deviceCompliancePolicy |
| createdDateTime | DateTimeOffset | DateTime em que o objeto foi criado. Herdada de deviceCompliancePolicy |
| description | String | O administrador forneceu a descrição da Configuração do dispositivo. Herdada de deviceCompliancePolicy |
| lastModifiedDateTime | DateTimeOffset | DateTime da última modificação do objeto. Herdada de deviceCompliancePolicy |
| displayName | String | O administrador forneceu o nome da Configuração do dispositivo. Herdada de deviceCompliancePolicy |
| version | Int32 | Versão da configuração do dispositivo. Herdada de deviceCompliancePolicy |
| deviceThreatProtectionEnabled | Boolean | Exige que os dispositivos tenham habilitada a proteção contra ameaças. |
| deviceThreatProtectionRequiredSecurityLevel | deviceThreatProtectionLevel | Exige o nível mínimo de risco de Proteção contra Ameaças Móveis para indicar falta de conformidade. Os possíveis valores são: unavailable, secured, low, medium, high, notSet. |
| advancedThreatProtectionRequiredSecurityLevel | deviceThreatProtectionLevel | MDATP Exigir nível de risco mínimo de Proteção Contra Ameaças para Dispositivos Móveis para comunicar não conformidade. Os possíveis valores são: unavailable, secured, low, medium, high, notSet. |
| securityRequireSafetyNetAttestationBasicIntegrity | Booliano | Exigir que o dispositivo passe a verificação de integridade básica da Integridade da Reprodução. |
| securityRequireSafetyNetAttestationCertifiedDevice | Booliano | Exigir que o dispositivo passe a verificação de integridade do dispositivo da Integridade da Reprodução. |
| osMinimumVersion | String | Versão mínima do Android. |
| osMaximumVersion | String | Versão máxima do Android. |
| minAndroidSecurityPatchLevel | String | Nível mínimo de patch de segurança Android. |
| passwordRequired | Boolean | Exige uma senha para desbloquear o dispositivo. |
| passwordMinimumLength | Int32 | Comprimento mínimo da senha. Valores válidos de 4 a 16 |
| passwordMinimumLetterCharacters | Int32 | Indica o número mínimo de carateres de letra necessários para a palavra-passe do dispositivo. Valores válidos de 1 a 16 |
| passwordMinimumLowerCaseCharacters | Int32 | Indica o número mínimo de carateres minúsculos necessários para a palavra-passe do dispositivo. Valores válidos de 1 a 16 |
| passwordMinimumNonLetterCharacters | Int32 | Indica o número mínimo de carateres que não são letras necessários para a palavra-passe do dispositivo. Valores válidos de 1 a 16 |
| passwordMinimumNumericCharacters | Int32 | Indica o número mínimo de carateres numéricos necessários para a palavra-passe do dispositivo. Valores válidos de 1 a 16 |
| passwordMinimumSymbolCharacters | Int32 | Indica o número mínimo de carateres de símbolo necessários para a palavra-passe do dispositivo. Valores válidos de 1 a 16 |
| passwordMinimumUpperCaseCharacters | Int32 | Indica o número mínimo de carateres de letra maiúsculas necessários para a palavra-passe do dispositivo. Valores válidos de 1 a 16 |
| passwordRequiredType | androidDeviceOwnerRequiredPasswordType | Tipo de carateres na palavra-passe. Os valores possíveis são: deviceDefault, required, numeric, numericComplex, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, customPassword. |
| passwordMinutesOfInactivityBeforeLock | Int32 | Minutos de inatividade antes que uma senha seja necessária. |
| passwordExpirationDays | Int32 | Número de dias antes da expiração da senha. Valores válidos de 1 a 365 |
| passwordPreviousPasswordCountToBlock | Int32 | Número de senhas anteriores para bloquear. Valores válidos de 1 a 24 |
| storageRequireEncryption | Boolean | Exige criptografia em dispositivos Android. |
| securityRequireIntuneAppIntegrity | Booliano | Se a definição estiver definida como verdadeira, verifica se a aplicação do Intune instalada em dispositivos inscritos no Android Enterprise com perfil de trabalho totalmente gerido, dedicado ou pertencente à empresa é o fornecido pela Microsoft a partir da Managed Google Playstore. Se a verificação falhar, o dispositivo será reportado como não conforme. |
| requireNoPendingSystemUpdates | Booliano | Exigir que o dispositivo não tenha atualizações pendentes do sistema Android. |
| securityRequiredAndroidSafetyNetEvaluationType | androidSafetyNetEvaluationType | Exigir um tipo de avaliação de Integridade de Reprodução específico para conformidade. Os valores possíveis são: basic e hardwareBacked. |
Resposta
Se for bem-sucedido, este método devolve um 200 OK código de resposta e um objeto androidDeviceOwnerCompliancePolicy atualizado no corpo da resposta.
Exemplo
Solicitação
Este é um exemplo da solicitação.
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"
}
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: 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"
}