Обновление windowsDeliveryOptimizationConfiguration
Пространство имен: microsoft.graph
Важно: API Microsoft Graph в версии /beta могут быть изменены; Использование в рабочей среде не поддерживается.
Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.
Обновите свойства объекта windowsDeliveryOptimizationConfiguration .
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
| Тип разрешения | Разрешения (в порядке повышения привилегий) |
|---|---|
| Делегированные (рабочая или учебная учетная запись) | DeviceManagementConfiguration.ReadWrite.All |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. |
| Приложение | DeviceManagementConfiguration.ReadWrite.All |
HTTP-запрос
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/groupAssignments/{deviceConfigurationGroupAssignmentId}/deviceConfiguration
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations/{deviceConfigurationId}
Заголовки запроса
| Заголовок | Значение |
|---|---|
| Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
| Accept | application/json |
Текст запроса
В тексте запроса укажите представление объекта windowsDeliveryOptimizationConfiguration в формате JSON.
В следующей таблице показаны свойства, необходимые при создании windowsDeliveryOptimizationConfiguration.
| Свойство | Тип | Описание |
|---|---|---|
| id | String | Ключ объекта. Наследуется от объекта deviceConfiguration. |
| lastModifiedDateTime | DateTimeOffset | Дата и время последнего изменения объекта. Наследуется от объекта deviceConfiguration. |
| roleScopeTagIds | Коллекция строк | Список тегов области для этого экземпляра сущности. Наследуется от объекта deviceConfiguration. |
| supportsScopeTags | Логический | Указывает, поддерживает ли базовая конфигурация устройства назначение тегов область. Назначение свойству ScopeTags не допускается, если это значение равно false, а сущности не будут видны пользователям с областью действия. Это происходит для устаревших политик, созданных в Silverlight, и его можно устранить путем удаления и повторного создания политики на портале Azure. Это свойство доступно только для чтения. Наследуется от объекта deviceConfiguration. |
| deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | Применимость выпуска ОС для этой политики. Наследуется от объекта deviceConfiguration. |
| deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | Правило применимости версий ОС для этой политики. Наследуется от объекта 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 клиент запрашивает параметр DHCP с идентификатором 234 и использует возвращенное значение GUID в качестве идентификатора группы. | ||
| bandwidthMode | deliveryOptimizationBandwidth | Указывает использование полосы пропускания переднего плана и фона с использованием процентных значений, абсолютов или часов. |
| backgroundDownloadFromHttpDelayInSeconds | Int64 | Указывает время в секундах для задержки источника HTTP в фоновом режиме загрузки, для использования однорангового узла. Допустимые значения от 0 до 4294967295 |
| foregroundDownloadFromHttpDelayInSeconds | Int64 | Указывает время в секундах для задержки источника HTTP в загрузке переднего плана, который может использовать одноранговый узел (0–86400). Допустимые значения от 0 до 86400 |
| Если указать значение 0, для управления этим параметром с помощью облачной службы будет настроена оптимизация доставки. Допустимые значения от 0 до 86400 | ||
| minimumRamAllowedToPeerInGigabytes | Int32 | Указывает минимальный размер ОЗУ в ГБ для использования однорангового кэширования (1–10 0000). Допустимые значения от 1 до 100000 |
| minimumDiskSizeAllowedToPeerInGigabytes | Int32 | Указывает минимальный размер диска в ГБ для использования однорангового кэширования (1–10 0000). Допустимые значения от 1 до 100000 |
| Рекомендуемые значения: от 64 ДО 256 ГБ. Допустимые значения от 1 до 100000 | ||
| minimumFileSizeToCacheInMegabytes | Int32 | Указывает минимальный размер файла содержимого в МБ, включенный для использования однорангового кэширования (1–10 0000). Допустимые значения от 1 до 100000 |
| Рекомендуемые значения: от 1 ДО 100 000 МБ. Допустимые значения от 1 до 100000 | ||
| minimumBatteryPercentageAllowedToUpload | Int32 | Указывает минимальный процент заряда батареи, позволяющий устройству передавать данные (0–100). Допустимые значения: от 0 до 100 |
| Значение по умолчанию равно 0. Значение 0 (ноль) означает "не ограничено" и будет использоваться значение по умолчанию облачной службы. Допустимые значения: от 0 до 100 | ||
| modifyCacheLocation | String | Указывает диск, который оптимизация доставки должна использовать для своего кэша. |
| maximumCacheAgeInDays | Int32 | Указывает максимальное время в днях, в течение которых каждый файл хранится в кэше оптимизации доставки после успешного скачивания (0–3650). Допустимые значения от 0 до 3650 |
| maximumCacheSize | deliveryOptimizationMaxCacheSize | Указывает максимальный размер кэша для оптимизации доставки в процентах или в ГБ. |
| 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 Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по