Update a Link

put

/vision/api/linkData/{id}

Updates the specified link entirely. The link definition in the request body replaces the link's existing definition. 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 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
  • Api

Request

Path Parameters
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

200 Response

OK
Body ()
Root Schema : ResourceWrapper14
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 : content
Match All
Show Source
Nested Schema : ColumnData
Type: object
The details of columns to use to show data in a table.
Show Source
Nested Schema : content-allOf[1]
Match All
The requested or updated content.
Show Source
  • schema
    The details of a Vision link object.
  • The requested or updated content.
Nested 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

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