python-novaclient/novaclient/v1_1/usage.py
Cole Robinson c3b043be0e Add a 'usage' module and 'usage-list' cli command
This module talks to the nova extenstion os-simple-tenant-usage,
replacing the openstackx module currently used by horizon.

v2:
    Fix some pep8 and style violations

v4:
    Have usage-list default to including todays usage

v5:
    Fix a HACKING violation
    Fix rebase conflicts

Change-Id: Ica0b128c7b807b839abf23b4026e48bbee08b1be
2012-01-24 15:32:34 -05:00

49 lines
1.4 KiB
Python

"""
Usage interface.
"""
from novaclient import base
class Usage(base.Resource):
"""
Usage contains infomartion about a tenants physical resource usage
"""
def __repr__(self):
return "<ComputeUsage>"
class UsageManager(base.ManagerWithFind):
"""
Manage :class:`Usage` resources.
"""
resource_class = Usage
def list(self, start, end, detailed=False):
"""
Get usage for all tenants
:param start: :class:`datetime.datetime` Start date
:param end: :class:`datetime.datetime` End date
:param detailed: Whether to include information about each
instance whose usage is part of the report
:rtype: list of :class:`Usage`.
"""
return self._list(
"/os-simple-tenant-usage?start=%s&end=%s&detailed=%s" %
(start.isoformat(), end.isoformat(), int(bool(detailed))),
"tenant_usages")
def get(self, tenant_id, start, end):
"""
Get usage for a specific tenant.
:param tenant_id: Tenant ID to fetch usage for
:param start: :class:`datetime.datetime` Start date
:param end: :class:`datetime.datetime` End date
:rtype: :class:`Usage`
"""
return self._get("/os-simple-tenant-usage/%s?start=%s&end=%s" %
(tenant_id, start.isoformat(), end.isoformat()),
"tenant_usage")