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
Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.
Criar um novo objeto androidGeneralDeviceConfiguration.
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
POST /deviceManagement/deviceConfigurations
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 do objeto androidGeneralDeviceConfiguration.
A tabela a seguir mostra as propriedades que são necessárias ao criar androidGeneralDeviceConfiguration.
| Propriedade | Tipo | Descrição |
|---|---|---|
| id | String | Chave da entidade. Herdada de deviceConfiguration |
| lastModifiedDateTime | DateTimeOffset | DateTime da última modificação do objeto. Herdada de deviceConfiguration |
| createdDateTime | DateTimeOffset | DateTime em que o objeto foi criado. Herdada de deviceConfiguration |
| description | String | O administrador forneceu a descrição da Configuração do dispositivo. Herdada de deviceConfiguration |
| displayName | String | O administrador forneceu o nome da Configuração do dispositivo. Herdada de deviceConfiguration |
| versão | Int32 | Versão da configuração do dispositivo. Herdada de deviceConfiguration |
| appsBlockClipboardSharing | Boolean | Indica se a função de copiar e colar entre aplicativos será bloqueada ou não no compartilhamento de área de transferência. |
| appsBlockCopyPaste | Boolean | Indica se a função de copiar e colar dentro de aplicativos será bloqueada ou não. |
| appsBlockYouTube | Boolean | Indica se o aplicativo YouTube deve ou não ser bloqueado. |
| bluetoothBlocked | Boolean | Indica se o Bluetooth deve ou não ser bloqueado. |
| cameraBlocked | Boolean | Indica se o uso da câmera deve ou não ser bloqueado. |
| cellularBlockDataRoaming | Boolean | Indica se o roaming de dados deve ou não ser bloqueado. |
| cellularBlockMessaging | Boolean | Indica se as mensagens SMS/MMS devem ou não ser bloqueadas. |
| cellularBlockVoiceRoaming | Boolean | Indica se o roaming de voz deve ou não ser bloqueado. |
| cellularBlockWiFiTethering | Boolean | Indica se a sincronização de compartilhamento de Internet por Wi-Fi deve ou não ser bloqueada. |
| compliantAppsList | Coleção appListItem | Lista de aplicativos em conformidade (lista de permissões ou lista de bloqueios, controladas por CompliantAppListType). Essa coleção pode conter um máximo de 10.000 elementos. |
| compliantAppListType | appListType | Tipo de lista que está em CompliantAppsList. Os valores possíveis são: none, appsInListCompliant, appsNotInListCompliant. |
| diagnosticDataBlockSubmission | Boolean | Indica se o envio de dados de diagnóstico deve ou não ser bloqueado. |
| locationServicesBlocked | Boolean | Indica se os serviços de localização devem ou não ser bloqueados. |
| googleAccountBlockAutoSync | Boolean | Indica se a sincronização automática da conta do Google deve ou não ser bloqueada. |
| googlePlayStoreBlocked | Boolean | Indica se a Google Play Store deve ou não ser bloqueada. |
| kioskModeBlockSleepButton | Boolean | Indica se o botão de suspensão de tela deve ou não ser bloqueado no modo quiosque. |
| kioskModeBlockVolumeButtons | Boolean | Indica se os botões de volume devem ou não ser bloqueados no modo quiosque. |
| kioskModeApps | Coleção appListItem | Uma lista de aplicativos que poderão ser executados quando o dispositivo estiver no modo quiosque. Esta coleção pode conter um máximo de 500 elementos. |
| nfcBlocked | Boolean | Indica se a comunicação a curta distância deve ou não ser bloqueada. |
| passwordBlockFingerprintUnlock | Boolean | Indica se o desbloqueio de impressão digital deve ou não ser bloqueado. |
| passwordBlockTrustAgents | Boolean | Indica se o Smart Lock e outros agentes confiáveis devem ou não ser bloqueados. |
| passwordExpirationDays | Int32 | Número de dias antes da expiração da senha. Valores válidos de 1 a 365 |
| passwordMinimumLength | Int32 | Comprimento mínimo das senhas. Valores válidos de 4 a 16 |
| passwordMinutesOfInactivityBeforeScreenTimeout | Int32 | Minutos de inatividade antes que a tela atinja o tempo limite. |
| passwordPreviousPasswordBlockCount | Int32 | Número de senhas anteriores para bloquear. Valores válidos de 0 a 24 |
| passwordSignInFailureCountBeforeFactoryReset | Int32 | Número permitido de falhas de entrada antes da redefinição de fábrica. Valores válidos de 1 a 16 |
| passwordRequiredType | androidRequiredPasswordType | Tipo de senha necessário. Os valores possíveis são: deviceDefault, , alphanumericalphabetic, , lowSecurityBiometricalphanumericWithSymbols, numeric, , . anynumericComplex |
| passwordRequired | Boolean | Indica se uma senha deve ou não ser exigida. |
| powerOffBlocked | Boolean | Indica se o desligamento do dispositivo deve ou não ser bloqueado. |
| factoryResetBlocked | Boolean | Indica se o usuário será ou não impedido de executar uma restauração de fábrica. |
| screenCaptureBlocked | Boolean | Indica se capturas de tela devem ou não ser bloqueadas. |
| deviceSharingAllowed | Boolean | Indica se o modo de compartilhamento do dispositivo deve ou não ser permitido. |
| storageBlockGoogleBackup | Boolean | Indica se o Backup do Google deve ou não ser bloqueado. |
| storageBlockRemovableStorage | Boolean | Indica se o uso do armazenamento removível deve ou não ser bloqueado. |
| storageRequireDeviceEncryption | Boolean | Indica se a criptografia do dispositivo é ou não necessária. |
| storageRequireRemovableStorageEncryption | Boolean | Indica se a criptografia do armazenamento removível é ou não necessária. |
| voiceAssistantBlocked | Boolean | Indica se o uso do Assistente de voz será ou não bloqueado. |
| voiceDialingBlocked | Boolean | Indica se a discagem de voz deve ou não ser bloqueada. |
| webBrowserBlockPopups | Boolean | Indica se os pop-ups dentro do navegador da Web devem ou não ser bloqueados. |
| webBrowserBlockAutofill | Boolean | Indica se o recurso de preenchimento automático do navegador da Web deve ou não ser bloqueado. |
| webBrowserBlockJavaScript | Boolean | Indica se o JavaScript dentro do navegador da Web deve ou não ser bloqueado. |
| webBrowserBlocked | Boolean | Indica se o navegador da Web deve ou não ser bloqueado. |
| webBrowserCookieSettings | webBrowserCookieSettings | Configuração de cookies do navegador da Web. Os valores possíveis são: browserDefault, blockAlways, allowCurrentWebSite, allowFromWebsitesVisited, allowAlways. |
| wiFiBlocked | Boolean | Indica se a sincronização de Wi-Fi deve ou não ser bloqueada. |
| appsInstallAllowList | Coleção appListItem | Lista de aplicativos que podem ser instalados no dispositivo KNOX. Esta coleção pode conter um máximo de 500 elementos. |
| appsLaunchBlockList | Coleção appListItem | Lista de aplicativos que não podem ser abertos no dispositivo KNOX. Esta coleção pode conter um máximo de 500 elementos. |
| appsHideList | Coleção appListItem | Lista de aplicativos que devem ficar ocultos no dispositivo KNOX. Esta coleção pode conter um máximo de 500 elementos. |
| securityRequireVerifyApps | Boolean | Exige que o recurso de verificação de aplicativos Android esteja ativado. |
Resposta
Se bem-sucedido, este método retornará um código de resposta 201 Created e um objeto androidGeneralDeviceConfiguration no corpo da resposta.
Exemplo
Solicitação
Este é um exemplo da solicitação.
POST https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations
Content-type: application/json
Content-length: 3033
{
"@odata.type": "#microsoft.graph.androidGeneralDeviceConfiguration",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"appsBlockClipboardSharing": true,
"appsBlockCopyPaste": true,
"appsBlockYouTube": true,
"bluetoothBlocked": true,
"cameraBlocked": true,
"cellularBlockDataRoaming": true,
"cellularBlockMessaging": true,
"cellularBlockVoiceRoaming": true,
"cellularBlockWiFiTethering": true,
"compliantAppsList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"compliantAppListType": "appsInListCompliant",
"diagnosticDataBlockSubmission": true,
"locationServicesBlocked": true,
"googleAccountBlockAutoSync": true,
"googlePlayStoreBlocked": true,
"kioskModeBlockSleepButton": true,
"kioskModeBlockVolumeButtons": true,
"kioskModeApps": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"nfcBlocked": true,
"passwordBlockFingerprintUnlock": true,
"passwordBlockTrustAgents": true,
"passwordExpirationDays": 6,
"passwordMinimumLength": 5,
"passwordMinutesOfInactivityBeforeScreenTimeout": 14,
"passwordPreviousPasswordBlockCount": 2,
"passwordSignInFailureCountBeforeFactoryReset": 12,
"passwordRequiredType": "alphabetic",
"passwordRequired": true,
"powerOffBlocked": true,
"factoryResetBlocked": true,
"screenCaptureBlocked": true,
"deviceSharingAllowed": true,
"storageBlockGoogleBackup": true,
"storageBlockRemovableStorage": true,
"storageRequireDeviceEncryption": true,
"storageRequireRemovableStorageEncryption": true,
"voiceAssistantBlocked": true,
"voiceDialingBlocked": true,
"webBrowserBlockPopups": true,
"webBrowserBlockAutofill": true,
"webBrowserBlockJavaScript": true,
"webBrowserBlocked": true,
"webBrowserCookieSettings": "blockAlways",
"wiFiBlocked": true,
"appsInstallAllowList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"appsLaunchBlockList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"appsHideList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"securityRequireVerifyApps": true
}
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: 3205
{
"@odata.type": "#microsoft.graph.androidGeneralDeviceConfiguration",
"id": "9e00d534-d534-9e00-34d5-009e34d5009e",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"appsBlockClipboardSharing": true,
"appsBlockCopyPaste": true,
"appsBlockYouTube": true,
"bluetoothBlocked": true,
"cameraBlocked": true,
"cellularBlockDataRoaming": true,
"cellularBlockMessaging": true,
"cellularBlockVoiceRoaming": true,
"cellularBlockWiFiTethering": true,
"compliantAppsList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"compliantAppListType": "appsInListCompliant",
"diagnosticDataBlockSubmission": true,
"locationServicesBlocked": true,
"googleAccountBlockAutoSync": true,
"googlePlayStoreBlocked": true,
"kioskModeBlockSleepButton": true,
"kioskModeBlockVolumeButtons": true,
"kioskModeApps": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"nfcBlocked": true,
"passwordBlockFingerprintUnlock": true,
"passwordBlockTrustAgents": true,
"passwordExpirationDays": 6,
"passwordMinimumLength": 5,
"passwordMinutesOfInactivityBeforeScreenTimeout": 14,
"passwordPreviousPasswordBlockCount": 2,
"passwordSignInFailureCountBeforeFactoryReset": 12,
"passwordRequiredType": "alphabetic",
"passwordRequired": true,
"powerOffBlocked": true,
"factoryResetBlocked": true,
"screenCaptureBlocked": true,
"deviceSharingAllowed": true,
"storageBlockGoogleBackup": true,
"storageBlockRemovableStorage": true,
"storageRequireDeviceEncryption": true,
"storageRequireRemovableStorageEncryption": true,
"voiceAssistantBlocked": true,
"voiceDialingBlocked": true,
"webBrowserBlockPopups": true,
"webBrowserBlockAutofill": true,
"webBrowserBlockJavaScript": true,
"webBrowserBlocked": true,
"webBrowserCookieSettings": "blockAlways",
"wiFiBlocked": true,
"appsInstallAllowList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"appsLaunchBlockList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"appsHideList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"securityRequireVerifyApps": true
}