Microsoft Graph · Schema

networkConnection

Azure ADCollaborationContactsDocumentsEmailGraphIdentityMicrosoftOffice 365PresentationsProductivitySpreadsheetsT1Tasks

Properties

Name Type Description
applicationName string Name of the application managing the network connection (for example, Facebook or SMTP).
destinationAddress string Destination IP address (of the network connection).
destinationDomain string Destination domain portion of the destination URL. (for example 'www.contoso.com').
destinationLocation string Location (by IP address mapping) associated with the destination of a network connection.
destinationPort string Destination port (of the network connection).
destinationUrl string Network connection URL/URI string - excluding parameters. (for example 'www.contoso.com/products/default.html')
direction object Network connection direction. The possible values are: unknown, inbound, outbound.
domainRegisteredDateTime string Date when the destination domain was registered. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 20
localDnsName string The local DNS name resolution as it appears in the host's local DNS cache (for example, in case the 'hosts' file was tampered with).
natDestinationAddress string Network Address Translation destination IP address.
natDestinationPort string Network Address Translation destination port.
natSourceAddress string Network Address Translation source IP address.
natSourcePort string Network Address Translation source port.
protocol object Network protocol. The possible values are: unknown, ip, icmp, igmp, ggp, ipv4, tcp, pup, udp, idp, ipv6, ipv6RoutingHeader, ipv6FragmentHeader, ipSecEncapsulatingSecurityPayload, ipSecAuthenticationHe
riskScore string Provider generated/calculated risk score of the network connection. Recommended value range of 0-1, which equates to a percentage.
sourceAddress string Source (i.e. origin) IP address (of the network connection).
sourceLocation string Location (by IP address mapping) associated with the source of a network connection.
sourcePort string Source (i.e. origin) IP port (of the network connection).
status object Network connection status. The possible values are: unknown, attempted, succeeded, blocked, failed.
urlParameters string Parameters (suffix) of the destination URL.
@odata.type string
View JSON Schema on GitHub

JSON Schema

microsoft-graph-microsoftgraphnetworkconnection-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/microsoft.graph.networkConnection",
  "title": "networkConnection",
  "required": [
    "@odata.type"
  ],
  "type": "object",
  "properties": {
    "applicationName": {
      "type": "string",
      "description": "Name of the application managing the network connection (for example, Facebook or SMTP).",
      "nullable": true
    },
    "destinationAddress": {
      "type": "string",
      "description": "Destination IP address (of the network connection).",
      "nullable": true
    },
    "destinationDomain": {
      "type": "string",
      "description": "Destination domain portion of the destination URL. (for example 'www.contoso.com').",
      "nullable": true
    },
    "destinationLocation": {
      "type": "string",
      "description": "Location (by IP address mapping) associated with the destination of a network connection.",
      "nullable": true
    },
    "destinationPort": {
      "type": "string",
      "description": "Destination port (of the network connection).",
      "nullable": true
    },
    "destinationUrl": {
      "type": "string",
      "description": "Network connection URL/URI string - excluding parameters. (for example 'www.contoso.com/products/default.html')",
      "nullable": true
    },
    "direction": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/microsoft.graph.connectionDirection"
        },
        {
          "type": "object",
          "nullable": true
        }
      ],
      "description": "Network connection direction. The possible values are: unknown, inbound, outbound."
    },
    "domainRegisteredDateTime": {
      "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
      "type": "string",
      "description": "Date when the destination domain was registered. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z",
      "format": "date-time",
      "nullable": true
    },
    "localDnsName": {
      "type": "string",
      "description": "The local DNS name resolution as it appears in the host's local DNS cache (for example, in case the 'hosts' file was tampered with).",
      "nullable": true
    },
    "natDestinationAddress": {
      "type": "string",
      "description": "Network Address Translation destination IP address.",
      "nullable": true
    },
    "natDestinationPort": {
      "type": "string",
      "description": "Network Address Translation destination port.",
      "nullable": true
    },
    "natSourceAddress": {
      "type": "string",
      "description": "Network Address Translation source IP address.",
      "nullable": true
    },
    "natSourcePort": {
      "type": "string",
      "description": "Network Address Translation source port.",
      "nullable": true
    },
    "protocol": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/microsoft.graph.securityNetworkProtocol"
        },
        {
          "type": "object",
          "nullable": true
        }
      ],
      "description": "Network protocol. The possible values are: unknown, ip, icmp, igmp, ggp, ipv4, tcp, pup, udp, idp, ipv6, ipv6RoutingHeader, ipv6FragmentHeader, ipSecEncapsulatingSecurityPayload, ipSecAuthenticationHeader, icmpV6, ipv6NoNextHeader, ipv6DestinationOptions, nd, raw, ipx, spx, spxII."
    },
    "riskScore": {
      "type": "string",
      "description": "Provider generated/calculated risk score of the network connection. Recommended value range of 0-1, which equates to a percentage.",
      "nullable": true
    },
    "sourceAddress": {
      "type": "string",
      "description": "Source (i.e. origin) IP address (of the network connection).",
      "nullable": true
    },
    "sourceLocation": {
      "type": "string",
      "description": "Location (by IP address mapping) associated with the source of a network connection.",
      "nullable": true
    },
    "sourcePort": {
      "type": "string",
      "description": "Source (i.e. origin) IP port (of the network connection).",
      "nullable": true
    },
    "status": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/microsoft.graph.connectionStatus"
        },
        {
          "type": "object",
          "nullable": true
        }
      ],
      "description": "Network connection status. The possible values are: unknown, attempted, succeeded, blocked, failed."
    },
    "urlParameters": {
      "type": "string",
      "description": "Parameters (suffix) of the destination URL.",
      "nullable": true
    },
    "@odata.type": {
      "type": "string"
    }
  }
}