Get Compute Flow Connections

Get unique (deduplicated) flow records between two compute entities

Returns a paginated list of unique (deduplicated) flow records between a specific pair of compute entities. Flows are deduplicated by the 4-tuple of source VM, destination VM, destination port, and protocol -- multiple occurrences within the time window collapse into a single row reflecting the most recently observed state.

Notes:

source_id, destination_id, start_time, src_site_id, and dst_site_id are all required.
source_id and destination_id are the VM external IDs of the source and destination computes. Obtain them from the nodes returned by POST /visualization/topology/compute-flow-topology.
The VM external ID is the vCenter-assigned identifier for the compute, visible as the id field on each compute node in topology responses.
src_site_id and dst_site_id scope the query to a specific source and destination site. For intra-site flows, set both to the same site ID.
Set bidirectional to true to include flows in both directions between the two computes. Defaults to false (source -> destination only).
source_parent_id and destination_parent_id optionally scope results to flows where the compute belongs to a specific parent group.
filters accepts up to 300 filter entries.
To check whether any flows exist between two computes before fetching full details, use the lightweight POST /visualization/flow-analysis/compute-connections/flow-type endpoint first.

Request

URI

POST

https://{api_host}/intelligence/visualization/flow-analysis/compute-connections

COPY

Request Body

Wrapper request for ComputeConnections with restricted filter keys

VizComputeConnectionsRequest of type(s) application/json

Required

This request body class requires all of the following: VizTimeIntervalListSiteConnectionRequest , InlineVizComputeConnectionsRequest1

{
    "start_time": 1778777283139,
    "src_site_id": "8c27e777-2917-447c-a68f-566b985fe546",
    "dst_site_id": "8c27e777-2917-447c-a68f-566b985fe546",
    "source_id": "50031caf-ed05-1a3b-33e1-d115e4d68834",
    "destination_id": "50033bfe-c4bb-b585-da08-5a16174f0233",
    "bidirectional": true,
    "is_active_flows": false,
    "page_size": 50,
    "offset": 0
}

Authentication

This operation uses the following authentication methods.

Responses

200

success

Returns FlowConnectionListResult of type(s) application/json

This response body class contains all of the following: VizTimeIntervalListResult , InlineFlowConnectionListResult1

{
    "offset": 0,
    "number_of_results": 1,
    "total_result_count": 6,
    "total_pages": 1,
    "time_interval": {
        "start_time": 1778777283139,
        "end_time": 1781455762704
    },
    "results": [
        {
            "source": {
                "groups": [],
                "compute": {
                    "entity_type": "COMPUTE",
                    "compute_type": "VM",
                    "id": "50033bfe-c4bb-b585-da08-5a16174f0233",
                    "reference_id": "50033bfe-c4bb-b585-da08-5a16174f0233",
                    "name": "inc_1_nesx-node2_vm_5",
                    "config_events": [],
                    "highlight": false
                },
                "apps": [],
                "flow_type": "BLOCKED",
                "rules": [
                    {
                        "id": "2024"
                    }
                ],
                "jump_to_rules": []
            },
            "destination": {
                "groups": [],
                "compute": {
                    "entity_type": "COMPUTE",
                    "compute_type": "VM",
                    "id": "50031caf-ed05-1a3b-33e1-d115e4d68834",
                    "reference_id": "50031caf-ed05-1a3b-33e1-d115e4d68834",
                    "name": "inc_1_nesx-node0_vm_0",
                    "config_events": [],
                    "highlight": false
                },
                "apps": [],
                "configured_services": [
                    "MS-DS",
                    "SMB",
                    "MS-DS-TCP",
                    "SMB Server",
                    "MS Exchange 2007 Mailbox Servers",
                    "MS Exchange 2010 Mailbox Servers",
                    "Microsoft Exchange 2007",
                    "SharePoint 2007 V1",
                    "SharePoint 2010 V1",
                    "Microsoft Exchange 2010",
                    "Vmware View/VDM2.x",
                    "Microsoft Active Directory V1"
                ],
                "protocol": "TCP",
                "port": 445,
                "flow_type": "UNKNOWN",
                "rules": [
                    {
                        "id": "UNKNOWN"
                    }
                ],
                "jump_to_rules": [
                    {
                        "id": "UNKNOWN"
                    }
                ]
            },
            "flow_info": {
                "last_session_start_time": 1781262056,
                "last_session_end_time": 1781262056,
                "flow_type": "BLOCKED",
                "is_active": false
            }
        }
    ]
}

400

Bad Request

Returns BadRequest of type(s) application/json

{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}

integer

error_code

Required

HTTP Status or Application error code.

string

module_name

Optional

Module where the error happened.

string

error_message

Required

Message describing the error.

401

Unauthorized

Returns Unauthorized of type(s) application/json

{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}

integer

error_code

Required

HTTP Status or Application error code.

string

module_name

Optional

Module where the error happened.

string

error_message

Required

Message describing the error.

403

Forbidden

Returns Forbidden of type(s) application/json

{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}

integer

error_code

Required

HTTP Status or Application error code.

string

module_name

Optional

Module where the error happened.

string

error_message

Required

Message describing the error.

412

Precondition Failed

Returns PreconditionFailed of type(s) application/json

{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}

integer

error_code

Required

HTTP Status or Application error code.

string

module_name

Optional

Module where the error happened.

string

error_message

Required

Message describing the error.

428

Precondition Required

Returns PreconditionRequired of type(s) application/json

{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}

integer

error_code

Required

HTTP Status or Application error code.

string

module_name

Optional

Module where the error happened.

string

error_message

Required

Message describing the error.

429

Too Many Requests

Returns TooManyRequests of type(s) application/json

{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}

integer

error_code

Required

HTTP Status or Application error code.

string

module_name

Optional

Module where the error happened.

string

error_message

Required

Message describing the error.

default

Error

Returns Error of type(s) application/json

{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}

integer

error_code

Required

HTTP Status or Application error code.

string

module_name

Optional

Module where the error happened.

string

error_message

Required

Message describing the error.

Code Samples

COPY

                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{}' https://{api_host}/intelligence/visualization/flow-analysis/compute-connections

On This Page

Description

Request

Request Body

Authentication

Response

200 Response Body

Errors

Security Explorer Operations

POST

Get App Flow Details

POST