This document describes how to configure Amazon billing data for standard accounts and resellers with partner accounts
Changes to AWS billing
The following changes apply to AWS billing:
In Abiquo 6.1.0+, replace the
price_factor
enterprise property with the Abiquo price factors for Amazon. See Manage price factorsIn Abiquo 6.1.2+, you can also add a managed costs using a price factor. See Manage price factors
Configure AWS to supply billing data
To configure AWS to supply billing data for standard or reseller accounts, do the following steps.
Create an S3 bucket, for example,
costandusagebillingreport
Within the bucket, create a folder where AWS will store your reports. Give it the name of your report, for example
costandusagebillingreport
Note the billing bucket name, for example,
costandusagebillingreport
Create a new user, such as
programmaticbilling
to create the reportsAssign the
AmazonS3ReadOnlyAccess
policyActivate the IAM user's access to billing information. See https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/control-access-billing.html
Configure Cost & Usage Reports
Go to Cost & Usage Reports
Enter the Report name, and note the value to enter in Abiquo later, then click Next
Click Configure and select the S3 bucket. Click Next, then select I have confirmed that this policy is correct.
By default, Amazon will put the reports in a folder with the name format
/report-name/date-range/
. Note this as the value for theamazon_bucket_prefix
in Abiquo. Click NextReview your configuration and check that the following parameters are set:
bucket name
path (folder/subfolder)
time detail:
Hourly
GZ or ZIP format
The AWS account with credentials to use in Abiquo should be an account with pricing and billing permissions.
For partner accounts, see https://abiquo.atlassian.net/wiki/spaces/doc/pages/311370749/Obtain+AWS+credentials#Reseller-pricing-and-billing-credentials
For standard accounts, see https://abiquo.atlassian.net/wiki/spaces/doc/pages/311370749/Obtain+AWS+credentials#Standard-account-pricing-and-billing-policy
Configure dashboard display in Abiquo
To configure billing dashboards in Abiquo for resellers, do these steps in Abiquo.
Edit the reseller or standard enterprise and create the following enterprise properties:
amazon_bucket: bucket_name
amazon_bucket_region: code for the AWS region of the bucket, such as
us-east-1
amazon_report_name: amazon_bucket/amazon_bucket_prefix/amazon_report_name/file.csv
amazon_bucket_prefix: amazon_bucket/ amazon_bucket_prefix /amazon_report_name/file.csv
amazon_billing_compress_format:
ZIP
orGZ
amazon_mpa: set to
dedicated
orno
to use blended costs; if not present orshared
, use unblended costs
For resellers
Create an additional enterprise property for resellers:
amazon_discount: as agreed with Amazon, usually with a value such as
0.03
,0.02
In Pricing view, create price factors as required for the reseller, the customers, and for a percentage of managed costs. See Manage price factors
For your customer enterprises, add the Account ID as a public cloud credential
Assign the privilege to
View bills
to your user rolesOptionally, configure Abiquo properties
By default, the platform will retrieve billing data for the last two months. To change this value, on the Abiquo Server, set the following property
abiquo.enterprise.property.billing.monthoffset=2
By default, the platform will process all items in the CSV file, so the partner discount (
SppDiscount
) value can be visible on customer dashboards. To discard items from the CSV file, on the Remote Services server, set the following property with a list of codes of any items to discard.abiquo.ec2billing.parser.lineItemType.ignore=SppDiscount