Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Importante: A Microsoft dá suporte a APIs /beta do Intune, mas elas estão sujeitas a alterações mais frequentes. A Microsoft recomenda usar a versão v1.0 sempre que possível. Verifique a disponibilidade de uma API na versão v1.0 usando o seletor de versão.
Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.
Crie um novo objeto androidForWorkCompliancePolicy .
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA 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
POST /deviceManagement/deviceCompliancePolicies
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 da solicitação, forneça uma representação JSON para o objeto androidForWorkCompliancePolicy.
A tabela a seguir mostra as propriedades necessárias ao criar o androidForWorkCompliancePolicy.
| Propriedade | Tipo | Descrição |
|---|---|---|
| roleScopeTagIds | String collection | Lista de marcas de escopo 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 |
| passwordRequired | Boolean | Exige uma senha para desbloquear o dispositivo. |
| passwordMinimumLength | Int32 | Comprimento mínimo da senha. Valores válidos de 4 a 16 |
| passwordRequiredType | androidRequiredPasswordType | Tipo de caracteres na senha. Os valores possíveis são: deviceDefault, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, numeric, numericComplex, any. |
| requiredPasswordComplexity | androidRequiredPasswordComplexity | Indica a complexidade necessária da senha do dispositivo no Android. Um dos: NENHUM, BAIXO, MÉDIO, ALTO. Essa é uma nova API voltada para a API 12+ do Android. Os valores possíveis são: none, low, medium, high. |
| 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 |
| passwordPreviousPasswordBlockCount | Int32 | Número de senhas anteriores para bloquear. Valores válidos de 1 a 24 |
| passwordSignInFailureCountBeforeFactoryReset | Int32 | Número de falhas de entrada permitidas antes da redefinição de fábrica. Valores válidos de 1 a 16 |
| workProfilePasswordExpirationInDays | Int32 | Número de dias antes que a senha do perfil de trabalho expire. Valores válidos de 1 a 365 |
| workProfilePasswordMinimumLength | Int32 | Comprimento mínimo da senha do perfil de trabalho. Valores válidos de 4 a 16 |
| workProfileInactiveBeforeScreenLockInMinutes | Int32 | Minutos de inatividade antes que a tela atinja o tempo limite. |
| workProfilePreviousPasswordBlockCount | Int32 | Número de senhas de perfil de trabalho anteriores a serem bloqueadas. Valores válidos de 0 a 24 |
| workProfilePasswordRequiredType | androidForWorkRequiredPasswordType | Tipo de senha de perfil de trabalho necessária. Os valores possíveis são: deviceDefault, lowSecurityBiometric, required, atLeastNumeric, numericComplex, atLeastAlphabetic, atLeastAlphanumeric, alphanumericWithSymbols. |
| workProfileRequiredPasswordComplexity | androidRequiredPasswordComplexity | Indica a complexidade de senha de perfil de trabalho necessária no Android. Um dos: NENHUM, BAIXO, MÉDIO, ALTO. Essa é uma nova API voltada para o Android 12+. Os valores possíveis são: none, low, medium, high. |
| workProfileRequirePassword | Booliano | A senha é obrigatória ou não para o perfil de trabalho |
| securityPreventInstallAppsFromUnknownSources | Boolean | Exige que os dispositivos não permitam a instalação de aplicativos de origens desconhecidas. |
| securityDisableUsbDebugging | Boolean | Desabilite a depuração USB em dispositivos Android. |
| securityRequireVerifyApps | Boolean | Exige que o recurso de verificação de aplicativos Android esteja ativado. |
| 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 valores possíveis são: unavailable, secured, low, medium, high, notSet. |
| securityBlockJailbrokenDevices | Booliano | Indica que o dispositivo não deve estar enraizado. Quando TRUE, se o dispositivo for detectado como enraizado, ele será relatado como não compatível. Quando FALSE, o dispositivo não é relatado como não compatível, independentemente do estado com raiz do dispositivo. O padrão é FALSE. |
| 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. |
| storageRequireEncryption | Boolean | Exige criptografia em dispositivos Android. |
| securityRequireSafetyNetAttestationBasicIntegrity | Booliano | Exigir que o dispositivo passe na verificação de integridade básica de Integridade de Jogo da marca. |
| securityRequireSafetyNetAttestationCertifiedDevice | Booliano | Exigir que o dispositivo passe na verificação de integridade do dispositivo de Integridade do Jogo da marca. |
| securityRequireGooglePlayServices | Boolean | Exige que os Google Play Services sejam instalados e habilitados no dispositivo. |
| securityRequireUpToDateSecurityProviders | Boolean | Exige que o dispositivo tenha provedores de segurança atualizados. O dispositivo exigirá que os Google Play Services sejam habilitados e atualizados. |
| securityRequireCompanyPortalAppIntegrity | Boolean | Exige que o dispositivo passe na verificação de integridade de tempo de execução de aplicativo cliente do Portal da Empresa. |
| securityRequiredAndroidSafetyNetEvaluationType | androidSafetyNetEvaluationType | Exigir um tipo de avaliação específico do SafetyNet para conformidade. Os valores possíveis são: basic e hardwareBacked. |
Resposta
Se for bem-sucedido, esse método retornará um código de 201 Created resposta e um objeto androidForWorkCompliancePolicy no corpo da resposta.
Exemplo
Solicitação
Este é um exemplo da solicitação.
POST https://graph.microsoft.com/beta/deviceManagement/deviceCompliancePolicies
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"
}
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 201 Created
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"
}