Mettre à jour windowsDeliveryOptimizationConfiguration

Espace de noms: microsoft.graph

Important: Les API Microsoft Graph sous la version /beta sont susceptibles d’être modifiées ; l’utilisation de production n’est pas prise en charge.

Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.

Mettez à jour les propriétés d’un objet windowsDeliveryOptimizationConfiguration .

Cette API est disponible dans les déploiements de cloud national suivants.

Service global	Gouvernement des États-Unis L4	Us Government L5 (DOD)	Chine gérée par 21Vianet
✅	✅	✅	✅

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation	Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire)	DeviceManagementConfiguration.ReadWrite.All
Déléguée (compte Microsoft personnel)	Non prise en charge.
Application	DeviceManagementConfiguration.ReadWrite.All

Requête HTTP

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/groupAssignments/{deviceConfigurationGroupAssignmentId}/deviceConfiguration
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations/{deviceConfigurationId}

En-têtes de demande

En-tête	Valeur
Autorisation	Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Accepter	application/json

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON pour l’objet windowsDeliveryOptimizationConfiguration .

Le tableau suivant indique les propriétés requises lorsque vous créez windowsDeliveryOptimizationConfiguration.

Propriété	Type	Description
id	String	Clé de l’entité. Hérité de deviceConfiguration.
lastModifiedDateTime	DateTimeOffset	Date et heure de dernière modification de l’objet. Hérité de deviceConfiguration.
roleScopeTagIds	String collection	Liste des balises d’étendue pour cette instance d’entité. Hérité de deviceConfiguration.
supportsScopeTags	Valeur booléenne	Indique si la configuration d’appareil sous-jacente prend en charge l’attribution des balises d’étendue. L’attribution à la propriété ScopeTags n’est pas autorisée lorsque cette valeur est false et que les entités ne sont pas visibles par les utilisateurs délimités. Cela se produit pour les stratégies héritées créées dans Silverlight et peut être résolu en supprimant et en recréant la stratégie dans le portail Azure. Cette propriété est en lecture seule. Hérité de deviceConfiguration.
deviceManagementApplicabilityRuleOsEdition	deviceManagementApplicabilityRuleOsEdition	Applicabilité de l’édition du système d’exploitation pour cette stratégie. Hérité de deviceConfiguration.
deviceManagementApplicabilityRuleOsVersion	deviceManagementApplicabilityRuleOsVersion	Règle d’applicabilité de la version du système d’exploitation pour cette stratégie. Hérité de deviceConfiguration.
deviceManagementApplicabilityRuleDeviceMode	deviceManagementApplicabilityRuleDeviceMode	Règle d’applicabilité du mode appareil pour cette stratégie. Hérité de deviceConfiguration.
createdDateTime	DateTimeOffset	Date et heure de création de l’objet. Hérité de deviceConfiguration.
description	String	Description de la configuration de l’appareil fournie par l’administrateur. Hérité de deviceConfiguration.
displayName	String	Nom de la configuration de l’appareil fourni par l’administrateur. Hérité de deviceConfiguration.
version	Int32	Version de la configuration de l’appareil. Hérité de deviceConfiguration.
deliveryOptimizationMode	windowsDeliveryOptimizationMode	Spécifie la méthode de téléchargement que l’optimisation de la distribution peut utiliser pour gérer la consommation de bande passante réseau dans les scénarios de distribution de contenu volumineux. Les valeurs possibles sont les suivantes : userDefined, httpOnly, httpWithPeeringNat, httpWithPeeringPrivateGroup, httpWithInternetPeering, simpleDownload et bypassMode.
restrictPeerSelectionBy	deliveryOptimizationRestrictPeerSelectionByOptions	Spécifie de restreindre la sélection d’homologues via l’option sélectionnée.
L’option 1 (masque de sous-réseau) s’applique uniquement aux modes d’optimisation de la distribution mode LAN (1) et groupe (2). Les valeurs possibles sont les suivantes : notConfigured, subnetMask.
groupIdSource	deliveryOptimizationGroupIdSource	Spécifie de restreindre la sélection d’homologues à une source spécifique.
Les options définies dans cette stratégie s’appliquent uniquement au mode d’optimisation de la distribution groupe (2) mode de téléchargement. Si Le groupe (2) n’est pas défini en mode de téléchargement, cette stratégie est ignorée. Pour l’option 3 - ID d’option DHCP, le client interroge l’ID d’option DHCP 234 et utilise la valeur GUID retournée comme ID de groupe.
bandwidthMode	deliveryOptimizationBandwidth	Spécifie l’utilisation de la bande passante au premier plan et en arrière-plan à l’aide de pourcentages, d’absolus ou d’heures.
backgroundDownloadFromHttpDelayInSeconds	Int64	Spécifie le nombre de secondes pendant lesquelles une source HTTP est retardée dans un téléchargement en arrière-plan autorisé à utiliser le pair à pair. Valeurs valides 0 à 4294967295
foregroundDownloadFromHttpDelayInSeconds	Int64	Spécifie le nombre de secondes pendant lesquelles une source HTTP est retardée dans un téléchargement au premier plan autorisé à utiliser l’égal à égal (0-86400). Valeurs valides 0 à 86400
La spécification de 0 définit l’optimisation de la distribution pour gérer ce paramètre à l’aide du service cloud. Valeurs valides 0 à 86400
minimumRamAllowedToPeerInGigabytes	Int32	Spécifie la taille minimale de RAM en Go pour utiliser la mise en cache d’homologue (1-100000). Valeurs valides 1 à 100000
minimumDiskSizeAllowedToPeerInGigabytes	Int32	Spécifie la taille de disque minimale en Go pour utiliser la mise en cache d’homologue (1-100000). Valeurs valides 1 à 100000
Valeurs recommandées : 64 Go à 256 Go. Valeurs valides 1 à 100000
minimumFileSizeToCacheInMegabytes	Int32	Spécifie la taille minimale du fichier de contenu en Mo activée pour utiliser la mise en cache d’homologue (1-100000). Valeurs valides 1 à 100000
Valeurs recommandées : 1 Mo à 100 000 Mo. Valeurs valides 1 à 100000
minimumBatteryPercentageAllowedToUpload	Int32	Spécifie le pourcentage de batterie minimal pour permettre à l’appareil de charger des données (0-100). Valeurs valides comprises entre 0 et 100
La valeur par défaut est 0. La valeur 0 (zéro) signifie « non limité » et la valeur par défaut du service cloud sera utilisée. Valeurs valides comprises entre 0 et 100
modifyCacheLocation	Chaîne	Spécifie le lecteur que l’optimisation de la distribution doit utiliser pour son cache.
maximumCacheAgeInDays	Int32	Spécifie la durée maximale en jours pendant laquelle chaque fichier est conservé dans le cache d’optimisation de la distribution après le téléchargement réussi (0-3650). Valeurs valides 0 à 3650
maximumCacheSize	deliveryOptimizationMaxCacheSize	Spécifie la taille de cache maximale que l’optimisation de la distribution soit sous forme de pourcentage, soit en Go.
vpnPeerCaching	Enablement	Spécifie si l’appareil est autorisé à participer à la mise en cache d’homologue lorsqu’il est connecté via VPN au réseau de domaine. Les valeurs possibles sont notConfigured, enabled et disabled.
cacheServerHostNames	String collection	Spécifie les noms d’hôte des serveurs de cache.
cacheServerForegroundDownloadFallbackToHttpDelayInSeconds	Int32	Spécifie le nombre de secondes pour retarder un secours des serveurs de cache vers une source HTTP pour un téléchargement au premier plan. Valeurs valides 0 à 2592000.
cacheServerBackgroundDownloadFallbackToHttpDelayInSeconds	Int32	Spécifie le nombre de secondes pour retarder un retour des serveurs de cache vers une source HTTP pour un téléchargement en arrière-plan. Valeurs valides 0 à 2592000.

Réponse

Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet windowsDeliveryOptimizationConfiguration mis à jour dans le corps de la réponse.

Exemple

Demande

Voici un exemple de demande.

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
}

Réponse

Voici un exemple de réponse. Remarque : l’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.

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
}