Cisco Prime Infrastructure API
Prime Infrastructure API Documentation

GET InventoryDetails

It provides an aggregated view of all the available inventory information for the device.

Since Product Version: 1.2

Resource Information

Rate Limiting?

Yes

Sorting?

Yes

Paging?

Yes

Filtering?

Yes

Group Filtering?

Yes

Aggregation?

No

Response Formats

xml

json

User Group

NBI Read

HTTP Methods

GET

Resource URL

/webacs/api/v2/data/InventoryDetails

To filter entities based on device groups, use Group Based Filtering as documented on the Filtering page on the Home page. Example: ?.group=myrouters

Unmodified

This resource has not been modified since the previous API version.

Response Parameters

Attribute Description

cdpNeighbor Arrow image CDPNeighbor[]

This nested field provides information on the CDP neighbors for this device.

deviceId Long

An internal id for the device

etherChannel Arrow image EtherChannel[]

This nested field provides information about the ether channels associated with this device.

ethernetInterface Arrow image EthernetInterface[]

This nested field provides information on the ethernet interfaces associated with this device.

fan Arrow image Fan[]

This nested field provides information about the fans associated with this device

ipInterface Arrow image IpInterface[]

This nested field provides information about the ip interfaces associated with this device.

module Arrow image DeviceModule[]

This nested field provides a listing of the modules associated with this device

physicalPort Arrow image PhysicalPort[]

This nested field provides information about the physical ports associated with this device.

powerSupply Arrow image PowerSupply[]

This nested field provides information about the power supplies associated with this device.

sensor Arrow image DeviceSensor[]

This nested field provides information about the sensors associated with this device.

summary Arrow image Summary

A nested field that provides an inventory summary

udf Arrow image UDFValue[]

This nested field provides the user defined fields for this device.

udiDetail Arrow image UDIDetail[]

This nested field provides a listing of the Unique Device Identifier's associated with this device.

vlanInterface Arrow image VlanInterface[]

This nested field provides information about the vlan interfaces associated with this device.

Sample Payloads

Sample payloads are for information only. They are automatically generated and the values included may not be representative of actual valid data values.

Sample XML Payload

https://localhost/webacs/api/v2/data/InventoryDetails/15

