Freigeben über

Erstellen von microsoftTunnelServer

  • Artikel

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.

Erstellen Sie ein neues microsoftTunnelServer-Objekt .

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

Weltweiter Service 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

POST /deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelServers

Anforderungsheader

Kopfzeile Wert
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über 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 String 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 String 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 String 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 String 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

Bei erfolgreicher Ausführung gibt die Methode einen 201 Created Antwortcode und ein microsoftTunnelServer-Objekt im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

POST https://graph.microsoft.com/beta/deviceManagement/microsoftTunnelSites/{microsoftTunnelSiteId}/microsoftTunnelServers
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 201 Created
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"
}