Actualizar windowsDeliveryOptimizationConfiguration

Espacio de nombres: microsoft.graph

Importante: Las API de Microsoft Graph en la versión /beta están sujetas a cambios; no se admite el uso de producción.

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

Actualice las propiedades de un objeto windowsDeliveryOptimizationConfiguration .

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

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/groupAssignments/{deviceConfigurationGroupAssignmentId}/deviceConfiguration
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations/{deviceConfigurationId}

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, proporcione una representación JSON para el objeto windowsDeliveryOptimizationConfiguration .

En la tabla siguiente se muestran las propiedades necesarias al crear windowsDeliveryOptimizationConfiguration.

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
roleScopeTagIds	Colección de cadenas	Lista de etiquetas de ámbito para esta instancia de entity. Heredado de deviceConfiguration
supportsScopeTags	Booleano	Indica si la configuración de dispositivo subyacente admite o no la asignación de etiquetas de ámbito. No se permite asignar a la propiedad ScopeTags cuando este valor es false y las entidades no serán visibles para los usuarios con ámbito. Esto ocurre para las directivas heredadas creadas en Silverlight y se pueden resolver mediante la eliminación y la recreación de la directiva en Azure Portal. Esta propiedad es de sólo lectura. Heredado de deviceConfiguration
deviceManagementApplicabilityRuleOsEdition	deviceManagementApplicabilityRuleOsEdition	Aplicabilidad de la edición del sistema operativo para esta directiva. Heredado de deviceConfiguration
deviceManagementApplicabilityRuleOsVersion	deviceManagementApplicabilityRuleOsVersion	Regla de aplicabilidad de la versión del sistema operativo para esta directiva. Heredado de deviceConfiguration
deviceManagementApplicabilityRuleDeviceMode	deviceManagementApplicabilityRuleDeviceMode	Regla de aplicabilidad del modo de dispositivo para esta directiva. 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
deliveryOptimizationMode	windowsDeliveryOptimizationMode	Especifica el método de descarga que puede usar la optimización de entrega para administrar el consumo de ancho de banda de red para escenarios de distribución de contenido de gran tamaño. Valores posibles: userDefined, httpOnly, httpWithPeeringNat, httpWithPeeringPrivateGroup, httpWithInternetPeering, simpleDownload, bypassMode.
restrictPeerSelectionBy	deliveryOptimizationRestrictPeerSelectionByOptions	Especifica que se restrinja la selección del mismo nivel mediante la opción seleccionada.
La opción 1 (máscara de subred) solo se aplica a los modos de optimización de distribución LAN (1) y Grupo (2). Los valores posibles son notConfigured y subnetMask.
groupIdSource	deliveryOptimizationGroupIdSource	Especifica que se restrinja la selección del mismo nivel a un origen specfic.
Las opciones establecidas en esta directiva solo se aplican al modo de descarga grupo de optimización de distribución (2). Si El grupo (2) no está establecido como modo de descarga, se omitirá esta directiva. En el caso de la opción 3: id. de opción DHCP, el cliente consultará el identificador de opción DHCP 234 y usará el valor GUID devuelto como identificador de grupo.
bandwidthMode	deliveryOptimizationBandwidth	Especifica el uso del ancho de banda en primer plano y en segundo plano mediante porcentajes, absolutos o horas.
backgroundDownloadFromHttpDelayInSeconds	Int64	Especifica el número de segundos para retrasar un origen HTTP en una descarga en segundo plano que puede usar punto a punto. Valores válidos de 0 a 4294967295
foregroundDownloadFromHttpDelayInSeconds	Int64	Especifica el número de segundos para retrasar un origen HTTP en una descarga en primer plano que puede usar punto a punto (0-86400). Valores válidos de 0 a 86400
Al especificar 0 se establece la optimización de distribución para administrar esta configuración mediante el servicio en la nube. Valores válidos de 0 a 86400
minimumRamAllowedToPeerInGigabytes	Int32	Especifica el tamaño mínimo de RAM en GB para usar el almacenamiento en caché del mismo nivel (1-100000). Valores válidos de 1 a 100000
minimumDiskSizeAllowedToPeerInGigabytes	Int32	Especifica el tamaño mínimo de disco en GB para usar el almacenamiento en caché del mismo nivel (1-100000). Valores válidos de 1 a 100000
Valores recomendados: de 64 GB a 256 GB. Valores válidos de 1 a 100000
minimumFileSizeToCacheInMegabytes	Int32	Especifica el tamaño mínimo de archivo de contenido en MB habilitado para usar el almacenamiento en caché del mismo nivel (1-100000). Valores válidos de 1 a 100000
Valores recomendados: de 1 MB a 100 000 MB. Valores válidos de 1 a 100000
minimumBatteryPercentageAllowedToUpload	Int32	Especifica el porcentaje mínimo de batería para permitir que el dispositivo cargue datos (0-100). Valores válidos de 0 a 100.
El valor predeterminado es 0. El valor 0 (cero) significa "no limitado" y se usará el valor predeterminado del servicio en la nube. Valores válidos de 0 a 100.
modifyCacheLocation	Cadena	Especifica la unidad que la optimización de distribución debe usar para su memoria caché.
maximumCacheAgeInDays	Int32	Especifica el tiempo máximo en días que cada archivo se mantiene en la caché de optimización de distribución después de la descarga correcta (0-3650). Valores válidos de 0 a 3650
maximumCacheSize	deliveryOptimizationMaxCacheSize	Especifica el tamaño máximo de caché que optimiza la distribución como porcentaje o en GB.
vpnPeerCaching	Habilitación	Especifica si el dispositivo puede participar en el almacenamiento en caché del mismo nivel mientras está conectado a través de VPN a la red de dominio. Los valores posibles son: notConfigured, enabled y disabled.
cacheServerHostNames	Colección string	Especifica los nombres de host de los servidores de caché.
cacheServerForegroundDownloadFallbackToHttpDelayInSeconds	Int32	Especifica el número de segundos para retrasar una devolución de los servidores de caché a un origen HTTP para una descarga en primer plano. Valores válidos de 0 a 2592000.
cacheServerBackgroundDownloadFallbackToHttpDelayInSeconds	Int32	Especifica el número de segundos para retrasar una devolución de los servidores de caché a un origen HTTP para una descarga en segundo plano. Valores válidos de 0 a 2592000.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto windowsDeliveryOptimizationConfiguration actualizado en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 2039

