更新 windowsDeliveryOptimizationConfiguration

项目
09/13/2021

命名空间：microsoft.graph

重要提示： Microsoft Graph /beta 版本下的 API 可能会更改;不支持生产使用。

注意： 适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。

更新 windowsDeliveryOptimizationConfiguration 对象的属性。

先决条件

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	DeviceManagementConfiguration.ReadWrite.All
委派（个人 Microsoft 帐户）	不支持。
应用程序	DeviceManagementConfiguration.ReadWrite.All

HTTP 请求

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

请求标头

标头	值
Authorization	Bearer <token>。必需。
接受	application/json

请求正文

在请求正文中，提供 windowsDeliveryOptimizationConfiguration 对象的 JSON 表示形式。

下表显示创建 windowsDeliveryOptimizationConfiguration 时所需的属性。

属性	类型	说明
id	String	实体的键。继承自 deviceConfiguration
lastModifiedDateTime	DateTimeOffset	上次修改对象的日期/时间。继承自 deviceConfiguration
roleScopeTagIds	String collection	此实体实例的范围标记列表。继承自 deviceConfiguration
supportsScopeTags	Boolean	指示基础设备配置是否支持分配范围标记。当此值为 false 且实体对范围用户不可见时，不允许分配给 ScopeTags 属性。这适用于在 Silverlight 中创建的旧版策略，可通过在 Azure 门户中删除和重新创建策略来解决。此属性是只读的。继承自 deviceConfiguration
deviceManagementApplicabilityRuleOsEdition	deviceManagementApplicabilityRuleOsEdition	此策略的操作系统版本适用性。继承自 deviceConfiguration
deviceManagementApplicabilityRuleOsVersion	deviceManagementApplicabilityRuleOsVersion	此策略的操作系统版本适用性规则。继承自 deviceConfiguration
deviceManagementApplicabilityRuleDeviceMode	deviceManagementApplicabilityRuleDeviceMode	此策略的设备模式适用性规则。继承自 deviceConfiguration
createdDateTime	DateTimeOffset	创建对象的日期/时间。继承自 deviceConfiguration
说明	String	管理员提供的设备配置的说明。继承自 deviceConfiguration
displayName	String	管理员提供的设备配置的名称。继承自 deviceConfiguration
version	Int32	设备配置的版本。继承自 deviceConfiguration
deliveryOptimizationMode	windowsDeliveryOptimizationMode	指定传递优化可用于管理大型内容分发方案的网络带宽消耗的下载方法。可取值为：`userDefined`、`httpOnly`、`httpWithPeeringNat`、`httpWithPeeringPrivateGroup`、`httpWithInternetPeering`、`simpleDownload` 或 `bypassMode`。
restrictPeerSelectionBy	deliveryOptimizationRestrictPeerSelectionByOptions	指定通过所选选项限制对等选择。
选项 1 (子网掩码) 仅适用于传递优化模式下载模式 LAN (1) 和组 (2) 。可取值为：`notConfigured`、`subnetMask`。
groupIdSource	deliveryOptimizationGroupIdSource	指定将对等选择限制到特定源。
此策略中设置的选项仅适用于"传递优化"模式组 (2) 下载模式。如果组 (2) 未设置为下载模式，此策略将被忽略。对于选项 3 - DHCP 选项 ID，客户端将查询 DHCP 选项 ID 234，并使用返回的 GUID 值作为组 ID。
bandwidthMode	deliveryOptimizationBandwidth	使用百分比、绝对值或小时指定前台和后台带宽使用量。
backgroundDownloadFromHttpDelayInSeconds	Int64	指定在后台下载中延迟允许使用对等的 HTTP 源的秒数。有效值为 0 到 4294967295
foregroundDownloadFromHttpDelayInSeconds	Int64	指定延迟前台下载中允许使用对等 (0-86400 的 HTTP 源的) 。有效值为 0 到 86400
指定 0 将设置传递优化以使用云服务管理此设置。有效值为 0 到 86400
minimumRamAllowedToPeerInGtesbytes	Int32	指定使用 1-100000 Caching (1-100000 时的最小 RAM) 。有效值为 1 到 100000
minimumDiskSizeAllowedToPeerInGtesbytes	Int32	指定使用对等模式的最小磁盘大小（以 GB 为单位Caching (1-100000) 。有效值为 1 到 100000
建议的值：64 GB 到 256 GB。有效值为 1 到 100000
minimumFileSizeToCacheInMegabytes	Int32	指定启用最小内容文件大小（以 MB 为单位）以使用 1-100000 Caching (1-100000) 。有效值为 1 到 100000
建议的值：1 MB 到 100，000 MB。有效值为 1 到 100000
minimumBatteryPercentageAllowedToUpload	Int32	指定允许设备将数据上载到 0-100 (的最小电池百) 。有效值为 0 至 100
默认值为 0。值 0 (零) 表示"没有限制"，将使用云服务默认值。有效值为 0 至 100
modifyCacheLocation	String	指定传递优化应该用于其缓存的驱动器。
maximumCacheAgeInDays	Int32	指定在 0-3650 (下载成功后每个文件在传递优化缓存中保存的最大) 。有效值为 0 到 3650
maximumCacheSize	deliveryOptimizationMaxCacheSize	以百分比或 GB 为单位指定传递优化的最大缓存大小。
vpnPeerCaching	enablement	指定在通过 VPN 连接到域网络Caching是否允许设备参与对等连接。可取值为：`notConfigured`、`enabled`、`disabled`。
cacheServerHostNames	String collection	指定缓存服务器主机名。
cacheServerForegroundDownloadFallbackToHttpDelayInSeconds	Int32	指定延迟从缓存服务器回退到 HTTP 源以用于前台下载的秒数。有效值为 0 到 2592000。
cacheServerBackgroundDownloadFallbackToHttpDelayInSeconds	Int32	指定延迟从缓存服务器回退到 HTTP 源进行后台下载的秒数。有效值为 0 到 2592000。

响应

如果成功，此方法在响应正文中返回响应代码和更新的 200 OK windowsDeliveryOptimizationConfiguration 对象。

示例

请求

下面是一个请求示例。

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
}

响应

下面是一个响应示例。注意：为了简单起见，可能会将此处所示的响应对象截断。将从实际调用中返回所有属性。

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
}

更新 windowsDeliveryOptimizationConfiguration

先决条件

HTTP 请求

请求标头

请求正文

响应

示例

请求

响应

反馈