创建 windowsDeliveryOptimizationConfiguration

项目
08/01/2024

命名空间：microsoft.graph

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

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

创建新的 windowsDeliveryOptimizationConfiguration 对象。

全局服务	美国政府 L4	美国政府 L5 (DOD)	由世纪互联运营的中国
✅	✅	✅	✅

权限

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

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

HTTP 请求

POST /deviceManagement/deviceConfigurations
POST /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations

请求标头

标头	值
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。

响应

如果成功，此方法在 201 Created 响应正文中返回响应代码和 windowsDeliveryOptimizationConfiguration 对象。

示例

请求

下面是一个请求示例。

POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations
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 201 Created
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 请求

请求标头

请求正文

响应

示例

请求

响应

反馈

其他资源