tipo de recurso de conexão

Namespace: 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 Global Secure Access (GSA), uma conexão representa vários networkAccessTraffic ocorrendo e compartilhando uma única ID de conexão. Fornece informações sobre conexões de rede, incluindo detalhes de origem e destino, estatísticas de tráfego e status da conexão.

Métodos

Método Tipo de retorno Descrição
List Coleção Microsoft.Graph.NetworkAccess.Connection Obtenha uma lista dos objetos de conexão e suas propriedades.
Get Microsoft.Graph.NetworkAccess.Connection Ler as propriedades e relações de um objeto de conexão.

Propriedades

Propriedade Tipo Descrição
agentVersion Cadeia de caracteres A versão do cliente que iniciou a conexão.
applicationSnapshot microsoft.graph.networkaccess.applicationSnapshot appId (ou ID do cliente) do aplicativo Microsoft Entra de destino.
createdDateTime DateTimeOffset A hora em que a conexão foi criada.
crossTenantAccessType microsoft.graph.networkaccess.crossTenantAccessType Detalhes de acesso entre locatários, para cenários B2B. Os valores possíveis são: none, b2bCollaboration, unknownFutureValue.
destinationFqdn Cadeia de caracteres O FQDN de destino da conexão.
destinationIp Cadeia de caracteres O IP de destino da conexão.
destinationPort Int32 A porta de destino da conexão.
deviceCategory microsoft.graph.networkaccess.deviceCategory A categoria do dispositivo. Os valores possíveis são: client, branch, unknownFutureValue, remoteNetwork. Use o Prefer: include-unknown-enum-members cabeçalho da solicitação para obter os seguintes valores dessa enumeração evolutiva: remoteNetwork.
deviceId Cadeia de caracteres O DeviceID.
deviceJoinType microsoft.graph.networkaccess.deviceJoinType Tipo de registro de dispositivo, para cenários BYOD. Os valores possíveis são: none, microsoftEntraJoined, microsoftEntraRegistered, unknownFutureValue.
deviceOperatingSystem Cadeia de caracteres O tipo de sistema operacional do dispositivo.
deviceOperatingSystemVersion Cadeia de caracteres A versão do sistema operacional do dispositivo.
endDateTime DateTimeOffset A hora em que a conexão foi encerrada.
homeTenantId Cadeia de caracteres O identificador do locatário principal, para cenários B2B do Entra.
id Cadeia de caracteres O identificador exclusivo da conexão. Herdado de microsoft.graph.entity.
initiatingProcessName Cadeia de caracteres O processo que inicia a conexão de tráfego.
lastUpdateDateTime DateTimeOffset Quando a conexão foi atualizada pela última vez.
networkProtocol microsoft.graph.networkaccess.networkingProtocol O protocolo de rede da conexão. Os valores possíveis são: ip, icmp, igmp, ggpipv4tcppupudpidpipv6ipv6RoutingHeaderipv6FragmentHeaderipSecEncapsulatingSecurityPayloadipSecAuthenticationHeadericmpV6ipv6NoNextHeaderipv6DestinationOptionsndrawipxspxspxIIunknownFutureValue
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 acumulativos recebidos.
sentBytes Int64 Acumula bytes enviados.
sourceIp Cadeia de caracteres O IP de origem da conexão.
sourcePort Int32 A porta de origem da conexão.
status microsoft.graph.networkaccess.connectionStatus Status da conexão. Os valores possíveis são: open, active, closed, unknownFutureValue.
tenantId String A ID do locatário onde a conexã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. Use o Prefer: include-unknown-enum-members cabeçalho da solicitação para obter os seguintes valores dessa enumeração evolutiva: microsoft.
transactionBlockCount Int32 O número de transações bloqueadas pertencentes à conexão.
transactionCount Int32 O número de transações pertencentes à conexão.
transportProtocol microsoft.graph.networkaccess.networkingProtocol O protocolo de transporte da conexão. Os valores possíveis são: ip, icmp, igmp, ggpipv4tcppupudpidpipv6ipv6RoutingHeaderipv6FragmentHeaderipSecEncapsulatingSecurityPayloadipSecAuthenticationHeadericmpV6ipv6NoNextHeaderipv6DestinationOptionsndrawipxspxspxIIunknownFutureValue
userId Cadeia de caracteres A ID do usuário.
userPrincipalName Cadeia de caracteres O nome principal do usuário.

Relações

Nenhum

Representação JSON

A representação JSON a seguir 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",
  "homeTenantId": "String",
  "crossTenantAccessType": "String",
  "deviceJoinType": "String"
}
  • Última atualização em