WindowsDeliveryOptimizationConfiguration を更新する
名前空間: microsoft.graph
大事な: /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。
注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。
windowsDeliveryOptimizationConfiguration オブジェクトのプロパティを更新します。
この API は、次の国内クラウド展開で使用できます。
グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
アクセス許可
この 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 | オブジェクトの最終更新の DateTime。 deviceConfiguration から継承します |
roleScopeTagIds | String collection | このエンティティ インスタンスのスコープ タグの一覧。 deviceConfiguration から継承します |
supportsScopeTags | ブール型 | 基になるデバイス構成がスコープ タグの割り当てをサポートするかどうかを示します。 ScopeTags プロパティへの割り当ては、この値が false であり、スコープ付きユーザーにエンティティが表示されない場合は許可されません。 これは Silverlight で作成されたレガシ ポリシーに対して発生し、Azure Portal でポリシーを削除して再作成することで解決できます。 このプロパティは読み取り専用です。 deviceConfiguration から継承します |
deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | このポリシーの OS エディションの適用性。 deviceConfiguration から継承します |
deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | このポリシーの OS バージョンの適用規則。 deviceConfiguration から継承します |
deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | このポリシーのデバイス モードの適用規則。 deviceConfiguration から継承します |
createdDateTime | DateTimeOffset | オブジェクトが作成された DateTime。 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 | ピア キャッシュ (1 から 100000) を使用する最小ディスク サイズを GB 単位で指定します。 有効な値 1 ~ 100000 |
推奨値: 64 GB から 256 GB。 有効な値 1 ~ 100000 | ||
minimumFileSizeToCacheInMegabytes | Int32 | ピア キャッシュ (1 から 100000) を使用するために有効な最小コンテンツ ファイル サイズを MB 単位で指定します。 有効な値 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 経由でドメイン ネットワークに接続しているときに、デバイスがピア キャッシュに参加できるかどうかを指定します。 可能な値は 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
}