Skip to main content

aws-quickstart

Last updated on
important

AWS CUR 2.0 (Data Exports) is now supported and recommended for new connectors. It currently supports Cost Visibility, Asset Governance, and Recommendations. If you need AutoStopping, Commitments, or Cluster Orchestrator, use CUR 1.0, which remains fully supported and covers all CACM features.

Before You Start​

To ensure a smooth and error-free setup experience, complete the following steps in your AWS console before launching the Harness wizard. This will allow you to progress through the setup without delays or missing prerequisites.

Required InfoWhere to Find ItWhy It’s Needed
AWS Account ID (12-digit number)AWS Console → Account SettingsUsed to associate your cloud costs with your Harness project.
Cost and Usage Report (CUR)AWS Console → Billing → Cost & Usage ReportsHarness uses this to ingest detailed billing data.
S3 Bucket NameAWS Console → S3Stores the CUR files for Harness to access.

Set up the Cost and Usage Report​

CUR 2.0 setup​

info

This feature is behind the feature flag CCM_AWS_NEW_CUR. Contact Harness Support to enable it.

  1. In the AWS console, navigate to Billing and Cost Management → Data Exports → Create export.
  2. Under Report details, select all four options:
    • Include resource IDs
    • Split cost allocation data
    • Include caller identity (IAM principal) allocation data
    • Include capacity reservation columns and granularity
  3. Under Delivery options, configure the following:
SettingRequired Value
Compression typeParquet
S3 bucketSelect or create a bucket. Copy the bucket name, as you will need it for the Harness connector.
S3 path prefixEnter any prefix.
  1. Do not uncheck any columns.
  2. Review and create the export. Copy the export name, as you will need it for the Harness connector.
time for data delivery

It may take up to 24 hours for AWS to begin delivering cost and usage data. You can still proceed through the wizard, but the connection test may fail if data isn’t yet available.

In the meantime, explore the optional requirements and feature integrations available in Harness CACM, these will be available to select in your Choose Requirements step of the connection wizard:

Cloud Connector Wizard​

Once you've gathered the required AWS details, follow these steps in the Harness setup wizard to connect your AWS account and enable cost visibility.

Interactive Guide​

Step-by-Step​

Step 1: Add AWS Account Details​

  1. In the wizard, enter a name for your connector (e.g., ccm-aws-prod).
  2. Enter your 12-digit AWS Account ID.
  3. (Optional) Add a description and tags to help identify this connector later.
  4. If you're using a GovCloud account, select Yes; otherwise, leave the default.
  5. Click Continue.

Step 2: Select or Create a Cost and Usage Report​

In the connector wizard, select the report type based on the features you need:

Report typeSupported featuresRecommended for
CUR 2.0 (recommended)Cost Visibility, Asset Governance, RecommendationsNew connectors, AI cost attribution (e.g. Amazon Bedrock), organizations that do not need AutoStopping, Commitments, or Cluster Orchestrator
CUR 1.0 (legacy)Cost Visibility, Asset Governance, Recommendations, AutoStopping, Commitments, Cluster OrchestratorExisting connectors that rely on AutoStopping, Commitments, or Cluster Orchestrator
  1. In the connector wizard, select the CUR 2.0 (recommended) tab.
  2. Click Launch AWS console and follow the CUR 2.0 setup steps to create a Data Export if you have not done so already.
  3. Enter the Data Export Name and S3 Bucket Name in the fields provided.
  4. Click Continue.
info

Review Feature Permissions for CACM to understand the minimum IAM roles or policies needed for every CACM feature.

Step 3: Choose Requirements​

  1. Cost Visibility is selected by default and is required, leave it checked.
  2. (Optional) You can enable any of the following features (they can also be added later):
    • Resource Inventory Management
    • Optimization by AutoStopping
    • Cloud Governance
    • Commitment Orchestration
  3. Click Continue.
tip

Not sure which options to choose? Learn more about each feature.

Step 4: Authentication (Conditional)​

If you have selected Optimization by AutoStopping, Cloud Governance or Commitment Orchestration, in previous step, you can set up Authentication using OIDC. If not selected, this step will not be prompted.

You can enable authentication for your AWS account via

Step 5: Enter Cross Account Role Details​

  1. Paste the Cross Account Role ARN you created via the CloudFormation template. You can find it under CloudFormation → Stacks → Outputs tab in AWS.
note

If you are using CUR 2.0, ensure the Cross Account IAM role has been updated with the CUR 2.0 permissions by re-running the CloudFormation template or manually adding them as described in the Migrating from CUR 1.0 tab above.

  1. The External ID will be pre-filled. Leave it as is.
  2. Click Save and Continue.

Step 6: Verify the Connection​

  1. Harness will attempt to validate the connection using your inputs.
  2. If this step fails, it's usually because AWS has not yet delivered the first CUR file.
    • Wait up to 24 hours after setting up the CUR before trying again.
  3. Once validated, click Finish Setup.

🎉 You’ve now connected your AWS account and enabled cost visibility in Harness.

Next Steps​

Once your AWS billing data is flowing into Harness, explore these features to enhance your cloud & AI cost management:

Take the next step in your cloud & AI cost management journey and turn visibility into action.