Mettre à jour microsoftTunnelConfiguration

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 microsoftTunnelConfiguration .

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/microsoftTunnelConfigurations/{microsoftTunnelConfigurationId}
PATCH /deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelConfiguration

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 microsoftTunnelConfiguration .

Le tableau suivant présente les propriétés requises lorsque vous créez microsoftTunnelConfiguration.

Propriété	Type	Description
id	Chaîne	Identificateur unique de l’ID de configuration. Prend en charge : $delete, $update. $Insert, $skip, $top n’est pas pris en charge. En lecture seule.
displayName	Chaîne	Nom complet de la configuration du serveur. Cette propriété est requise lors de la création d’un serveur.
description	Chaîne	Description de la configuration (facultatif)
réseau	Chaîne	Sous-réseau IPv4 qui sera utilisé pour allouer l’adresse virtuelle pour les clients
ipv6Network	Chaîne	Sous-réseau IPv6 qui sera utilisé pour allouer l’adresse virtuelle des clients
dnsServers	String collection	Serveurs DNS qui seront utilisés par les clients
defaultDomainSuffix	Chaîne	Annexe domaine par défaut qui sera utilisée par les clients
routesInclude	String collection	Itinéraires qui seront routés par le serveur. Cette propriété va être dépréciée avec l’option d’utilisation de la nouvelle propriété« RouteIncludes ».
routesExclude	Collection de chaînes	Sous-ensembles des itinéraires qui ne seront pas routés par le serveur. Cette propriété va être déconseillée avec l’option d’utilisation de la nouvelle propriété « RouteExcludes ».
routeIncludes	Collection de chaînes	Itinéraires qui seront routés par le serveur
routeExcludes	Collection de chaînes	Sous-ensembles des itinéraires qui ne seront pas routés par le serveur
splitDNS	Collection de chaînes	Domaines qui seront résolus à l’aide des serveurs DNS fournis
listenPort	Int32	Port que TCP et UPD écoutent sur le serveur
advancedSettings	Collection keyValuePair	Paramètres supplémentaires pouvant être appliqués au serveur
lastUpdateDateTime	DateTimeOffset	Quand la configuration a été mise à jour pour la dernière fois
roleScopeTagIds	String collection	Liste des balises d’étendue pour cette instance d’entité
disableUdpConnections	Valeur booléenne	Lorsque DisableUdpConnections est défini, les clients et le serveur VPN n’utilisent pas de connexions DTLS pour transférer des données.

Réponse

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

Exemple

Demande

Voici un exemple de demande.

PATCH https://graph.microsoft.com/beta/deviceManagement/microsoftTunnelConfigurations/{microsoftTunnelConfigurationId}
Content-type: application/json
Content-length: 933

{
  "@odata.type": "#microsoft.graph.microsoftTunnelConfiguration",
  "displayName": "Display Name value",
  "description": "Description value",
  "network": "Network value",
  "ipv6Network": "Ipv6Network value",
  "dnsServers": [
    "Dns Servers value"
  ],
  "defaultDomainSuffix": "Default Domain Suffix value",
  "routesInclude": [
    "Routes Include value"
  ],
  "routesExclude": [
    "Routes Exclude value"
  ],
  "routeIncludes": [
    "Route Includes value"
  ],
  "routeExcludes": [
    "Route Excludes value"
  ],
  "splitDNS": [
    "Split DNS value"
  ],
  "listenPort": 10,
  "advancedSettings": [
    {
      "@odata.type": "microsoft.graph.keyValuePair",
      "name": "Name value",
      "value": "Value value"
    }
  ],
  "lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "disableUdpConnections": true
}

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: 982

{
  "@odata.type": "#microsoft.graph.microsoftTunnelConfiguration",
  "id": "b8bdb469-b469-b8bd-69b4-bdb869b4bdb8",
  "displayName": "Display Name value",
  "description": "Description value",
  "network": "Network value",
  "ipv6Network": "Ipv6Network value",
  "dnsServers": [
    "Dns Servers value"
  ],
  "defaultDomainSuffix": "Default Domain Suffix value",
  "routesInclude": [
    "Routes Include value"
  ],
  "routesExclude": [
    "Routes Exclude value"
  ],
  "routeIncludes": [
    "Route Includes value"
  ],
  "routeExcludes": [
    "Route Excludes value"
  ],
  "splitDNS": [
    "Split DNS value"
  ],
  "listenPort": 10,
  "advancedSettings": [
    {
      "@odata.type": "microsoft.graph.keyValuePair",
      "name": "Name value",
      "value": "Value value"
    }
  ],
  "lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "disableUdpConnections": true
}