| Table of Contents |
|---|
This new feature will make usage data available through the Abiquo API and it is especially useful for reseller environments. It will offer a new way to provide flat VM hour pricing to tenants while enabling you to offer volume discounts for resellers in the hierarchy.
VM usage data
The reports methods of the new “cost usage” resource provide VM usage in hours for the platform, per tenant, and for a tenant hierarchy. The data for the tenant hierarchy is aggregated using the reseller and key node tags.
The following table describes the "costusage" report endpoints.
...
Platform
...
Reseller
...
For API documentation, see 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
...
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.
| Property | Description |
|---|---|
| resellerCodereseller_code | To identify a reseller in the platform |
| contractIdinternal_customer_id | To identify an enterprise 's contract with for the platform provider |
| currencyCodecurrency_code | By default this is "EUR" |
| conversionFactorconversion_factor | For example, to convert from Euros to USD, you could set a value of "1.12". |
Accounting data
In order to obtain the usage in VM hours, this This feature retrieves and stores some data from the Abiquo Accounting system on a daily basis. This data in hours is categorized by resources. You can also filter, access, and manage this data from the action endpoints under cost usage.
Pricing data
In this initial release the cost usage feature does not use granular resource pricing, and while it can be aligned with the pricing model, it is not integrated to it directly. In future releases, Abiquo will continue to develop these features to enable customers to easily retrieve and manage cloud usage and accounting data. For a version of this output customized for your needs, please contact us.
Platform VM volume intervals
It is possible to configure an internal table with intervals of VM volume usage across the whole platform for incorporation into the reports. Please contact us for further information
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".