Update Logical Port
Modifies an existing logical switch port. Parameters that can be modified include attachment_type (LOGICALROUTER, VIF), admin_state (UP or DOWN), attachment id and switching_profile_ids. You cannot modify the logical_switch_id. In other words, you cannot move an existing port from one switch to another switch.
Request
URI
PUT
https://nsxmanager.your.domain/api/v1/logical-ports/{lport-id}
COPY
Path Parameters
string
lport-id
Required
lport-id
Request Body
LogicalPort of type(s) application/json
Optional
{
"_self": {
"action": "string",
"href": "string",
"rel": "string"
},
"_links": [
{
"action": "string",
"href": "string",
"rel": "string"
}
],
"_schema": "string",
"_revision": 0,
"_system_owned": false,
"display_name": "string",
"description": "string",
"tags": [
{
"scope": "string",
"tag": "string"
}
],
"_create_user": "string",
"_protection": "string",
"_create_time": 0,
"_last_modified_time": 0,
"_last_modified_user": "string",
"id": "string",
"resource_type": "string",
"logical_switch_id": "string",
"init_state": "string",
"switching_profile_ids": [
{
"value": "string",
"key": "string"
}
],
"attachment": {
"attachment_type": "string",
"context": {
"allocate_addresses": "string",
"resource_type": "string"
},
"id": "string"
},
"admin_state": "string",
"extra_configs": [
{
"config_pair": {
"value": "string",
"key": "string"
}
}
],
"address_bindings": [
{
"vlan": 0,
"ip_address": "string",
"mac_address": "string"
}
]
}
Responses
200
OK
Returns LogicalPort of type(s) application/json
This response body class contains all of the following: ManagedResource , InlineLogicalPort1
{
"_self": {
"action": "string",
"href": "string",
"rel": "string"
},
"_links": [
{
"action": "string",
"href": "string",
"rel": "string"
}
],
"_schema": "string",
"_revision": 0,
"_system_owned": false,
"display_name": "string",
"description": "string",
"tags": [
{
"scope": "string",
"tag": "string"
}
],
"_create_user": "string",
"_protection": "string",
"_create_time": 0,
"_last_modified_time": 0,
"_last_modified_user": "string",
"id": "string",
"resource_type": "string",
"logical_switch_id": "string",
"init_state": "string",
"switching_profile_ids": [
{
"value": "string",
"key": "string"
}
],
"attachment": {
"attachment_type": "string",
"context": {
"allocate_addresses": "string",
"resource_type": "string"
},
"id": "string"
},
"admin_state": "string",
"extra_configs": [
{
"config_pair": {
"value": "string",
"key": "string"
}
}
],
"address_bindings": [
{
"vlan": 0,
"ip_address": "string",
"mac_address": "string"
}
]
}
400
Returns BadRequest of type(s) application/json
This response body class contains all of the following: RelatedApiError , InlineApiError1
{
"module_name": "string",
"error_message": "string",
"error_code": 0,
"details": "string",
"related_errors": [
{
"module_name": "string",
"error_message": "string",
"error_code": 0,
"details": "string"
}
]
}
403
Returns Forbidden of type(s) application/json
This response body class contains all of the following: RelatedApiError , InlineApiError1
{
"module_name": "string",
"error_message": "string",
"error_code": 0,
"details": "string",
"related_errors": [
{
"module_name": "string",
"error_message": "string",
"error_code": 0,
"details": "string"
}
]
}
404
Not Found
Operation doesn't return any data structure
412
Returns PreconditionFailed of type(s) application/json
This response body class contains all of the following: RelatedApiError , InlineApiError1
{
"module_name": "string",
"error_message": "string",
"error_code": 0,
"details": "string",
"related_errors": [
{
"module_name": "string",
"error_message": "string",
"error_code": 0,
"details": "string"
}
]
}
500
Returns InternalServerError of type(s) application/json
This response body class contains all of the following: RelatedApiError , InlineApiError1
{
"module_name": "string",
"error_message": "string",
"error_code": 0,
"details": "string",
"related_errors": [
{
"module_name": "string",
"error_message": "string",
"error_code": 0,
"details": "string"
}
]
}
503
Returns ServiceUnavailable of type(s) application/json
This response body class contains all of the following: RelatedApiError , InlineApiError1
{
"module_name": "string",
"error_message": "string",
"error_code": 0,
"details": "string",
"related_errors": [
{
"module_name": "string",
"error_message": "string",
"error_code": 0,
"details": "string"
}
]
}
On This Page
Logical Switching Operations
POST
Create Logical Port
POST
Create Logical Switch
POST
Create Switching Profile
DELETE
Delete Logical Port
DELETE
Delete Logical Switch
DELETE
Delete Switching Profile
GET
Get Logical Port
GET
Get Logical Port Mac Table
GET
Get Logical Port Mac Table In Csv Format Csv
GET
Get Logical Port Operational Status
GET
Get Logical Port State
GET
Get Logical Port Statistics
GET
Get Logical Port Status Summary
GET
Get Logical Switch
GET
Get Logical Switch Mac Table
GET
Get Logical Switch Mac Table In Csv Format Csv
GET
Get Logical Switch State
GET
Get Logical Switch Statistics
GET
Get Logical Switch Status
GET
Get Logical Switch Status Summary
GET
Get Logical Switch Vtep Table
GET
Get Logical Switch Vtep Table In Csv Format Csv
GET
Get Switching Profile
GET
Get Switching Profile Status
GET
List Logical Ports
GET
List Logical Switches
GET
List Logical Switches By State
GET
List Switching Profiles
PUT
Update Logical Port
PUT
Update Logical Switch
PUT
Update Switching Profile