NSX-T Data Center REST API
Create or update a traceflow config
If a traceflow config with the traceflow-id is notalready present, create a new traceflow config. If it already exists,
update the traceflow config. This is a full replace. This
configuration will be cleaned up by the system after two hours of inactivity.
To start traceflow on a DHCP port in a custom project, enforcement point path is required.
User needs to update the in-band network telemetry (INT) configuration to specify the DSCP
bit/value for traceflow crafted packet, if the source port of traceflow is on VLAN logical network.
The INT configuration is under global operations configuration so please refer NSX-T API document
Policy > Networking > Networking Profiles > Global Gateway Configuration to check how to set the
DSCP bit/value via global operations configuration related API.
Request:
Method:
PUT
URI Path(s):
/policy/api/v1/infra/traceflows/{traceflow-id}
/policy/api/v1/orgs/{org-id}/projects/{project-id}/infra/traceflows/{traceflow-id}
/policy/api/v1/orgs/{org-id}/projects/{project-id}/infra/traceflows/{traceflow-id}
Request Headers:
n/a
Query Parameters:
TraceflowStatusRequest+
Request Body:
TraceflowConfig+
Example Request:
{ "segment_port_path": "/infra/tier-1s/it_t1/segments/it-t1-seg/ports/default:c8d7ac3f-1904-4088-a9ec-f0183b5b14d6", "packet": { "eth_header": { "src_mac": "00:55:56:8f:49:60", "dst_mac": "00:50:56:8f:2f:97", "eth_type": 2048 }, "ip_header": { "src_ip": "172.16.14.11", "dst_ip": "172.16.16.13", "protocol": 1, "ttl": 64, "flags": 0 }, "transport_header": { "icmp_echo_request_header": { "id": 0, "sequence": 0 } }, "payload": "", "resource_type": "FieldsPacketData", "frame_size": 128, "routed": true, "transport_type": "UNICAST" }, "timeout": 10 }Successful Response:
Response Code:
200 OK
Response Headers:
Content-type: application/json
Response Body:
TraceflowConfig+