Connecting to Oracle Cloud (OCI)

Connect your Oracle Cloud Infrastructure (OCI) account to CloudZero to bring your OCI cost data into a unified view of all your cloud spend. CloudZero organizes your OCI costs, along with your other cloud costs, into categories (called Dimensions) that matter most to your business. For example: business unit, team, product, feature, environment, customer, or virtually anything else. Once connected and organized, you can quickly answer questions about your cloud spend that matter to your stakeholders.

This guide walks through the three-step connection process, which uses an API key from your OCI tenant for read-only access. Cost data appears in the Explorer within 24 hours.

What you need

Step 1: Confirm access to Cost and Usage Reports

For full details, see Oracle's Cost and Usage Reports documentation.

  1. In the Oracle Cloud Console, open the top-left menu and navigate to Billing & Cost Management.
Billing and cost management screen in the Oracle Cloud Console
  1. Select Cost and Usage Reports. A list of available reports appears.
Cost and Usage Reports list in the Oracle Cloud Console

If you see policy errors instead of reports, your account does not have root tenant access. See OCI billing access policies or contact your OCI administrator.

Step 2: Generate an API key

For full details, see Oracle's API signing key documentation.

  1. In the Oracle Cloud Console, go to your user profile and select the Tokens and keys tab.
API keys section in the Oracle Cloud Console user profile
  1. Select Add API key.
  2. Download the private key file. You will need it in Step 3.
  3. Select Add.
  4. On the Configuration file preview screen, copy the values listed in the table below. You will need them in Step 3.
Configuration file preview showing the required connection values
CloudZero fieldConfiguration file preview field
User OCIDuser
API Key Fingerprintfingerprint
Regionregion
Tenancy OCIDtenancy

Step 3: Configure the connection in CloudZero

  1. In CloudZero, go to Settings > Cloud Connections.
  2. Select Create Connection + and select the Oracle Cloud tile.
  3. Paste the values you copied from the configuration file preview into the corresponding fields.
  4. Open the private key file you downloaded in Step 2 and copy the full contents of the key.
  5. Paste the private key into the Private Key field.
CloudZero Oracle Cloud connection screen
  1. Select Continue. CloudZero verifies the connection and creates it.

What to expect

After CloudZero processes the first data ingest, the connection status changes from Pending Data to Healthy, and your cost data appears in the Explorer. This can take up to 24 hours.

ℹ️

Have questions or feedback? Reach out to your account manager.