Listar ligações

Espaço de nomes: microsoft.graph.networkaccess

Obtenha uma lista de objetos de ligação e as respetivas propriedades.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Solicitação HTTP

GET /networkAccess/logs/connections

Parâmetros de consulta opcionais

Este método suporta os seguintes parâmetros de consulta OData para ajudar a personalizar a resposta. Para obter informações gerais, acesse Parâmetros de consulta OData.

Cabeçalhos de solicitação

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se for bem-sucedido, este método devolve um 200 OK código de resposta e uma coleção de objetos microsoft.graph.networkaccess.connection no corpo da resposta.

Exemplos

Solicitação

GET https://graph.microsoft.com/beta/networkAccess/logs/connections

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.NetworkAccess.Logs.Connections.GetAsync();

// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
connections, err := graphClient.NetworkAccess().Logs().Connections().Get(context.Background(), nil)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.models.networkaccess.ConnectionCollectionResponse result = graphClient.networkAccess().logs().connections().get();

const options = {
	authProvider,
};

const client = Client.init(options);

let connections = await client.api('/networkAccess/logs/connections')
	.version('beta')
	.get();

<?php
use Microsoft\Graph\Beta\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->networkAccess()->logs()->connections()->get()->wait();

Import-Module Microsoft.Graph.Beta.NetworkAccess

Get-MgBetaNetworkAccessLogConnection

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.network_access.logs.connections.get()

Resposta

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

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.networkaccess.connection",
      "id": "6e3f9793-04a3-9473-f647-29adc069debb",
      "createdDateTime": "2025-04-20T10:00:00Z",
      "tenantId": "contoso.onmicrosoft.com",
      "lastUpdateDateTime": "2025-04-20T10:15:00Z",
      "endDateTime": "2025-04-20T10:30:00Z",
      "status": "active",
      "trafficType": "internet",
      "transactionCount": 10,
      "transactionBlockCount": 1,
      "sentBytes": 15360,
      "receivedBytes": 30720,
      "destinationIp": "13.107.6.152",
      "destinationPort": 443,
      "destinationFqdn": "graph.microsoft.com",
      "userId": "87d349ed-44d7-43e1-9a83-5f2406dee5bd",
      "sourceIp": "192.168.1.100",
      "sourcePort": 54321,
      "initiatingProcessName": "msedge.exe",
      "deviceId": "5b7c0300-45c3-487c-a6d3-a3098cb6e51b",
      "deviceOperatingSystem": "Windows",
      "deviceOperatingSystemVersion": "10.0.19045",
      "agentVersion": "1.0.2307.15",
      "applicationSnapshot": {
        "@odata.type": "microsoft.graph.networkaccess.applicationSnapshot",
        "appId": "00000003-0000-0000-c000-000000000000"
      },
      "privateAccessDetails": {
        "@odata.type": "microsoft.graph.networkaccess.privateAccessDetails",
        "connectorId": "e1a83a2c-5689-4f1c-b8ba-698606c784c9",
        "connectorName": "connector-1",
        "connectorIp": "10.0.0.100",
        "connectionStatus": "active",
        "accessType": "privateAccess",
        "processingRegion": "westus2"
      },
      "deviceCategory": "client",
      "userPrincipalName": "johndoe@contoso.com",
      "transportProtocol": "tcp",
      "networkProtocol": "ipv4",
      "popProcessingRegion": "westus2"
    },
    {
      "@odata.type": "#microsoft.graph.networkaccess.connection",
      "id": "7f4e8694-15b4-8584-g758-30bdc179efcc",
      "createdDateTime": "2025-04-20T10:05:00Z",
      "tenantId": "contoso.onmicrosoft.com",
      "lastUpdateDateTime": "2025-04-20T10:20:00Z",
      "status": "active",
      "trafficType": "microsoft365",
      "transactionCount": 5,
      "transactionBlockCount": 0,
      "sentBytes": 8192,
      "receivedBytes": 16384,
      "destinationIp": "40.99.4.10",
      "destinationPort": 443,
      "destinationFqdn": "outlook.office365.com",
      "userId": "87d349ed-44d7-43e1-9a83-5f2406dee5bd",
      "sourceIp": "192.168.1.100",
      "sourcePort": 54322,
      "initiatingProcessName": "outlook.exe",
      "deviceId": "5b7c0300-45c3-487c-a6d3-a3098cb6e51b",
      "deviceCategory": "client",
      "userPrincipalName": "johndoe@contoso.com",
      "transportProtocol": "tcp",
      "networkProtocol": "ipv4",
      "popProcessingRegion": "westus2"
    }
  ]
}