'Get the containers present in the cluster.
:return: A ``list`` of ``dict`` representing each of the containers
that are configured to exist anywhere on the cluster.'

@app.route('/state/containers', methods=['GET'])
@user_documentation(u"\n                                This    reflects    the    control    service's    knowledge    of    the    cluster,\n                                which    may    be    out    of    date    or    incomplete,    e.g.    if    a    container    agent\n                                has    not    connected    or    updated    the    control    service    yet.\n                                ", header=u"Get    the    cluster's    actual    containers", examples=[u'get    actual    containers'], section=u'container')
@structured(inputSchema={}, outputSchema={'$ref': '/v1/endpoints.json#/definitions/state_containers_array'}, schema_store=SCHEMAS)
def get_containers_state(self):

    deployment_state = self.cluster_state_service.as_deployment()
    return _extract_containers_state(deployment_state)
