Menu

Lumen help

Vyvx reservations

Description

Get the status of all active services (reservations).

The call returns a JSON collection with one keyed entry per reservation. The “state” field describes the overall state of the reservation, and the “ingress_state” field describes the informed estimation of the state of the signal at the ingress to the CenturyLink network.

Possible state values:

  • online—service is operating normally.
  • impaired—service is operating normally, with some non-service-impacting anomaly.
  • degraded—service is still operational, but is experiencing some service-impacting anomaly.
  • offline—service is not operational.
  • unknown—the state cannot be determined.

Method

GET

Base URI

https://ws.lumen.com/vyvx/v1.0

URI syntax

/customer/service/_active/status

Example

https://ws.lumen.com/vyvx/v1.0/customer/service/_active/status

{
“data”: {
“services”: {
“1234567”: { “state”: “offline”,”ingress_state”: “online” },
“9999999”: { “state”: “offline”,”ingress_state”: “online” }
},
“time”: “2019-01-02T15:04:05.000Z”
}

Possible status and error messages returned to client

200: Request Successful.

400: Bad Request—missing required request information.

401: Not Authorized—access to unauthorized resource.

500: Internal Server Error—internal errors (DB, etc).

Description

Get the status of a single active service (reservation).

The call returns a JSON collection with one keyed entry per reservation. The “state” field describes the overall state of the reservation, and the “ingress_state” field describes the informed estimation of the state of the signal at the ingress to the Lumen network.

Possible state values:

  • online—service is operating normally.
  • impaired—service is operating normally, with some non-service-impacting anomaly.
  • degraded—service is still operational, but is experiencing some service-impacting anomaly.
  • offline—service is not operational.
  • unknown—the state cannot be determined.

Method

GET

Base URI

https://ws.lumen.com/vyvx/v1.0

URI syntax

/customer/service/(id)/status

id : Reservation ID (required)

Example

https://ws.lumen.com/vyvx/v1.0/customer/service/1234567/status

{
“data”: {
“services”: {
“1234567”: { “state”: “offline”, “ingress_state”: “online” }
},
“time”: “2019-01-02T15:04:05.000Z”
}

Possible status and error messages returned to client

200: Request Successful.

400: Bad Request—missing required request information.

401: Not Authorized—access to unauthorized resource.

500: Internal Server Error—internal errors (DB, etc).

Description

Get the alarm history of a single active service (reservation).

Method

GET

Base URI

https://ws.lumen.com/vyvx/v1.0

URI syntax

/customer/service/(id)/history?start=(start)&end=(end)

Example

https://ws.lumen.com/vyvx/v1.0/customer/service/1234567/history?2019-01-02T15:04:05.000Z&end=2019-01-03T15:04:05.000Z

{
“data”: {
“services”: {
“1234567”: { “history”: {
“events”: [
{ “interval”: {“start”: “2019-01-02T16:00:00.000Z”, “end”: “2019-01-02T17:00:00.000Z },
“state”: “offline”,
“message”: “TS Loss”
}
]
}
} },
“time”: “2019-01-02T15:04:05.000Z”
}

Possible status and error messages returned to client

200: Request Successful.

400: Bad Request—missing required request information.

401: Not Authorized—access to unauthorized resource.

500: Internal Server Error—internal errors (DB, etc).

Overview

Lumen provides live reservation state (health) information for video reservations through the Vyvx API system. Lumen defines two types of reservation state:

  • (overall) state
  • ingress state

The 'state' refers to the overall health of the service from end-to-end, while the 'ingress state' represents an informed estimation of the health of the signal being presented to the ingress demarcation point of the network (i.e. the quality of the signal being provided to Lumen for transport).

Possible state values

The state and ingress state fields use a defined terminology and are always one of the following values:

  • online—service is operating normally
  • impaired—service is operating normally, with some non-service-impacting anomaly
  • degraded—service is still operational, but is experiencing some service-impacting anomaly
  • offline—service is not operational
  • unknown—the state cannot be determined

Ingress state calculation

Lumen provides the ingress state as an informed estimation of the health of the signal being provided by the source. The ingress state is calculated by examining the health of the signal being presented to the first piece of equipment in the signal flow chain that can be actively monitored. Because Lumen does not maintain active monitoring equipment at all customer demarcations, the first monitored equipment may be at a location other than the demarcation point. This means that the ingress state presented by Lumen systems is an informed estimation of the health of the signal being provided, not an authoritative declaration.

Should there be no active monitoring equipment in the signal flow chain prior to long-haul transport, Lumen will determine the ingress state to be “unknown” should a service impairment be detected.