MicrosoftTunnelSite erstellen
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 microsoftTunnelSite-Objekt .
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
POST /deviceManagement/microsoftTunnelSites
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 objekt microsoftTunnelSite an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von microsoftTunnelSite erforderlich sind.
Eigenschaft | Typ | Beschreibung |
---|---|---|
id | Zeichenfolge | Der eindeutige Bezeichner für die Standort-ID. $Insert, $skip $top wird nicht unterstützt. Schreibgeschützt. |
displayName | Zeichenfolge | Der Anzeigename für die Website. Diese Eigenschaft ist erforderlich, wenn eine Website erstellt wird. |
description | Zeichenfolge | Beschreibung der Website (optional) |
publicAddress | Zeichenfolge | Der öffentliche Domänenname oder die IP-Adresse des Standorts |
upgradeWindowUtcOffsetInMinutes | Int32 | Die Zeitzone der Website, die als Minutenoffset von UTC dargestellt wird |
upgradeWindowStartTime | TimeOfDay | Startzeit des Upgradefensters der Website |
upgradeWindowEndTime | TimeOfDay | Endzeit des Upgradefensters der Website |
upgradeAutomatisch | Boolesch | Die Einstellung für automatisches Upgrade der Website. True für automatische Upgrades, false für manuelle Steuerung |
upgradeAvailable | Boolesch | Der Standort gibt den Status an, zu dem ein Upgrade verfügbar ist. |
internalNetworkProbeUrl | Zeichenfolge | Die URL des internen Netzwerkzugriffstests der Website |
roleScopeTagIds | String collection | Liste der Bereichstags für diese Entitätsinstanz |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 201 Created
Antwortcode und ein microsoftTunnelSite-Objekt im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
POST https://graph.microsoft.com/beta/deviceManagement/microsoftTunnelSites
Content-type: application/json
Content-length: 524
{
"@odata.type": "#microsoft.graph.microsoftTunnelSite",
"displayName": "Display Name value",
"description": "Description value",
"publicAddress": "Public Address value",
"upgradeWindowUtcOffsetInMinutes": 15,
"upgradeWindowStartTime": "12:01:27.3030000",
"upgradeWindowEndTime": "11:57:17.9830000",
"upgradeAutomatically": true,
"upgradeAvailable": true,
"internalNetworkProbeUrl": "https://example.com/internalNetworkProbeUrl/",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
]
}
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: 573
{
"@odata.type": "#microsoft.graph.microsoftTunnelSite",
"id": "b2f7dc3e-dc3e-b2f7-3edc-f7b23edcf7b2",
"displayName": "Display Name value",
"description": "Description value",
"publicAddress": "Public Address value",
"upgradeWindowUtcOffsetInMinutes": 15,
"upgradeWindowStartTime": "12:01:27.3030000",
"upgradeWindowEndTime": "11:57:17.9830000",
"upgradeAutomatically": true,
"upgradeAvailable": true,
"internalNetworkProbeUrl": "https://example.com/internalNetworkProbeUrl/",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
]
}