Get diff between two versions | NVIDIA Switch Infrastructure

curl -G https://host.com/v1/config/device_uuid/filename/diff \
     -H "Content-Type: application/json" \
     -d from_version=12 \
     -d to_version=15 \
     -d file_type=intended

{
  "device_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "diff": "--- router-config.txt v12\n+++ router-config.txt v15\n@@ -10,7 +10,8 @@\n interface GigabitEthernet0/1\n- ip address 192.168.1.1 255.255.255.0\n+ ip address 192.168.1.2 255.255.255.0\n+ description Updated IP address\n",
  "diff_stats": {
    "lines_added": 2,
    "lines_removed": 1,
    "files_changed": 1
  },
  "filename": "router-config.txt",
  "from_version": 12,
  "new_content": "interface GigabitEthernet0/1\n ip address 192.168.1.2 255.255.255.0\n description Updated IP address\n!",
  "old_content": "interface GigabitEthernet0/1\n ip address 192.168.1.1 255.255.255.0\n!",
  "to_version": 15,
  "device": {
    "name": "CoreRouter01",
    "site": "Data Center 1",
    "last_updated": "2024-01-15T09:30:00Z",
    "nautobot_url": "https://nautobot.example.com/devices/3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "platform": "Cisco IOS XE",
    "primary_ip4": "192.168.1.1",
    "rack": "Rack-22B",
    "role": "Core Router"
  }
}

Generate a diff between two versions of a configuration file.

Path parameters

device_uuidstringRequiredformat: "uuid"

filenamestringRequired

Query parameters

from_versionintegerRequired

to_versionintegerRequired

file_typeenumOptional

Enum for config file types.

Allowed values:

Response

Successful Response

device_uuidstringformat: "uuid"

Device UUID

diffstring

Unified diff output

diff_statsmap from strings to integers

Statistics about the diff

filenamestring

File name

from_versioninteger

Source version

new_contentstring

Content of target version

old_contentstring

Content of source version

to_versioninteger

Target version

deviceobject or null

Device metadata from Nautobot

Errors

422

Unprocessable Entity Error