Fetching tenants usage batch

Tenants and personal tenants provide metrics of service usage on level of offering items.
A Personal tenant represents a tenant bound to a specific user account, and is used only to control user account quotas and to collect user account real usage of a service.

To fetch tenants usage batch

  1. Authenticate to the cloud platform via the Python shell.

    The following variables should be available now:

    >>> base_url  # the base URL of the API
'<the data center URL>/api/2'
>>> auth  # the 'Authorization' header value with the access token
{'Authorization': 'Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6ImMwMD...'}
>>> tenant_id  # the UUID of the tenant to which the token provides access
'ede9f834-70b3-476c-83d9-736f9f8c7dae'

  2. Collect the tenant UUIDs using search and define an array to store them. The following variable will be used as an example:

    >>> tenant_ids
['d8515984-648a-4a38-9aeb-c91ec704ccda', '6838f6a2-42b4-44a3-8c7f-2a796185951c']

  3. Define a variable named params, and then assign the tenants query string parameter to this variable:

    >>> params = {
...     'tenants': ','.join(tenant_id)
... }

    Name

    Value type

    Required

    Description

    tenants

    string

    Yes

    Comma-separated tenant UUIDs.

  4. Send a GET request to the /tenants/usages endpoint:

    >>> response = requests.get(f'{base_url}/tenants/usages', headers=auth, params=params)

  5. Check the status code of the response:

    >>> response.status_code
200

    Status code 200 means that the request was successful.

    Note

    A different status code means that an error has occurred. For details of the error, see HTTP status response codes and API error codes.

    Also, the response body contains the items array with usages of the specified tenants, formatted as a JSON text. When converted to an object, it will look like this:

    >>> pprint.pprint(response.json())
{'items': [{'tenant': 'd8515984-648a-4a38-9aeb-c91ec704ccda',
            'usages': [{'absolute_value': 0,
                        'application_id': '6e6d758d-8e74-3ae3-ac84-50eb0dff12eb',
                        'edition': 'standard',
                        'infra_id': '019097a6-114f-4418-bd54-e01ef049f209',
                        'measurement_unit': 'bytes',
                        'name': 'storage',
                        'usage_name': 'storage',
                        'offering_item': {'quota': {'overage': None,
                                                    'value': None,
                                                    'version': 0},
                                          'status': 1},
                        'range_start': '2019-08-01T00:00:00',
                        'tenant_id': 1326401,
                        'type': 'infra',
                        'value': 0}, ...]},
            {'tenant': '6838f6a2-42b4-44a3-8c7f-2a796185951c',
            'usages': [{'absolute_value': 0,
                        'application_id': '6e6d758d-8e74-3ae3-ac84-50eb0dff12eb',
                        'edition': 'standard',
                        'infra_id': '019097a6-114f-4418-bd54-e01ef049f209',
                        'measurement_unit': 'bytes',
                        'name': 'storage',
                        'usage_name': 'storage',
                        'offering_item': {'quota': {'overage': None,
                                                    'value': None,
                                                    'version': 0},
                                          'status': 1},
                        'range_start': '2019-08-01T00:00:00',
                        'tenant_id': 1318423,
                        'type': 'infra',
                        'value': 0}, ...]}]}