Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

As at 1.12.8 we have introduced the Connections endpoint.

NOTE - Page under revision for v2.0.

How Does it Work?

 

Creating a Connection

To make another network go to menu -> Admin -> Connections -> Create Connection. Image Removed

View Connection Details

Go to menu -> Admin -> Connections -> List Connections.Image Removed

You will see a list of connections. You can view a connection by clicking on the it's ID (in green). You can also edit or delete the network.

 Image Removed

Example Database Entry

Connections are stored in the database in the "oa_connection" table. A typical entry will look as below. 

                   id: 5

...

Code Block
languagesql
                   id: 5
               org_id: 0

...


                 name: Marks Home Connection

...


             provider: Telstra 23

...


         service_type: Cable

...


         product_name: Bigpond Cable Ultimate

...


   service_identifier:

...

 
                speed: 100.000

...


        location_id_a: 2

...


        location_id_b: 2

...


          system_id_a: 0

...


          system_id_b: 0

...


        line_number_a:

...

 
        line_number_b:

...

 
ip_address_external_a:

...

 
ip_address_external_b:

...

 
ip_address_internal_a:

...

 
ip_address_internal_b: 

 

API / Web Access?

You can access the /connections collection using the normal Open-AudIT JSON based API. Just like any other collection. Please see the API documentation for further details.

...

GETcollectionReturns list of connectionsPOSTncreateInsert new connections entry
Request Method
ID
Action
Resulting Function
Permission Required
URL Example
Notes
Example Response
POSTn createconnections::create/connectionsInsert a new connections entry.connections_collectioncreate.json
GETy readconnections::read/connections/{id}Returns a connection's details.connections_read.json
PATCHy updateconnections::update/connections/{id}Update an attribute of a connections entry.connections_patch.json
DELETEy deleteconnections::delete/connections/{id}Delete a connections entry.connections_createdelete.json
DELETEGETyn deletecollectionconnections::read/connections/{id}Delete Returns a connections entrylist of connections.connections_deletecollection.json

Web Application Routes

Request Method
ID
Action
Resulting Function
Permission Required
URL Example
Notes
GETncreatecreate_formconnections:create/connections/createDisplays a standard web form for submission to POST /connections.
GETyupdateupdate_form /connections/{id}/updateShow the connection's details with the option to update attributes using PATCH to /connections/{id}
GETnimportimport_formconnections:create/connections/importDisplays a standard web form for submission to POST /connections/import.
POSTnimportimportconnections:create/connections/importImport multiple connections using a CSV.