{
  "@odata.type": "#microsoft.graph.windowsDeliveryOptimizationConfiguration",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "windows10EnterpriseN"
    ],
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "Min OSVersion value",
    "maxOSVersion": "Max OSVersion value",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "sModeConfiguration",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "deliveryOptimizationMode": "httpOnly",
  "restrictPeerSelectionBy": "subnetMask",
  "groupIdSource": {
    "@odata.type": "microsoft.graph.deliveryOptimizationGroupIdSource"
  },
  "bandwidthMode": {
    "@odata.type": "microsoft.graph.deliveryOptimizationBandwidth"
  },
  "backgroundDownloadFromHttpDelayInSeconds": 8,
  "foregroundDownloadFromHttpDelayInSeconds": 8,
  "minimumRamAllowedToPeerInGigabytes": 2,
  "minimumDiskSizeAllowedToPeerInGigabytes": 7,
  "minimumFileSizeToCacheInMegabytes": 1,
  "minimumBatteryPercentageAllowedToUpload": 7,
  "modifyCacheLocation": "Modify Cache Location value",
  "maximumCacheAgeInDays": 5,
  "maximumCacheSize": {
    "@odata.type": "microsoft.graph.deliveryOptimizationMaxCacheSize"
  },
  "vpnPeerCaching": "enabled",
  "cacheServerHostNames": [
    "Cache Server Host Names value"
  ],
  "cacheServerForegroundDownloadFallbackToHttpDelayInSeconds": 9,
  "cacheServerBackgroundDownloadFallbackToHttpDelayInSeconds": 9
}

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 200 OK
Content-Type: application/json
Content-Length: 2211

{
  "@odata.type": "#microsoft.graph.windowsDeliveryOptimizationConfiguration",
  "id": "5954ee9b-ee9b-5954-9bee-54599bee5459",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "windows10EnterpriseN"
    ],
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "Min OSVersion value",
    "maxOSVersion": "Max OSVersion value",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "sModeConfiguration",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "deliveryOptimizationMode": "httpOnly",
  "restrictPeerSelectionBy": "subnetMask",
  "groupIdSource": {
    "@odata.type": "microsoft.graph.deliveryOptimizationGroupIdSource"
  },
  "bandwidthMode": {
    "@odata.type": "microsoft.graph.deliveryOptimizationBandwidth"
  },
  "backgroundDownloadFromHttpDelayInSeconds": 8,
  "foregroundDownloadFromHttpDelayInSeconds": 8,
  "minimumRamAllowedToPeerInGigabytes": 2,
  "minimumDiskSizeAllowedToPeerInGigabytes": 7,
  "minimumFileSizeToCacheInMegabytes": 1,
  "minimumBatteryPercentageAllowedToUpload": 7,
  "modifyCacheLocation": "Modify Cache Location value",
  "maximumCacheAgeInDays": 5,
  "maximumCacheSize": {
    "@odata.type": "microsoft.graph.deliveryOptimizationMaxCacheSize"
  },
  "vpnPeerCaching": "enabled",
  "cacheServerHostNames": [
    "Cache Server Host Names value"
  ],
  "cacheServerForegroundDownloadFallbackToHttpDelayInSeconds": 9,
  "cacheServerBackgroundDownloadFallbackToHttpDelayInSeconds": 9
}