Table of Contents |
---|
Info |
---|
This document describes how to configure Amazon billing data for standard accounts and resellers with partner accounts. For standard accounts see Display Amazon billing data for standard accounts . |
Changes to AWS billing
...
The following changes apply to AWS billing:
In Abiquo 6.
...
1.0
...
Before you upgrade, add the amazon_bucket_region as an enterprise property with the AWS region code of your billing bucket location (for example, us-east-1)
Abiquo 6.1.0
...
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, edit the abiquo.properties
file and add the following property with any items to discard. For example:
Code Block |
---|
abiquo.ec2billing.parser.lineItemType.ignore=SppDiscount |
...
+, replace the
price_factor
enterprise property with the Abiquo price factors for Amazon. See Manage price factors
Configure properties
To configure Abiquo properties for AWS billing
By default, the platform will retrieve billing data for the last two months. To change this value, on the Abiquo Server, edit the abiquo.properties
file and add the following property with the number of months to retrieve:
Code Block |
---|
abiquo.enterprise.property.billing.monthoffset=2 |
In 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, which you will need 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 have these permissions
Price list: Full access to All resources
S3: Full list and read access to Multiple resourcesFor 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
be an account with pricing and billing permissions.
...
Configure dashboard display in Abiquo
To configure billing dashboards in Abiquo for resellers, do these steps in Abiquo.
...
Edit the reseller 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
...
Additional configuration for resellers
This section describes additional configuration for reseller accounts.
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. You can also create and apply price factors for customers, the customers, and for a percentage of managed costs. See Manage price factors
For your customer enterprises, add credentials for compute and/or billing
Assign the privilege to
View bills
to 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