System Administration > Configuration > Fabric > Profiles > Hostswitch Profiles

Create or update a Hostswitch Profile

Patch a hostswitch profile. The resource_type is required and needs to be
one of the following,
UplinkHostSwitchProfile, LldpHostSwitchProfile, NiocProfile &
ExtraConfigHostSwitchProfile.
Uplink profile - For uplink profiles, the teaming and policy parameters are
required. By default, the mtu is 1600 and the transport_vlan is 0. The
supported MTU range is 1280 through (uplink_mtu_threshold).
uplink_mtu_threshold is 9000 by default. Range can be extended by modifying
(uplink_mtu_threshold) in SwitchingGlobalConfig to the required upper threshold.
Teaming defined in this profile allows NSX to load balance traffic across
different physical NICs (PNICs) on the hypervisor hosts. Multiple teaming
policies are supported, including LACP active, LACP passive, load balancing
based on source ID, and failover order.
Lldp profile - Enable or disable sending LLDP packets
NiocProfile - Network I/O Control settings: defines limits, shares and
reservations for various host traffic types.
ExtraConfig - Vendor specific configuration on HostSwitch, logical switch
or logical port

Request:

Method:
PATCH
URI Path(s):
/policy/api/v1/infra/host-switch-profiles/<host-switch-profile-id>
Request Headers:
n/a
Query Parameters:
n/a
Request Body:
PolicyExtraConfigHostSwitchProfile+
PolicyLldpHostSwitchProfile+
PolicyNiocProfile+
PolicyUplinkHostSwitchProfile+

Example Request:

PATCH https://<policy-mgr>/policy/api/v1/infra/host-switch-profiles/uplinkProfile1 { "lags": [ { "name": "lag2", "id": "49114", "mode": "ACTIVE", "load_balance_algorithm": "SRCMAC", "number_of_uplinks": 2, "uplinks": [ { "uplink_name": "lag2-0", "uplink_type": "PNIC" }, { "uplink_name": "lag2-1", "uplink_type": "PNIC" } ], "timeout_type": "FAST" } ], "teaming": { "policy": "LOADBALANCE_SRC_MAC", "active_list": [ { "uplink_name": "lag2", "uplink_type": "LAG" } ] }, "transport_vlan": 19, "overlay_encap": "GENEVE", "resource_type": "UplinkHostSwitchProfile", "id": "uplinkProfile1", "display_name": "CustomLagProfile-LOADBALANCE_SRC_MAC", "path": "/infra/host-switch-profiles/uplinkProfile1", "relative_path": "uplinkProfile1", "parent_path": "/infra", "unique_id": "7917d0ba-4388-4f3f-921f-94d09959007a", "marked_for_delete": false, "overridden": false, "_create_user": "unknown", "_create_time": 0, "_last_modified_user": "unknown", "_last_modified_time": 1612408913822, "_system_owned": false, "_protection": "NOT_PROTECTED", "_revision": 1 }

Successful Response:

Response Code:
200 OK
Response Headers:
Content-type: application/json
Response Body:
PolicyExtraConfigHostSwitchProfile+
PolicyLldpHostSwitchProfile+
PolicyNiocProfile+
PolicyUplinkHostSwitchProfile+

Example Response:

{ "lags": [ { "name": "lag2", "id": "45412", "mode": "ACTIVE", "load_balance_algorithm": "SRCMAC", "number_of_uplinks": 2, "uplinks": [ { "uplink_name": "lag2-0", "uplink_type": "PNIC" }, { "uplink_name": "lag2-1", "uplink_type": "PNIC" } ], "timeout_type": "FAST" } ], "teaming": { "policy": "LOADBALANCE_SRC_MAC", "active_list": [ { "uplink_name": "lag2", "uplink_type": "LAG" } ] }, "transport_vlan": 19, "overlay_encap": "GENEVE", "resource_type": "UplinkHostSwitchProfile", "id": "uplinkProfile1", "display_name": "CustomLagProfile-LOADBALANCE_SRC_MAC", "path": "/infra/host-switch-profiles/uplinkProfile1", "relative_path": "uplinkProfile1", "parent_path": "/infra", "unique_id": "7917d0ba-4388-4f3f-921f-94d09959007a", "marked_for_delete": false, "overridden": false, "_create_user": "unknown", "_create_time": 1612407975428, "_last_modified_user": "unknown", "_last_modified_time": 1612407975428, "_system_owned": false, "_protection": "NOT_PROTECTED", "_revision": 0 }

Required Permissions:

crud

Feature:

profiles_host_switch_profiles

Additional Errors: