.. -*- rst -*-

==============
Manage service
==============




Show orchestration engine status
================================

.. rest_method::  GET /v1/{tenant_id}/services

Enables administrative users to view details for all orchestration engines.

Orchestration engine details include engine id, binary, topic name, host, 
report interval, last updated time, health status, and host name.

Troubleshooting

- A ``503`` error code indicates that the heat engines are not
  operational. Run the heat-manage service list command or contact
  your cloud provider to determine why the heat engines are not
  operational.


Normal response codes: 200
Error response codes:403,503,


Request
-------

.. rest_parameters:: parameters.yaml

   - tenant_id: tenant_id


Response Parameters
-------------------

.. rest_parameters:: parameters.yaml

   - status: status
   - binary: binary
   - report_interval: report_interval
   - engine_id: engine_id
   - created_at: created_at
   - hostname: hostname
   - updated_at: updated_at
   - topic: topic
   - host: host
   - services: services
   - deleted_at: deleted_at
   - id: id



Response Example
----------------

.. literalinclude:: samples/services-list-response.json
   :language: javascript





