Set Device Alias Names Using the Devices Web Service

You can set an alias name for a single monitored device. The alias name appears in the inventory list of devices and in the inventory list of interfaces.
As an Administrator, you can set an alias name for a monitored device using the
devices
endpoint for the
NetOps Portal
REST web service. The alias name appears in the inventory list of devices and in the inventory list of interfaces.
You can also set the alias name for a monitored device using the
update_alias_name.sh
script. You can use this script to set the alias names for multiple monitored devices. Device alias names set from the REST web service take precedence over the alias names that are set using the
update_alias_name.sh
script.
For more information, see Set Alias Names Using a Script.
The following URL shows the syntax for the
devices
endpoint for the
NetOps Portal
REST service:
http://
PC_host
:8181/pc/center/webservice/devices
Follow these steps:
  1. Determine the devices for which you want to set an alias name by issuing a GET request to the following
    devices
    endpoints for the
    NetOps Portal
    REST service:
    http://
    PC_host
    :8181/pc/center/webservice/devices
    A list of monitored devices is shown in the response.
  2. Issue a PUT request to the following
    devices
    endpoint for the
    NetOps Portal
    REST web service:
    http://
    PC_host
    :8181/pc/center/webservice/devices/deviceItemId/<
    device_id>
    /aliasName/<
    alias_name>
    Example:
    http://
    PC_host
    :8181/pc/center/webservice/devices/deviceItemId/119/aliasName/Alias name for 96.24
    • device_id
      The identification number for the monitored device for which you want to set an alias name.
    • alias_name
      The alias name for the monitored device.