Configuration version URIs

The NSM client user can request a list of configuration versions that match the device fully qualified name.

When the NSM client user requests a list of configuration versions using the following GET method URIs, a list of configuration versions that match the fully qualified device names is returned. A single configuration version is returned if the configuration version external ID parameter is supplied.

/2.0/device/fqname/{fqname}/configversion/{externalid}
/2.0/device/fqname/{fqname}/configversion

Note: These URIs require version information (2.0) in the URI.

Input parameters

{ fqname }

{externalid}

If the fqname contains forward slashes, these must be escaped using the %252F value as shown in the example below.

Available HTTP Headers

Accept: application/json

Accept: text/xml

Sample request

http://www.example.com:16310/nsm/2.0/device/fqname/ITNCM%252FEMULATED%252Femulcli4-17/configversion

http://www.example.com:16310/nsm/2.0/device/fqname/ITNCM%252FEMULATED%252Femulcli4-17/configversion/2016-05-11T10:09:15.615+0000

Sample response

XML

{
<device>
    <configVersions>
        <configVersion>
            <id>103</id>
            <name>Imported Configuration</name>
            <externalID>2016-05-11T10:09:15.615+0000</externalID>
            <os>C2600-IS-M-12.2(3</os>
            <createdDate>2016-05-11 10:09:15.615 UTC</createdDate>
            <createdBy>administrator</createdBy>
            <lastModifiedDate>2016-05-11 10:09:15.615 UTC</lastModifiedDate>
            <lastModifiedBy>administrator</lastModifiedBy>
            <status>versioned</status>
            <golden>device specific</golden>
            <supportLevel>SmartModel</supportLevel>
        </configVersion>
    </configVersions>
</device>
}

JSON

{
    "configVersions": [
        {
            "lastModifiedDate": 1462961355615,
            "id": 103,
            "name": "Imported Configuration",
            "os": "C2600-IS-M-12.2(3)",
            "createdDate": 1462961355615,
            "modifiedDate": 1462961355615,
            "lastModifiedBy": "administrator",
            "status": "versioned",
            "createdBy": "administrator",
            "supportLevel": "SmartModel",
            "externalID": "2016-05-11T10:09:15.615+0000",
            "golden": "device specific"
        }
    ]
}

Response details

Table 1. Response details
Tag	Type	Description
`configVersions`	Container tag	Container for configVersions
`configVersion(XML only)`	Container tag	Specifies the configuration version
`Id`	Integer	Specifies the configuration version internal ID as supplied by Netcool Configuration Manager
`name`	String	Specifies the configuration version name
`externalID`	String	Specifies the Configuration version
`os`	String	Specifies the operating system of the configuration version
`createdDate`	String	Specifies the date when configuration version was created
`createdBy`	String	Specifies who created the configuration version
`lastModifiedDate`	String	Specifies the date when the configuration version was last modified
`lastModifiedBy`	String	Specifies who last modified the configuration version
`status`	String	Specifies the status of the configuration version
`golden`	String	Specifies the golden configuration status of the configuration version
`supportLevel`	String	Specifies the support level for the configuration version The possible levels are: Limited, SmartModel, and Standard