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 | Boolean | 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 | String | 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
}