Compartilhar via

tipo de recurso de ligação

Espaço de nomes: microsoft.graph.networkaccess

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

No Acesso Seguro Global (GSA), uma ligação representa vários networkAccessTraffic que ocorrem e partilham o ID de ligação única. Fornece informações sobre ligações de rede, incluindo detalhes de origem e destino, estatísticas de tráfego e status de ligação.

Métodos

Método Tipo de retorno Descrição
List microsoft.graph.networkaccess.connection collection Obtenha uma lista dos objetos de ligação e respetivas propriedades.
Get microsoft.graph.networkaccess.connection Leia as propriedades e relações de um objeto de ligação.

Propriedades

Propriedade Tipo Descrição
agentVersion Cadeia de caracteres A versão do cliente que iniciou a ligação.
applicationSnapshot microsoft.graph.networkaccess.applicationSnapshot appId (ou ID de cliente) da aplicação Microsoft Entra de destino.
createdDateTime DateTimeOffset A hora em que a ligação foi criada.
destinationFqdn Cadeia de caracteres O FQDN de destino da ligação.
destinationIp Cadeia de caracteres O IP de destino da ligação.
destinationPort Int32 A porta de destino da ligação.
deviceCategory microsoft.graph.networkaccess.deviceCategory A categoria do dispositivo. Os valores possíveis são: client, branch, unknownFutureValue, remoteNetwork. Utilize o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores desta enumeração evoluível: remoteNetwork.
deviceId Cadeia de caracteres O DeviceID.
deviceOperatingSystem Cadeia de caracteres O tipo de sistema operativo do dispositivo.
deviceOperatingSystemVersion Cadeia de caracteres A versão do sistema operativo do dispositivo.
endDateTime DateTimeOffset A hora em que a ligação foi terminada.
id Cadeia de caracteres O identificador exclusivo da ligação. Herdado de microsoft.graph.entity.
initiatingProcessName Cadeia de caracteres O processo que inicia a ligação de tráfego.
lastUpdateDateTime DateTimeOffset Quando a ligação foi atualizada pela última vez.
networkProtocol microsoft.graph.networkaccess.networkingProtocol O protocolo de rede da ligação. Os valores possíveis são: ip, , icmpigmp, ggp, ipv4, tcp, pup, udp, idp, ipv6, ipv6RoutingHeader, , ipv6FragmentHeader, ipSecEncapsulatingSecurityPayload, ipSecAuthenticationHeader, icmpV6, , ipv6NoNextHeader, , ipv6DestinationOptions, , nd, raw, unknownFutureValueipxspxspxII.
popProcessingRegion Cadeia de caracteres A região de processamento do Ponto de Presença do tráfego.
privateAccessDetails microsoft.graph.networkaccess.privateAccessDetails Detalhes de acesso privado.
receivedBytes Int64 Bytes acumulados recebidos.
sentBytes Int64 Bytes acumulados enviados.
sourceIp Cadeia de caracteres O IP de origem da ligação.
sourcePort Int32 A porta de origem da ligação.
status microsoft.graph.networkaccess.connectionStatus Estado da ligação. Os valores possíveis são: open, active, closed, unknownFutureValue.
tenantId String O ID do inquilino onde a ligação foi iniciada.
trafficType microsoft.graph.networkaccess.trafficType O tipo de tráfego. Os valores possíveis são: internet, private, microsoft365, all, unknownFutureValue, microsoft. Utilize o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores desta enumeração evoluível: microsoft.
transactionBlockCount Int32 O número de transações bloqueadas que pertencem à ligação.
transactionCount Int32 O número de transações pertencentes à ligação.
transportProtocol microsoft.graph.networkaccess.networkingProtocol O protocolo de transporte da ligação. Os valores possíveis são: ip, , icmpigmp, ggp, ipv4, tcp, pup, udp, idp, ipv6, ipv6RoutingHeader, , ipv6FragmentHeader, ipSecEncapsulatingSecurityPayload, ipSecAuthenticationHeader, icmpV6, , ipv6NoNextHeader, , ipv6DestinationOptions, , nd, raw, unknownFutureValueipxspxspxII.
userId Cadeia de caracteres A ID do usuário.
userPrincipalName Cadeia de caracteres O nome principal do utilizador.

Relações

Nenhum

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
  "@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"
}
  • Last updated on