HP CloudSystem Matrix/Matrix Operating Environment 7.2 Integration Interfaces API and CLI Operations Reference Guide

9 Introduction
Chargeback SOAP API
HP CloudSystem Matrix 7.1 includes a new chargeback feature. Chargeback is primarily a metering
system capable of collecting and exposing usage data for the provisioned infrastructure.
Using the infrastructure orchestration chargeback feature, the administrator can:
• Map allocation data to services, logical servers, logical networks, and logical disks
• Map uptime for logical servers
• Filter data for a specific period in time
The chargeback server collects, stores and exposes usage and cost metrics for services and individual
resources in these services. Collected metrics are accessible through the chargeback SOAP API.
Chargeback web services retrieve the allocation data according to the filter specified in the request.
The resulting output file is a structured XML file that contains the usage and cost metrics required
to build a user customized report. Several different tools can be used to process XML files and
build complex reports; however, there are cases for which only a simple report is required. This
appendix describes how to create customized simple reports from those XML files using a client to
connect to the chargeback SOAP API.
The chargeback command line interface can also be used to retrieve allocation data.
For more information about the chargeback feature, see the HP Matrix Operating Environment
Infrastructure Orchestration User Guide at http://www.hp.com/go/matrixoe/docs.
NOTE: While the chargeback API is similar in build and specifications to the HP Matrix OE
infrastructure orchestration API, there is no overlap between the two.
Creating a standard monthly chargeback report
The following procedure is an example of using the chargeback feature to create a standard
monthly service usage report.
1. Locate the chargeback.bat file:
C:\Program Files\HP\Matrix infrastructure orchestration\chargeback\
bin
2. Call the file to create the report.
chargeback.bat get detailedusage -S %reportfromdate% -E
%reportuntildate% -o %reportname%
3. The report is generated in the following location:
C:\Program Files\HP\Matrix infrastructure orchestration\chargeback\
bin\reports
Chargeback SOAP API 97