WindowsDeliveryOptimizationConfiguration を作成する

名前空間: microsoft.graph

重要:Microsoft は Intune /beta API をサポートしていますが、より頻繁に変更される可能性があります。 可能な場合は、バージョン v1.0 を使用することをお勧めします。 バージョン セレクターを使用して、バージョン v1.0 で API が使用できるかどうかを確認します。

注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。

新しい WindowsDeliveryOptimizationConfiguration オブジェクトを作成します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この 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 オブジェクトの最終更新の DateTime。 deviceConfiguration から継承します
roleScopeTagIds String collection このエンティティ インスタンスのスコープ タグの一覧。 deviceConfiguration から継承します
supportsScopeTags ブール型 基になるデバイス構成がスコープ タグの割り当てをサポートしているかどうかを示します。 この値が false の場合、ScopeTags プロパティへの割り当ては許可されず、スコープを指定されたユーザーにエンティティが表示されません。 これは、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 配信の最適化が大規模なコンテンツ配信シナリオでのネットワーク帯域幅の使用量を管理するために使用できるダウンロードの方法を指定します。 可能な値は、userDefinedhttpOnlyhttpWithPeeringNathttpWithPeeringPrivateGrouphttpWithInternetPeeringsimpleDownloadbypassMode です。
restrictPeerSelectionBy deliveryOptimizationRestrictPeerSelectionByOptions 選択したオプションを使用してピアの選択を制限することを指定します。
オプション 1 (サブネット マスク) は、配信の最適化モードのダウンロード モード、LAN (1)、およびグループ (2) にのみ適用されます。 可能な値は、notConfiguredsubnetMask です。
groupIdSource deliveryOptimizationGroupIdSource ピア選択を特定のソースに制限することを指定します。
このポリシーで設定するオプションは、配信の最適化モードのグループ (2) ダウンロード モードにのみ適用されます。 グループ (2) がダウンロード モードとして設定されていない場合、このポリシーは無視されます。 オプション 3 - DHCP オプション ID の場合、クライアントは DHCP オプション ID 234 を照会し、返された GUID 値をグループ ID として使用します。
bandwidthMode deliveryOptimizationBandwidth パーセンテージ、絶対値、または時間を使用して、フォアグラウンドとバックグラウンドの帯域幅の使用量を指定します。
backgroundDownloadFromHttpDelayInSeconds Int64 ピアツーピアの使用が許可されているバックグラウンド ダウンロードで HTTP ソースを遅延させる秒数を指定します。 有効な値 0 から 4294967295
foregroundDownloadFromHttpDelayInSeconds Int64 ピアツーピアの使用が許可されているフォアグラウンド ダウンロードで HTTP ソースを遅延する秒数を指定します (0-86400)。 有効な値: 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 ピア キャッシュ (1 から 100000) を使用できるようにするコンテンツ ファイルの最小サイズを MB 単位で指定します。 有効な値: 1 - 100000
推奨値: 1 MB から 100,000 MB。 有効な値: 1 - 100000
minimumBatteryPercentageAllowedToUpload Int32 デバイスがデータをアップロードできるようにするための最小バッテリー使用率を指定します (0 - 100)。 有効な値は 0 から 100 までです
既定値は 0 です。 値 0 (ゼロ) は "制限されていない" ことを意味し、クラウド サービスの既定値が使用されます。 有効な値は 0 から 100 までです
modifyCacheLocation 文字列 配信の最適化がキャッシュに使用するドライブを指定します。
maximumCacheAgeInDays Int32 各ファイルが正常にダウンロードされた後、各ファイルが配信の最適化キャッシュに保持される最大時間の日数を指定します (0 から 3650)。 有効な値: 0 から 3650
maximumCacheSize deliveryOptimizationMaxCacheSize 配信の最適化による最大キャッシュ サイズをパーセンテージまたは GB 単位で指定します。
vpnPeerCaching 有効化 VPN 経由でドメイン ネットワークに接続されているときに、デバイスがピア キャッシュに参加することを許可するかどうかを指定します。 可能な値は notConfiguredenableddisabled です。
cacheServerHostNames String collection キャッシュ サーバーのホスト名を指定します。
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
}