MicrosoftTunnelServer aktualisieren

Namespace: microsoft.graph

Wichtig: Microsoft Graph-APIs unter der /beta-Version können sich ändern. Die Verwendung in der Produktion wird nicht unterstützt.

Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.

Aktualisieren sie die Eigenschaften eines microsoftTunnelServer-Objekts .

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst	US Government L4	US Government L5 (DOD)	China, betrieben von 21Vianet
✅	✅	✅	❌

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	DeviceManagementConfiguration.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	DeviceManagementConfiguration.ReadWrite.All

HTTP-Anforderung

PATCH /deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelServers/{microsoftTunnelServerId}

Anforderungsheader

Kopfzeile	Wert
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Annehmen	application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung für das microsoftTunnelServer-Objekt an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von microsoftTunnelServer erforderlich sind.

Eigenschaft	Typ	Beschreibung
id	Zeichenfolge	Der eindeutige Bezeichner für den verwalteten Server. Diese ID wird zum Zeitpunkt der Registrierung zugewiesen. Unterstützt: $filter, $select, $top, $skip, $orderby. $search wird nicht unterstützt. Schreibgeschützt.
displayName	Zeichenfolge	Der Anzeigename des Servers. Er ist identisch mit dem Hostnamen während der Registrierung und kann später geändert werden. Unterstützt: $filter, $select, $top, $skip, $orderby. $search wird nicht unterstützt. Die maximal zulässige Länge beträgt 200 Zeichen.
tunnelServerHealthStatus	microsoftTunnelServerHealthStatus	Gibt den Integritätsstatus des Servers zum Zeitpunkt der letzten Auswertung an. Die Integrität wird alle 60 Sekunden ausgewertet, und die möglichen Werte sind: unknown, healthy, unhealthy, warning, offline, upgradeInProgress, upgradeFailed. Unterstützt: $filter, $select, $top, $skip, $orderby. $search wird nicht unterstützt. Schreibgeschützt. Mögliche Werte: unknown, healthy, unhealthy, warning, offline, upgradeInProgress, upgradeFailed, unknownFutureValue.
lastCheckinDateTime	DateTimeOffset	Gibt an, wann der Server zuletzt eingecheckt wurde. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'. Unterstützt: $filter, $select, $top, $skip, $orderby. $search wird nicht schreibgeschützt unterstützt.
agentImageDigest	Zeichenfolge	Der Digest des aktuellen Agent-Images, das auf diesem Server ausgeführt wird. Unterstützt: $filter, $select, $top, $skip, $orderby. $search wird nicht unterstützt. Schreibgeschützt.
serverImageDigest	Zeichenfolge	Der Digest des aktuellen Serverimages, das auf diesem Server ausgeführt wird. Unterstützt: $filter, $select, $top, $skip, $orderby. $search wird nicht unterstützt. Schreibgeschützt.
deploymentMode	microsoftTunnelDeploymentMode	Microsoft Tunnel-Serverbereitstellungsmodus. Der Wert wird festgelegt, wenn der Server registriert wird. Mögliche Werte sind standaloneRootful, standaloneRootless, podRootful und podRootless. Standardwert: standaloneRootful. Unterstützt: $filter, $select, $top, $skip, $orderby. $search wird nicht unterstützt. Schreibgeschützt. Mögliche Werte: standaloneRootful, standaloneRootless, podRootful, podRootless, unknownFutureValue.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 200 OK Antwortcode und ein aktualisiertes microsoftTunnelServer-Objekt im Antworttext zurückgegeben.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

PATCH https://graph.microsoft.com/beta/deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelServers/{microsoftTunnelServerId}
Content-type: application/json
Content-length: 355

{
  "@odata.type": "#microsoft.graph.microsoftTunnelServer",
  "displayName": "Display Name value",
  "tunnelServerHealthStatus": "healthy",
  "lastCheckinDateTime": "2017-01-01T00:02:46.0431416-08:00",
  "agentImageDigest": "Agent Image Digest value",
  "serverImageDigest": "Server Image Digest value",
  "deploymentMode": "standaloneRootless"
}

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 404

{
  "@odata.type": "#microsoft.graph.microsoftTunnelServer",
  "id": "b5cf0aee-0aee-b5cf-ee0a-cfb5ee0acfb5",
  "displayName": "Display Name value",
  "tunnelServerHealthStatus": "healthy",
  "lastCheckinDateTime": "2017-01-01T00:02:46.0431416-08:00",
  "agentImageDigest": "Agent Image Digest value",
  "serverImageDigest": "Server Image Digest value",
  "deploymentMode": "standaloneRootless"
}