Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


This section

Table of Contents

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. 

...

Info

This document describes how to configure Amazon billing data for

resellers. For

standard accounts

see Display Amazon billing data for standard accounts.

Note
titleChanges to enterprise properties for AWS billing

Abiquo 6.0.0

  • Before you upgrade, add the amazon_bucket_region as an enterprise property. The value is the code for the AWS region where your billing bucket is located (for example, us-east-1)

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

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 factors

  • 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.

  1. Create an S3 bucket, for example,

...

  1. costandusagebillingreport

...

    1. Within the bucket, create a folder where AWS will store your reports. Give it the name of your report, for example

...

    1. costandusagebillingreport

...

    1. Note the billing bucket name, for example, 

...

    1. costandusagebillingreport

...

  1. Create a new user, such as

...

  1. programmaticbilling

...

  1. to create the reports

    1. Assign

...

    1. the AmazonS3ReadOnlyAccess policy

    2. Activate the IAM user's access to billing information. See https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/control-access-billing.html

...

Optionally configure legacy billing reports

...

Go to Billing → Billing preferences

...

Open the Detailed Billing Reports [Legacy] section

...

...

  1. Configure

...

  1. Cost

...

Click Save preferences

...

  1. & Usage Reports

    1. Go to Cost & Usage Reports

    2. Enter the Report  name,

...

    1. and note the value to enter in Abiquo later, then click Next

    2. Click Configure and select the S3 bucket. Click Next, then select I have confirmed that this policy is correct.

    3. By default, Amazon will put the reports in a folder with the name format

...

    1. /report-name/date-range/

...

    1. . Note this as the value for the 

...

    1. amazon_bucket_prefix in Abiquo. Click Next

    2. Review your configuration and check that the following parameters are set: 

      1. bucket name

      2. path (folder/subfolder)

      3. time detail: Hourly

...

      1. GZ or ZIP format

  1. The AWS account with credentials to use in Abiquo should

...

  1. be an account with pricing and billing permissions.

    1. For partner accounts, see https://abiquo.atlassian.net/wiki/spaces/doc/pages/311370749/Obtain+AWS+credentials#Reseller-pricing-and-billing-credentials

    2. 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.

...

  1. Edit the enterprise and create the following enterprise properties

...

  1. :

    1. amazon_bucket

...

    1. : bucket_name

    2. amazon_bucket_region

...

    1. : code for the AWS region

...

    1. of the bucket

...

    1. , such asus-east-1

...

...

    1. amazon_report_name

...

    1. : amazon_bucket/amazon_bucket_prefix/amazon_report_name/file.csv

...

    1. amazon_bucket_prefix

...

    1. : amazon_bucket/ amazon_bucket_prefix /amazon_report_name/file.csv

...

    1. amazon_billing_compress_

...

    1. format

...

    1. : ZIP or

...

    1. GZ

    2. amazon

...

    1. _

...

    1. mpa: set to dedicated or no to use blended costs

...

    1. ; if not present or

...

    1. shared

...

    1. , use unblended costs

...

...

Additional configuration for resellers

This section describes additional configuration for reseller accounts.

  1. Create an additional enterprise property for resellers:

    1. amazon_discount

...

    1. : as agreed with Amazon, usually with a value such as 0.03, 0.02

...

_

In Abiquo, edit the enterprises of the customers of the reseller and create the following property. You can also set the default value in the reseller.

...

Property

...

Description

...

  1. In Pricing view, create price factors as required for the reseller, the customers, and for a percentage of managed costs. See Manage price factors

  2. For your customer enterprises, add credentials for compute and/or billing

  3. Assign the privilege to View bills to user roles

  4. Optionally, configure Abiquo properties

    1. 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

    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