Configuring PVLAN on a Port Channel Interface
Configuring a VLAN Addition to a PVLAN List
Configuring a VLAN Addition to a PVLAN List
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"children": [
{
"pvlanIf": {
"attributes": {
"if": "po123"
},
"children": [
{
"pvlanAccess": {
"children": [
{
"pvlanAccessPromiscuous": {
"attributes": {
"primaryVlan": "vlan-264",
"secondaryVlans": "2352"
}
}
}
]
}
}
]
}
}
]
}
},
{
"interfaceEntity": {
"children": [
{
"pcAggrIf": {
"attributes": {
"id": "po123",
"layer": "Layer2",
"userCfgdFlags": "admin_layer"
}
}
}
]
}
}
]
}
}
{
imdata:[]
}
<System>
<pvlan-items>
<if-items>
<If-list>
<if>po123</if>
<access-items>
<promiscuous-items>
<primaryVlan>vlan-264</primaryVlan>
<secondaryVlans>2352</secondaryVlans>
</promiscuous-items>
</access-items>
</If-list>
</if-items>
</pvlan-items>
<intf-items>
<aggr-items>
<AggrIf-list>
<id>po123</id>
<layer>Layer2</layer>
<userCfgdFlags>admin_layer</userCfgdFlags>
</AggrIf-list>
</aggr-items>
</intf-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
interface port-channel 123
switchport
switchport private-vlan mapping 264 add 2352
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanIf | sys/pvlan/if-[po123] |
pvlanAccess | sys/pvlan/if-[po123]/access |
pvlanAccessPromiscuous | sys/pvlan/if-[po123]/access/promiscuous |
interfaceEntity | sys/intf |
pcAggrIf | sys/intf/aggr-[po123] |
pvlanIf Properties
The following table contains information about the pvlanIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
if | nw:IfId (base:IfIndex) | Interface id of port with PVLAN | Must match first field in the output of `show intf brief`. Example: Eth1/1 |
pvlanAccessPromiscuous Properties
The following table contains information about the pvlanAccessPromiscuous properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
primaryVlan | base:Encap | Primary VLAN of a PVLAN domain | SELECTION: unknown, vlan-%d or vxlan-%d |
secondaryVlans | l2:VlanBitmap (base:BitArray) | Secondary VLANS of the PVLAN domain | ARRAY SIZE: 4096 |
pcAggrIf Properties
The following table contains information about the pcAggrIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
id | nw:IfId (base:IfIndex) | An identifier . | Must match first field in the output of `show intf brief`. Example: Eth1/1 |
layer | l1:Layer (scalar:Enum8) | Administrative port layer | SELECTION: 1 - Layer2 2 - Layer3 DEFAULT: pltfmDfltLayer |
userCfgdFlags | l1:userCfgdFlags (scalar:Bitmask8) | Port User Config Flags | SELECTION: 0 - none 1 - admin_state 2 - admin_layer 4 - admin_router_mac 8 - admin_dce_mode 16 - admin_mtu DEFAULT: none |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:
Configuring a VLAN Removal from a PVLAN List
Configuring a VLAN Removal from a PVLAN List
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"children": [
{
"pvlanIf": {
"attributes": {
"if": "po123"
},
"children": [
{
"pvlanAccess": {
"children": [
{
"pvlanAccessPromiscuous": {
"attributes": {
"primaryVlan": "vlan-264",
"secondaryVlans": ""
}
}
}
]
}
}
]
}
}
]
}
},
{
"interfaceEntity": {
"children": [
{
"pcAggrIf": {
"attributes": {
"id": "po123",
"layer": "Layer2",
"userCfgdFlags": "admin_layer"
}
}
}
]
}
}
]
}
}
{
imdata:[]
}
<System>
<pvlan-items>
<if-items>
<If-list>
<if>po123</if>
<access-items>
<promiscuous-items>
<primaryVlan>vlan-264</primaryVlan>
<secondaryVlans></secondaryVlans>
</promiscuous-items>
</access-items>
</If-list>
</if-items>
</pvlan-items>
<intf-items>
<aggr-items>
<AggrIf-list>
<id>po123</id>
<layer>Layer2</layer>
<userCfgdFlags>admin_layer</userCfgdFlags>
</AggrIf-list>
</aggr-items>
</intf-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
interface port-channel 123
switchport
switchport private-vlan mapping 264 remove 2352
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanIf | sys/pvlan/if-[po123] |
pvlanAccess | sys/pvlan/if-[po123]/access |
pvlanAccessPromiscuous | sys/pvlan/if-[po123]/access/promiscuous |
interfaceEntity | sys/intf |
pcAggrIf | sys/intf/aggr-[po123] |
pvlanIf Properties
The following table contains information about the pvlanIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
if | nw:IfId (base:IfIndex) | Interface id of port with PVLAN | Must match first field in the output of `show intf brief`. Example: Eth1/1 |
pvlanAccessPromiscuous Properties
The following table contains information about the pvlanAccessPromiscuous properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
primaryVlan | base:Encap | Primary VLAN of a PVLAN domain | SELECTION: unknown, vlan-%d or vxlan-%d |
secondaryVlans | l2:VlanBitmap (base:BitArray) | Secondary VLANS of the PVLAN domain | ARRAY SIZE: 4096 |
pcAggrIf Properties
The following table contains information about the pcAggrIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
id | nw:IfId (base:IfIndex) | An identifier . | Must match first field in the output of `show intf brief`. Example: Eth1/1 |
layer | l1:Layer (scalar:Enum8) | Administrative port layer | SELECTION: 1 - Layer2 2 - Layer3 DEFAULT: pltfmDfltLayer |
userCfgdFlags | l1:userCfgdFlags (scalar:Bitmask8) | Port User Config Flags | SELECTION: 0 - none 1 - admin_state 2 - admin_layer 4 - admin_router_mac 8 - admin_dce_mode 16 - admin_mtu DEFAULT: none |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:
Configuring a VLAN Addition to a PVLAN List
Configuring a VLAN Addition to a PVLAN List
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"children": [
{
"pvlanIf": {
"attributes": {
"if": "po123"
},
"children": [
{
"pvlanTrunk": {
"children": [
{
"pvlanTrunkPromiscuousTable": {
"children": [
{
"pvlanTrunkPromiscuousEntry": {
"attributes": {
"primaryVlan": "vlan-2643",
"secondaryVlans": "3637-3638"
}
}
}
]
}
}
]
}
}
]
}
}
]
}
},
{
"interfaceEntity": {
"children": [
{
"pcAggrIf": {
"attributes": {
"id": "po123",
"layer": "Layer2",
"userCfgdFlags": "admin_layer"
}
}
}
]
}
}
]
}
}
{
imdata:[]
}
<System>
<pvlan-items>
<if-items>
<If-list>
<if>po123</if>
<trunk-items>
<promiscuous-items>
<primary-items>
<TrunkPromiscuousEntry-list>
<primaryVlan>vlan-2643</primaryVlan>
<secondaryVlans>3637-3638</secondaryVlans>
</TrunkPromiscuousEntry-list>
</primary-items>
</promiscuous-items>
</trunk-items>
</If-list>
</if-items>
</pvlan-items>
<intf-items>
<aggr-items>
<AggrIf-list>
<id>po123</id>
<layer>Layer2</layer>
<userCfgdFlags>admin_layer</userCfgdFlags>
</AggrIf-list>
</aggr-items>
</intf-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
interface port-channel 123
switchport
switchport private-vlan mapping trunk 2643 add 3638
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanIf | sys/pvlan/if-[po123] |
pvlanTrunk | sys/pvlan/if-[po123]/trunk |
pvlanTrunkPromiscuousTable | sys/pvlan/if-[po123]/trunk/promiscuous |
pvlanTrunkPromiscuousEntry | sys/pvlan/if-[po123]/trunk/promiscuous/primary-[vlan-2643] |
interfaceEntity | sys/intf |
pcAggrIf | sys/intf/aggr-[po123] |
pvlanIf Properties
The following table contains information about the pvlanIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
if | nw:IfId (base:IfIndex) | Interface id of port with PVLAN | Must match first field in the output of `show intf brief`. Example: Eth1/1 |
pvlanTrunkPromiscuousEntry Properties
The following table contains information about the pvlanTrunkPromiscuousEntry properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
primaryVlan | base:Encap | Primary VLAN of a PVLAN domain | SELECTION: unknown, vlan-%d or vxlan-%d |
secondaryVlans | l2:VlanBitmap (base:BitArray) | Secondary VLANS of the PVLAN domain | ARRAY SIZE: 4096 |
pcAggrIf Properties
The following table contains information about the pcAggrIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
id | nw:IfId (base:IfIndex) | An identifier . | Must match first field in the output of `show intf brief`. Example: Eth1/1 |
layer | l1:Layer (scalar:Enum8) | Administrative port layer | SELECTION: 1 - Layer2 2 - Layer3 DEFAULT: pltfmDfltLayer |
userCfgdFlags | l1:userCfgdFlags (scalar:Bitmask8) | Port User Config Flags | SELECTION: 0 - none 1 - admin_state 2 - admin_layer 4 - admin_router_mac 8 - admin_dce_mode 16 - admin_mtu DEFAULT: none |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:
Deleting a VLAN Addition to a PVLAN List
Deleting a VLAN Addition to a PVLAN List
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"children": [
{
"pvlanIf": {
"attributes": {
"if": "po123"
},
"children": [
{
"pvlanTrunk": {
"children": [
{
"pvlanTrunkPromiscuousTable": {
"children": [
{
"pvlanTrunkPromiscuousEntry": {
"attributes": {
"primaryVlan": "vlan-2643",
"status": "deleted"
}
}
}
]
}
}
]
}
}
]
}
}
]
}
},
{
"interfaceEntity": {
"children": [
{
"pcAggrIf": {
"attributes": {
"id": "po123",
"layer": "Layer2",
"userCfgdFlags": "admin_layer"
}
}
}
]
}
}
]
}
}
{
imdata:[]
}
<System>
<pvlan-items>
<if-items>
<If-list>
<if>po123</if>
<trunk-items>
<promiscuous-items>
<primary-items>
<TrunkPromiscuousEntry-list nc:operation="delete">
<primaryVlan>vlan-2643</primaryVlan>
</TrunkPromiscuousEntry-list>
</primary-items>
</promiscuous-items>
</trunk-items>
</If-list>
</if-items>
</pvlan-items>
<intf-items>
<aggr-items>
<AggrIf-list>
<id>po123</id>
<layer>Layer2</layer>
<userCfgdFlags>admin_layer</userCfgdFlags>
</AggrIf-list>
</aggr-items>
</intf-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
interface port-channel 123
switchport
no switchport private-vlan mapping trunk 2643 add 3638
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanIf | sys/pvlan/if-[po123] |
pvlanTrunk | sys/pvlan/if-[po123]/trunk |
pvlanTrunkPromiscuousTable | sys/pvlan/if-[po123]/trunk/promiscuous |
pvlanTrunkPromiscuousEntry | sys/pvlan/if-[po123]/trunk/promiscuous/primary-[vlan-2643] |
interfaceEntity | sys/intf |
pcAggrIf | sys/intf/aggr-[po123] |
pvlanIf Properties
The following table contains information about the pvlanIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
if | nw:IfId (base:IfIndex) | Interface id of port with PVLAN | Must match first field in the output of `show intf brief`. Example: Eth1/1 |
pvlanTrunkPromiscuousEntry Properties
The following table contains information about the pvlanTrunkPromiscuousEntry properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
primaryVlan | base:Encap | Primary VLAN of a PVLAN domain | SELECTION: unknown, vlan-%d or vxlan-%d |
status | mo:ModificationStatus (scalar:Bitmask32) | The upgrade status. This property is for internal use only. | SELECTION: 2 - created 4 - modified 8 - deleted 16 - replaced |
pcAggrIf Properties
The following table contains information about the pcAggrIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
id | nw:IfId (base:IfIndex) | An identifier . | Must match first field in the output of `show intf brief`. Example: Eth1/1 |
layer | l1:Layer (scalar:Enum8) | Administrative port layer | SELECTION: 1 - Layer2 2 - Layer3 DEFAULT: pltfmDfltLayer |
userCfgdFlags | l1:userCfgdFlags (scalar:Bitmask8) | Port User Config Flags | SELECTION: 0 - none 1 - admin_state 2 - admin_layer 4 - admin_router_mac 8 - admin_dce_mode 16 - admin_mtu DEFAULT: none |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:
Configuring a VLAN Removal from a PVLAN List
Configuring a VLAN Removal from a PVLAN List
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"children": [
{
"pvlanIf": {
"attributes": {
"if": "po123"
},
"children": [
{
"pvlanTrunk": {
"children": [
{
"pvlanTrunkPromiscuousTable": {
"children": [
{
"pvlanTrunkPromiscuousEntry": {
"attributes": {
"primaryVlan": "vlan-2643",
"secondaryVlans": "3637"
}
}
}
]
}
}
]
}
}
]
}
}
]
}
},
{
"interfaceEntity": {
"children": [
{
"pcAggrIf": {
"attributes": {
"id": "po123",
"layer": "Layer2",
"userCfgdFlags": "admin_layer"
}
}
}
]
}
}
]
}
}
{
imdata:[]
}
<System>
<pvlan-items>
<if-items>
<If-list>
<if>po123</if>
<trunk-items>
<promiscuous-items>
<primary-items>
<TrunkPromiscuousEntry-list>
<primaryVlan>vlan-2643</primaryVlan>
<secondaryVlans>3637</secondaryVlans>
</TrunkPromiscuousEntry-list>
</primary-items>
</promiscuous-items>
</trunk-items>
</If-list>
</if-items>
</pvlan-items>
<intf-items>
<aggr-items>
<AggrIf-list>
<id>po123</id>
<layer>Layer2</layer>
<userCfgdFlags>admin_layer</userCfgdFlags>
</AggrIf-list>
</aggr-items>
</intf-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
interface port-channel 123
switchport
switchport private-vlan mapping trunk 2643 remove 3638
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanIf | sys/pvlan/if-[po123] |
pvlanTrunk | sys/pvlan/if-[po123]/trunk |
pvlanTrunkPromiscuousTable | sys/pvlan/if-[po123]/trunk/promiscuous |
pvlanTrunkPromiscuousEntry | sys/pvlan/if-[po123]/trunk/promiscuous/primary-[vlan-2643] |
interfaceEntity | sys/intf |
pcAggrIf | sys/intf/aggr-[po123] |
pvlanIf Properties
The following table contains information about the pvlanIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
if | nw:IfId (base:IfIndex) | Interface id of port with PVLAN | Must match first field in the output of `show intf brief`. Example: Eth1/1 |
pvlanTrunkPromiscuousEntry Properties
The following table contains information about the pvlanTrunkPromiscuousEntry properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
primaryVlan | base:Encap | Primary VLAN of a PVLAN domain | SELECTION: unknown, vlan-%d or vxlan-%d |
secondaryVlans | l2:VlanBitmap (base:BitArray) | Secondary VLANS of the PVLAN domain | ARRAY SIZE: 4096 |
pcAggrIf Properties
The following table contains information about the pcAggrIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
id | nw:IfId (base:IfIndex) | An identifier . | Must match first field in the output of `show intf brief`. Example: Eth1/1 |
layer | l1:Layer (scalar:Enum8) | Administrative port layer | SELECTION: 1 - Layer2 2 - Layer3 DEFAULT: pltfmDfltLayer |
userCfgdFlags | l1:userCfgdFlags (scalar:Bitmask8) | Port User Config Flags | SELECTION: 0 - none 1 - admin_state 2 - admin_layer 4 - admin_router_mac 8 - admin_dce_mode 16 - admin_mtu DEFAULT: none |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:
Deleting a VLAN Removal from a PVLAN List
Deleting a VLAN Removal from a PVLAN List
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"children": [
{
"pvlanIf": {
"attributes": {
"if": "po123"
},
"children": [
{
"pvlanTrunk": {
"children": [
{
"pvlanTrunkPromiscuousTable": {
"children": [
{
"pvlanTrunkPromiscuousEntry": {
"attributes": {
"primaryVlan": "vlan-2643",
"status": "deleted"
}
}
}
]
}
}
]
}
}
]
}
}
]
}
},
{
"interfaceEntity": {
"children": [
{
"pcAggrIf": {
"attributes": {
"id": "po123",
"layer": "Layer2",
"userCfgdFlags": "admin_layer"
}
}
}
]
}
}
]
}
}
{
imdata:[]
}
<System>
<pvlan-items>
<if-items>
<If-list>
<if>po123</if>
<trunk-items>
<promiscuous-items>
<primary-items>
<TrunkPromiscuousEntry-list nc:operation="delete">
<primaryVlan>vlan-2643</primaryVlan>
</TrunkPromiscuousEntry-list>
</primary-items>
</promiscuous-items>
</trunk-items>
</If-list>
</if-items>
</pvlan-items>
<intf-items>
<aggr-items>
<AggrIf-list>
<id>po123</id>
<layer>Layer2</layer>
<userCfgdFlags>admin_layer</userCfgdFlags>
</AggrIf-list>
</aggr-items>
</intf-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
interface port-channel 123
switchport
no switchport private-vlan mapping trunk 2643 remove 3638
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanIf | sys/pvlan/if-[po123] |
pvlanTrunk | sys/pvlan/if-[po123]/trunk |
pvlanTrunkPromiscuousTable | sys/pvlan/if-[po123]/trunk/promiscuous |
pvlanTrunkPromiscuousEntry | sys/pvlan/if-[po123]/trunk/promiscuous/primary-[vlan-2643] |
interfaceEntity | sys/intf |
pcAggrIf | sys/intf/aggr-[po123] |
pvlanIf Properties
The following table contains information about the pvlanIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
if | nw:IfId (base:IfIndex) | Interface id of port with PVLAN | Must match first field in the output of `show intf brief`. Example: Eth1/1 |
pvlanTrunkPromiscuousEntry Properties
The following table contains information about the pvlanTrunkPromiscuousEntry properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
primaryVlan | base:Encap | Primary VLAN of a PVLAN domain | SELECTION: unknown, vlan-%d or vxlan-%d |
status | mo:ModificationStatus (scalar:Bitmask32) | The upgrade status. This property is for internal use only. | SELECTION: 2 - created 4 - modified 8 - deleted 16 - replaced |
pcAggrIf Properties
The following table contains information about the pcAggrIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
id | nw:IfId (base:IfIndex) | An identifier . | Must match first field in the output of `show intf brief`. Example: Eth1/1 |
layer | l1:Layer (scalar:Enum8) | Administrative port layer | SELECTION: 1 - Layer2 2 - Layer3 DEFAULT: pltfmDfltLayer |
userCfgdFlags | l1:userCfgdFlags (scalar:Bitmask8) | Port User Config Flags | SELECTION: 0 - none 1 - admin_state 2 - admin_layer 4 - admin_router_mac 8 - admin_dce_mode 16 - admin_mtu DEFAULT: none |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:
Configuring PVLANs on FEX Trunk Ports
Configuring PVLANs on FEX Trunk Ports
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"attributes": {
"fexTrunk": "enabled"
}}}]}}
{
imdata:[]
}
<System>
<pvlan-items>
<fexTrunk>enabled</fexTrunk>
</pvlan-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
system private-vlan fex trunk
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanPrivateVlan Properties
The following table contains information about the pvlanPrivateVlan properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
fexTrunk | nw:AdminSt (scalar:Enum8) | Enable or disable PVLANs for FEX trunk | SELECTION: 1 - enabled 2 - disabled DEFAULT: disabled |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:
Deleting PVLANs on FEX Trunk Ports
Deleting PVLANs on FEX Trunk Ports
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"attributes": {
"fexTrunk": "disabled"
}}}]}}
{
imdata:[]
}
<System>
<pvlan-items>
<fexTrunk>disabled</fexTrunk>
</pvlan-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
no system private-vlan fex trunk
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanPrivateVlan Properties
The following table contains information about the pvlanPrivateVlan properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
fexTrunk | nw:AdminSt (scalar:Enum8) | Enable or disable PVLANs for FEX trunk | SELECTION: 1 - enabled 2 - disabled DEFAULT: disabled |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:
Configuring Private-VLAN Trunk Secondary
Configuring Private-VLAN Trunk Secondary
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"children": [
{
"pvlanIf": {
"attributes": {
"if": "po123"
},
"children": [
{
"pvlanTrunk": {
"children": [
{
"pvlanTrunkSecondaryTable": {
"children": [
{
"pvlanTrunkSecondaryEntry": {
"attributes": {
"primaryVlan": "vlan-500",
"secondaryVlan": "vlan-600"
}
}
}
]
}
}
]
}
}
]
}
}
]
}
},
{
"interfaceEntity": {
"children": [
{
"pcAggrIf": {
"attributes": {
"id": "po123",
"layer": "Layer2",
"userCfgdFlags": "admin_layer"
}
}
}
]
}
}
]
}
}
{
imdata:[]
}
<System>
<pvlan-items>
<if-items>
<If-list>
<if>po123</if>
<trunk-items>
<secondary-items>
<primary-items>
<TrunkSecondaryEntry-list>
<primaryVlan>vlan-500</primaryVlan>
<secondaryVlan>vlan-600</secondaryVlan>
</TrunkSecondaryEntry-list>
</primary-items>
</secondary-items>
</trunk-items>
</If-list>
</if-items>
</pvlan-items>
<intf-items>
<aggr-items>
<AggrIf-list>
<id>po123</id>
<layer>Layer2</layer>
<userCfgdFlags>admin_layer</userCfgdFlags>
</AggrIf-list>
</aggr-items>
</intf-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
interface port-channel 123
switchport
switchport private-vlan association trunk 500 600
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanIf | sys/pvlan/if-[po123] |
pvlanTrunk | sys/pvlan/if-[po123]/trunk |
pvlanTrunkSecondaryTable | sys/pvlan/if-[po123]/trunk/secondary |
pvlanTrunkSecondaryEntry | sys/pvlan/if-[po123]/trunk/secondary/primary-[vlan-591] |
interfaceEntity | sys/intf |
pcAggrIf | sys/intf/aggr-[po123] |
pvlanIf Properties
The following table contains information about the pvlanIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
if | nw:IfId (base:IfIndex) | Interface id of port with PVLAN | Must match first field in the output of `show intf brief`. Example: Eth1/1 |
pvlanTrunkSecondaryEntry Properties
The following table contains information about the pvlanTrunkSecondaryEntry properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
primaryVlan | base:Encap | Primary VLAN of a PVLAN domain | SELECTION: unknown, vlan-%d or vxlan-%d |
secondaryVlan | base:Encap | Secondary VLAN of the PVLAN domain | SELECTION: unknown, vlan-%d or vxlan-%d |
pcAggrIf Properties
The following table contains information about the pcAggrIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
id | nw:IfId (base:IfIndex) | An identifier . | Must match first field in the output of `show intf brief`. Example: Eth1/1 |
layer | l1:Layer (scalar:Enum8) | Administrative port layer | SELECTION: 1 - Layer2 2 - Layer3 DEFAULT: pltfmDfltLayer |
userCfgdFlags | l1:userCfgdFlags (scalar:Bitmask8) | Port User Config Flags | SELECTION: 0 - none 1 - admin_state 2 - admin_layer 4 - admin_router_mac 8 - admin_dce_mode 16 - admin_mtu DEFAULT: none |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:
Deleting Private-VLAN Trunk Secondary
Deleting Private-VLAN Trunk Secondary
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"children": [
{
"pvlanIf": {
"attributes": {
"if": "po123"
},
"children": [
{
"pvlanTrunk": {
"children": [
{
"pvlanTrunkSecondaryTable": {
"children": [
{
"pvlanTrunkSecondaryEntry": {
"attributes": {
"primaryVlan": "vlan-500",
"status": "deleted"
}
}
}
]
}
}
]
}
}
]
}
}
]
}
},
{
"interfaceEntity": {
"children": [
{
"pcAggrIf": {
"attributes": {
"id": "po123",
"layer": "Layer2",
"userCfgdFlags": "admin_layer"
}
}
}
]
}
}
]
}
}
{
imdata:[]
}
<System>
<pvlan-items>
<if-items>
<If-list>
<if>po123</if>
<trunk-items>
<secondary-items>
<primary-items>
<TrunkSecondaryEntry-list nc:operation="delete">
<primaryVlan>vlan-500</primaryVlan>
</TrunkSecondaryEntry-list>
</primary-items>
</secondary-items>
</trunk-items>
</If-list>
</if-items>
</pvlan-items>
<intf-items>
<aggr-items>
<AggrIf-list>
<id>po123</id>
<layer>Layer2</layer>
<userCfgdFlags>admin_layer</userCfgdFlags>
</AggrIf-list>
</aggr-items>
</intf-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
interface port-channel 123
switchport
no switchport private-vlan association trunk 500 600
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanIf | sys/pvlan/if-[po123] |
pvlanTrunk | sys/pvlan/if-[po123]/trunk |
pvlanTrunkSecondaryTable | sys/pvlan/if-[po123]/trunk/secondary |
pvlanTrunkSecondaryEntry | sys/pvlan/if-[po123]/trunk/secondary/primary-[vlan-591] |
interfaceEntity | sys/intf |
pcAggrIf | sys/intf/aggr-[po123] |
pvlanIf Properties
The following table contains information about the pvlanIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
if | nw:IfId (base:IfIndex) | Interface id of port with PVLAN | Must match first field in the output of `show intf brief`. Example: Eth1/1 |
pvlanTrunkSecondaryEntry Properties
The following table contains information about the pvlanTrunkSecondaryEntry properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
primaryVlan | base:Encap | Primary VLAN of a PVLAN domain | SELECTION: unknown, vlan-%d or vxlan-%d |
status | mo:ModificationStatus (scalar:Bitmask32) | The upgrade status. This property is for internal use only. | SELECTION: 2 - created 4 - modified 8 - deleted 16 - replaced |
pcAggrIf Properties
The following table contains information about the pcAggrIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
id | nw:IfId (base:IfIndex) | An identifier . | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
layer | l1:Layer (scalar:Enum8) | Administrative port layer | SELECTION: 1 - Layer2 2 - Layer3 DEFAULT: pltfmDfltLayer |
userCfgdFlags | l1:userCfgdFlags (scalar:Bitmask8) | Port User Config Flags | SELECTION: 0 - none 1 - admin_state 2 - admin_layer 4 - admin_router_mac 8 - admin_dce_mode 16 - admin_mtu DEFAULT: none |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:
Configuring the Private VLAN Host Association
Configuring the Private VLAN Host Association
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"children": [
{
"pvlanIf": {
"attributes": {
"if": "po123"
},
"children": [
{
"pvlanAccess": {
"children": [
{
"pvlanAccessSecondary": {
"attributes": {
"primaryVlan": "vlan-1200",
"secondaryVlan": "vlan-1300"
}
}
}
]
}
}
]
}
}
]
}
},
{
"interfaceEntity": {
"children": [
{
"pcAggrIf": {
"attributes": {
"id": "po123",
"layer": "Layer2",
"userCfgdFlags": "admin_layer"
}
}
}
]
}
}
]
}
}
{
imdata:[]
}
<System>
<pvlan-items>
<if-items>
<If-list>
<if>po123</if>
<access-items>
<secondary-items>
<primaryVlan>vlan-1200</primaryVlan>
<secondaryVlan>vlan-1300</secondaryVlan>
</secondary-items>
</access-items>
</If-list>
</if-items>
</pvlan-items>
<intf-items>
<aggr-items>
<AggrIf-list>
<id>po123</id>
<layer>Layer2</layer>
<userCfgdFlags>admin_layer</userCfgdFlags>
</AggrIf-list>
</aggr-items>
</intf-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
interface port-channel 123
switchport
switchport private-vlan host-association 1200 1300
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanIf | sys/pvlan/if-[po123] |
pvlanAccess | sys/pvlan/if-[po123]/access |
pvlanAccessSecondary | sys/pvlan/if-[po123]/access/secondary |
interfaceEntity | sys/intf |
pcAggrIf | sys/intf/aggr-[po123] |
pvlanIf Properties
The following table contains information about the pvlanIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
if | nw:IfId (base:IfIndex) | Interface id of port with PVLAN | Must match first field in the output of `show intf brief`. Example: Eth1/1 |
pvlanAccessSecondary Properties
The following table contains information about the pvlanAccessSecondary properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
primaryVlan | base:Encap | Primary VLAN of a PVLAN domain | SELECTION: unknown, vlan-%d or vxlan-%d |
secondaryVlan | base:Encap | Secondary VLAN of the PVLAN domain | SELECTION: unknown, vlan-%d or vxlan-%d |
pcAggrIf Properties
The following table contains information about the pcAggrIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
id | nw:IfId (base:IfIndex) | An identifier . | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
layer | l1:Layer (scalar:Enum8) | Administrative port layer | SELECTION: 1 - Layer2 2 - Layer3 DEFAULT: pltfmDfltLayer |
userCfgdFlags | l1:userCfgdFlags (scalar:Bitmask8) | Port User Config Flags | SELECTION: 0 - none 1 - admin_state 2 - admin_layer 4 - admin_router_mac 8 - admin_dce_mode 16 - admin_mtu DEFAULT: none |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:
Deleting the Private VLAN Host Association
Deleting the Private VLAN Host Association
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"children": [
{
"pvlanIf": {
"attributes": {
"if": "po123"
},
"children": [
{
"pvlanAccess": {
"children": [
{
"pvlanAccessSecondary": {
"attributes": {
"status": "deleted"
}
}
}
]
}
}
]
}
}
]
}
},
{
"interfaceEntity": {
"children": [
{
"pcAggrIf": {
"attributes": {
"id": "po123",
"layer": "Layer2",
"userCfgdFlags": "admin_layer"
}
}
}
]
}
}
]
}
}
{
imdata:[]
}
<System>
<pvlan-items>
<if-items>
<If-list>
<if>po123</if>
<access-items>
<secondary-items nc:operation="delete">
</secondary-items>
</access-items>
</If-list>
</if-items>
</pvlan-items>
<intf-items>
<aggr-items>
<AggrIf-list>
<id>po123</id>
<layer>Layer2</layer>
<userCfgdFlags>admin_layer</userCfgdFlags>
</AggrIf-list>
</aggr-items>
</intf-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
interface port-channel 123
switchport
no switchport private-vlan host-association 1200 1300
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanIf | sys/pvlan/if-[po123] |
pvlanAccess | sys/pvlan/if-[po123]/access |
pvlanAccessSecondary | sys/pvlan/if-[po123]/access/secondary |
interfaceEntity | sys/intf |
pcAggrIf | sys/intf/aggr-[po123] |
pvlanIf Properties
The following table contains information about the pvlanIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
if | nw:IfId (base:IfIndex) | Interface id of port with PVLAN | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
pvlanAccessSecondary Properties
The following table contains information about the pvlanAccessSecondary properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
status | mo:ModificationStatus (scalar:Bitmask32) | The upgrade status. This property is for internal use only. | SELECTION: 2 - created 4 - modified 8 - deleted 16 - replaced |
pcAggrIf Properties
The following table contains information about the pcAggrIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
id | nw:IfId (base:IfIndex) | An identifier . | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
layer | l1:Layer (scalar:Enum8) | Administrative port layer | SELECTION: 1 - Layer2 2 - Layer3 DEFAULT: pltfmDfltLayer |
userCfgdFlags | l1:userCfgdFlags (scalar:Bitmask8) | Port User Config Flags | SELECTION: 0 - none 1 - admin_state 2 - admin_layer 4 - admin_router_mac 8 - admin_dce_mode 16 - admin_mtu DEFAULT: none |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:
Setting Private VLAN Trunking Native Configuration
Setting Private VLAN Trunking Native Configuration
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"children": [
{
"pvlanIf": {
"attributes": {
"if": "po123"
},
"children": [
{
"pvlanTrunk": {
"attributes": {
"nativeVlan": "vlan-3238"
}
}
}
]
}
}
]
}
},
{
"interfaceEntity": {
"children": [
{
"pcAggrIf": {
"attributes": {
"id": "po123",
"layer": "Layer2",
"userCfgdFlags": "admin_layer"
}
}
}
]
}
}
]
}
}
{
imdata:[]
}
<System>
<pvlan-items>
<if-items>
<If-list>
<if>po123</if>
<trunk-items>
<nativeVlan>vlan-3238</nativeVlan>
</trunk-items>
</If-list>
</if-items>
</pvlan-items>
<intf-items>
<aggr-items>
<AggrIf-list>
<id>po123</id>
<layer>Layer2</layer>
<userCfgdFlags>admin_layer</userCfgdFlags>
</AggrIf-list>
</aggr-items>
</intf-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
interface port-channel 123
switchport
switchport private-vlan trunk native vlan 3238
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanIf | sys/pvlan/if-[po123] |
pvlanTrunk | sys/pvlan/if-[po123]/trunk |
interfaceEntity | sys/intf |
pcAggrIf | sys/intf/aggr-[po123] |
pvlanIf Properties
The following table contains information about the pvlanIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
if | nw:IfId (base:IfIndex) | Interface id of port with PVLAN | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
pvlanTrunk Properties
The following table contains information about the pvlanTrunk properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
nativeVlan | base:Encap | Native VLAN on PVLAN trunk | SELECTION: unknown, vlan-%d or vxlan-%d DEFAULT: vlan-1 |
pcAggrIf Properties
The following table contains information about the pcAggrIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
id | nw:IfId (base:IfIndex) | An identifier . | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
layer | l1:Layer (scalar:Enum8) | Administrative port layer | SELECTION: 1 - Layer2 2 - Layer3 DEFAULT: pltfmDfltLayer |
userCfgdFlags | l1:userCfgdFlags (scalar:Bitmask8) | Port User Config Flags | SELECTION: 0 - none 1 - admin_state 2 - admin_layer 4 - admin_router_mac 8 - admin_dce_mode 16 - admin_mtu DEFAULT: none |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:
Unsetting Private VLAN Trunking Native Configuration
Unsetting Private VLAN Trunking Native Configuration
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"children": [
{
"pvlanIf": {
"attributes": {
"if": "po123"
},
"children": [
{
"pvlanTrunk": {
"attributes": {
"nativeVlan": "vlan-1"
}
}
}
]
}
}
]
}
},
{
"interfaceEntity": {
"children": [
{
"pcAggrIf": {
"attributes": {
"id": "po123",
"layer": "Layer2",
"userCfgdFlags": "admin_layer"
}
}
}
]
}
}
]
}
}
{
imdata:[]
}
<System>
<pvlan-items>
<if-items>
<If-list>
<if>po123</if>
<trunk-items>
<nativeVlan>vlan-1</nativeVlan>
</trunk-items>
</If-list>
</if-items>
</pvlan-items>
<intf-items>
<aggr-items>
<AggrIf-list>
<id>po123</id>
<layer>Layer2</layer>
<userCfgdFlags>admin_layer</userCfgdFlags>
</AggrIf-list>
</aggr-items>
</intf-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
interface port-channel 123
switchport
no switchport private-vlan trunk native vlan 3238
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanIf | sys/pvlan/if-[po123] |
pvlanTrunk | sys/pvlan/if-[po123]/trunk |
interfaceEntity | sys/intf |
pcAggrIf | sys/intf/aggr-[po123] |
pvlanIf Properties
The following table contains information about the pvlanIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
if | nw:IfId (base:IfIndex) | Interface id of port with PVLAN | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
pvlanTrunk Properties
The following table contains information about the pvlanTrunk properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
nativeVlan | base:Encap | Native VLAN on PVLAN trunk | SELECTION: unknown, vlan-%d or vxlan-%d DEFAULT: vlan-1 |
pcAggrIf Properties
The following table contains information about the pcAggrIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
id | nw:IfId (base:IfIndex) | An identifier . | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
layer | l1:Layer (scalar:Enum8) | Administrative port layer | SELECTION: 1 - Layer2 2 - Layer3 DEFAULT: pltfmDfltLayer |
userCfgdFlags | l1:userCfgdFlags (scalar:Bitmask8) | Port User Config Flags | SELECTION: 0 - none 1 - admin_state 2 - admin_layer 4 - admin_router_mac 8 - admin_dce_mode 16 - admin_mtu DEFAULT: none |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:
Configuring a Trunk-Allowed VLAN List
Configuring a Trunk-Allowed VLAN List
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"children": [
{
"pvlanIf": {
"attributes": {
"if": "po123"
},
"children": [
{
"pvlanTrunk": {
"attributes": {
"trunkAllowedVlans": "3404"
}
}
}
]
}
}
]
}
},
{
"interfaceEntity": {
"children": [
{
"pcAggrIf": {
"attributes": {
"id": "po123",
"layer": "Layer2",
"userCfgdFlags": "admin_layer"
}
}
}
]
}
}
]
}
}
{
imdata:[]
}
<System>
<pvlan-items>
<if-items>
<If-list>
<if>po123</if>
<trunk-items>
<trunkAllowedVlans>3404</trunkAllowedVlans>
</trunk-items>
</If-list>
</if-items>
</pvlan-items>
<intf-items>
<aggr-items>
<AggrIf-list>
<id>po123</id>
<layer>Layer2</layer>
<userCfgdFlags>admin_layer</userCfgdFlags>
</AggrIf-list>
</aggr-items>
</intf-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
interface port-channel 123
switchport
switchport private-vlan trunk allowed vlan add 3404
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanIf | sys/pvlan/if-[po123] |
pvlanTrunk | sys/pvlan/if-[po123]/trunk |
interfaceEntity | sys/intf |
pcAggrIf | sys/intf/aggr-[po123] |
pvlanIf Properties
The following table contains information about the pvlanIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
if | nw:IfId (base:IfIndex) | Interface id of port with PVLAN | Must match first field in the output of `show intf brief`. Example: Eth1/1 |
pvlanTrunk Properties
The following table contains information about the pvlanTrunk properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
trunkAllowedVlans | l2:VlanBitmap (base:BitArray) | Trunk Allowed VLANs on PVLAN trunk | ARRAY SIZE: 4096 |
pcAggrIf Properties
The following table contains information about the pcAggrIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
id | nw:IfId (base:IfIndex) | An identifier . | Must match first field in the output of `show intf brief`. Example: Eth1/1 |
layer | l1:Layer (scalar:Enum8) | Administrative port layer | SELECTION: 1 - Layer2 2 - Layer3 DEFAULT: pltfmDfltLayer |
userCfgdFlags | l1:userCfgdFlags (scalar:Bitmask8) | Port User Config Flags | SELECTION: 0 - none 1 - admin_state 2 - admin_layer 4 - admin_router_mac 8 - admin_dce_mode 16 - admin_mtu DEFAULT: none |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:
Deleting a Trunk-Allowed VLAN List
Deleting a Trunk-Allowed VLAN List
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"children": [
{
"pvlanIf": {
"attributes": {
"if": "po123"
},
"children": [
{
"pvlanTrunk": {
"attributes": {
"trunkAllowedVlans": ""
}
}
}
]
}
}
]
}
},
{
"interfaceEntity": {
"children": [
{
"pcAggrIf": {
"attributes": {
"id": "po123",
"layer": "Layer2",
"userCfgdFlags": "admin_layer"
}
}
}
]
}
}
]
}
}
{
imdata:[]
}
<System>
<pvlan-items>
<if-items>
<If-list>
<if>po123</if>
<trunk-items>
<trunkAllowedVlans></trunkAllowedVlans>
</trunk-items>
</If-list>
</if-items>
</pvlan-items>
<intf-items>
<aggr-items>
<AggrIf-list>
<id>po123</id>
<layer>Layer2</layer>
<userCfgdFlags>admin_layer</userCfgdFlags>
</AggrIf-list>
</aggr-items>
</intf-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
interface port-channel 123
switchport
no switchport private-vlan trunk allowed vlan 3404
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanIf | sys/pvlan/if-[po123] |
pvlanTrunk | sys/pvlan/if-[po123]/trunk |
interfaceEntity | sys/intf |
pcAggrIf | sys/intf/aggr-[po123] |
pvlanIf Properties
The following table contains information about the pvlanIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
if | nw:IfId (base:IfIndex) | Interface id of port with PVLAN | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
pvlanTrunk Properties
The following table contains information about the pvlanTrunk properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
trunkAllowedVlans | l2:VlanBitmap (base:BitArray) | Trunk Allowed VLANs on PVLAN trunk | ARRAY SIZE: 4096 |
pcAggrIf Properties
The following table contains information about the pcAggrIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
id | nw:IfId (base:IfIndex) | An identifier . | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
layer | l1:Layer (scalar:Enum8) | Administrative port layer | SELECTION: 1 - Layer2 2 - Layer3 DEFAULT: pltfmDfltLayer |
userCfgdFlags | l1:userCfgdFlags (scalar:Bitmask8) | Port User Config Flags | SELECTION: 0 - none 1 - admin_state 2 - admin_layer 4 - admin_router_mac 8 - admin_dce_mode 16 - admin_mtu DEFAULT: none |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:
Configuring VLAN Exceptions (Trunk-Allowed VLAN List)
Configuring VLAN Exceptions (Trunk-Allowed VLAN List)
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"children": [
{
"pvlanIf": {
"attributes": {
"if": "po123"
},
"children": [
{
"pvlanTrunk": {
"attributes": {
"trunkAllowedVlans": "1-3403,3405-4094"
}
}
}
]
}
}
]
}
},
{
"interfaceEntity": {
"children": [
{
"pcAggrIf": {
"attributes": {
"id": "po123",
"layer": "Layer2",
"userCfgdFlags": "admin_layer"
}
}
}
]
}
}
]
}
}
{
imdata:[]
}
<System>
<pvlan-items>
<if-items>
<If-list>
<if>po123</if>
<trunk-items>
<trunkAllowedVlans>1-3403,3405-4094</trunkAllowedVlans>
</trunk-items>
</If-list>
</if-items>
</pvlan-items>
<intf-items>
<aggr-items>
<AggrIf-list>
<id>po123</id>
<layer>Layer2</layer>
<userCfgdFlags>admin_layer</userCfgdFlags>
</AggrIf-list>
</aggr-items>
</intf-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
interface port-channel 123
switchport
switchport private-vlan trunk allowed vlan except 3404
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanIf | sys/pvlan/if-[po123] |
pvlanTrunk | sys/pvlan/if-[po123]/trunk |
interfaceEntity | sys/intf |
pcAggrIf | sys/intf/aggr-[po123] |
pvlanIf Properties
The following table contains information about the pvlanIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
if | nw:IfId (base:IfIndex) | Interface id of port with PVLAN | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
pvlanTrunk Properties
The following table contains information about the pvlanTrunk properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
trunkAllowedVlans | l2:VlanBitmap (base:BitArray) | Trunk Allowed VLANs on PVLAN trunk | ARRAY SIZE: 4096 |
pcAggrIf Properties
The following table contains information about the pcAggrIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
id | nw:IfId (base:IfIndex) | An identifier . | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
layer | l1:Layer (scalar:Enum8) | Administrative port layer | SELECTION: 1 - Layer2 2 - Layer3 DEFAULT: pltfmDfltLayer |
userCfgdFlags | l1:userCfgdFlags (scalar:Bitmask8) | Port User Config Flags | SELECTION: 0 - none 1 - admin_state 2 - admin_layer 4 - admin_router_mac 8 - admin_dce_mode 16 - admin_mtu DEFAULT: none |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:
Setting Allowed VLANs when Interface is in Private-VLAN Trunking Mode (Trunk-Allowed VLAN List)
Setting Allowed VLANs when Interface is in Private-VLAN Trunking Mode (Trunk-Allowed VLAN List)
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"children": [
{
"pvlanIf": {
"attributes": {
"if": "po123"
},
"children": [
{
"pvlanTrunk": {
"attributes": {
"trunkAllowedVlans": ""
}
}
}
]
}
}
]
}
},
{
"interfaceEntity": {
"children": [
{
"pcAggrIf": {
"attributes": {
"id": "po123",
"layer": "Layer2",
"userCfgdFlags": "admin_layer"
}
}
}
]
}
}
]
}
}
{
imdata:[]
}
<System>
<pvlan-items>
<if-items>
<If-list>
<if>po123</if>
<trunk-items>
<trunkAllowedVlans></trunkAllowedVlans>
</trunk-items>
</If-list>
</if-items>
</pvlan-items>
<intf-items>
<aggr-items>
<AggrIf-list>
<id>po123</id>
<layer>Layer2</layer>
<userCfgdFlags>admin_layer</userCfgdFlags>
</AggrIf-list>
</aggr-items>
</intf-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
interface port-channel 123
switchport
switchport private-vlan trunk allowed vlan none
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanIf | sys/pvlan/if-[po123] |
pvlanTrunk | sys/pvlan/if-[po123]/trunk |
interfaceEntity | sys/intf |
pcAggrIf | sys/intf/aggr-[po123] |
pvlanIf Properties
The following table contains information about the pvlanIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
if | nw:IfId (base:IfIndex) | Interface id of port with PVLAN | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
pvlanTrunk Properties
The following table contains information about the pvlanTrunk properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
trunkAllowedVlans | l2:VlanBitmap (base:BitArray) | Trunk Allowed VLANs on PVLAN trunk | ARRAY SIZE: 4096 |
pcAggrIf Properties
The following table contains information about the pcAggrIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
id | nw:IfId (base:IfIndex) | An identifier . | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
layer | l1:Layer (scalar:Enum8) | Administrative port layer | SELECTION: 1 - Layer2 2 - Layer3 DEFAULT: pltfmDfltLayer |
userCfgdFlags | l1:userCfgdFlags (scalar:Bitmask8) | Port User Config Flags | SELECTION: 0 - none 1 - admin_state 2 - admin_layer 4 - admin_router_mac 8 - admin_dce_mode 16 - admin_mtu DEFAULT: none |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:
Deleting Allowed VLANs when Interface is in Private-VLAN Trunking Mode (Trunk-Allowed VLAN List)
Deleting Allowed VLANs when Interface is in Private-VLAN Trunking Mode (Trunk-Allowed VLAN List)
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"children": [
{
"pvlanIf": {
"attributes": {
"if": "po123"
},
"children": [
{
"pvlanTrunk": {
"attributes": {
"trunkAllowedVlans": ""
}
}
}
]
}
}
]
}
},
{
"interfaceEntity": {
"children": [
{
"pcAggrIf": {
"attributes": {
"id": "po123",
"layer": "Layer2",
"userCfgdFlags": "admin_layer"
}
}
}
]
}
}
]
}
}
{
imdata:[]
}
<System>
<pvlan-items>
<if-items>
<If-list>
<if>po123</if>
<trunk-items>
<trunkAllowedVlans></trunkAllowedVlans>
</trunk-items>
</If-list>
</if-items>
</pvlan-items>
<intf-items>
<aggr-items>
<AggrIf-list>
<id>po123</id>
<layer>Layer2</layer>
<userCfgdFlags>admin_layer</userCfgdFlags>
</AggrIf-list>
</aggr-items>
</intf-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
interface port-channel 123
switchport
no switchport private-vlan trunk allowed vlan 123
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanIf | sys/pvlan/if-[po123] |
pvlanTrunk | sys/pvlan/if-[po123]/trunk |
interfaceEntity | sys/intf |
pcAggrIf | sys/intf/aggr-[po123] |
pvlanIf Properties
The following table contains information about the pvlanIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
if | nw:IfId (base:IfIndex) | Interface id of port with PVLAN | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
pvlanTrunk Properties
The following table contains information about the pvlanTrunk properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
trunkAllowedVlans | l2:VlanBitmap (base:BitArray) | Trunk Allowed VLANs on PVLAN trunk | ARRAY SIZE: 4096 |
pcAggrIf Properties
The following table contains information about the pcAggrIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
id | nw:IfId (base:IfIndex) | An identifier . | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
layer | l1:Layer (scalar:Enum8) | Administrative port layer | SELECTION: 1 - Layer2 2 - Layer3 DEFAULT: pltfmDfltLayer |
userCfgdFlags | l1:userCfgdFlags (scalar:Bitmask8) | Port User Config Flags | SELECTION: 0 - none 1 - admin_state 2 - admin_layer 4 - admin_router_mac 8 - admin_dce_mode 16 - admin_mtu DEFAULT: none |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:
Configuring VLAN Removal From the Trunk-Allowed VLAN List
Configuring VLAN Removal From the Trunk-Allowed VLAN List
POST http://<mgmt0_IP>/api/mo/sys.json
{
"topSystem": {
"children": [
{
"pvlanPrivateVlan": {
"children": [
{
"pvlanIf": {
"attributes": {
"if": "po123"
},
"children": [
{
"pvlanTrunk": {
"attributes": {
"trunkAllowedVlans": ""
}
}
}
]
}
}
]
}
},
{
"interfaceEntity": {
"children": [
{
"pcAggrIf": {
"attributes": {
"id": "po123",
"layer": "Layer2",
"userCfgdFlags": "admin_layer"
}
}
}
]
}
}
]
}
}
{
imdata:[]
}
<System>
<pvlan-items>
<if-items>
<If-list>
<if>po123</if>
<trunk-items>
<trunkAllowedVlans></trunkAllowedVlans>
</trunk-items>
</If-list>
</if-items>
</pvlan-items>
<intf-items>
<aggr-items>
<AggrIf-list>
<id>po123</id>
<layer>Layer2</layer>
<userCfgdFlags>admin_layer</userCfgdFlags>
</AggrIf-list>
</aggr-items>
</intf-items>
</System>
Note: This example was added in Release 9.3(5).
CLI Commands
The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.
interface port-channel 123
switchport
switchport private-vlan trunk allowed vlan remove 3404
Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO | DN |
---|---|
topSystem | sys |
pvlanPrivateVlan | sys/pvlan |
pvlanIf | sys/pvlan/if-[po123] |
pvlanTrunk | sys/pvlan/if-[po123]/trunk |
interfaceEntity | sys/intf |
pcAggrIf | sys/intf/aggr-[po123] |
pvlanIf Properties
The following table contains information about the pvlanIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
if | nw:IfId (base:IfIndex) | Interface id of port with PVLAN | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
pvlanTrunk Properties
The following table contains information about the pvlanTrunk properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
trunkAllowedVlans | l2:VlanBitmap (base:BitArray) | Trunk Allowed VLANs on PVLAN trunk | ARRAY SIZE: 4096 |
pcAggrIf Properties
The following table contains information about the pcAggrIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name | Data Type | Description | Values |
---|---|---|---|
id | nw:IfId (base:IfIndex) | An identifier . | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
layer | l1:Layer (scalar:Enum8) | Administrative port layer | SELECTION: 1 - Layer2 2 - Layer3 DEFAULT: pltfmDfltLayer |
userCfgdFlags | l1:userCfgdFlags (scalar:Bitmask8) | Port User Config Flags | SELECTION: 0 - none 1 - admin_state 2 - admin_layer 4 - admin_router_mac 8 - admin_dce_mode 16 - admin_mtu DEFAULT: none |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide: