Documentation Powered by ReDoc

Inventory Service (2.6.0)

Download OpenAPI specification:Download

Extreme Networks: support@extremenetworks.com URL: https://www.extremenetworks.com License: Apache license

This is the spec that defines the API provided by the Inventory/Asset Service, which is used by multiple services to access network configuration/state data

Replace

replaceSwitch

Replace the switch as part of an RMA. This will replace the asset information of the new switch in the Inventory.

query Parameters
ip_address
required
string

IP Addresses of the device to be replaced.

config_backup_id
string

UUID of config backup

Responses

202

Accepted switch replace request

401

Authorization information is missing or invalid.

409

A switch with the specified IP doesnt exists.

500

Unexpected error

default

Unexpected error

post/switch/replace
http://goinventory-service:80/v1/inventory/switch/replace

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "href": "href",
  • "uuid": "id"
}

Switch replace

rma

delet RMA ID.

query Parameters
key
string

IP Addresses of the device or RMA uuid to deleted.

Responses

200

drift and reconcile delete request

409

Invalid IP address.

500

Unexpected error.

default

Unexpected error

delete/switch/replace
http://goinventory-service:80/v1/inventory/switch/replace

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "result": 0,
  • "userKey": "1111-1111-1111",
  • "error": "uuid not found"
}

Switch replace History list

getRMAHistorys

Get Switch replace History list

query Parameters
device_ip
string

Ip of the entry for which RMA history is fetched

Responses

200

OK

404

No RMA History found in the system

500

Unexpected error

default

Unexpected error

get/rma-history
http://goinventory-service:80/v1/inventory/rma-history

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

Switch Replace Details

getRMADetail

Get RMA Detail

query Parameters
rma_id
required
string

RMA Id of the entry for which detail is fetched

Responses

200

OK

404

Status of the device was not found.

500

Unexpected error.

default

Unexpected error

get/rma-detail
http://goinventory-service:80/v1/inventory/rma-detail

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "dr_id": "1111-1111-1111",
  • "device-ip": "1.1.1.1",
  • "status": "Success",
  • "StartTime": "12:03:24,12/2/2020"
}

Compare

compareSwitch

Compare the Specified Switch configuration with whats in the Asset DB

query Parameters
ip_address
required
string

IP Addresses of the device which we want to compare configuration that is saved on the device vs actual configuration on the device.

Responses

200

OK

404

A switch with the specified IP doesnt exists.

500

Unexpected error

default

Unexpected error

post/switch/compare
http://goinventory-service:80/v1/inventory/switch/compare

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "compare-results":
    {
    }
}

TpvmUpgrade

getTpvmUpgradeStatus

Get the status of the TPVM upgrade execution.

query Parameters
ip_address
string

IP Addresses of the device

execution_id
string

Execution ID. Get the tpvm upgrade execution status for device by execution ID.

Responses

200

OK

404

No tpvm upgrade execution switch found for the specified ip address.

500

Unexpected error.

default

Unexpected error

get/switch/tpvm-upgrade
http://goinventory-service:80/v1/inventory/switch/tpvm-upgrade

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "switch_data":
    {
    },
  • "start_time": "2000-01-23T04:42:16.000Z",
  • "last_update_time": "2000-01-23T04:56:07.000Z",
  • "update_state": "Completed",
  • "id": 1,
  • "target_tpvm_version": "4.2.1",
  • "status": "TPVM Upgrade Completed",
  • "detailed_status": "None"
}

executeTpvmUpgrade

Execute TPVM upgrade on the switch.

query Parameters
ip_address
required
string

IP Addresses of the device.

firmware_host
required
string

IP address of a registered firmware host.

tpvm_image
required
string

TPVM image path and filename located on the firmware host.

trusted_peer_sudo_user
string

TPVM trusted peer sudo user configuration to be reconfigured after the TPVM has been upgraded. Default sudo user is "extreme" if not specified along with the trusted peer password.

trusted_peer_password
string

TPVM trusted peer password configuration to be reconfigured after the TPVM has been upgraded.

Responses

202

Accepted TPVM upgrade execution request.

404

No switch found for the specified ip address.

428

Precondition validation error.

500

Unexpected error.

default

Unexpected error

post/switch/tpvm-upgrade/execute
http://goinventory-service:80/v1/inventory/switch/tpvm-upgrade/execute

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "href": "href",
  • "uuid": "id"
}

Switch Setting

getSwitchSetting

query Parameters
ip_address
required
string

IP Addresses of the device to be retrieved.

Responses

200

OK

207

Partial success

400

Incorrect values specified for Switch setting

401

Authorization information is missing or invalid.

404

A Switch with the specified IP was not found.

409

A Switch settings already exist and cannot be updated.

500

Unexpected error.

default

Unexpected error

get/switchconfig/setting
http://goinventory-service:80/v1/inventory/switchconfig/setting

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "device-ip": "10.20.30.40",
  • "device-settings":
    {
    }
}

updateSwitchSetting

Request Body schema: application/json

Update Switch Settings.

ip_address
required
string
keyval
required
Array of objects (DeviceParameter)

Responses

200

OK

207

Partial success.

400

Incorrect values specified for Switch setting

401

Authorization information is missing or invalid.

404

A Switch with the specified IP was not found.

409

A switch settings already exist and cannot be updated.

422

Specified switch setting doesnt exist.

500

Unexpected error.

default

Unexpected error

put/switchconfig/setting
http://goinventory-service:80/v1/inventory/switchconfig/setting

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "ip_address": "10.20.30.40",
  • "keyval":
    [
    ]
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "device-ip": "10.20.30.40",
  • "device-settings":
    {
    }
}

Drift and reconcile

driftAndReconcile

Trigger drift and reconcile for inventory, fabric and tenant.

query Parameters
ip_address
required
string

IP Addresses of the device to be retrieved.

reconcile
required
boolean
Default: false

Value true implies efa drift with devices will be reconciled

Responses

202

Accepted drift and reconcile execution request

409

Invalid IP address.

500

Unexpected error.

default

Unexpected error

post/switchconfig/drift-reconcile
http://goinventory-service:80/v1/inventory/switchconfig/drift-reconcile

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "href": "href",
  • "uuid": "id"
}

driftAndReconcile

delet drift and reconcile ID.

query Parameters
key
string

IP Addresses of the device or drift and reconcile uuid to deleted.

Responses

200

drift and reconcile delete request

409

Invalid IP address.

500

Unexpected error.

default

Unexpected error

delete/switchconfig/drift-reconcile
http://goinventory-service:80/v1/inventory/switchconfig/drift-reconcile

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "result": 0,
  • "userKey": "1111-1111-1111",
  • "error": "uuid not found"
}

switch health status

switchHealthStatus

current health status for the switch.

query Parameters
ip_address
required
string

IP Addresses of the device to be retrieved.

Responses

200

Accepted drift and reconcile execution request

409

Invalid IP address.

500

Unexpected error.

default

Unexpected error

get/switchhealth/status
http://goinventory-service:80/v1/inventory/switchhealth/status

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "switchHealth": "disabled",
  • "drUUID": "Id",
  • "href": "/v1/inventory/drift_reconcile/detail",
  • "heartBeatMissCounter": 2,
  • "heartBeatMissThreshold": 2,
  • "healthCheckInterval": "5m",
  • "maintenanceMode": "enabled"
}

Config Replay

StartConfigReplay

Config Replay to device.

query Parameters
ip_address
required
string

IP Addresses of the device to be replayed.

cb_id
string

ConfigBackup Id of the config to be applied

ss_id
string

Snapshot Id of the config to be applied

startup_config
boolean

Copy the config to startup config.

no_reboot
boolean

Don't reboot the device.

Responses

202

Accepted config replay execution request

409

Invalid IP address.

500

Unexpected error.

default

Unexpected error

post/switchconfig/config-replay
http://goinventory-service:80/v1/inventory/switchconfig/config-replay

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "href": "href",
  • "uuid": "id"
}

ConfigReplay

Delete Config Replay ID.

query Parameters
key
string

IP Addresses of the device or config Replay uuid to deleted.

Responses

200

Config Replay delete request

409

Invalid IP address.

500

Unexpected error.

default

Unexpected error

delete/switchconfig/config-replay
http://goinventory-service:80/v1/inventory/switchconfig/config-replay

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "result": 0,
  • "userKey": "1111-1111-1111",
  • "error": "uuid not found"
}

Config Backup

StartConfigBackup

Config Backup from device.

query Parameters
ip_address
required
string

IP Addresses of the device to be retrieved.

Responses

202

Accepted config backup request

409

Invalid IP address.

500

Unexpected error.

default

Unexpected error

post/switchconfig/config-backup
http://goinventory-service:80/v1/inventory/switchconfig/config-backup

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "href": "href",
  • "uuid": "id"
}

ConfigBackup

Delete Config Backup ID.

query Parameters
key
string

IP Addresses of the device or config backup uuid to deleted.

Responses

200

Config Backup delete request

409

Invalid IP address.

500

Unexpected error.

default

Unexpected error

delete/switchconfig/config-backup
http://goinventory-service:80/v1/inventory/switchconfig/config-backup

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "result": 0,
  • "userKey": "1111-1111-1111",
  • "error": "uuid not found"
}

Switches

getSwitches

Get All switches in the specified fabric.

query Parameters
fabric_name
string

Only devices which are associated to the fabric name specified as returned.

device_ids
Array of integers non-empty

Database Ids of switches to be fetched

device_ips
Array of strings non-empty

IPs of the devices to be fetched

orphan
boolean

This is a standalone parameter, which is used to return devices not associated to any fabric. fabric_name/device_ids/device_ips/role cannot be specified with this parameter

role
string
Enum: "Leaf" "Spine" "SuperSpine" "BorderLeaf" "SuperSuperSpine"

Only devices with the specified role are returned. This parameter works in conjunction with fabric_name parameter and is not expected by itself

Responses

200

OK

404

No switches found for the specified fabric.

422

Specified Fabric not found.

500

Unexpected error.

default

Unexpected error

get/switches
http://goinventory-service:80/v1/inventory/switches

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

updateSwitches

Update All switches in the specified fabric.

query Parameters
device_ips
Array of strings non-empty

IP Addresses of the device(s) to be updated.

fabric_name
string

Update devices which are associated to the fabric name.

username
string

Update username and password for the devices.

password
string

Update username and password for the devices.

Responses

200

OK

404

No switches found for the specified fabric.

422

Specified Fabric not found.

500

Unexpected error.

default

Unexpected error

put/switches
http://goinventory-service:80/v1/inventory/switches

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

deleteSwitches

Delete the specified devices from the inventory.

query Parameters
device_ips
Array of strings non-empty

IP Addresses of the device to be deleted.

fabric_name
string

Fabric name. Devices in this fabric will be deleted.

Responses

200

OK

401

Authorization information is missing or invalid.

404

A switch with the specified IP Address was not found.

500

Unexpected error.

default

Unexpected error

delete/switches
http://goinventory-service:80/v1/inventory/switches

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

manageSwitchesConfig

Manage the running-config on the specified devices.

Request Body schema: application/json

Managed the running-config for devices in the fabric or specified devices.

device_ips
Array of strings

IP Addresses of the devices for managing the running-config.

fabric_name
string

Name of the fabric

persist_local
boolean
Default: true

Save the running-config to the startup-config on the specified devices.

Responses

200

OK

401

Authorization information is missing or invalid.

404

No switches found for the specified fabric.

422

Specified Fabric not found.

500

Unexpected error.

default

Unexpected error

post/switches/running-config
http://goinventory-service:80/v1/inventory/switches/running-config

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "fabric_name": "fabric_name",
  • "device_ips":
    [
    ],
  • "persist_local": true
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

executeSwitchesCli

Execute CLI commands on the specified devices.

Request Body schema: application/json

Execute CLI commands on the devices in the fabric or specified devices.

device_ips
Array of strings

IP Addresses of the devices to execute the CLI command.

fabric_name
string

Name of the fabric

role
string
Enum: "Spine" "Leaf" "Super Spine" "Border Leaf" "Standalone"

role of the device

commands
string

CLI commands to be executed on the device.

config
boolean
Default: false

Specifies if the command is to be executed on config-term or exec-mode of the device.

Responses

200

OK

401

Authorization information is missing or invalid.

404

No switches found for the specified fabric.

422

Specified Fabric not found.

500

Unexpected error.

default

Unexpected error

post/switches/execute-cli
http://goinventory-service:80/v1/inventory/switches/execute-cli

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "fabric_name": "default",
  • "role": "Spine",
  • "device_ips":
    [
    ],
  • "config": false,
  • "commands": "show version"
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

Register

registerSwitches

Register switches with the inventory service

Request Body schema: application/json

Register a new Switch.

device_ips
required
Array of strings
username
required
string
password
required
string
maintmode
boolean

Responses

200

OK

401

Authorization information is missing or invalid.

409

A switch with the specified IP already exists.

500

Unexpected error.

default

Unexpected error

post/switches
http://goinventory-service:80/v1/inventory/switches

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "password": "password",
  • "device_ips":
    [
    ],
  • "username": "username",
  • "maintmode": true
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

FirmwareDownload

getFirmwareDownloadStatus

Get the status of the firmware download execution.

query Parameters
fabric_name
string

Fabric name. Get the firmware download execution status for devices in the given fabric.

execution_id
string

Execution ID. Get the firmware download execution status for devices in the fabric by execution ID.

Responses

200

OK

404

No firmware download execution switches found for the specified fabric.

422

Specified Fabric not found.

500

Unexpected error.

default

Unexpected error

get/switches/firmware-download
http://goinventory-service:80/v1/inventory/switches/firmware-download

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

executeFirmwareDownload

Execute firmware download on the prepared switches.

query Parameters
fabric_name
required
string

Fabric name. Execute the firmware download for prepared devices in the given fabric.

group_execution
string

Group Execution option in Firmware Download.

no_auto_commit
boolean

Configure auto commit for Firmware Downloaed.

no_maint_mode
boolean

Configure Maintainance mode in Firmware Download

Responses

202

Accepted firmware download execution request

404

No prepared switches found for the specified fabric.

422

Specified Fabric not found.

428

Precondition validation error.

500

Unexpected error.

default

Unexpected error

post/switches/firmware-download/execute
http://goinventory-service:80/v1/inventory/switches/firmware-download/execute

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "execution_task":
    {
    }
}

commmitFirmwareDownload

Execute firmware download commit on the switches.

Request Body schema: application/json

IPs of the devices to be prepared for a firmware download.

device_ips
Array of strings
fabric
string

Responses

200

Firmware download commit request succesful

400

No firmware downloded switches found for the specified fabric.

404

No prepared switches found for the specified fabric.

422

Specified Fabric not found.

428

Precondition validation error.

500

Unexpected error.

default

Unexpected error

post/switches/firmware-download/commit
http://goinventory-service:80/v1/inventory/switches/firmware-download/commit

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "fabric": "fabric",
  • "device_ips":
    [
    ]
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

restoreFirmwareDownload

Execute firmware download restore on the switches.

Request Body schema: application/json

IPs of the devices to be prepared for a firmware download.

device_ips
Array of strings
fabric
string

Responses

202

Accepted firmware download restore request

400

No firmware downloded switches found for the specified fabric.

422

Specified Fabric not found.

428

Precondition validation error.

500

Unexpected error.

default

Unexpected error

post/switches/firmware-download/restore
http://goinventory-service:80/v1/inventory/switches/firmware-download/restore

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "fabric": "fabric",
  • "device_ips":
    [
    ]
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "execution_task":
    {
    },
  • "items":
    [
    ]
}

getPreparedSwitches

Get the prepared devices ready for a firmware download operation.

query Parameters
device_ips
Array of strings non-empty

IPs of the devices to be fetched

fabric_name
string

Fabric name. Prepared devices in this fabric to be fetched.

Responses

200

OK

404

No switches found for the specified fabric.

422

Specified Fabric not found.

500

Unexpected error.

default

Unexpected error

get/switches/firmware-download/prepare
http://goinventory-service:80/v1/inventory/switches/firmware-download/prepare

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

addPreparedSwitches

Prepare the devices for a firmware download operation.

query Parameters
force
boolean

Configure force option in prepare request to skip all validations

Request Body schema: application/json

IPs of the devices to be prepared for a firmware download.

device_ips
Array of strings
group_name
integer
fabric
string
firmware_host
required
string
firmware_directory
required
string

Responses

200

OK

401

Authorization information is missing or invalid.

404

No switches found for the specified fabric.

422

Specified Fabric not found.

500

Unexpected error.

default

Unexpected error

post/switches/firmware-download/prepare
http://goinventory-service:80/v1/inventory/switches/firmware-download/prepare

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "fabric": "fabric",
  • "device_ips":
    [
    ],
  • "firmware_host": "firmware_host",
  • "firmware_directory": "firmware_directory"
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

removePreparedSwitches

Un-prepare the devices from a firmware download operation.

query Parameters
device_ips
Array of strings non-empty

IP Addresses of the devices to be unprepared from a firmware download operation.

fabric_name
string

Fabric name. Devices in this fabric will be un-prepared.

group_name
integer

Group name. Devices in this Group will be un-prepared.

Responses

200

OK

401

Authorization information is missing or invalid.

404

A switch with the specified IP Address was not found.

500

Unexpected error.

default

Unexpected error

delete/switches/firmware-download/prepare
http://goinventory-service:80/v1/inventory/switches/firmware-download/prepare

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

FabricServiceData

fabricServiceData

Populate Fabric service specific data in Inventory service

Request Body schema: application/json

Fabric service data fabric_type, device_rack.

items
Array of objects (Fabric service specefic data)

Responses

200

Fabric data updated successfully in Inventory

400

No Fabric data found to update in Inventory

422

Specified Fabric not found.

428

Precondition validation error.

500

Unexpected error.

default

Unexpected error

post/switches/fabricServiceData
http://goinventory-service:80/v1/inventory/switches/fabricServiceData

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "reason": "string"
}

SupportSave

DeviceSupportSave

Capture the supportsave data from device(s) and return the file name in the response

Request Body schema: application/json

SupportSave for devices

fabric
string

Fabric name to take SS of rall devices in the fabric

device-ips
string

Device IP's of switches to collect support save from

fabric-all
boolean

true/false to take Support save of all devices

Responses

200

OK

401

Authorization information is missing or invalid.

500

Unexpected error.

default

Unexpected error

post/switches/supportsave
http://goinventory-service:80/v1/inventory/switches/supportsave

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "fabric": "default",
  • "device-ips": "10.24.131.3,162.101.21.2,192.24.32.204",
  • "fabric-all": true
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "deviceSSResponse":
    [
    ]
}

Interfaces

getInterfaces

Get only the interfaces with the specific parameters for the specified switch

query Parameters
device_ips
Array of strings non-empty

IP address of the device for which the interfaces are being fetched for

device_ids
Array of integers non-empty

IP address of the device for which the interfaces are being fetched for

type
required
string
Default: "All"
Enum: "All" "Physical" "Loopback" "VE" "PO"

Interface types. All, Ethernet interfaces, Loopback interfaces only, VE interfaces only or Port channels only

admin_state
required
string
Default: "All"
Enum: "Up" "Down" "All"

Interface's admin state. up, down, all values only for admin state

rme
boolean

Interface's RME. enabled or not

oper_state
required
string
Default: "All"
Enum: "Up" "Down" "All"

Interface's oper state(Line protocol state). up, down, all values only for admin state

fabric_intf_role
string
Enum: "fabric" "edge"

Fabric interface role , it can be either fabric or edge, Fabric means it will returns interfaces connected to other fabric devices otherwise it is edge ports. This parameter must be given in conjunction with device_ips or device_ids

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

get/interfaces
http://goinventory-service:80/v1/inventory/interfaces

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

Change Interface Port Admin State

Down/Up interfaces with the specific parameters for the specified switch

Request Body schema: application/json

Register a new Switch.

ip_address
required
Array of strings non-empty
intfNames
required
Array of strings non-empty
adminState
required
string
Enum: "up" "down"
intfType
string
Default: "Eth"
Enum: "Eth" "VE" "PO"

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

put/interfaces/admin-state
http://goinventory-service:80/v1/inventory/interfaces/admin-state

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "intfType": "Eth",
  • "adminState": "up",
  • "ip_address": "ip_address",
  • "intfNames":
    [
    ]
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Create Breakout Interface Port

Create Breakout interfaces port with the specific parameters for the specified switch

Request Body schema: application/json

Breakout break Port into multiple interfaces.

ip_address
required
Array of strings non-empty
intfNames
required
Array of strings non-empty

Interface Port Names

intfType
string
Default: "Eth"
Enum: "Eth" "VE" "PO"
mode
required
string
Enum: "4x10g" "4x25g"

Port breakout mode

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

post/interfaces/breakout
http://goinventory-service:80/v1/inventory/interfaces/breakout

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "mode": "4x10g",
  • "intfType": "Eth",
  • "ip_address": "ip_address",
  • "intfNames":
    [
    ]
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Remove Breakout of Interface Port

Remove Breakout of interfaces port with the specific parameters for the specified switch

Request Body schema: application/json

Removes Breakout of interfaces of the Switch.

ip_address
Array of strings
intfNames
required
Array of strings

Interface Port Names

intfType
string
Default: "Eth"
Enum: "Eth" "VE" "PO"

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

delete/interfaces/breakout
http://goinventory-service:80/v1/inventory/interfaces/breakout

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "ip_address":
    [
    ],
  • "intfNames":
    [
    ],
  • "intfType": "Eth"
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

List Breakout Interface Port

List Breakout interfaces port with the specific parameters for the specified switch

query Parameters
device_ips
Array of strings non-empty

IP Addresses of the device(s) to List Breakout Ports.

fabric_name
string

List Breakout Ports of devices which are associated to the fabric name.

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

409

Conflict.

500

Unexpected error.

default

Unexpected error

get/interfaces/breakout
http://goinventory-service:80/v1/inventory/interfaces/breakout

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Change Interface Port Speed

Change interfaces port speed with the specific parameters for the specified switch

Request Body schema: application/json

Change Port speed of interfaces of the Switch.

ip_address
required
Array of strings non-empty
intfNames
required
Array of strings non-empty

Interface Port Names

speed
required
string
Enum: "100Mbps" "1Gbps" "10Gbps" "25Gbps" "40Gbps" "100Gbps" "1GbpsAN" "AUTO"

Port Speed

intfType
string
Default: "Eth"
Enum: "Eth" "VE" "PO"

Interface Type

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

put/interfaces/port-speed
http://goinventory-service:80/v1/inventory/interfaces/port-speed

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "intfType": "Eth",
  • "ip_address": "ip_address",
  • "intfNames":
    [
    ],
  • "speed": "100Mbps"
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Change Interface Port MTU

Set L2Mtu, IPv4Mtu and IPv6Mtu to interfaces with the specific parameters for the specified switch

Request Body schema: application/json

Set L2Mtu, IPv4Mtu and IPv6Mtu to device interfaces.

ip_address
required
Array of strings non-empty
intfNames
required
Array of strings non-empty

Interface Port Names

intfType
string
Default: "Eth"
Enum: "Eth" "VE" "PO"

Interface Type

mtu
integer

L2 Mtu of interface

ip_mtu
integer

IPv4 Mtu of interface

ipv6_mtu
integer

IPv6 Mtu of interface

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

put/interfaces/set-mtu
http://goinventory-service:80/v1/inventory/interfaces/set-mtu

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "ip_address":
    [
    ],
  • "intfNames":
    [
    ],
  • "intfType": "Eth",
  • "mtu": 0,
  • "ip_mtu": 0,
  • "ipv6_mtu": 0
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Change Interface Port Forward Error Correction (FEC)

Change interfaces port FEC with the specific parameters for the specified switch

Request Body schema: application/json

Change Port FEC of interfaces of the Switch.

ip_address
required
Array of strings non-empty
intfNames
required
Array of strings non-empty

Interface Port Names

mode
required
string
Enum: "fc-fec" "rs-fec" "auto" "disabled"

Port FEC mode

intfType
string
Default: "Eth"
Enum: "Eth" "VE" "PO"

Interface Type

Responses

200

OK

401

Authorization information is missing or invalid.

500

Unexpected error.

default

Unexpected error

put/interfaces/port-fec
http://goinventory-service:80/v1/inventory/interfaces/port-fec

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "intfType": "Eth",
  • "ip_address": "ip_address",
  • "intfNames":
    [
    ],
  • "mode": "fc-fec"
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Remove Port Forward Error Correction (FEC) from Interface Port

Remove Port FEC of interfaces port with the specific parameters for the specified switch

Request Body schema: application/json

Removes Port FEC of interfaces of the Switch.

ip_address
Array of strings
intfNames
required
Array of strings

Interface Port Names

intfType
string
Default: "Eth"
Enum: "Eth" "VE" "PO"

Interface Type

Responses

200

OK

401

Authorization information is missing or invalid.

500

Unexpected error.

default

Unexpected error

delete/interfaces/port-fec
http://goinventory-service:80/v1/inventory/interfaces/port-fec

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "intfType": "Eth",
  • "ip_address": "ip_address",
  • "intfNames":
    [
    ]
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Change Interface Port Dampening

Change interfaces port dampening with the specific parameters for the specified switch

Request Body schema: application/json

Change Port Dampening of interfaces of the Switch.

ip_address
required
Array of strings non-empty
intfNames
required
Array of strings non-empty

Interface Port Names

toggleThreshold
integer

Port Dampening toggle threshold

samplingTime
integer

Port Dampening sampling time

waitTime
integer

Port Dampening wait time

Responses

200

OK

401

Authorization information is missing or invalid.

500

Unexpected error.

default

Unexpected error

put/interfaces/port-dampening
http://goinventory-service:80/v1/inventory/interfaces/port-dampening

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "ip_address": "ip_address",
  • "intfNames":
    [
    ],
  • "toggleThreshold": 1,
  • "samplingTime": 1,
  • "waitTime": 1
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Remove Port Dampening from Interface Port

Remove Port Dampening of interfaces port with the specific parameters for the specified switch

Request Body schema: application/json

Removes Port Dampening of interfaces of the Switch.

ip_address
Array of strings
intfNames
required
Array of strings

Interface Port Names

Responses

200

OK

401

Authorization information is missing or invalid.

500

Unexpected error.

default

Unexpected error

delete/interfaces/port-dampening
http://goinventory-service:80/v1/inventory/interfaces/port-dampening

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "ip_address": "ip_address",
  • "intfNames":
    [
    ]
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Change Interface Port Redundant management Ethernet (RME)

Enable RME on interfaces with the specific parameters for the specified switch

Request Body schema: application/json

Change RME status of interfaces of the Switch.

ip_address
required
Array of strings non-empty
intfNames
required
string

Interface Port Name

EnableRME
boolean

Port RME toggle threshold

Responses

200

OK

401

Authorization information is missing or invalid.

500

Unexpected error.

default

Unexpected error

put/interfaces/redundant-management
http://goinventory-service:80/v1/inventory/interfaces/redundant-management

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "ip_address":
    [
    ],
  • "intfNames": "0/31",
  • "EnableRME": true
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Port Channels

getPortChannels

Get only the POs with the specific parameters for the specified switches

query Parameters
device_ips
Array of strings non-empty

IP address of the device for which the port channels are being fetched for

device_ids
Array of integers non-empty

IP address of the device for which the port channels are being fetched for

po_numbers
Array of integers non-empty

Numbers of the Port Channels to be fetched

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

get/portchannels
http://goinventory-service:80/v1/inventory/portchannels

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

LLDP data

getLldpData

Get LLDP data for a given input param

query Parameters
remote_macs
Array of strings non-empty

fetch the lldp data for remote interface MACs in hhhh.hhhh.hhhh format

device_ips
Array of strings non-empty

Fetch the lldp data for single device IP in hhh.hhh.hhh.hhh format

neighbor_type
string
Default: "all"
Enum: "all" "edge" "fabric"

fetch all, edge or fabric lldp neighbors as a filter.

Responses

200

OK

400

Get links request has invalid input params.

401

Authorization information is missing or invalid.

500

Unexpected error.

default

Unexpected error

get/lldp_data
http://goinventory-service:80/v1/inventory/lldp_data

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

VLANS

getVLANs

Get VLANS for the specified switches

query Parameters
device_ip
string

IP address of the device for which the VLANs are being fetched for

device_id
integer

Device IDs for which the VLANs are being fetched for

vlan_ids
Array of integers non-empty

VLAN IDs to be fetched

Responses

200

OK

400

Vlan request has invalid input params.

401

Authorization information is missing or invalid.

404

Vlans with specified device IP/ID or Vlan ID was not found.

500

Unexpected error.

default

Unexpected error

get/vlans
http://goinventory-service:80/v1/inventory/vlans

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

Mirror Sessions

getMirrorSessions

Get Mirror Sessions for the specified switches

query Parameters
device_ip
string

IP address of the device for which the Mirror Sessions are being fetched for

device_id
integer

Device IDs for which the Mirror Sessions are being fetched for

Responses

200

OK

400

Mirror Session request has invalid input params.

401

Authorization information is missing or invalid.

404

Mirror Sessions with specified device IP/ID was not found.

500

Unexpected error.

default

Unexpected error

get/mirror-session
http://goinventory-service:80/v1/inventory/mirror-session

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

Drift Reconcile History list

getDriftReconcileHistorys

Get Drift Reconcile History list

query Parameters
device_ip
string

Ip of the entry for which Drift-Reconcile history is fetched

Responses

200

OK

404

No Drift Reconcile History found in the system

500

Unexpected error

default

Unexpected error

get/drift-reconciles
http://goinventory-service:80/v1/inventory/drift-reconciles

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

Drift Reconcile Details

getDriftReconcileDetail

Get Drift Reconcile Detail

query Parameters
dr_id
required
string

DriftReconcile Id of the entry for which detail is fetched

Responses

200

OK

404

Status of the device was not found.

500

Unexpected error.

default

Unexpected error

get/drift-reconcile-detail
http://goinventory-service:80/v1/inventory/drift-reconcile-detail

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "dr_id": "1111-1111-1111",
  • "device-ip": "1.1.1.1",
  • "status": "Success",
  • "Reason": "Manual",
  • "StartTime": "12:03:24,12/2/2020"
}

Config Backup History list

getConfigBackupHistorys

Get Config Backup History list

query Parameters
device_ip
string

Ip of the entry for which Config-Backup history is fetched

Responses

200

OK

404

No Drift Reconcile History found in the system

500

Unexpected error

default

Unexpected error

get/config-backups
http://goinventory-service:80/v1/inventory/config-backups

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

Config Backup Details

getConfigBackupDetail

Get Config Backup Detail

query Parameters
cb_id
required
string

ConfigBackup Id of the entry for which detail is fetched

show_config
boolean

Show complete configuration text

Responses

200

OK

404

Status of the device was not found.

500

Unexpected error.

default

Unexpected error

get/config-backup-detail
http://goinventory-service:80/v1/inventory/config-backup-detail

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "cb_id": "1111-1111-1111",
  • "device-ip": "1.1.1.1",
  • "status": "Success",
  • "Reason": "Manual",
  • "StartTime": "12:03:24,12/2/2020"
}

Config Replay History list

getConfigReplayHistorys

Get Config Replay History list

query Parameters
device_ip
string

Ip of the entry for which Config-Replay history is fetched

Responses

200

OK

404

No Config Replay History found in the system

500

Unexpected error

default

Unexpected error

get/config-replays
http://goinventory-service:80/v1/inventory/config-replays

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

Config Replay Details

getConfigReplayDetail

Get Config Replay Detail

query Parameters
cr_id
required
string

ConfigReplay Id of the entry for which detail is fetched

Responses

200

OK

404

Status of the device was not found.

500

Unexpected error.

default

Unexpected error

get/config-replay-detail
http://goinventory-service:80/v1/inventory/config-replay-detail

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "cr_id": "1111-1111-1111",
  • "device-ip": "1.1.1.1",
  • "cb_id": "2222-3333-2233",
  • "status": "Success",
  • "Reason": "Manual",
  • "StartTime": "12:03:24,12/2/2020"
}

VE Interface

getVEs

Get only the VEs with the specific parameters for the specified switches

query Parameters
device_ips
Array of strings non-empty

IP address of the device for which the VEs are being fetched for

device_ids
Array of integers non-empty

IP address of the device for which the VEs are being fetched for

ve_ids
Array of integers non-empty

IDs of the VEs to be fetched

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

get/veinterfaces
http://goinventory-service:80/v1/inventory/veinterfaces

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

Router BGP

getRouterBgp

Get only the Router BGP with the specific parameters for the specified switch

query Parameters
device_ip
string

IP address of the device for which the Router BGP are being fetched for

device_id
integer

IP address of the device for which the Router BGP are being fetched for

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

get/bgp
http://goinventory-service:80/v1/inventory/bgp

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "af_ip":
    [
    ],
  • "peer_group":
    [
    ],
  • "router_bgp":
    {
    },
  • "af_evpn":
    {
    }
}

MCT

getMCTManagementCluster

Get only the MCT cluster node details with the specific parameters for the specified switch

query Parameters
device_ip
string

IP address of the device for which the cluster members are being fetched for

device_id
integer

ID of the device for which the cluster member are being fetched for

node_ids
Array of integers non-empty

IDs of the cluster nodes to be fetched. This is optional parameter along with device_id or device_ip

ids
Array of integers non-empty

IDs of the nodes to be fetched

Responses

200

OK

400

Management cluster request has invalid input params.

401

Authorization information is missing or invalid.

404

Management Cluster with the specified device IP/ID or Node ID or instance ID was not found.

500

Unexpected error.

default

Unexpected error

get/mct/management
http://goinventory-service:80/v1/inventory/mct/management

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

getMCTClusterConfiguration

Get the MCT cluster configuration with the specific parameters for the specified switch

query Parameters
device_ip
string

IP address of the device for which the cluster members are being fetched for

device_id
integer

Device ID of the device for which the cluster member are being fetched for

cluster_ids
Array of integers non-empty

cluster ID for which the configuration to be fetched. This is optional parameter along with device_ip or device_id

ids
Array of integers non-empty

IDs of the cluster client members to be fetched

Responses

200

OK

400

MCT cluster request has invalid input params.

401

Authorization information is missing or invalid.

404

MCT cluster with specified device IP/ID or Cluster ID or instance ID was not found.

500

Unexpected error.

default

Unexpected error

get/mct/cluster
http://goinventory-service:80/v1/inventory/mct/cluster

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

getMCTClusterClients

Get the MCT cluster client details with the specific parameters for the specified switch

query Parameters
device_ip
string

IP address of the device for which the cluster members are being fetched for

device_id
integer

ID of the device for which the cluster member are being fetched for

client_ids
Array of integers non-empty

cluster client ID for which the members to be fetched

cluster_id
integer

ID of the cluster for which the clients to be fetched

ids
Array of integers non-empty

IDs of the cluster client members to be fetched

Responses

200

OK

400

MCT client request has invalid input params.

401

Authorization information is missing or invalid.

404

MCT clients with specificed device IP/ID or Client ID or Cluster ID or instance ID was not found.

500

Unexpected error.

default

Unexpected error

get/mct/client
http://goinventory-service:80/v1/inventory/mct/client

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

LIF

getLIF

Get only the LIFs details with the specific parameters for the specified switch

query Parameters
device_ip
string

IP address of the device for which the lifs are being fetched for

device_id
integer

IP address of the device for which the lifs are being fetched for

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

get/lif
http://goinventory-service:80/v1/inventory/lif

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

EVPN

getEVPNInstance

Get only the EVPN Instance details along with Bridge Domain, VLAN mapping with the specific parameters for the specified switch

query Parameters
device_ip
string

IP address of the device for which the evpn instance are being fetched for

device_id
integer

Device ID for which the evpn instance are being fetched for

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

get/evpn
http://goinventory-service:80/v1/inventory/evpn

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "evpn":
    {
    },
  • "vlans":
    [
    ],
  • "route_target":
    [
    ],
  • "id": 1,
  • "bridge_domains":
    [
    ]
}

Pseudowire Profile

getPseudowireProfile

Get the Pseudowire Profile details with the specific parameters for the specified switch

query Parameters
device_ip
string

IP address of the device for which the Pseudowire Profile details are being fetched for

device_id
integer

IP address of the device for which the Pseudowire Profile details are being fetched for

pseudowire_profiles
Array of strings non-empty

Pseudowire Profiles that users want to specifically query. This will be in conjunction with the device_id or device_ip

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

get/pwprofile
http://goinventory-service:80/v1/inventory/pwprofile

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Bridge Domain

getBridgeDomain

Get only the EVPN Instance details along with Bridge Domain mapping with the specific parameters for the specified switch

query Parameters
device_ip
string

IP address of the device for which the BD details are being fetched for

device_id
integer

IP address of the device for which the BD details are being fetched for

bridge_domains
Array of integers non-empty

Bridge domains that users want to specifically query. This will be in conjunction with the device_id or device_ip

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

get/bridgedomain
http://goinventory-service:80/v1/inventory/bridgedomain

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Overlay Gateway

getOverlayGateway

Get only the Overlay Gateway details along with Bridge Domain to VNI mappinps and VLAN to VNI mapping with the specific parameters for the specified switch

query Parameters
device_ip
string

IP address of the device for which the overlay gateway details are being fetched for

device_id
integer

Device ID for which the overlay gateway details are being fetched for

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

get/overlaygateway
http://goinventory-service:80/v1/inventory/overlaygateway

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Tunnels

getTunnel

Get only the Tunnel details with the specific parameters for the specified switch

query Parameters
device_ip
string

IP address of the device for which the tunnel details are being fetched for

device_id
integer

IP address of the device for which the tunnel details are being fetched for

ids
Array of integers non-empty

IDs of the tunnel details to be fetched

tunnel_numbers
Array of integers non-empty

Tunnel Numbers of the tunnel details to be fetched

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

get/tunnel
http://goinventory-service:80/v1/inventory/tunnel

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "tunnels":
    [
    ],
  • "ip_address": "ip_address"
}

VRF

getVRF

Get only the VRF details with the specific parameters for the specified switch

query Parameters
device_ip
string

IP address of the device for which the VRF details are being fetched for

device_id
integer

IP address of the device for which the VRF details are being fetched for

ids
Array of integers non-empty

IDs of the VRF details to be fetched

vrfs
Array of strings non-empty

VRF names of the VRF details to be fetched. This will be in conjunction with device_ip or device_id

Responses

200

OK

400

VRF request has invalid input params.

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

get/vrf
http://goinventory-service:80/v1/inventory/vrf

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

VRRP

getVRRP

Get only the VRRP details with the specific parameters for the specified switch

query Parameters
device_ip
string

IP address of the device for which the VRF details are being fetched for

device_id
integer

IP address of the device for which the VRF details are being fetched for

int_type
string
Enum: "ethernet" "ve"

Interface Type to fetch VRRP details for. This works in conjunction with device_id or device_ip and int_name

int_name
string

Interface Name to fetch VRRP details for. This works in conjunction with device_id or device_ip and int_type

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

get/vrrp
http://goinventory-service:80/v1/inventory/vrrp

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Router PIM

getRouterPim

Get only the Router Pim with the specific parameters for the specified switch

query Parameters
device_ip
string

IP address of the device for which the Router PIM are being fetched for

device_id
integer

Device ID for which the Router PIM are being fetched for

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

