Service Statuses

Overview

The Service Status entries are used to track the health state of the services in the Designate system.

Get a Service Status

GET /service_statuses/(uuid: id)

Lists a particular Service Status

Example request:

GET /service_statuses/5abe514c-9fb5-41e8-ab73-5ed25f8a73e9 HTTP/1.1
Host: example.com
Accept: application/json

Example response:

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8

{
    "capabilities": {},
    "created_at": "2016-03-08T09:20:23.000000",
    "heartbeated_at": "2016-03-08T09:26:18.000000",
    "hostname": "vagrant-ubuntu-trusty-64",
    "id": "769e8ca2-f71e-48be-8dee-631492c91e41",
    "links": {
        "self": "http://192.168.27.100:9001/v2/service_statuses/769e8ca2-f71e-48be-8dee-631492c91e41",
        "service_status": "http://192.168.27.100:9001/v2/service_statuses/769e8ca2-f71e-48be-8dee-631492c91e41"
    },
    "service_name": "pool_manager",
    "stats": {},
    "status": "UP",
    "updated_at": "2016-03-08T09:26:18.000000"
}

Form Parameters:  

• created_at – timestamp
• updated_at – timestamp
• id – uuid
• description – UTF-8 text field
• links – links to traverse the list
• service_name – Service name
• hostname – Service hostname
• capabilities – Service capabilities - dict of capabilities
• stats – Service stats - dict of stats
• status – Service status - UP, DOWN or WARNING

Status Codes:

• 200 OK – OK
• 401 Unauthorized – Access Denied
• 404 Not Found – Service Status not found

List Service Statuses

GET /service_statuses

Lists all Service Statuses

Example request:

GET /service_statuses HTTP/1.1
Host: example.com
Accept: application/json

Example response:

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8

{
  "service_statuses":[
    {
        "capabilities": {},
        "created_at": "2016-03-08T09:20:23.000000",
        "heartbeated_at": "2016-03-08T09:26:18.000000",
        "hostname": "vagrant-ubuntu-trusty-64",
        "id": "769e8ca2-f71e-48be-8dee-631492c91e41",
        "links": {
            "self": "http://192.168.27.100:9001/v2/service_statuses/769e8ca2-f71e-48be-8dee-631492c91e41",
            "service_status": "http://192.168.27.100:9001/v2/service_statuses/769e8ca2-f71e-48be-8dee-631492c91e41"
        },
        "service_name": "pool_manager",
        "stats": {},
        "status": "UP",
        "updated_at": "2016-03-08T09:26:18.000000"
    },
    {
        "capabilities": {},
        "created_at": "2016-03-08T09:20:26.000000",
        "heartbeated_at": "2016-03-08T09:26:16.000000",
        "hostname": "vagrant-ubuntu-trusty-64",
        "id": "adcf580b-ea1c-4ebc-8a95-37ccdeed11ae",
        "links": {
            "self": "http://192.168.27.100:9001/v2/service_statuses/adcf580b-ea1c-4ebc-8a95-37ccdeed11ae",
            "service_status": "http://192.168.27.100:9001/v2/service_statuses/adcf580b-ea1c-4ebc-8a95-37ccdeed11ae"
        },
        "service_name": "zone_manager",
        "stats": {},
        "status": "UP",
        "updated_at": "2016-03-08T09:26:17.000000"
    }
  ],
  "links":{
    "self":"http://127.0.0.1:9001/v2/service_statuses"
  }
}

Form Parameters:  

• created_at – timestamp
• updated_at – timestamp
• id – uuid
• description – UTF-8 text field
• links – links to traverse the list
• service_name – Service name
• hostname – Service hostname
• capabilities – Service capabilities - dict of capabilities
• stats – Service stats - dict of stats
• status – Service status - UP, DOWN or WARNING

Status Codes:

• 200 OK – OK
• 401 Unauthorized – Access Denied