Acronis to Service - 2.1

Modified on Wed, 22 Jul at 1:22 PM

Overview

The Acronis to Service 2.1 collector retrieves tenant usage and allocation data from the Acronis Cyber Protect Cloud platform using the Acronis API v2.

This collector provides visibility into service provider tenant usage across product offerings such as storage, workloads, and other metered resources, enabling organizations to validate subscriptions, reconcile consumption, and allocate costs within Varibill.

The collector retrieves unrated allocation data, meaning no monetary values are supplied by the source system. Pricing and billing calculations are applied within Varibill based on configured contracts and pricing rules.

This is a point-in-time collector, meaning each execution retrieves the current state of tenant usage and quota allocations at the time of collection.

For general instructions on creating and running Source Collectors, see: Configuring a New Cloud Source Collector

Collector Summary

Field	Value
Source Collector Name	Acronis to Service - 2.1
Collection Behavior	Point in Time
Rating Model	Unrated
Vendor Name	Acronis
Product	Acronis Cyber Protect Cloud
Purpose	Retrieves tenant usage and allocation data from Acronis Cyber Protect Cloud for billing and validation within Varibill

About Acronis Cyber Protect Cloud

Acronis is a global provider of cyber protection solutions that integrate backup, disaster recovery, cybersecurity, and endpoint management into a single platform.

Acronis Cyber Protect Cloud is a service provider platform that enables managed service providers (MSPs) and resellers to deliver data protection, backup, and security services to their customers. Each customer is represented as a tenant within the platform, and usage is tracked across product offerings such as cloud storage, workloads, and other metered resources.

Service providers use the Acronis management console to manage their tenant hierarchy, monitor consumption against allocated quotas, and provision services across their customer base.

Data Collected

The Acronis to Service 2.1 collector retrieves unrated tenant usage allocation data from Acronis Cyber Protect Cloud. For each customer tenant, the collector captures usage across the configured product offerings and measurement units.

The collector submits two types of allocation records per tenant and product offering:

Included allocation — the quota allocated to the tenant for the product offering.
Overage allocation — any usage exceeding the allocated quota. Overage records are submitted separately with a distinct Product Identifier suffix.

Note: Storage usage measured in bytes is automatically converted to gigabytes (GB) before submission to Varibill. Other measurement units are submitted as-is.

Note: The Acronis to Service 2.1 collector reflects the state of the Acronis platform at the time it runs. More frequent execution improves billing accuracy for environments with frequent usage or quota changes.

Prerequisites

Before configuring this collector, ensure that:

You have administrator access to the Acronis Cyber Protect Cloud management console
You have created an API Client in the Acronis management console with appropriate permissions
You have copied the Client ID and Client Secret values from the API Client configuration
You have noted the Data Center URL of your Acronis environment (for example, https://cloud.acronis.com)
You have access to the Varibill Source Collector configuration screen

Tip: The Data Center URL is specific to your Acronis data center region. You can find it in the address bar when logged in to the Acronis management console. Use the base URL without any trailing path.

Note: For instructions on creating an API Client in Acronis, refer to the Acronis developer documentation.

Configuration Parameters

The parameters below are entered when configuring the collector in Varibill. They are grouped by function.

Connection Parameters

These parameters identify and authenticate against your Acronis Cyber Protect Cloud environment.

Parameter	What it is	Where to find it
Data Center URL	The base URL of your Acronis data center	The address bar of the Acronis management console when logged in. Format: `https://cloud.example.com` (include `https://`, no trailing slash)
Acronis Client ID	The Client ID of the API Client used for authentication	Acronis management console → Settings → API Clients → Your API Client
Acronis Secret	The Client Secret of the API Client used for authentication	Acronis management console → Settings → API Clients → Your API Client

Warning! The Acronis Client Secret grants API access to your Acronis environment. Store it securely and do not share it. If the secret is compromised, revoke and regenerate it immediately in the Acronis management console.

Collection Filter Parameters

These parameters control which tenant usage data is collected. They allow you to narrow the scope of collection to specific product offerings and measurement units.

Parameter	What it is	Example
Included Measure Units	Filters usage records to include only those with the specified measurement unit. Records with other measurement units are excluded.	`bytes`
Included Products	Filters usage records to include only the specified product offering names. Leave empty to collect all product offerings.	`pg_base_storage`
Children Only	When set to `true`, only customer tenants that have child tenants of their own are included in the collection. When set to `false`, all customer tenants are included.	Default: `false`

Note: Product offering names and measurement units are defined by Acronis and may vary depending on the services provisioned in your environment. Consult the Acronis management console or API documentation for the available values.

Billing Parameters

Parameter	What it is	Example
Product Identifier Prefix	A prefix applied to the beginning of each Product Identifier submitted to Varibill. The Product Identifier is constructed as the prefix followed by the Acronis product offering name. Overage records receive an additional `#overage` suffix.	`acro#`

Note: The Product Identifier submitted to Varibill is constructed as: {prefix}{product_offering_name} for included allocation records, and {prefix}{product_offering_name}#overage for overage records. Ensure your Varibill product configuration accounts for both formats.

Operational Parameters

These parameters control collection and file management behavior.

Parameter	What it is	Default
Delete data files older than	The number of days after which locally stored collection files are automatically deleted	`62`
Maximum number of records per file	The maximum number of records written to a single output file before a new file is started. Must be between 1,000 and 50,000.	`10000`

Acronis References

The following resources may assist with locating values or configuring your Acronis API access.

Acronis Documentation (External)

Acronis Cyber Protect Cloud API Documentation

Note: Acronis documentation is provided for reference. Steps and interface labels may vary depending on your Acronis data center region and account permissions.

Configuration Steps

Step 1: Prepare Acronis Cyber Protect Cloud

Log in to the Acronis Cyber Protect Cloud management console as an administrator.
Navigate to Settings > API Clients.
Create a new API Client or select an existing one with appropriate permissions.
Copy the Client ID value.
Copy the Client Secret value.
Note the Data Center URL from your browser’s address bar (the base URL, for example https://cloud.example.com).

Step 2: Configure the Collector in Varibill

In the Varibill User Interface, open the Source Collector configuration screen.
Enter the required field values under the Details tab:
- Hosting Provider: Select Varibill Cloud
- Source Collector Name: Select Acronis to Service - 2.1
Enter the connection parameters:
- Data Center URL: The base URL of your Acronis data center (for example, https://cloud.example.com)
- Acronis Client ID: The Client ID from the Acronis API Client configuration
- Acronis Secret: The Client Secret from the Acronis API Client configuration
Configure the collection filters:
- Included Measure Units: The measurement unit to filter by (for example, bytes)
- Included Products: The product offering names to collect (leave empty for all)
- Children Only: Set to true to collect only tenants with child tenants, or false for all customer tenants
Enter the billing parameters:
- Product Identifier Prefix: The prefix to apply to Product Identifiers (for example, acro#)
Save the collector configuration.

Step 3: Run the Collector

Run or schedule the collector according to your standard Source Collector execution process.

For detailed instructions, see: Configuring a New Cloud Source Collector

Troubleshooting

If the collector fails to connect to Acronis Cyber Protect Cloud, verify that:

The Data Center URL is correct and includes https:// with no trailing slash.
The Client ID is correct.
The Client Secret is valid and has not been revoked or regenerated since it was last configured.
The API Client has sufficient permissions to query tenant usage data.
No firewall or IP restriction rules are blocking the Varibill collector’s IP address.

If no data is returned despite a successful connection, verify that:

The Included Measure Units value matches a measurement unit used by the product offerings in your Acronis environment.
The Included Products value matches a valid product offering name, or is left empty to collect all offerings.
There are active customer tenants with usage data in your Acronis environment.
If Children Only is set to true, confirm that at least one customer tenant has child tenants.