Verbindungsressourcentyp

Namespace: microsoft.graph.networkaccess

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

In Global Secure Access (GSA) stellt eine Verbindung mehrere networkAccessTraffic dar, die eine einzige Verbindungs-ID verwenden. Enthält Informationen zu Netzwerkverbindungen, einschließlich Quell- und Zieldetails, Datenverkehrsstatistiken und Status der Verbindung.

Methoden

Methode Rückgabetyp Beschreibung
List Microsoft.Graph.NetworkAccess.Connection Collection Rufen Sie eine Liste der Verbindungsobjekte und deren Eigenschaften ab.
Get Microsoft.Graph.NetworkAccess.Connection Lesen Sie die Eigenschaften und Beziehungen eines Verbindungsobjekts.

Eigenschaften

Eigenschaft Typ Beschreibung
agentVersion Zeichenfolge Die Version des Clients, der die Verbindung initiiert hat.
applicationSnapshot microsoft.graph.networkaccess.applicationSnapshot appId (oder Client-ID) der Microsoft Entra-Zielanwendung.
createdDateTime DateTimeOffset Der Zeitpunkt, zu dem die Verbindung hergestellt wurde.
crossTenantAccessType microsoft.graph.networkaccess.crossTenantAccessType Mandantenübergreifende Zugriffsdetails für B2B-Szenarien. Die möglichen Werte sind: none, b2bCollaboration, unknownFutureValue.
destinationFqdn Zeichenfolge Der Ziel-FQDN der Verbindung.
destinationIp Zeichenfolge Die Ziel-IP der Verbindung.
destinationPort Int32 Der Zielport der Verbindung.
deviceCategory microsoft.graph.networkaccess.deviceCategory Die Kategorie des Geräts. Mögliche Werte sind: client, branch, unknownFutureValue, remoteNetwork. Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Werte aus dieser entwicklungsfähigen Aufzählung zu erhalten: remoteNetwork.
deviceId Zeichenfolge Die DeviceID.
deviceJoinType microsoft.graph.networkaccess.deviceJoinType Geräteregistrierungstyp für BYOD-Szenarien. Mögliche Werte sind: none, microsoftEntraJoined, microsoftEntraRegistered, unknownFutureValue.
deviceOperatingSystem Zeichenfolge Der Typ des Betriebssystems des Geräts.
deviceOperatingSystemVersion Zeichenfolge Die Version des Betriebssystems des Geräts.
endDateTime DateTimeOffset Der Zeitpunkt, zu dem die Verbindung beendet wurde.
homeTenantId Zeichenfolge Der Bezeichner des Home-Mandanten, für Entra B2B-Szenarien.
id Zeichenfolge Der eindeutige Bezeichner für die Verbindung. Geerbt von microsoft.graph.entity.
initiatingProcessName Zeichenfolge Der Prozess, mit dem die Datenverkehrsverbindung initiiert wird.
lastUpdateDateTime DateTimeOffset Wann die Verbindung zuletzt aktualisiert wurde.
networkProtocol microsoft.graph.networkaccess.networkingProtocol Das Netzwerkprotokoll der Verbindung. Die möglichen Werte sind: ip, icmp, igmp, ggp, ipv4, tcppupudpidpipv6ipv6RoutingHeaderipv6FragmentHeaderipSecEncapsulatingSecurityPayloadipSecAuthenticationHeadericmpV6ipv6NoNextHeaderipv6DestinationOptionsndrawipxspxspxIIunknownFutureValue
popProcessingRegion Zeichenfolge Der Point-of-Presence-Verarbeitungsbereich des Datenverkehrs.
privateAccessDetails microsoft.graph.networkaccess.privateAccessDetails Details zum privaten Zugriff.
receivedBytes Int64 Akkumulative empfangene Bytes.
sentBytes Int64 Akkumulative Bytes gesendet.
sourceIp Zeichenfolge Die Quell-IP der Verbindung.
sourcePort Int32 Der Quellport der Verbindung.
status Microsoft.Graph.NetworkAccess.ConnectionStatus Status der Verbindung. Mögliche Werte sind: open, active, closed, unknownFutureValue.
tenantId Zeichenfolge Die ID des Mandanten, in dem die Verbindung initiiert wurde.
trafficType microsoft.graph.networkaccess.trafficType Der Typ des Datenverkehrs. Mögliche Werte sind: internet, private, microsoft365, all, unknownFutureValue, microsoft. Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Werte aus dieser entwicklungsfähigen Aufzählung zu erhalten: microsoft.
transactionBlockCount Int32 Die Anzahl der blockierten Transaktionen, die zu der Verbindung gehören.
transactionCount Int32 Die Anzahl der Transaktionen, die zur Verbindung gehören.
transportProtocol microsoft.graph.networkaccess.networkingProtocol Das Transportprotokoll der Verbindung. Die möglichen Werte sind: ip, icmp, igmp, ggp, ipv4, tcppupudpidpipv6ipv6RoutingHeaderipv6FragmentHeaderipSecEncapsulatingSecurityPayloadipSecAuthenticationHeadericmpV6ipv6NoNextHeaderipv6DestinationOptionsndrawipxspxspxIIunknownFutureValue
userId String Die Benutzer-ID.
userPrincipalName Zeichenfolge Der Prinzipalname des Benutzers.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.networkaccess.connection",
  "id": "String (identifier)",
  "createdDateTime": "String (timestamp)",
  "tenantId": "String",
  "lastUpdateDateTime": "String (timestamp)",
  "endDateTime": "String (timestamp)",
  "status": "String",
  "trafficType": "String",
  "transactionCount": "Integer",
  "transactionBlockCount": "Integer",
  "sentBytes": "Integer",
  "receivedBytes": "Integer",
  "destinationIp": "String",
  "destinationPort": "Integer",
  "destinationFqdn": "String",
  "userId": "String",
  "sourceIp": "String",
  "sourcePort": "Integer",
  "initiatingProcessName": "String",
  "deviceId": "String",
  "deviceOperatingSystem": "String",
  "deviceOperatingSystemVersion": "String",
  "agentVersion": "String",
  "applicationSnapshot": {
    "@odata.type": "microsoft.graph.networkaccess.applicationSnapshot"
  },
  "privateAccessDetails": {
    "@odata.type": "microsoft.graph.networkaccess.privateAccessDetails"
  },
  "deviceCategory": "String",
  "userPrincipalName": "String",
  "transportProtocol": "String",
  "networkProtocol": "String",
  "popProcessingRegion": "String",
  "homeTenantId": "String",
  "crossTenantAccessType": "String",
  "deviceJoinType": "String"
}
  • Last updated on