Management Plane API > Networking > Logical Switching > Logical Switch Ports

Update a Switching Profile

Updates the user-configurable parameters of a switching profile. Only the qos,
port-mirroring, spoof-guard and port-security switching profiles can be modified.
You cannot modify the ipfix or ip-discovery switching profiles.

Request:

Method:
PUT
URI Path(s):
/api/v1/switching-profiles/<switching-profile-id>
Request Headers:
n/a
Query Parameters:
n/a
Request Body:
IpDiscoverySwitchingProfile+
MacManagementSwitchingProfile+
PortMirroringSwitchingProfile+
QosSwitchingProfile+
SpoofGuardSwitchingProfile+
SwitchSecuritySwitchingProfile+

Example Request:

PUT https://<nsx-mgr>/api/v1/switching-profiles/11a97fd4-b668-4f1c-932d-b3bd087550ea { "resource_type": "QosSwitchingProfile", "description": "", "id": "7f39bf67-ccf5-4613-8993-506ec89d893a", "display_name": "Medium priority", "tags": [], "dscp": { "mode": "TRUSTED", "priority": 0 }, "shaper_configuration": [ { "resource_type": "IngressRateShaper", "enabled": true, "average_bandwidth_mbps": 1000, "peak_bandwidth_mbps": 2000, "burst_size_bytes": 1250 }, { "resource_type": "IngressBroadcastRateShaper", "enabled": true, "burst_size_bytes": 1250, "peak_bandwidth_kbps": 2000, "average_bandwidth_kbps": 2000 }, { "resource_type": "EgressRateShaper", "enabled": false, "average_bandwidth_mbps": 1000, "peak_bandwidth_mbps": 2000, "burst_size_bytes": 1250 } ], "class_of_service": 2, "_revision": 0 }

Successful Response:

Response Code:
200 OK
Response Headers:
Content-type: application/json
Response Body:
IpDiscoverySwitchingProfile+
MacManagementSwitchingProfile+
PortMirroringSwitchingProfile+
QosSwitchingProfile+
SpoofGuardSwitchingProfile+
SwitchSecuritySwitchingProfile+

Example Response:

{ "resource_type": "QosSwitchingProfile", "description": "", "id": "7f39bf67-ccf5-4613-8993-506ec89d893a", "display_name": "Medium priority", "tags": [], "required_capabilities": [ "switchingprofile.qos.shaper.broadcast" ], "dscp": { "mode": "TRUSTED", "priority": 0 }, "shaper_configuration": [ { "resource_type": "IngressRateShaper", "enabled": true, "average_bandwidth_mbps": 1000, "peak_bandwidth_mbps": 2000, "burst_size_bytes": 1250 }, { "resource_type": "IngressBroadcastRateShaper", "enabled": true, "burst_size_bytes": 1250, "peak_bandwidth_kbps": 2000, "average_bandwidth_kbps": 2000 }, { "resource_type": "EgressRateShaper", "enabled": false, "average_bandwidth_mbps": 1000, "peak_bandwidth_mbps": 2000, "burst_size_bytes": 1250 } ], "class_of_service": 2, "_last_modified_time": 1458857995660, "_last_modified_user": "admin", "_system_owned": false, "_revision": 1 }

Required Permissions:

crud

Feature:

switching_switching_profiles

Additional Errors: