Services

Service management

List services

get

Lists all services

Authorizations
X-Auth-TokenstringRequired

OpenStack authentication token

Query parameters
hoststringOptional

Filter by host name

binarystringOptional

Filter by binary

clusterstringOptional

Filter by cluster name

Responses
200

OK

application/json
get
/v3/os-services
GET /v3/v3/os-services HTTP/1.1
Host: example.com
X-Auth-Token: YOUR_API_KEY
Accept: */*
200

OK

{
  "services": [
    {
      "binary": "text",
      "host": "text",
      "zone": "text",
      "status": "text",
      "state": "text",
      "updated_at": "2025-11-28T20:20:03.639Z",
      "disabled_reason": "text",
      "cluster": "text",
      "frozen": true,
      "replication_status": "text",
      "active_backend_id": "text"
    }
  ]
}

Update service

put

Updates a service

Authorizations
X-Auth-TokenstringRequired

OpenStack authentication token

Body
Responses
200

OK

application/json
put
/v3/os-services
PUT /v3/v3/os-services HTTP/1.1
Host: example.com
X-Auth-Token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "body": {
    "disabled": true,
    "disabled_reason": "text"
  }
}
200

OK

{
  "service": {
    "binary": "text",
    "host": "text",
    "zone": "text",
    "status": "text",
    "state": "text",
    "updated_at": "2025-11-28T20:20:03.639Z",
    "disabled_reason": "text",
    "cluster": "text",
    "frozen": true,
    "replication_status": "text",
    "active_backend_id": "text"
  }
}

Last updated

Was this helpful?