services.py 1.53 KB
Newer Older
Daniele Venzano's avatar
Daniele Venzano committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
# Copyright (c) 2016, Daniele Venzano
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#    http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
# implied.
# See the License for the specific language governing permissions and
# limitations under the License.

"""
This module contains all service-related API calls that a Zoe client can use.
"""
import logging

21
from zoe_lib.api_base import ZoeAPIBase
Daniele Venzano's avatar
Daniele Venzano committed
22 23 24 25 26 27 28 29 30
from zoe_lib.exceptions import ZoeAPIException

log = logging.getLogger(__name__)


class ZoeServiceAPI(ZoeAPIBase):
    """
    The service API class. Services are read-only objects. The delete operation merely informs the master that a service has died outside of its control.
    """
31
    def get(self, container_id):
Daniele Venzano's avatar
Daniele Venzano committed
32 33 34 35 36
        """
        Retrieve service state.

        :param container_id: the service to query
        :return:
37 38

        :type container_id: int
Daniele Venzano's avatar
Daniele Venzano committed
39
        :rtype: dict
Daniele Venzano's avatar
Daniele Venzano committed
40
        """
41
        cont, status_code = self._rest_get('/service/' + str(container_id))
Daniele Venzano's avatar
Daniele Venzano committed
42
        if status_code == 200:
43
            return cont
Daniele Venzano's avatar
Daniele Venzano committed
44 45 46 47
        elif status_code == 404:
            raise ZoeAPIException('service "{}" not found'.format(container_id))
        else:
            raise ZoeAPIException('error retrieving service {}'.format(container_id))