REST API for Unified Assurance Core

Get Device Availability Details

get

/api/deviceNavigation/Devices/readStatesAvailability

Get availability details about the devices specified in DeviceID to indicate if they have been up or down recently.

Request

Query Parameters

DeviceID(required): string
The comma-separated list of device IDs.
Example:
```
40,10,109,7
```
limit: integer(int32)
The number of records to limit results by.
Example:
```
100
```
start: integer(int32)
The page of results to start from.

Default Value: 0
Example:
```
1
```

There's no request body for this operation.

Response

Supported Media Types

application/json

200 Response

Successful operation

Root Schema : schema

Type: object

Show Source

data: array data
message: string

The response message.

Example: Retrieved Availability States
success: boolean

Whether the operation was a success (true) or failure (false).

Example: true

{
    "properties":{
        "success":{
            "description":"Whether the operation was a success (<b>true</b>) or failure (<b>false</b>).",
            "type":"boolean",
            "example":"true"
        },
        "message":{
            "description":"The response message.",
            "type":"string",
            "example":"Retrieved Availability States"
        },
        "data":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/deviceNavigationDevicesReadStatesAvailability"
            },
            "example":[
                {
                    "DeviceID":"40",
                    "AvailabilityExists":true,
                    "AvailabilitySeverity":"unknown",
                    "Availability":null,
                    "LoadingStates":false
                },
                {
                    "DeviceID":"10",
                    "AvailabilityExists":true,
                    "AvailabilitySeverity":"unknown",
                    "Availability":null,
                    "LoadingStates":false
                },
                {
                    "DeviceID":"109",
                    "AvailabilityExists":true,
                    "AvailabilitySeverity":"normal",
                    "Availability":"100.00",
                    "LoadingStates":false
                },
                {
                    "DeviceID":"7",
                    "AvailabilityExists":true,
                    "AvailabilitySeverity":"normal",
                    "Availability":"100.00",
                    "LoadingStates":false
                }
            ]
        }
    }
}

Nested Schema : data

Type: array

Show Source

Array of: object deviceNavigationDevicesReadStatesAvailability

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/deviceNavigationDevicesReadStatesAvailability"
    },
    "example":[
        {
            "DeviceID":"40",
            "AvailabilityExists":true,
            "AvailabilitySeverity":"unknown",
            "Availability":null,
            "LoadingStates":false
        },
        {
            "DeviceID":"10",
            "AvailabilityExists":true,
            "AvailabilitySeverity":"unknown",
            "Availability":null,
            "LoadingStates":false
        },
        {
            "DeviceID":"109",
            "AvailabilityExists":true,
            "AvailabilitySeverity":"normal",
            "Availability":"100.00",
            "LoadingStates":false
        },
        {
            "DeviceID":"7",
            "AvailabilityExists":true,
            "AvailabilitySeverity":"normal",
            "Availability":"100.00",
            "LoadingStates":false
        }
    ]
}

Example:

[
    {
        "DeviceID":"40",
        "AvailabilityExists":true,
        "AvailabilitySeverity":"unknown",
        "Availability":null,
        "LoadingStates":false
    },
    {
        "DeviceID":"10",
        "AvailabilityExists":true,
        "AvailabilitySeverity":"unknown",
        "Availability":null,
        "LoadingStates":false
    },
    {
        "DeviceID":"109",
        "AvailabilityExists":true,
        "AvailabilitySeverity":"normal",
        "Availability":"100.00",
        "LoadingStates":false
    },
    {
        "DeviceID":"7",
        "AvailabilityExists":true,
        "AvailabilitySeverity":"normal",
        "Availability":"100.00",
        "LoadingStates":false
    }
]

Nested Schema : deviceNavigationDevicesReadStatesAvailability

Type: object

Show Source

Availability: number

Average availability value ranges between 0 and 100

Example: 100.00
AvailabilityExists: boolean

Availability Exists

Example: true
AvailabilitySeverity: string

Average availability status values. Possible values: - "normal" (100%) - "critical" (0%) - "warning" (less than 100 and more than 0) - "notConfigured" (no metric values).

Example: normal
DeviceID: integer

Device ID

Example: 40
LoadingStates: boolean

Loading States

Example: false

{
    "properties":{
        "DeviceID":{
            "description":"Device ID",
            "type":"integer",
            "example":"40"
        },
        "AvailabilityExists":{
            "description":"Availability Exists",
            "type":"boolean",
            "example":true
        },
        "AvailabilitySeverity":{
            "description":"Average availability status values. \n\nPossible values: \n- \"normal\" (100%)\n- \"critical\" (0%)\n- \"warning\" (less than 100 and more than 0)\n- \"notConfigured\" (no metric values).",
            "type":"string",
            "example":"normal"
        },
        "Availability":{
            "description":"Average availability value ranges between 0 and 100",
            "type":"number",
            "example":"100.00"
        },
        "LoadingStates":{
            "description":"Loading States",
            "type":"boolean",
            "example":false
        }
    },
    "type":"object"
}

Default Response

Failed operation

Root Schema : schema

Type: object

Show Source

errors: array errors

The list of errors reported. Validation errors will be keyed by record field.
message: string

The response message.

Example: Exception thrown
success: boolean

Whether the operation was a success (true) or a failure (false).

Example: false

{
    "properties":{
        "success":{
            "description":"Whether the operation was a success (<b>true</b>) or a failure (<b>false</b>).",
            "type":"boolean",
            "example":"false"
        },
        "message":{
            "description":"The response message.",
            "type":"string",
            "example":"Exception thrown"
        },
        "errors":{
            "description":"The list of errors reported. Validation errors will be keyed by record field.",
            "type":"array",
            "items":{
                "type":"object"
            }
        }
    },
    "type":"object"
}

Nested Schema : errors

Type: array

The list of errors reported. Validation errors will be keyed by record field.

Show Source

Array of: object items

{
    "description":"The list of errors reported. Validation errors will be keyed by record field.",
    "type":"array",
    "items":{
        "type":"object"
    }
}

Nested Schema : items

Type: object