Cisco Prime Infrastructure API
Prime Infrastructure API Documentation

GET settings/inventory/configArchiveBasic

Retrieves basic parameters for the configuration archive, such as protocol, timeout value, number of configuration versions to store, and so forth.

Since Product Version: 3.2

Resource Information

Rate Limiting?

No

Sorting?

No

Paging?

No

Filtering?

No

Group Filtering?

No

Aggregation?

No

Response Formats

xml

json

User Group

NBI Credential

HTTP Methods

GET

Resource URL

/webacs/api/v4/op/settings/inventory/configArchiveBasic

Unmodified

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

Response Parameters

Attribute Description

inventoryIntegration boolean

Do you want the application to archive configuration after Inventory Sync?

inventoryTriggered boolean

Trigger inventory collection before config archive?

maskAuthInfo boolean

Do you want to mask security content while exporting configuration to a file?

noOfParallelThreads int

Thread pool count.

numberOfDays Integer

Maximum number of days for which configuration versions should be retained for each device. Turn off this property as well as "Number of versions to retain" property to maintain unlimited number of versions. In case both the retention policies are enabled, application will use the widest retained versions from both the policies.

numberOfVersions Integer

Maximum number of configuration versions to be retained for each device. Turn off this property as well as "Number of days to retain" property to maintain unlimited number of versions. In case both the retention policies are enabled, application will use the widest retained versions from both the policies.

outofboxArchiveIntegration boolean

Do you want the application to archive configuration out-of-box? Turn off this property to disable automatic configuration archive through all the flows. To control archive on inventory sync and change events etc, use individual settings by keeping this setting on. Turning on this setting alone means, archive on initial inventory will be enabled.

syslogHoldOffTimer Integer

Do you want the application to archive configuration after receiving configuration change events? Turn off (do not pass value) this property to stop processing configuration change events. The events that are already received and waiting for their hold off timer period, will still get processed immediately. Hold-off timer controls when the application should trigger archive, after the first indication of a configuration change event. Measurement unit is minute.

timeout int

Maximum time in milliseconds to wait while performing any configuration operation like fetch, archive and rollback.

viewUpdateTimeout int

Maximum time in minutes to wait before updating configuration archive summary data.

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 Response Payload

https://localhost/webacs/api/v4/op/settings/inventory/configArchiveBasic

<?xml version="1.0" ?>
<mgmtResponse responseType="operation" requestUrl="https://localhost/webacs/api/v4/op/settings/inventory/configArchiveBasic" rootUrl="https://localhost/webacs/api/v4/op">
  <inventoryConfigArchiveBasicSettingsDto>
    <inventoryIntegration>true</inventoryIntegration>
    <inventoryTriggered>true</inventoryTriggered>
    <maskAuthInfo>true</maskAuthInfo>
    <noOfParallelThreads>1</noOfParallelThreads>
    <numberOfDays>15</numberOfDays>
    <numberOfVersions>15</numberOfVersions>
    <outofboxArchiveIntegration>true</outofboxArchiveIntegration>
    <syslogHoldOffTimer>15</syslogHoldOffTimer>
    <timeout>1</timeout>
    <viewUpdateTimeout>1</viewUpdateTimeout>
  </inventoryConfigArchiveBasicSettingsDto>
</mgmtResponse>

Sample JSON Response Payload

https://localhost/webacs/api/v4/op/settings/inventory/configArchiveBasic.json

{
  "mgmtResponse" : {
    "@requestUrl" : "https://localhost/webacs/api/v4/op/settings/inventory/configArchiveBasic",
    "@responseType" : "operation",
    "@rootUrl" : "https://localhost/webacs/api/v4/op",
    "inventoryConfigArchiveBasicSettingsDto" : [ {
      "inventoryIntegration" : true,
      "inventoryTriggered" : true,
      "maskAuthInfo" : true,
      "noOfParallelThreads" : 1,
      "numberOfDays" : 15,
      "numberOfVersions" : 15,
      "outofboxArchiveIntegration" : true,
      "syslogHoldOffTimer" : 15,
      "timeout" : 1,
      "viewUpdateTimeout" : 1
    } ]
  }
}