<?xml version="1.0" ?>
<queryResponse type="InventoryDetails" responseType="getEntity" requestUrl="https://localhost/webacs/api/v2/data/InventoryDetails/15" rootUrl="https://localhost/webacs/api/v2/data">
  <entity dtoType="inventoryDetailsDTO" type="InventoryDetails" url="https://localhost/webacs/api/v2/data/InventoryDetails/15">
    <inventoryDetailsDTO displayName="String value" id="15" uuid="String value">
      <cdpNeighbors>
        <cdpNeighbor>
          <duplexMode>UNKNOWN</duplexMode>
          <farEndInterface>String value</farEndInterface>
          <interfaceIndex>1</interfaceIndex>
          <nearEndInterface>String value</nearEndInterface>
          <neighborCapabilities>String value</neighborCapabilities>
          <neighborDeviceName>String value</neighborDeviceName>
          <neighborDevicePlatformType>String value</neighborDevicePlatformType>
        </cdpNeighbor>
      </cdpNeighbors>
      <deviceId>15</deviceId>
      <etherChannels>
        <etherChannel>
          <actorAdminKey>15</actorAdminKey>
          <channelGroupId>1</channelGroupId>
          <controlMethod>MANUAL</controlMethod>
          <name>String value</name>
          <numberOfMembers>1</numberOfMembers>
        </etherChannel>
      </etherChannels>
      <ethernetInterfaces>
        <ethernetInterface>
          <accessVlan>15</accessVlan>
          <adminStatus>UNKNOWN</adminStatus>
          <allowedVlanIds>String value</allowedVlanIds>
          <channelGroupId>15</channelGroupId>
          <description>String value</description>
          <desiredTrunkingEncapsulation>UNKOWN</desiredTrunkingEncapsulation>
          <desiredVlanMode>UNKNOWN</desiredVlanMode>
          <duplexMode>UNKNOWN</duplexMode>
          <mtu>15</mtu>
          <name>String value</name>
          <nativeVlan>15</nativeVlan>
          <operationalStatus>NOT_APPLICABLE</operationalStatus>
          <operationalTrunkEncapsulation>UNKOWN</operationalTrunkEncapsulation>
          <operationalVlanMode>UNKNOWN</operationalVlanMode>
          <pruneEligibleVlanIds>String value</pruneEligibleVlanIds>
          <trunkingEncapsulationNegotiation>true</trunkingEncapsulationNegotiation>
          <macAddress>String value</macAddress>
          <speed>
            <lazyLoadedEntities>
              <entry>
                <key>String value</key>
                <value xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xs:string">String value</value>
              </entry>
            </lazyLoadedEntities>
            <instanceId>2</instanceId>
            <instanceUuid>String value</instanceUuid>
            <instanceVersion>1</instanceVersion>
            <units>String value</units>
            <longAmount>2</longAmount>
          </speed>
        </ethernetInterface>
      </ethernetInterfaces>
      <fans>
        <fan>
          <description>String value</description>
          <name>String value</name>
          <operationalStatus>String value</operationalStatus>
          <serialNumber>String value</serialNumber>
          <vendorEquipmentType>String value</vendorEquipmentType>
        </fan>
      </fans>
      <ipInterfaces>
        <ipInterface>
          <adminStatus>UNKNOWN</adminStatus>
          <name>String value</name>
          <operationalStatus>NOT_APPLICABLE</operationalStatus>
          <ipAddress>String value</ipAddress>
        </ipInterface>
      </ipInterfaces>
      <modules>
        <module>
          <description>String value</description>
          <equipmentType>OTHER</equipmentType>
          <firmwareVersion>String value</firmwareVersion>
          <operationStatus>String value</operationStatus>
          <physicalLocation>String value</physicalLocation>
          <productId>String value</productId>
          <productName>String value</productName>
          <slotNumber>String value</slotNumber>
          <softwareVersion>String value</softwareVersion>
          <vendorType>String value</vendorType>
          <equipmentId>String value</equipmentId>
          <isInlinePowerCapable>true</isInlinePowerCapable>
          <nrPorts>String value</nrPorts>
        </module>
      </modules>
      <physicalPorts>
        <physicalPort>
          <description>String value</description>
          <deviceId>2</deviceId>
          <equipmentId>2</equipmentId>
          <name>String value</name>
          <residingModule>String value</residingModule>
          <vendorEquipmentType>String value</vendorEquipmentType>
        </physicalPort>
      </physicalPorts>
      <powerSupplies>
        <powerSupply>
          <description>String value</description>
          <manufacturerName>String value</manufacturerName>
          <name>String value</name>
          <operationalStatus>String value</operationalStatus>
          <serialNumber>String value</serialNumber>
          <vendorEquipmentType>String value</vendorEquipmentType>
        </powerSupply>
      </powerSupplies>
      <sensors>
        <sensor>
          <description>String value</description>
          <entPhysicalIndex>String value</entPhysicalIndex>
          <equipmentName>String value</equipmentName>
          <name>String value</name>
          <precision>15</precision>
          <status>OK</status>
          <type>OTHER</type>
          <vendorSensorType>String value</vendorSensorType>
        </sensor>
      </sensors>
      <summary>
        <ciscoIdentityCapable>true</ciscoIdentityCapable>
        <contact>String value</contact>
        <deviceId>String value</deviceId>
        <deviceName>String value</deviceName>
        <deviceType>String value</deviceType>
        <ipAddress>String value</ipAddress>
        <location>String value</location>
        <locationCapable>true</locationCapable>
        <nrPortsDown>2</nrPortsDown>
        <nrPortsUp>2</nrPortsUp>
        <productFamily>String value</productFamily>
        <reachability>UNKNOWN</reachability>
        <softwareVersion>String value</softwareVersion>
        <systemTime>1986-07-24T00:00:00Z</systemTime>
        <upTime>String value</upTime>
      </summary>
      <udfs>
        <udf>
          <name>String value</name>
          <value>String value</value>
        </udf>
      </udfs>
      <udiDetails>
        <udiDetail>
          <description>String value</description>
          <modelNr>String value</modelNr>
          <name>String value</name>
          <productId>String value</productId>
          <udiSerialNr>String value</udiSerialNr>
          <versionId>String value</versionId>
        </udiDetail>
      </udiDetails>
      <vlanInterfaces>
        <vlanInterface>
          <adminStatus>UNKNOWN</adminStatus>
          <maxSpeed>
            <lazyLoadedEntities>
              <entry>
                <key>String value</key>
                <value xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xs:string">String value</value>
              </entry>
            </lazyLoadedEntities>
            <instanceId>2</instanceId>
            <instanceUuid>String value</instanceUuid>
            <instanceVersion>1</instanceVersion>
            <units>String value</units>
            <longAmount>2</longAmount>
          </maxSpeed>
          <mtu>15</mtu>
          <operationalStatus>NOT_APPLICABLE</operationalStatus>
          <portName>String value</portName>
          <portType>OTHER</portType>
          <vlanId>1</vlanId>
        </vlanInterface>
      </vlanInterfaces>
    </inventoryDetailsDTO>
  </entity>
</queryResponse>

Sample JSON Payload

https://localhost/webacs/api/v2/data/InventoryDetails/15.json

