REST API for Unified Assurance Vision

Delete a Unified Assurance Device Association

delete

/vision/api/assure1DeviceLink

Deletes the association between the Unified Assurance device and the Vision entity specified in the request body. The Vision entity is not deleted, only the association between it and the device. This request is run automatically when you delete an entity.
Unified Assurance roles with the following Vision package permissions have access to this endpoint:

Admin
Api

Request

There are no request parameters for this operation.

Supported Media Types

Root Schema : schema

Type: object

The details of an association between a Unified Assurance device and a Vision entity.

Show Source

deviceId: integer (int64)

The device ID. If this is 0, the entity has no associated device.

Example: 1
deviceZoneId: integer (int64)

The device zone ID.

Example: 1
entityName: string

The entity name.

Example: host.example.com
sourceId: integer (int64)

The ID of the source for the device. Only 1 for Assure1 is supported.

Example: 1

{
    "properties":{
        "deviceId":{
            "description":"The device ID. If this is <b>0</b>, the entity has no associated device.",
            "example":1,
            "format":"int64",
            "type":"integer"
        },
        "deviceZoneId":{
            "description":"The device zone ID.",
            "example":1,
            "format":"int64",
            "type":"integer"
        },
        "entityName":{
            "description":"The entity name.",
            "example":"host.example.com",
            "type":"string"
        },
        "sourceId":{
            "description":"The ID of the source for the device. Only <b>1</b> for <b>Assure1</b> is supported.",
            "example":1,
            "format":"int64",
            "type":"integer"
        }
    },
    "description":"The details of an association between a Unified Assurance device and a Vision entity.",
    "type":"object"
}

Response

Supported Media Types

application/json

204 Response

No Content

401 Response

Unauthorized Access

Root Schema : schema

Type: object

The error response details.

Show Source

message: string

The error message.

Example: An internal server error occurred.
reason: string

The reason phrase for the response.

Example: INTERNAL SERVER ERROR
status: integer (int32)

The response status code.

Example: 500

{
    "properties":{
        "message":{
            "description":"The error message.",
            "example":"An internal server error occurred.",
            "type":"string"
        },
        "reason":{
            "description":"The reason phrase for the response.",
            "example":"INTERNAL SERVER ERROR",
            "type":"string"
        },
        "status":{
            "description":"The response status code.",
            "example":500,
            "format":"int32",
            "type":"integer"
        }
    },
    "description":"The error response details.",
    "type":"object"
}

422 Response

Unprocessable Entity. Usually due to not providing a required field.

Root Schema : schema

Type: object

The error response details.

Show Source

message: string

The error message.

Example: An internal server error occurred.
reason: string

The reason phrase for the response.

Example: INTERNAL SERVER ERROR
status: integer (int32)

The response status code.

Example: 500

{
    "properties":{
        "message":{
            "description":"The error message.",
            "example":"An internal server error occurred.",
            "type":"string"
        },
        "reason":{
            "description":"The reason phrase for the response.",
            "example":"INTERNAL SERVER ERROR",
            "type":"string"
        },
        "status":{
            "description":"The response status code.",
            "example":500,
            "format":"int32",
            "type":"integer"
        }
    },
    "description":"The error response details.",
    "type":"object"
}

500 Response

An internal server error occurred while accessing the database or performing a database operation.

Root Schema : schema

Type: object

The error response details.

Show Source

message: string

The error message.

Example: An internal server error occurred.
reason: string

The reason phrase for the response.

Example: INTERNAL SERVER ERROR
status: integer (int32)

The response status code.

Example: 500

{
    "properties":{
        "message":{
            "description":"The error message.",
            "example":"An internal server error occurred.",
            "type":"string"
        },
        "reason":{
            "description":"The reason phrase for the response.",
            "example":"INTERNAL SERVER ERROR",
            "type":"string"
        },
        "status":{
            "description":"The response status code.",
            "example":500,
            "format":"int32",
            "type":"integer"
        }
    },
    "description":"The error response details.",
    "type":"object"
}