Capabilities
✅ Cloud cost | Every line item of your AWS bill in the FOCUS 1.2 format, with the service, region, account, resource, commitment discount and all four cost columns |
Prerequisites
You must be able to create a data export in AWS Billing and Cost Management. In an AWS Organization that means the management account, or a member account you have delegated billing access to
You must be able to create an IAM role and an S3 bucket in that same account
Data Exports runs in the
us-east-1region only, though the destination bucket can live anywhere
Setup
Create an S3 bucket for the export, or pick an existing one. Note its name and its region.
Create the FOCUS data export:
Open the AWS console and go to Billing and Cost Management → Data Exports → Create
Choose Standard data export
Export type: FOCUS 1.2 (if offered, the "with AWS columns" variant is also fine)
Give the export a name, for example
viio-cloud-costUnder Data table delivery options, choose Create new data export file. AWS then writes each delivery to its own folder instead of overwriting a file Viio may be reading
Compression type and file format: gzip - text/csv. Viio cannot read Parquet exports
Choose your bucket and set an S3 path prefix, for example
cost/focusCreate the export. AWS will ask to add a bucket policy that lets the billing service write to the bucket. Accept it
AWS delivers the first file within about 24 hours, then refreshes the current month about three times a day. Each refresh republishes the whole month, so a charge that arrives late, or a credit AWS applies after the fact, appears in the next delivery.
Create a role for Viio to read the export. In IAM → Roles → Create role, choose Custom trust policy and paste:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": { "AWS": "<VIIO_PRINCIPAL_ARN>" },
"Action": "sts:AssumeRole"
}
]
}Attach an inline policy that grants read access to the export only. Replace the bucket name and path prefix with your own:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "s3:ListBucket",
"Resource": "arn:aws:s3:::my-cost-bucket",
"Condition": { "StringLike": { "s3:prefix": "cost/focus/*" } }
},
{
"Effect": "Allow",
"Action": "s3:GetObject",
"Resource": "arn:aws:s3:::my-cost-bucket/cost/focus/*"
}
]
}If a customer managed KMS key encrypts the bucket, also grant the role
kms:Decrypton that key.Configure the integration in Viio:
Open Viio → Integrations and choose AWS → Connect
Enter the four values below, then click Continue, add a name, and click Save
Role ARN: the role you created in step 3, for example
arn:aws:iam::123456789012:role/viio-cost-reader.Bucket: the bucket name only, with no
s3://and no path, for examplemy-cost-bucket.Region: the region the bucket is in, not the region of the export, for example
eu-west-1.Export path: the S3 path prefix you set on the export, with no bucket name, for example
cost/focus.
Initial sync:
Viio reads every billing period already in the bucket, so the first run brings in every month the export covers
After that Viio picks up each new delivery and replaces that month's figures with the latest ones AWS published
Troubleshooting & FAQ
Symptom | Quick fix |
The integration saves but no cost appears. | Usually AWS has not delivered the first file yet. That takes up to 24 hours after you create the export. Open Data Exports in the console and check that the export shows a recent delivery, then open the bucket and confirm there is a |
I get an access denied error. | Check three things. The role ARN in Viio matches the role you created. The role's trust policy names the Viio principal exactly. The inline policy's bucket name and path prefix match where the export actually writes, including the |
What does Viio see in my account? | Only the objects under the export path prefix in the one bucket you name. The role grants read access to nothing else, and Viio never writes to your account. |
Which month does a charge count towards? | The billing period AWS assigned it, which is the folder AWS delivered the row in. A charge recorded late still lands in the month it belongs to rather than the month it arrived. |
My bill went down after a few days. Is something wrong? | No. AWS refreshes the open month until it invoices it, adding credits, refunds and savings plan allocations as it calculates them. Viio replaces the month with each new delivery, so what you see matches the latest version AWS published. |
Can I point Viio at an export I already have? | Yes, as long as it is FOCUS 1.2, gzipped CSV, and set to create new files rather than overwrite. Viio cannot read a legacy Cost and Usage Report, a CUR 2.0 export, or a Parquet export. |
Can I connect more than one AWS account? | Connect the management account of your organization. Its export already covers every member account and identifies each one separately. Connect standalone accounts one integration at a time. Do not connect the same account twice, since Viio would count both copies. |
Technical details
Authentication: Viio assumes the customer-provided role with
sts:AssumeRoleunder the session nameviio-cloud-cost, and assumes it again when the session expires. Viio stores no long-lived credentials from the customer account.Discovery: AWS rewrites one manifest per billing period on every delivery, at
<export_path>/metadata/billing_period=YYYY-MM/<name>-Manifest.json. Viio lists those manifests, reads each one'sexecutionId, and fetches a period only when itsexecutionIddiffers from the one Viio recorded on the last successful sync. Viio ignores the per-execution manifest copies one folder deeper.Reading: Viio streams the data files from S3 and decompresses them as it reads, so memory does not grow with the size of the export. Rows go out in batches that close on either a row count or a byte budget. Viio passes money and quantity columns through as the exact decimal strings AWS exported, and parses only the period columns. A blank cell in the export, for example the region of a global service, arrives as no value rather than an empty string. Viio keeps columns outside the FOCUS specification, such as
x_ServiceCode, alongside the row.
