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
- CloudZero user with data configuration permissions
- In OCI, root tenant access with the ability to generate API keys
Step 1: Confirm access to Cost and Usage Reports
For full details, see Oracle's Cost and Usage Reports documentation.
- In the Oracle Cloud Console, open the top-left menu and navigate to Billing & Cost Management.

- Select Cost and Usage Reports. A list of available reports appears.

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.
- In the Oracle Cloud Console, go to your user profile and select the Tokens and keys tab.

- Select Add API key.
- Download the private key file. You will need it in Step 3.
- Select Add.
- On the Configuration file preview screen, copy the values listed in the table below. You will need them in Step 3.

| CloudZero field | Configuration file preview field |
|---|---|
| User OCID | user |
| API Key Fingerprint | fingerprint |
| Region | region |
| Tenancy OCID | tenancy |
Step 3: Configure the connection in CloudZero
- In CloudZero, go to Settings > Cloud Connections.
- Select Create Connection + and select the Oracle Cloud tile.
- Paste the values you copied from the configuration file preview into the corresponding fields.
- Open the private key file you downloaded in Step 2 and copy the full contents of the key.
- Paste the private key into the Private Key field.

- 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.
Updated 15 days ago
