Configuring an Application
Configuring an Application
POST http://<mgmt0_IP>/api/mo/sys/apphosting.json
{
"apphostingAppHosting": {
"attributes": {},
"children" : [
{
"apphostingAppConf" : {
"attributes" : {
"adminSt": "enabled",
"appId" : "te_app",
"gwIpV4IntfIdx": "0",
"gwIpV4Addr": "172.25.44.1"
},
"children" : [
{
"apphostingVnicEntry" : {
"attributes" : {
"adminSt": "enabled",
"hostIntf" : "bridge1",
"guestIntfId" : "0",
"ipV4Addr": "172.25.44.2/30"
}
}
},
]}}]}}
{
"apphostingAppHosting": {
"attributes": {},
"children" : [
{
"apphostingAppConf" : {
"attributes" : {
"adminSt" : "disabled"
"appId" : "te_app"
}
}
}
]
}
}
{
imdata:[]
}
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.
Configure an application
app-hosting appid te_app
app-vnic bridge 1 guest-interface 0
guest-ipaddress 172.25.44.2/30
exit
app-default-gateway 172.25.44.1 guest-interface 0
end
Unconfigure an application
no app-hosting appid te_app
Note: The property information for this example was added in release 10.3(1)F.
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 |
|---|---|
| apphostingAppHosting | sys/apphosting |
| apphostingAppConf | sys/apphosting/appconf-appid |
| apphostingVnicEntry | sys/apphosting/appconf-appid/vnic-guestIntfId |
appHostingAppConf Properties
The following table contains information about the appHostingAppConf 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 | Values | Description |
|---|---|---|---|
| adminSt | scalar: Enum8 | Selection: 1: enabled 2: disabled Default: disabled | Admin Status |
| appId | string: Basic | Range: [1,64] | Unique identifier of an application |
| gwIpV4IntfIdx | scalar: Unit32 | Range: [1,3] Default: 0 | Default gateway interface index |
| gwIpV4Addr | Address: ip | Value must match ipv4 known format | Default gateway ip address |
appHostingVnicEntry Properties
The following table contains information about the appHostingVnicEntry 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 | Values | Description |
|---|---|---|---|
| adminSt | scalar: Enum8 | Selection: 1: enabled 2: disabled Default: disabled | Admin Status |
| hostIntf | scalar: Enum8 | Selection: 0-management 1 to 8 - bridge 1-8 Default: Management | Application host interface type |
| guestIntfId | scalar: Unit32 | Range: [1,3] Default: 0 | Guest interface identifier |
| ipV4Addr | Address: ip | Value must match ipv4 known format | v4 ip address of the interface |
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: