更新 windowsDeliveryOptimizationConfiguration
命名空间：microsoft.graph
重要： /beta 版本下的 Microsoft Graph API 可能会更改;不支持生产使用。
注意：适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。
更新 windowsDeliveryOptimizationConfiguration 对象的属性。
此 API 可用于以下国家级云部署。
| 全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
权限
要调用此 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 | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
| 接受 | application/json |
请求正文
在请求正文中，提供 windowsDeliveryOptimizationConfiguration 对象的 JSON 表示形式。
下表显示了创建 windowsDeliveryOptimizationConfiguration 时所需的属性。
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 实体的键。 继承自 deviceConfiguration |
| lastModifiedDateTime | DateTimeOffset | 上次修改对象的日期/时间。 继承自 deviceConfiguration |
| roleScopeTagIds | 字符串集合 | 此实体实例的范围标记列表。 继承自 deviceConfiguration |
| supportsScopeTags | 布尔值 | 指示基础设备配置是否支持分配范围标记。 如果此值为 false，并且实体对限定范围的用户不可见，则不允许向 ScopeTags 属性分配。 这发生在 Silverlight 中创建的旧策略，可以通过在 Azure 门户中删除并重新创建策略来解决。 此属性是只读的。 继承自 deviceConfiguration |
| deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | 此策略的 OS 版本适用性。 继承自 deviceConfiguration |
| deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | 此策略的 OS 版本适用性规则。 继承自 deviceConfiguration |
| deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | 此策略的设备模式适用性规则。 继承自 deviceConfiguration |
| createdDateTime | DateTimeOffset | 创建对象的日期/时间。 继承自 deviceConfiguration |
| description | 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 | ||
| minimumRamAllowedToPeerInGigabytes | Int32 | 指定使用对等缓存的最小 RAM 大小（以 GB 为单位） (1-100000) 。 有效值 1 到 100000 |
| minimumDiskSizeAllowedToPeerInGigabytes | Int32 | 指定使用对等缓存的最小磁盘大小（以 GB 为单位 (1-100000) ）。 有效值 1 到 100000 |
| 建议的值：64 GB 到 256 GB。 有效值 1 到 100000 | ||
| minimumFileSizeToCacheInMegabytes | Int32 | 指定允许使用对等缓存的最小内容文件大小（以 MB 为单位） (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 | 支持 | 指定是否允许设备在通过 VPN 连接到域网络时参与对等缓存。 可取值为：notConfigured、enabled、disabled。 |
| cacheServerHostNames | 字符串集合 | 指定缓存服务器的主机名。 |
| 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
}
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