get/pim
http://goinventory-service:80/v1/inventory/pim

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "pim":
    [
    ]
}

IP Prefix-List

getIPPrefixList

Get only the IP Prefix List with the specific parameters for the specified switch

query Parameters
device_ip
string

IP address of the device for which the IP Prefix List is being fetched for

device_id
integer

Device ID for which the IP Prefix List is being fetched for

prefixlist_name
string

IP Prefix List name that is being fetched. This will be in conjunction with device_ip or device_id

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

get/ip-prefix-list
http://goinventory-service:80/v1/inventory/ip-prefix-list

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "ipprefix-list":
    [
    ]
}

Route map

getRouteMap

Get only the Route map with the specific parameters for the specified switch

query Parameters
device_ip
string

IP address of the device for which the Route Map is being fetched for

device_id
integer

Device ID for which the Route Map is being fetched for

routemap_name
string

Route Map name that is being fetched. This will be in conjunction with device_ip or device_id

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

get/route-map
http://goinventory-service:80/v1/inventory/route-map

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

Trouble Shooting

getExecutionDetail

Get the detailed output of the given execution ID

query Parameters
id
required
string

Detailed output of the given execution ID

Responses

200

OK

401

Authorization information is missing or invalid.

500

Unexpected error.

default

Unexpected error

get/execution
http://goinventory-service:80/v1/inventory/execution

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "start_time": "2000-01-23T04:56:07.000Z",
  • "end_time": "2000-01-23T04:56:07.000Z",
  • "id": "id",
  • "logs": "logs",
  • "URL": "/v1/inventory/switches",
  • "status": "Failed, Succeeded"
}

getExecutionList

Get the list of all the previous executions

query Parameters
limit
required
integer
Default: 10

Limit the number of executions that will be sent in the response. Default is 10

status
string
Default: "all"

Filter the executions based on the status(failed/succeeded/all)

Responses

200

OK

401

Authorization information is missing or invalid.

500

Unexpected error.

default

Unexpected error

get/executions
http://goinventory-service:80/v1/inventory/executions

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

GetRunningConfig

Get the list of all CLIs in Running Config

Responses

200

OK

401

Authorization information is missing or invalid.

500

Unexpected error.

default

Unexpected error

get/runningConfig
http://goinventory-service:80/v1/inventory/runningConfig

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

Key Value

getKeyValueList

Returns a list of all key value pairs.

query Parameters
prefix
string

Only return values which name starts with the provided prefix.

decrypt
boolean

Decrypt secrets and display plain text

limit
integer
Default: 100

Number of keys to get

Responses

200

List of key value pairs

default

Unexpected error

get/keys
http://goinventory-service:80/v1/inventory/keys

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "ref": "core.local"
}

getValueForKey

Get a specific key vale pair based on key_name.

path Parameters
name
required
string

Key Name

query Parameters
decrypt
boolean

Decrypt secrets and display plain text.

Responses

200

Key value pair requested.

default

Unexpected error

get/keys/{name}
http://goinventory-service:80/v1/inventory/keys/{name}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "name": "name",
  • "secret": true,
  • "value": "value"
}

updateValueForKey

Create a new key value pair or update an existing one.

path Parameters
name
required
string

Key Name.

Request Body schema: application/json

Key Value pair content.

name
required
string

Key Name.

value
required
string

Key's value.

secret
boolean

Encrypt value before saving the value.

Responses

200

Key set/updated.

default

Unexpected error

put/keys/{name}
http://goinventory-service:80/v1/inventory/keys/{name}

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "name": "name",
  • "secret": true,
  • "value": "value"
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "name": "name",
  • "secret": true,
  • "value": "value"
}

deleteKey

Delete a Key.

path Parameters
name
required
string

Key Name.

Responses

204

Key deleted.

default

Unexpected error

delete/keys/{name}
http://goinventory-service:80/v1/inventory/keys/{name}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "message": "Device is already registered in inventory",
  • "code": 101
}

FirmwareHosts

getFirmwareHosts

Get all firmware hosts.

query Parameters
host_ips
Array of strings non-empty

IPs of the firmware hosts to be fetched

Responses

200

OK

404

No firmware hosts found.

500

Unexpected error.

default

Unexpected error

get/firmware-hosts
http://goinventory-service:80/v1/inventory/firmware-hosts

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

FirmwareHost

getFirmwareHost

Get only specified firmware host details. The firmware host can be identified by IP Address

query Parameters
ip_address
required
string

IP Address of the firmware host

Responses

200

OK

404

A firmware host with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

get/firmware-host
http://goinventory-service:80/v1/inventory/firmware-host

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "protocol": "scp",
  • "id": 1,
  • "ip_address": "10.24.39.224",
  • "status":
    {
    }
}

registerFirmwareHost

Register firmware host with the inventory service

Request Body schema: application/json

Register a new firmware host.

ip_address
required
string
protocol
required
string
Enum: "ftp" "tftp" "sftp" "scp" "http"
username
required
string
password
required
string

Responses

200

OK

401

Authorization information is missing.

409

A firmware host with the specified IP already exists.

422

Invalid IP/Protocol/Username/Password for registering the firmware host.

424

Firmware host connection failed while registering the host.

500

Unexpected error.

default

Unexpected error

post/firmware-host
http://goinventory-service:80/v1/inventory/firmware-host

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "protocol": "ftp",
  • "password": "password",
  • "ip_address": "ip_address",
  • "username": "username"
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "protocol": "scp",
  • "id": 1,
  • "ip_address": "10.24.39.224",
  • "status":
    {
    }
}

deleteFirmwareHost

Delete the specified firmware host from the inventory.

query Parameters
ip_address
required
string

IP Addresses of the firmware host to be deleted.

Responses

200

OK

404

A firmware host with the specified IP Address was not found.

422

Not able to delete the firmware host with specified IP Address.

500

Unexpected error.

default

Unexpected error

delete/firmware-host
http://goinventory-service:80/v1/inventory/firmware-host

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "protocol": "scp",
  • "id": 1,
  • "ip_address": "10.24.39.224",
  • "status":
    {
    }
}

updateFirmwareHost

Update the specified firmware host details in the inventory.

path Parameters
ip_address
required
string

IP Address of the firmware host to be updated.

Request Body schema: application/json

Update firmware host if credentials changes provide new username and password

ip_address
required
string
protocol
required
string
Enum: "ftp" "tftp" "sftp" "scp" "http"
username
required
string
password
required
string

Responses

200

OK

401

Authorization information is missing.

404

Couldnt connect to the firmware host.

422

Update firmware download host failed because of invalid IP address in the request.

424

Firmware host update failed for the specified IP address.

500

Unexpected error.

default

Unexpected error

put/firmware-host/{ip_address}
http://goinventory-service:80/v1/inventory/firmware-host/{ip_address}

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "protocol": "ftp",
  • "password": "password",
  • "ip_address": "ip_address",
  • "username": "username"
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "protocol": "scp",
  • "id": 1,
  • "ip_address": "10.24.39.224",
  • "status":
    {
    }
}

DeviceDetails

Get device discovery interval time & device details

Get device discovery interval time for specific switch or switches in fabric

query Parameters
fabric_name
string

Only devices which are associated to the fabric name specified as returned.

device_ips
string

Device IP's of switches to be fetched

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

get/device/discovery
http://goinventory-service:80/v1/inventory/device/discovery

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

Change device discovery interval time

Change device discovery interval time for specific switch or switches in fabric

Request Body schema: application/json

Change Port speed of interfaces of the Switch.

ip_address
string

IP address of the device

fabric_name
string

Name of the fabric

min
integer

Device discovery time in minutes

hour
integer

Device discovery time in minutes

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

put/device/discovery
http://goinventory-service:80/v1/inventory/device/discovery

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "ip_address": "10.25.225.165",
  • "fabric_name": "default",
  • "min": 30,
  • "hour": 2
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

DevicesLockStatus

Get devices lock statuses

Get devices lock statuses

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

get/debug/deviceslock
http://goinventory-service:80/v1/inventory/debug/deviceslock

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

UnlockExistingLock

Force Unlock Current Locks.

Force Unlock Current Locks.

query Parameters
device_ips
Array of strings non-empty

IP Addresses of the device(s) to be forcefully remove locks.

fabric_name
string

Forcefully Update Fwdl status of devices which are associated to the fabric name.

service_lock
boolean
Default: false

Value true implies service lock need to be removed

Responses

200

OK

404

No switches found for the specified fabric.

422

Specified Fabric not found.

500

Unexpected error.

default

Unexpected error

put/debug/deviceslock
http://goinventory-service:80/v1/inventory/debug/deviceslock

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

ServiceLockStatus

getServiceLockStatus

Get the service Lock status from Inventory service.

Responses

200

OK

409

Approval From one of service is failed

get/servicelockstatus
http://goinventory-service:80/v1/inventory/servicelockstatus

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "ServiceName": "string",
  • "Status": "string",
  • "Error": "string"
}

Debug

deviceConfigDriftReconcile

This API helps user to generate the config-drift between efa intended and device configuration. If reconcile flag is set then drifted configuration will be reconciled on the device.

query Parameters
ip_address
required
string

IP Addresses of the device for which config drift will be generated.

reconcile
required
boolean
Default: false

Value true implies efa drift with devices will be reconciled

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

409

A drift and reconcile operation is already in progress for the device.

500

Unexpected error.

default

Unexpected error

post/debug/device/config/drift
http://goinventory-service:80/v1/inventory/debug/device/config/drift

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "mgmt-ip": "10.10.10.10",
  • "reconciliation-status":
    [
    ],
  • "config-drift":
    {
    }
}

GetFwdlInProgressDevices

Get FWDL In progress devices

Get FWDL In progress devices

Responses

200

OK

401

Authorization information is missing or invalid.

404

A device with the specified IP was not found.

500

Unexpected error.

default

Unexpected error

get/debug/updatefwdlstatus
http://goinventory-service:80/v1/inventory/debug/updatefwdlstatus

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

ForceRemovalFromFwdl

Force Removal from Fwdl status

Force Removal from Fwdl status.

query Parameters
device_ips
Array of strings non-empty

IP Addresses of the device(s) to be forcefully updated the fwdl status.

fabric_name
string

Forcefully Update Fwdl status of devices which are associated to the fabric name.

Responses

200

OK

404

No switches found for the specified fabric.

422

Specified Fabric not found.

500

Unexpected error.

default

Unexpected error

put/debug/updatefwdlstatus
http://goinventory-service:80/v1/inventory/debug/updatefwdlstatus

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Certificates

Install Certificates

Install certificates

Request Body schema: application/json

Install certificates on switches

device_ips
Array of strings
certificateType
string
Enum: "https" "token"

Type of certificate to be installed, either https or token

Responses

200

OK

401

Authorization information is missing or invalid.

500

Unexpected error.

default

Unexpected error

post/certificate
http://goinventory-service:80/v1/inventory/certificate

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "device_ips":
    [
    ],
  • "certificateType": "https"
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Device State Change History list

GetDSCHistorys

Get Device State Change History list

query Parameters
device_ip
string

Ip of the device for which DSC history is fetched

Responses

200

OK

404

No DSC History found in the system

500

Unexpected error

default

Unexpected error

get/dsc-history
http://goinventory-service:80/v1/inventory/dsc-history

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

Device State Change Details

getDeviceState

Get Device Current State

query Parameters
device_ip
string

Ip of the entry for which Device State is fetched

Responses

200

OK

404

State of the device was not found.

500

Unexpected error.

default

Unexpected error

get/device-current-state
http://goinventory-service:80/v1/inventory/device-current-state

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "device-ip": "1.1.1.1",
  • "admin_state_action": "up",
  • "oper_state": "up",
  • "switch_health_status": "enable"
}

getDSCDetail

Get DSC Detail

query Parameters
dsc_id
required
string

DSC Id of the entry for which detail is fetched

Responses

200

OK

404

Status of the device was not found.

500

Unexpected error.

default

Unexpected error

get/device-state
http://goinventory-service:80/v1/inventory/device-state

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "dr_id": "1111-1111-1111",
  • "device-ip": "1.1.1.1",
  • "admin_state_action": "up",
  • "status": "Success",
  • "Fabric_status": "Success",
  • "Tenant_status": "Success",
  • "Policy_status": "Success",
  • "maintenance_mode_enable_status": "Success",
  • "StartTime": "12:03:24,12/2/2020"
}

Device state

deviceState

Trigger device state update as up or down.

query Parameters
ip_address
required
string

IP Address of the device to be retrieved.

state
required
string

State of the device to changed.

Responses

202

Accepted device state update as up or down request

409

Invalid IP address.

500

Unexpected error.

default

Unexpected error

post/device-state
http://goinventory-service:80/v1/inventory/device-state

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "href": "href",
  • "uuid": "id"
}

Device State

deleteDscDetails

delet DSC ID.

query Parameters
key
string

IP Addresses of the device or DSC uuid to deleted.

Responses

200

device state change delete request

409

Invalid IP address.

500

Unexpected error.

default

Unexpected error

delete/device-state
http://goinventory-service:80/v1/inventory/device-state

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "result": 0,
  • "userKey": "1111-1111-1111",
  • "error": "uuid not found"
}

Health

getHealth

Get the health of the Inventory service.

Responses

200

OK

get/health
http://goinventory-service:80/v1/inventory/health

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "Service": "string",
  • "MessageBus": "string"
}

NtpServers

getNtpServers

Get NTP servers for a list of devices

query Parameters
device_ips
Array of strings non-empty

IP addresses of the devices

fabric_name
string

Fabric name. Get the NTP servers for all the devices in the given fabric.

Responses

200

OK

401

Authorization information is missing or invalid.

404

IP address of device specified is not registered.

422

Specified Fabric not found.

500

Unexpected error

default

Unexpected error

get/ntp/server
http://goinventory-service:80/v1/inventory/ntp/server

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

NtpServer

createNtpServer

Create NTP server

Request Body schema: application/json

Create a NTP server

device_ips
Array of strings

IP address of devices

fabric_name
string

Name of the fabric

server
object (Server information)

Responses

200

OK

401

Authorization information is missing or invalid.

404

IP address of device specified is not registered.

422

Specified Fabric not found.

500

Unexpected error.

default

Unexpected error

post/ntp/server
http://goinventory-service:80/v1/inventory/ntp/server

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "fabric_name": "default",
  • "device_ips":
    [
    ],
  • "server":
    {
    }
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

deleteNtpServer

Delete NTP Server

query Parameters
server_ip
required
string

IP address of the NTP server

device_ips
Array of strings non-empty

IP addresses of the devices where NTP server needs to be deleted

fabric_name
string

Fabric name. Delete the NTP server for prepared devices in the given fabric.

Responses

200

OK

401

Authorization information is missing or invalid.

404

IP address of device specified is not registered.

422

Specified Fabric not found.

500

Unexpected error.

default

Unexpected error

delete/ntp/server
http://goinventory-service:80/v1/inventory/ntp/server

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

NtpDisable

getNtpDisable

Get NTP disable for a list of devices

query Parameters
device_ips
Array of strings non-empty

IP addresses of the devices

fabric_name
string

Fabric name. Get the NTP disable for all the devices in the given fabric.

Responses

200

OK

401

Authorization information is missing or invalid.

404

IP address of device specified is not registered.

422

Specified Fabric not found.

500

Unexpected error

default

Unexpected error

get/ntp/disable
http://goinventory-service:80/v1/inventory/ntp/disable

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

ntpDisable

Ntp disable server on the switches.

Request Body schema: application/json

IPs of the devices to disable ntp serve.

device_ips
Array of strings
fabric_name
string

Name of the fabric

disable
object (Disable information)

Responses

200

Ntp disable server request succesful

401

Authorization information is missing or invalid.

404

IP address of device specified is not registered.

422

Specified Fabric not found.

500

Unexpected error.

default

Unexpected error

