[RESTful API] Linking 2 ports together

[yann.mornet]

Hello community,

 

I made a bit of reverse engineering to determine what Spectrum needs so that a link is set up between two network devices like:

 

With the CLI and the Modeling Gateway I found that at least 4 actions are needed:

1. Link the 2 ports models with relation Links_with (0x10023) -> this does nothing visible in the OneClick topological view but you can see the two ports associated to each other in the interface tab of both devices
2. Link one port model with the opposite device model with relation Connects_to (0x10005) -> this creates a yellow link
3. Do the same with the other port and the other device (seems that the relations are incomplete if not done)
4. Set the ok_to_poll (0x11dd8) attribute to Yes (1) for both port models -> the link goes Green.

 

My question is : is it enough? Did I miss something ?

 

Unfortunately I am not able to test this modelization on test devices on which I could unplug a cable...

 

=== ADDITION ===

 

As the documentation is not as detailed as it should be and to spare time to those who want to do the same, here are the requests used:

 

To set a relation between two models

 

REQUEST	POST
URL	http://OC_HOST:OC_PORT/spectrum/restful/associations/relation /RELATIONTYPEID/leftmodel/LEFTMODELHANDLE/rightmodel/RIGHTMODELHANDLE
XML	NONE

 

 

To set an attribute value to multiple models

 

REQUEST	PUT
URL	http://OC_HOST:OC_PORT/spectrum/restful/models
XML	<?xml version="1.0" encoding="UTF-8"?> <rs:update-models-request throttlesize="0" xmlns:rs="http://www.ca.com/spectrum/restful/schema/request" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.ca.com/spectrum/restful/schema/request ../../../xsd/Request.xsd ">    <rs:target-models>       <rs:model mh="MODELHANDLE1" />       <rs:model mh="MODELHANDLE2" />    </rs:target-models>    <!-- ok_to_poll attribute -->    <rs:attribute-value id="0x11dd8">1</rs:attribute-value> </rs:update-models-request>

[Widjaja Sangtoki]

I think that is enough and good.

[yann.mornet]

Thank you for your feedback

[Christophe_Sperandio]

The last step "ok_to_poll" change is part of what is needed to turn the "Live Link" feature On. So, it's not absolutely necessary if you want to manage that through the Policy Manager for instance. But if that's intended, I confirm, this is fine!

[yann.mornet]

I was finally able to validate the configuration in a test environment with 2 switches.

Alarms behave as expected when unplugging a cable or powering off one of the two switches.