Criar androidForWorkCompliancePolicyCreate androidForWorkCompliancePolicy

Namespace: microsoft.graphNamespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; não há suporte para uso de produção.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Crie um novo objeto androidForWorkCompliancePolicy.Create a new androidForWorkCompliancePolicy object.

Pré-requisitosPrerequisites

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegada (conta corporativa ou de estudante)Delegated (work or school account) DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
Delegada (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All

Solicitação HTTPHTTP Request

POST /deviceManagement/deviceCompliancePolicies

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization <Token> de portador obrigatório.Bearer <token> Required.
AceitarAccept application/jsonapplication/json

Corpo da solicitaçãoRequest body

No corpo da solicitação, fornece uma representação JSON para o objeto androidForWorkCompliancePolicy.In the request body, supply a JSON representation for the androidForWorkCompliancePolicy object.

A tabela a seguir mostra as propriedades que são necessárias ao criar o androidForWorkCompliancePolicy.The following table shows the properties that are required when you create the androidForWorkCompliancePolicy.

PropriedadeProperty TipoType DescriçãoDescription
roleScopeTagIdsroleScopeTagIds Coleção de cadeias de caracteresString collection Lista de marcas de escopo para esta instância entity.List of Scope Tags for this Entity instance. Herdada de deviceCompliancePolicyInherited from deviceCompliancePolicy
idid Cadeia de caracteresString Chave da entidade.Key of the entity. Herdada de deviceCompliancePolicyInherited from deviceCompliancePolicy
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset DateTime em que o objeto foi criado.DateTime the object was created. Herdada de deviceCompliancePolicyInherited from deviceCompliancePolicy
descriçãodescription Cadeia de caracteresString O administrador forneceu a descrição da Configuração do dispositivo.Admin provided description of the Device Configuration. Herdada de deviceCompliancePolicyInherited from deviceCompliancePolicy
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset DateTime da última modificação do objeto.DateTime the object was last modified. Herdada de deviceCompliancePolicyInherited from deviceCompliancePolicy
displayNamedisplayName Cadeia de caracteresString O administrador forneceu o nome da Configuração do dispositivo.Admin provided name of the device configuration. Herdada de deviceCompliancePolicyInherited from deviceCompliancePolicy
versionversion Int32Int32 Versão da configuração do dispositivo.Version of the device configuration. Herdada de deviceCompliancePolicyInherited from deviceCompliancePolicy
passwordRequiredpasswordRequired BooleanBoolean Exige uma senha para desbloquear o dispositivo.Require a password to unlock device.
passwordMinimumLengthpasswordMinimumLength Int32Int32 Comprimento mínimo da senha.Minimum password length. Valores válidos de 4 a 16Valid values 4 to 16
passwordRequiredTypepasswordRequiredType androidRequiredPasswordTypeandroidRequiredPasswordType Tipo de caracteres em senha.Type of characters in password. Os valores possíveis são: deviceDefault, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, numeric, numericComplex, any.Possible values are: deviceDefault, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, numeric, numericComplex, any.
passwordMinutesOfInactivityBeforeLockpasswordMinutesOfInactivityBeforeLock Int32Int32 Minutos de inatividade antes que uma senha seja necessária.Minutes of inactivity before a password is required.
passwordExpirationDayspasswordExpirationDays Int32Int32 Número de dias antes da expiração da senha.Number of days before the password expires. Valores válidos de 1 a 365Valid values 1 to 365
passwordPreviousPasswordBlockCountpasswordPreviousPasswordBlockCount Int32Int32 Número de senhas anteriores para bloquear.Number of previous passwords to block. Valores válidos de 1 a 24Valid values 1 to 24
passwordSignInFailureCountBeforeFactoryResetpasswordSignInFailureCountBeforeFactoryReset Int32Int32 Número de falhas de login permitidas antes da redefinição de fábrica.Number of sign-in failures allowed before factory reset. Valores válidos de 1 a 16Valid values 1 to 16
securityPreventInstallAppsFromUnknownSourcessecurityPreventInstallAppsFromUnknownSources BooleanBoolean Exige que os dispositivos não permitam a instalação de aplicativos de origens desconhecidas.Require that devices disallow installation of apps from unknown sources.
securityDisableUsbDebuggingsecurityDisableUsbDebugging BooleanBoolean Desabilite a depuração USB em dispositivos Android.Disable USB debugging on Android devices.
securityRequireVerifyAppssecurityRequireVerifyApps BooleanBoolean Exige que o recurso de verificação de aplicativos Android esteja ativado.Require the Android Verify apps feature is turned on.
deviceThreatProtectionEnableddeviceThreatProtectionEnabled BooleanBoolean Exige que os dispositivos tenham habilitada a proteção contra ameaças.Require that devices have enabled device threat protection.
deviceThreatProtectionRequiredSecurityLeveldeviceThreatProtectionRequiredSecurityLevel deviceThreatProtectionLeveldeviceThreatProtectionLevel Exige o nível mínimo de risco de Proteção contra Ameaças Móveis para indicar falta de conformidade.Require Mobile Threat Protection minimum risk level to report noncompliance. Os valores possíveis são: unavailable, secured, low, medium, high, notSet.Possible values are: unavailable, secured, low, medium, high, notSet.
securityBlockJailbrokenDevicessecurityBlockJailbrokenDevices BooleanBoolean Os dispositivos não devem ser violados ou com modificações root.Devices must not be jailbroken or rooted.
osMinimumVersionosMinimumVersion StringString Versão mínima do Android.Minimum Android version.
osMaximumVersionosMaximumVersion StringString Versão máxima do Android.Maximum Android version.
minAndroidSecurityPatchLevelminAndroidSecurityPatchLevel StringString Nível mínimo de patch de segurança Android.Minimum Android security patch level.
storageRequireEncryptionstorageRequireEncryption BooleanBoolean Exige criptografia em dispositivos Android.Require encryption on Android devices.
securityRequireSafetyNetAttestationBasicIntegritysecurityRequireSafetyNetAttestationBasicIntegrity BooleanBoolean Exige que o dispositivo passe na verificação de integridade básica SafetyNet.Require the device to pass the SafetyNet basic integrity check.
securityRequireSafetyNetAttestationCertifiedDevicesecurityRequireSafetyNetAttestationCertifiedDevice BooleanBoolean Exige que o dispositivo passe na verificação de dispositivo certificado SafetyNet.Require the device to pass the SafetyNet certified device check.
securityRequireGooglePlayServicessecurityRequireGooglePlayServices BooleanBoolean Exige que os Google Play Services sejam instalados e habilitados no dispositivo.Require Google Play Services to be installed and enabled on the device.
securityRequireUpToDateSecurityProviderssecurityRequireUpToDateSecurityProviders BooleanBoolean Exige que o dispositivo tenha provedores de segurança atualizados.Require the device to have up to date security providers. O dispositivo exigirá que os Google Play Services sejam habilitados e atualizados.The device will require Google Play Services to be enabled and up to date.
securityRequireCompanyPortalAppIntegritysecurityRequireCompanyPortalAppIntegrity BooleanBoolean Exige que o dispositivo passe na verificação de integridade de tempo de execução de aplicativo cliente do Portal da Empresa.Require the device to pass the Company Portal client app runtime integrity check.

RespostaResponse

Se tiver êxito, este método retornará um código de resposta e um 201 Created objeto androidForWorkCompliancePolicy no corpo da resposta.If successful, this method returns a 201 Created response code and a androidForWorkCompliancePolicy object in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

POST https://graph.microsoft.com/beta/deviceManagement/deviceCompliancePolicies
Content-type: application/json
Content-length: 1283

{
  "@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",
  "passwordMinutesOfInactivityBeforeLock": 5,
  "passwordExpirationDays": 6,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "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
}

RespostaResponse

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.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1455

{
  "@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",
  "passwordMinutesOfInactivityBeforeLock": 5,
  "passwordExpirationDays": 6,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "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
}