post/ntp/disable
http://goinventory-service:80/v1/inventory/ntp/disable

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "fabric_name": "default",
  • "device_ips": "10.10.10.10 20.20.20.20",
  • "disable":
    {
    }
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

SNMP communities

getSnmpCommunities

Get SNMP communities for a list of devices

query Parameters
device_ips
Array of strings non-empty

IP addresses of the devices

Responses

200

OK

401

Authorization information is missing or invalid.

404

IP address of device specified is not registered.

500

Unexpected error

default

Unexpected error

get/snmp/community
http://goinventory-service:80/v1/inventory/snmp/community

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

SnmpCommunity

createSnmpCommunity

Create SNMP community

Request Body schema: application/json

Create a SNMP community

device_ips
Array of strings

IP address of devices

community
object (SNMP community and group information)

Responses

200

OK

401

Authorization information is missing or invalid.

404

IP address of device specified is not registered.

409

SNMP community with the specified name already exists.

500

Unexpected error.

default

Unexpected error

post/snmp/community
http://goinventory-service:80/v1/inventory/snmp/community

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "device_ips":
    [
    ],
  • "community":
    [
    ]
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

deleteSnmpCommunity

Delete SNMP community

query Parameters
name
required
string

Name of the SNMP community

device_ips
Array of strings non-empty

IP addresses of the devices where SNMP community needs to be deleted

Responses

200

OK

401

Authorization information is missing or invalid.

404

IP address of device specified is not registered.

500

Unexpected error.

default

Unexpected error

delete/snmp/community
http://goinventory-service:80/v1/inventory/snmp/community

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

SNMP users

getSnmpUsers

Get SNMP users for a list of devices

query Parameters
device_ips
Array of strings non-empty

IP addresses of the devices

Responses

200

OK

401

Authorization information is missing or invalid.

404

IP address of device specified is not registered

500

Unexpected error

default

Unexpected error

get/snmp/user
http://goinventory-service:80/v1/inventory/snmp/user

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

SnmpUser

createSnmpUser

Create SNMP user

Request Body schema: application/json

Create a SNMP user

device_ips
Array of strings

IP address of devices

user
object (SNMP user and group information)

Responses

200

OK

401

Authorization information is missing or invalid.

404

IP address of device specified is not registered.

500

Unexpected error.

default

Unexpected error

post/snmp/user
http://goinventory-service:80/v1/inventory/snmp/user

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "device_ips":
    [
    ],
  • "user":
    {
    }
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

deleteSnmpUser

Delete SNMP user

query Parameters
name
required
string

Name of the SNMP user

device_ips
Array of strings non-empty

IP addresses of the devices where SNMP user needs to be deleted

Responses

200

OK

401

Authorization information is missing or invalid.

404

IP address of device specified is not registered.

500

Unexpected error.

default

Unexpected error

delete/snmp/user
http://goinventory-service:80/v1/inventory/snmp/user

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

SNMP hosts

getSnmpHosts

Get SNMP hosts for a list of devices

query Parameters
device_ips
Array of strings non-empty

IP addresses of the devices

Responses

200

OK

401

Authorization information is missing or invalid.

404

IP address of device specified is not registered.

500

Unexpected error

default

Unexpected error

get/snmp/host
http://goinventory-service:80/v1/inventory/snmp/host

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

SnmpHost

createSnmpHost

Create SNMP host

Request Body schema: application/json

Create a SNMP host

device_ips
Array of strings

IP address of devices

host
object (SNMP host information)

Responses

200

OK

401

Authorization information is missing or invalid.

404

IP address of device specified is not registered.

500

Unexpected error.

default

Unexpected error

post/snmp/host
http://goinventory-service:80/v1/inventory/snmp/host

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "device_ips":
    [
    ],
  • "host":
    {
    }
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

deleteSnmpHost

Delete SNMP host

query Parameters
host_ip
required
string

IP address of of the SNMP host. Can be IPv4/IPv6/FQDN.

community
string

Snmp Community name associated with host

user
string

Snmp user name associated with host

device_ips
Array of strings non-empty

IP addresses of the devices where SNMP host needs to be deleted

Responses

200

OK

401

Authorization information is missing or invalid.

404

IP address of device specified is not registered.

500

Unexpected error.

default

Unexpected error

delete/snmp/host
http://goinventory-service:80/v1/inventory/snmp/host

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

SNMP groups

getSnmpGroups

Get SNMP groups for a list of devices

query Parameters
device_ips
Array of strings non-empty

IP addresses of the devices

Responses

200

OK

401

Authorization information is missing or invalid.

404

IP address of device specified is not registered.

500

Unexpected error

default

Unexpected error

get/snmp/group
http://goinventory-service:80/v1/inventory/snmp/group

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

SNMP views

getSnmpViews

Get SNMP views for a list of devices

query Parameters
device_ips
Array of strings non-empty

IP addresses of the devices

Responses

200

OK

401

Authorization information is missing or invalid.

404

IP address of device specified is not registered.

500

Unexpected error

default

Unexpected error

get/snmp/view
http://goinventory-service:80/v1/inventory/snmp/view

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

lockservice

lockservice

Get the lock from other services for given process name and device ip if given.

Request Body schema: application/json

process-name for which lock is required

process_name
required
string
ip_address
string

Responses

200

OK

409

Approval From one of service is failed

default

Unexpected error

post/lockservice
http://goinventory-service:80/v1/inventory/lockservice

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "process_name": "BackUp",
  • "ip_address": null
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

unlockservice

unlockservice

unlock other services for given process name and device ip if given.

Request Body schema: application/json

process-name for which unlock is required

process_name
required
string
ip_address
string

Responses

200

OK

409

Any error happened in service

default

Unexpected error

post/unlockservice
http://goinventory-service:80/v1/inventory/unlockservice

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "process_name": "BackUp",
  • "ip_address": null
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Device timezone

getDeviceTimezone

Get timezone for a list of devices

query Parameters
device_ips
Array of strings non-empty

IP addresses of the devices

Responses

200

OK

401

Authorization information is missing or invalid.

404

IP address of device specified is not registered.

500

Unexpected error

default

Unexpected error

get/timezone
http://goinventory-service:80/v1/inventory/timezone

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "items":
    [
    ]
}

setTimeZone

Set Device timezone

Request Body schema: application/json

Set timezone for device

device_ips
Array of strings

IP address of devices

timezone
string

Device Timezone

Responses

200

OK

401

Authorization information is missing or invalid.

404

IP address of device specified is not registered.

500

Unexpected error.

default

Unexpected error

put/timezone
http://goinventory-service:80/v1/inventory/timezone

Request samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "device_ips":
    [
    ],
  • "timezone":
    [
    ]
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Device Timezone

unsetDeviceTimezone

Unset Device Timezone

query Parameters
device_ips
Array of strings non-empty

IP addresses of the devices where timezone needs to be unset

Responses

200

OK

401

Authorization information is missing or invalid.

404

IP address of device specified is not registered.

500

Unexpected error.

default

Unexpected error

delete/timezone
http://goinventory-service:80/v1/inventory/timezone

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Supported device timezones

getSupportedDeviceTimezones

Get supported timezones

Responses

200

OK

401

Authorization information is missing or invalid.

500

Unexpected error

default

Unexpected error

get/timezone/debug-show
http://goinventory-service:80/v1/inventory/timezone/debug-show

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • "string"
]

Bindings

getBindings

Get bindings such as prefix-list, route-map etc for BGP Peers/ Interfaces

query Parameters
device_ips
required
Array of strings non-empty

List of devices for which the bindings need to be fetched. Example 1.1.1.1,2.2.2.2

name_of_instance
required
string

Name of the instance that needs to be fetched

type_of_instance
required
string
Enum: "route-map" "prefix-list"

Type of instances such as prefix-list, route-map etc.

Responses

200

OK

400

Mac Access Group request has invalid input params.

401

Authorization information is missing or invalid.

404

Mac Access Group with specified device IP/ID or Mac Access Group Name was not found.

500

Unexpected error.

default

Unexpected error

get/policy/bindings
http://goinventory-service:80/v1/inventory/policy/bindings

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "Device":
    [
    ]
}