接続リソースの種類

名前空間: microsoft.graph.networkaccess

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

グローバル セキュア アクセス (GSA) では、接続は複数の networkAccessTraffic が発生し、単一の接続 ID を共有していることを表します。 送信元と宛先の詳細、トラフィック統計、接続状態など、ネットワーク接続に関する情報を提供します。

メソッド

メソッド 戻り値の種類 説明
List Microsoft.Graph.NetworkAccess.Connection コレクション 接続オブジェクトとそのプロパティの一覧を取得します。
Get Microsoft.Graph.NetworkAccess.Connection 接続オブジェクトのプロパティと関係を読み取ります。

プロパティ

プロパティ 型 説明
agentVersion 文字列 接続を開始したクライアントのバージョン。
applicationSnapshot microsoft.graph.networkaccess.applicationSnapshot 宛先 Microsoft Entra アプリケーションの appId (またはクライアント ID)。
createdDateTime DateTimeOffset 接続が作成された時刻。
crossTenantAccessType microsoft.graph.networkaccess.crossTenantAccessType B2B シナリオのテナント間アクセスの詳細。 使用可能な値: none、b2bCollaboration、unknownFutureValue。
destinationFqdn 文字列 接続の宛先 FQDN。
destinationIp 文字列 接続の宛先 IP。
destinationPort Int32 接続の宛先ポート。
deviceCategory microsoft.graph.networkaccess.deviceCategory デバイスのカテゴリ。 使用可能な値: client、branch、unknownFutureValue、remoteNetwork。 Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この進化可能な列挙型から次の値を取得します。remoteNetwork。
deviceId 文字列 デバイス ID。
deviceJoinType microsoft.graph.networkaccess.deviceJoinType BYOD シナリオ用のデバイス登録の種類。 使用可能な値: none、microsoftEntraJoined、microsoftEntraRegistered、unknownFutureValue。
deviceOperatingSystem 文字列 デバイスのオペレーティング システムの種類。
deviceOperatingSystemVersion 文字列 デバイスのオペレーティング システムのバージョン。
endDateTime DateTimeOffset 接続が終了した時刻。
homeTenantId 文字列 Entra B2B シナリオのホーム テナントの識別子。
id 文字列 接続の一意識別子。 microsoft.graph.entity から継承されます。
initiatingProcessName 文字列 トラフィック接続を開始するプロセス。
lastUpdateDateTime DateTimeOffset 接続が最後に更新されたとき。
networkProtocol microsoft.graph.networkaccess.networkingProtocol 接続のネットワーク プロトコル。 可能な値は、 ip、 icmp、 igmp、 ggp、 ipv4、 tcp、 pup、 udp、 idp、 ipv6、 ipv6RoutingHeader、 ipv6FragmentHeader、 ipSecEncapsulatingSecurityPayload、 ipSecAuthenticationHeader、 icmpV6、 ipv6NoNextHeader、 ipv6DestinationOptions、 nd、 raw、 ipx、 spx、 spxII、 unknownFutureValue です。
popProcessingRegion 文字列 トラフィックの ポイント オブ プレゼンス処理リージョン。
privateAccessDetails microsoft.graph.networkaccess.privateAccessDetails プライベート アクセスの詳細。
receivedBytes Int64 受信した累積バイト数。
sentBytes Int64 送信された累積バイト数。
sourceIp 文字列 接続の発信元 IP。
sourcePort Int32 接続の送信元ポート。
status microsoft.graph.networkaccess.connectionStatus 接続の状態。 使用可能な値: open、active、closed、unknownFutureValue。
tenantId String 接続が開始されたテナントの ID。
trafficType microsoft.graph.networkaccess.trafficType トラフィックの種類。 使用可能な値: internet、private、microsoft365、all、unknownFutureValue、microsoft。 Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この進化可能な列挙型から次の値を取得します。microsoft。
transactionBlockCount Int32 接続に属するブロックされたトランザクションの数。
transactionCount Int32 接続に属するトランザクションの数。
transportProtocol microsoft.graph.networkaccess.networkingProtocol 接続のトランスポート プロトコル。 可能な値は、 ip、 icmp、 igmp、 ggp、 ipv4、 tcp、 pup、 udp、 idp、 ipv6、 ipv6RoutingHeader、 ipv6FragmentHeader、 ipSecEncapsulatingSecurityPayload、 ipSecAuthenticationHeader、 icmpV6、 ipv6NoNextHeader、 ipv6DestinationOptions、 nd、 raw、 ipx、 spx、 spxII、 unknownFutureValue です。
userId String ユーザー ID。
userPrincipalName String ユーザーのプリンシパル名。

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "@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"
}