Export Compute Flow Details

Export Compute Flow Details
Start a CSV export of VM flow records

Initiates an asynchronous job to generate a downloadable CSV file containing the same unique (deduplicated) flow records as POST /visualization/flow-analysis/computes/{compute-id}/flow-details for the specified VM.

Notes:

  • Returns 202 Accepted immediately. The export runs asynchronously -- do not call this endpoint in a loop.
  • Poll GET /visualization/flow-exports/exports/{export-id} using the export_id from the response until status is COMPLETED.
  • Once complete, call POST /visualization/flow-exports/exports/{export-id}/get-download-key to obtain the download URL.
  • file_name is required (1-255 characters) and sets the name of the generated CSV file.
  • Set expand_external_traffic to true to expand aggregated external traffic rows into individual rows per source and destination IP. Defaults to false.
  • Obtain compute-id from the topology graph returned by POST /visualization/topology/compute-flow-topology, where each node represents a compute.
Request
URI
POST
https://{api_host}/intelligence/visualization/flow-exports/computes/{compute-id}/flow-details/export
COPY
Path Parameters
string
compute-id
Required  

External ID of the target VM.


Request Body

Wrapper request for ComputeIdFlowDetailsExport with restricted filter keys

VizComputeIdFlowDetailsExportRequest of type(s) application/json
Required  
This request body class requires all of the following: VizComputeIdFlowDetailsRequest , InlineVizComputeIdFlowDetailsExportRequest1
{
    "start_time": 1781452306172,
    "site_id": "8c27e777-2917-447c-a68f-566b985fe546",
    "file_name": "my-export.csv"
}
Authentication
This operation uses the following authentication methods.
Responses
202

success

Returns AsyncApiResponse of type(s) application/json
{
    "id": "ca42e72c-6a4a-42ea-be4d-68c6ce1cfd53"
}
string
id
Optional

UUID identifier of the response.

string
status_url
Optional

The URL to check the status of the operation.


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-exports/computes/{compute-id}/flow-details/export