Create a Link

post

/vision/api/linkData

Creates a link. The following properties are required in the request body:
  • carrier
  • cid
  • startSourceId
  • startDeviceId
  • startPort
  • startEntityId
  • endSourceId
  • endEntityId
  • endDeviceId
  • endPort
  • mbps
The following properties are optional:
  • ckt
  • startPortFacingCkt
  • endPortFacingCkt
  • description
  • metaData
All other properties, such as the ID, longitude, latitude, zone ID, and names are automatically populated for the link when you submit the request. The pixel (X and Y) information is added when you add the link to a logical dashboard.
Unified Assurance roles with the following Vision package permissions have access to this endpoint:
  • Admin
  • Viewer
  • Api

Request

There are no request parameters for this operation.

Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
The details of a Vision link object.
Show Source
Nested Schema : endMetaData
Type: object
Additional Properties Allowed
Show Source
Metadata for the link's ending point.
Example:
type: dDevice
Nested Schema : startMetaData
Type: object
Additional Properties Allowed
Show Source
Metadata for the link's starting point.
Example:
type: dDevice
Nested Schema : additionalProperties
Type: object
Nested Schema : additionalProperties
Type: object
Back to Top

Response

Supported Media Types

201 Response

The link was created successfully.
Body ()
Root Schema : schema
Type: object
The response resource wrapper.
Show Source
Nested Schema : columns
Type: array
Information about the columns used to display the requested or updated content.
Show Source
Nested Schema : schema
Type: object
The details of a Vision link object.
Show Source
Nested Schema : links
Type: array
Links related to the requested or updated content.
Show Source
Nested Schema : ColumnData
Type: object
The details of columns to use to show data in a table.
Show Source
Nested Schema : endMetaData
Type: object
Additional Properties Allowed
Show Source
Metadata for the link's ending point.
Example:
type: dDevice
Nested Schema : startMetaData
Type: object
Additional Properties Allowed
Show Source
Metadata for the link's starting point.
Example:
type: dDevice
Nested Schema : additionalProperties
Type: object
Nested Schema : additionalProperties
Type: object

401 Response

Unauthorized Access
Body ()
Root Schema : schema
Type: object
The error response details.
Show Source

404 Response

Resource not Found
Body ()
Root Schema : schema
Type: object
The error response details.
Show Source

422 Response

Unprocessable Entity. Usually due to not providing a required field.
Body ()
Root Schema : schema
Type: object
The error response details.
Show Source

500 Response

An internal server error occurred while accessing the database or performing a database operation.
Body ()
Root Schema : schema
Type: object
The error response details.
Show Source
Back to Top