{
  "queryResponse" : {
    "@type" : "InventoryDetails",
    "@requestUrl" : "https://localhost/webacs/api/v2/data/InventoryDetails/15",
    "@responseType" : "getEntity",
    "@rootUrl" : "https://localhost/webacs/api/v2/data",
    "entity" : [ {
      "@dtoType" : "inventoryDetailsDTO",
      "@type" : "InventoryDetails",
      "@url" : "https://localhost/webacs/api/v2/data/InventoryDetails/15",
      "inventoryDetailsDTO" : {
        "@displayName" : "String value",
        "@id" : 15,
        "@uuid" : "String value",
        "cdpNeighbors" : {
          "cdpNeighbor" : [ {
            "duplexMode" : "UNKNOWN",
            "farEndInterface" : "String value",
            "interfaceIndex" : 1,
            "nearEndInterface" : "String value",
            "neighborCapabilities" : "String value",
            "neighborDeviceName" : "String value",
            "neighborDevicePlatformType" : "String value"
          } ]
        },
        "deviceId" : 15,
        "etherChannels" : {
          "etherChannel" : [ {
            "actorAdminKey" : 15,
            "channelGroupId" : 1,
            "controlMethod" : "MANUAL",
            "name" : "String value",
            "numberOfMembers" : 1
          } ]
        },
        "ethernetInterfaces" : {
          "ethernetInterface" : [ {
            "accessVlan" : 15,
            "adminStatus" : "UNKNOWN",
            "allowedVlanIds" : "String value",
            "channelGroupId" : 15,
            "description" : "String value",
            "desiredTrunkingEncapsulation" : "UNKOWN",
            "desiredVlanMode" : "UNKNOWN",
            "duplexMode" : "UNKNOWN",
            "macAddress" : "String value",
            "mtu" : 15,
            "name" : "String value",
            "nativeVlan" : 15,
            "operationalStatus" : "NOT_APPLICABLE",
            "operationalTrunkEncapsulation" : "UNKOWN",
            "operationalVlanMode" : "UNKNOWN",
            "pruneEligibleVlanIds" : "String value",
            "speed" : {
              "longAmount" : 2,
              "units" : "String value"
            },
            "trunkingEncapsulationNegotiation" : true
          } ]
        },
        "fans" : {
          "fan" : [ {
            "description" : "String value",
            "name" : "String value",
            "operationalStatus" : "String value",
            "serialNumber" : "String value",
            "vendorEquipmentType" : "String value"
          } ]
        },
        "ipInterfaces" : {
          "ipInterface" : [ {
            "adminStatus" : "UNKNOWN",
            "ipAddress" : "String value",
            "name" : "String value",
            "operationalStatus" : "NOT_APPLICABLE"
          } ]
        },
        "modules" : {
          "module" : [ {
            "description" : "String value",
            "equipmentId" : "String value",
            "equipmentType" : "OTHER",
            "firmwareVersion" : "String value",
            "isInlinePowerCapable" : true,
            "nrPorts" : "String value",
            "operationStatus" : "String value",
            "physicalLocation" : "String value",
            "productId" : "String value",
            "productName" : "String value",
            "slotNumber" : "String value",
            "softwareVersion" : "String value",
            "vendorType" : "String value"
          } ]
        },
        "physicalPorts" : {
          "physicalPort" : [ {
            "description" : "String value",
            "deviceId" : 2,
            "equipmentId" : 2,
            "name" : "String value",
            "residingModule" : "String value",
            "vendorEquipmentType" : "String value"
          } ]
        },
        "powerSupplies" : {
          "powerSupply" : [ {
            "description" : "String value",
            "manufacturerName" : "String value",
            "name" : "String value",
            "operationalStatus" : "String value",
            "serialNumber" : "String value",
            "vendorEquipmentType" : "String value"
          } ]
        },
        "sensors" : {
          "sensor" : [ {
            "description" : "String value",
            "entPhysicalIndex" : "String value",
            "equipmentName" : "String value",
            "name" : "String value",
            "precision" : 15,
            "status" : "OK",
            "type" : "OTHER",
            "vendorSensorType" : "String value"
          } ]
        },
        "summary" : {
          "ciscoIdentityCapable" : true,
          "contact" : "String value",
          "deviceId" : "String value",
          "deviceName" : "String value",
          "deviceType" : "String value",
          "ipAddress" : "String value",
          "location" : "String value",
          "locationCapable" : true,
          "nrPortsDown" : 2,
          "nrPortsUp" : 2,
          "productFamily" : "String value",
          "reachability" : "UNKNOWN",
          "softwareVersion" : "String value",
          "systemTime" : 522547200000,
          "upTime" : "String value"
        },
        "udfs" : {
          "udf" : [ {
            "name" : "String value",
            "value" : "String value"
          } ]
        },
        "udiDetails" : {
          "udiDetail" : [ {
            "description" : "String value",
            "modelNr" : "String value",
            "name" : "String value",
            "productId" : "String value",
            "udiSerialNr" : "String value",
            "versionId" : "String value"
          } ]
        },
        "vlanInterfaces" : {
          "vlanInterface" : [ {
            "adminStatus" : "UNKNOWN",
            "maxSpeed" : {
              "longAmount" : 2,
              "units" : "String value"
            },
            "mtu" : 15,
            "operationalStatus" : "NOT_APPLICABLE",
            "portName" : "String value",
            "portType" : "OTHER",
            "vlanId" : 1
          } ]
        }
      }
    } ]
  }
}