Crear androidGeneralDeviceConfiguration

Espacio de nombres: microsoft.graph

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.

Crear un objeto androidGeneralDeviceConfiguration.

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

POST /deviceManagement/deviceConfigurations

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, especifique una representación JSON del objeto androidGeneralDeviceConfiguration.

En la tabla siguiente se muestran las propiedades necesarias para crear el objeto androidGeneralDeviceConfiguration.

Propiedad Tipo Descripción
id Cadena Clave de la entidad. Heredado de deviceConfiguration
lastModifiedDateTime DateTimeOffset Fecha y hora en la que se modificó el objeto por última vez. Heredado de deviceConfiguration
createdDateTime DateTimeOffset Fecha y hora en la que se creó el objeto. Heredado de deviceConfiguration
description Cadena Descripción proporcionada por el administrador de la configuración del dispositivo. Heredado de deviceConfiguration
displayName Cadena Nombre proporcionado por el administrador de la configuración del dispositivo. Heredado de deviceConfiguration
version Int32 Versión de la configuración del dispositivo. Heredado de deviceConfiguration
appsBlockClipboardSharing Booleano Indica si se va a bloquear el uso compartido del Portapapeles para copiar y pegar entre aplicaciones.
appsBlockCopyPaste Booleano Indica si se va a impedir copiar y pegar en las aplicaciones.
appsBlockYouTube Booleano Indica si se va a bloquear la aplicación YouTube.
bluetoothBlocked Booleano Indica si se va a bloquear Bluetooth.
cameraBlocked Booleano Indica si se va a bloquear el uso de la cámara.
cellularBlockDataRoaming Booleano Indica si se va a bloquear la itinerancia de datos.
cellularBlockMessaging Booleano Indica si se va a bloquear la mensajería SMS/MMS.
cellularBlockVoiceRoaming Booleano Indica si se va a bloquear la itinerancia de voz.
cellularBlockWiFiTethering Booleano Indica si se va a bloquear la sincronización de tethering Wi-Fi.
compliantAppsList Colección appListItem Lista de aplicaciones en el cumplimiento (sea lista de permitidos o de bloqueados, controlado por CompliantAppListType). Esta colección puede contener un máximo de 10 000 elementos.
compliantAppListType appListType Tipo de lista que se encuentra en la CompliantAppsList. Los valores posibles son: none, appsInListCompliant y appsNotInListCompliant.
diagnosticDataBlockSubmission Booleano Indica si se va a bloquear el envío de datos de diagnóstico.
locationServicesBlocked Booleano Indica si se van a bloquear los servicios de ubicación.
googleAccountBlockAutoSync Booleano Indica si se va a bloquear la sincronización automática de cuentas de Google.
googlePlayStoreBlocked Booleano Indica si se va a bloquear la aplicación Google Play Store.
kioskModeBlockSleepButton Booleano Indica si se va a bloquear el botón de suspensión de pantalla durante el modo de pantalla completa.
kioskModeBlockVolumeButtons Booleano Indica si se van a bloquear los botones de volumen durante el modo de pantalla completa.
kioskModeApps Colección appListItem Lista de aplicaciones que se podrán ejecutar cuando el dispositivo esté en modo de pantalla completa. Esta colección puede contener un máximo de 500 elementos.
nfcBlocked Booleano Indica si se va a bloquear la transmisión de datos en proximidad.
passwordBlockFingerprintUnlock Booleano Indica si se va a impedir el desbloqueo por huella digital.
passwordBlockTrustAgents Booleano Indica si se van a bloquear Smart Lock y otros agentes de confianza.
passwordExpirationDays Int32 Número de días antes de que expire la contraseña. Valores válidos de 1 a 365.
passwordMinimumLength Int32 Longitud mínima de las contraseñas. Valores válidos de 4 a 16
passwordMinutesOfInactivityBeforeScreenTimeout Int32 Minutos de inactividad antes de que se agote el tiempo de espera de la pantalla.
passwordPreviousPasswordBlockCount Int32 Número de contraseñas anteriores que bloquear. Valores válidos de 0 a 24.
passwordSignInFailureCountBeforeFactoryReset Int32 Número de errores de inicio de sesión permitidos antes del restablecimiento de fábrica. Valores válidos de 1 a 16
passwordRequiredType androidRequiredPasswordType Tipo de contraseña que es necesario. Los valores posibles son: deviceDefault, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, numeric, numericComplex y any.
passwordRequired Booleano Indica si se va a requerir una contraseña.
powerOffBlocked Booleano Indica si se va a bloquear el apagado del dispositivo.
factoryResetBlocked Booleano Indica si se va a impedir que el usuario realice un restablecimiento de fábrica.
screenCaptureBlocked Booleano Indica si se van a impedir las capturas de pantalla.
deviceSharingAllowed Booleano Indica si se va a permitir el modo de uso compartido del dispositivo.
storageBlockGoogleBackup Booleano Indica si se va a bloquear Google Backup.
storageBlockRemovableStorage Booleano Indica si se va a bloquear el uso de almacenamiento extraíble.
storageRequireDeviceEncryption Booleano Indica si se va a requerir cifrado del dispositivo.
storageRequireRemovableStorageEncryption Booleano Indica si se va a requerir cifrado del almacenamiento extraíble.
voiceAssistantBlocked Booleano Indica si se va a bloquear el uso del asistente de voz.
voiceDialingBlocked Booleano Indica si se va a bloquear la marcación por voz.
webBrowserBlockPopups Booleano Indica si se van a bloquear los elementos emergentes en el explorador web.
webBrowserBlockAutofill Booleano Indica si se va a bloquear la característica de autorrellenado del explorador web.
webBrowserBlockJavaScript Booleano Indica si se va a bloquear JavaScript en el explorador web.
webBrowserBlocked Booleano Indica si se va a bloquear el explorador web.
webBrowserCookieSettings webBrowserCookieSettings Configuración de cookies en el explorador web. Los valores posibles son: browserDefault, blockAlways, allowCurrentWebSite, allowFromWebsitesVisited y allowAlways.
wiFiBlocked Booleano Indica si se va a bloquear la sincronización de Wi-Fi.
appsInstallAllowList Colección appListItem Lista de aplicaciones que se pueden instalar en el dispositivo KNOX. Esta colección puede contener un máximo de 500 elementos.
appsLaunchBlockList Colección appListItem Lista de aplicaciones cuyo inicio en el dispositivo KNOX está bloqueado. Esta colección puede contener un máximo de 500 elementos.
appsHideList Colección appListItem Lista de aplicaciones que se ocultarán en el dispositivo KNOX. Esta colección puede contener un máximo de 500 elementos.
securityRequireVerifyApps Booleano Requerir que la característica Verificar aplicaciones de Android esté activada.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 201 Created y un objeto androidGeneralDeviceConfiguration en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

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
}

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 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
}