Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Version published after converting to the new editor

Abiquo 4.6.3 introduces a new set of data entities based on platform usage in VM hours. This will enable you to provide flat VM hour pricing to tenants as well as volume discounts for resellers in a hierarchy.

Access to the report data will be controlled by the "ROLE_BILLS_MANAGE" privilege. The report for enterprises is also available to a user of an enterprise with the "ROLE_BILLS_VIEW" privilege.

Report data

Report data will be available through the Abiquo API from the "costusage" endpoints for all levels in a tenant hierarchy, as described in the following table.

...

Platform

...

Reseller

...

Table of Contents

This new feature will make usage data available through the Abiquo API. The data is available from the /action/list endpoint of the Cost Usage Resource. See https://wiki.abiquo.com/api/latest/CostUsageResource.html

Time zones

In the database, the time zones are stored in UTC format. The default billing period is from day 1 to the end of the previous month in UTC format.

Privileges

Access to the data will be controlled by the "ROLE_BILLS_MANAGE" privilege. The report for enterprises is also available to users of an enterprise with the "ROLE_BILLS_VIEW" privilege.

Additional configuration

The administrator can also configure some enterprise properties for use in the reports, as described in the following table. 

These properties are updated once a month at the start of the billing period. So if you make a change during a billing period, it will take effect in the next billing period.

PropertyDescription
resellerCodereseller_codeTo identify a reseller in the platform
contractIdinternal_customer_idTo identify an enterprise 's contract with for the platform provider
currencyCodecurrency_codeBy default this is "EUR"
conversionFactorconversion_factorFor example, to convert from Euros to USD, you could set a value of "1.12".

Platform volume metrics

...

Accounting data

This feature retrieves and stores some data from the Abiquo Accounting system on a daily basis. This data in hours is categorized by resources.

For a list of the categories, see Abiquo accounting services integration#Descriptionofresources. To sort this table by the "Cat." column, click on the header cell.

Filters

To filter this data, you can send a "reportfilterrequestdto" object. 

This request body object can contain dates to filter by. You can identify enterprises with an internal_customer_id or with links to a "reseller", "key-node" or "enterprise"