List Environment Monitoring Results

Get flow trend details for a specific environment pair

Retrieve the flow trend data points and group membership details for a specific environment pair.

Provides the time-series flow breakdown (category default rule hits, protection rule hits, total flows) plus the NSX groups associated with each environment.

The source_environment_id and destination_environment_id come from the source_environment.id and destination_environment.id fields in POST /monitoring/environments/pair-summary results.

The time granularity is automatically determined:

1 hour or less: 5-minute granularity
More than 1 hour, up to 24 hours: 1-hour granularity
More than 24 hours: 1-day granularity

If time_selection is omitted, defaults to the last 1 hour.

Request

URI

POST

https://{api_host}/intelligence/monitoring/environments/pair-details

COPY

Request Body

Source and destination environment IDs, and time range

EnvironmentPairTrendListRequestParameters of type(s) application/json

Required

Show optional properties

{
    "source_environment_id": "6c0a5b3c-6b9f-4d1e-afaf-ed3fb42bd57e",
    "destination_environment_id": "8ad292bc-e09b-49de-b011-03d9beab1a2a"
}

{
    "source_environment_id": "6c0a5b3c-6b9f-4d1e-afaf-ed3fb42bd57e",
    "destination_environment_id": "8ad292bc-e09b-49de-b011-03d9beab1a2a",
    "time_selection": {
        "start_time": 1781806444448
    }
}

string

source_environment_id

Required

Identifier (UUID) for the source environment.

string

destination_environment_id

Required

Identifier (UUID) for the destination environment.

object

time_selection

Optional

Time parameters for querying monitoring data. Specifies the start time for the query window, with the end time implicitly set to the current time. The system will examine monitoring metrics from the specified start_time to now.

Authentication

This operation uses the following authentication methods.

Responses

200

OK. Successfully retrieved environment pair details.

Returns EnvironmentPairDetails of type(s) application/json

This response body class contains all of the following: EnvironmentPair , InlineEnvironmentPairDetails1

{
    "pair_id": "6c0a5b3c-6b9f-4d1e-afaf-ed3fb42bd57e_8ad292bc-e09b-49de-b011-03d9beab1a2a",
    "source_environment": {
        "id": "6c0a5b3c-6b9f-4d1e-afaf-ed3fb42bd57e",
        "display_name": "US_West_debug"
    },
    "destination_environment": {
        "id": "8ad292bc-e09b-49de-b011-03d9beab1a2a",
        "display_name": "LTN_West_debug"
    },
    "stats": {
        "category_default_rule_unique_flow_count": 229,
        "protection_rule_unique_flow_count": 0,
        "total_unique_flow_count": 229
    },
    "protection_status": "ENVIRONMENT_UNPROTECTED",
    "related_policies": [
        {
            "dfw_policy_path": "/infra/domains/default/security-policies/SSP_Env_Default_Policy",
            "default_rule_path": "/infra/domains/default/security-policies/SSP_Env_Default_Policy/rules/ssp_env_default_rule",
            "rule_action": "JUMP_TO_APPLICATION",
            "site_id": "5cf83f93-f9dd-4898-a345-44513572c557",
            "is_category_global": true,
            "is_disabled": false,
            "is_pending_sync_from_nsx": false
        }
    ],
    "flow_trend": {
        "flow_trend": [
            {
                "category_default_rule_unique_flow_count": 48,
                "protection_rule_unique_flow_count": 0,
                "total_unique_flow_count": 48,
                "timestamp": 1781806200000
            },
            {
                "category_default_rule_unique_flow_count": 72,
                "protection_rule_unique_flow_count": 0,
                "total_unique_flow_count": 72,
                "timestamp": 1781806500000
            },
            {
                "category_default_rule_unique_flow_count": 60,
                "protection_rule_unique_flow_count": 0,
                "total_unique_flow_count": 60,
                "timestamp": 1781806800000
            },
            {
                "category_default_rule_unique_flow_count": 49,
                "protection_rule_unique_flow_count": 0,
                "total_unique_flow_count": 49,
                "timestamp": 1781807100000
            }
        ],
        "granularity": "FIVE_MINUTE"
    },
    "source_env_groups": [
        {
            "id": "7a84f8ae-d934-453d-973e-cd8e76244a7d",
            "site_id": "5cf83f93-f9dd-4898-a345-44513572c557"
        }
    ],
    "dest_env_groups": [
        {
            "id": "47ef061d-91ee-4858-9e1b-97d132073f71",
            "site_id": "5cf83f93-f9dd-4898-a345-44513572c557"
        }
    ]
}

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.

Code Samples

COPY

                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"source_environment_id":"string","destination_environment_id":"string"}' https://{api_host}/intelligence/monitoring/environments/pair-details

On This Page

Description

Request

Request Body

Authentication

Response

200 Response Body

Errors

Environment Monitoring Operations

POST

Get Environment Pairs

POST