Oracle Cloud Infrastructure Documentation

Usage Reports Overview

A usage report is a comma-separated value (CSV) file that can be used to get a detailed breakdown of resources in Oracle Cloud Infrastructure for audit or invoice reconciliation.

How Usage Reports Work

The usage report is automatically generated daily, and is stored in an Oracle-owned Object Storage bucket. It contains one row per each Oracle Cloud Infrastructure resource (such as instance, Object Storage bucket, VNIC) per hour along with consumption information, metadata, and tags. Usage reports generally contain 24 hours of usage data, although occasionally a usage report may contain late-arriving data that is older than 24 hours.

Usage reports are retained for one year.

The file name for each usage report is appended with an automatically incrementing numerical value.

The report may contain corrections. Corrections are added as new rows to the report, with the lineItem/iscorrection column set and the referenceNo value of the corrected line populated in the lineItem/backReference column.

Usage Report Schema

The following table shows the usage report schema.

Field Name Description
lineItem/referenceNo Line identifier. Used for debugging and corrections.
lineItem/TenantId The identifier (OCID) for the Oracle Cloud Infrastructure tenant.
lineItem/intervalUsageStart The start time of the usage interval for the resource in UTC.
lineItem/intervalUsageEnd The end time of the usage interval for the resource in UTC.
product/service The service that the resource is in.
product/resource The resource name used by the metering system.
product/compartmentId The ID of the compartment that contains the resource.
product/compartmentName The name of the compartment that contains the resource.
product/region The region that contains the resource.
product/availabilityDomain The availability domain that contains the resource.
product/resourceId The identifier for the resource.
usage/consumedQuantity The quantity of the resource that has been consumed over the usage interval.
usage/billedQuantity The quantity of the resource that has been billed over the usage interval.
usage/consumedQuantityUnits The unit for the consumed quantity and billed quantity.
usage/consumedQuantityMeasure The measure for the consumed quantity and billed quantity.
lineItem/backreference Data amendments and corrections reference. If a correction to an existing line item is needed, a new row is added with the corrected values and a reference to the original line. Used with the lineItem/isCorrection field.
lineItem/isCorrection Used if the current line is a correction. See the lineitem/backreference column for a reference to the corrected line item.
tags/ The usage report contains one column per tag definition (includes all tag definitions, not just cost tracking tags).

Required IAM Policy

To use Oracle Cloud Infrastructure, you must be given the required type of access in a policy  written by an administrator, whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you try to perform an action and get a message that you don’t have permission or are unauthorized, confirm with your administrator the type of access you've been granted and which compartment  you should work in.

If you're new to policies, see Getting Started with Policies and Common Policies.

Authentication and Authorization

Each service in Oracle Cloud Infrastructure integrates with IAM for authentication and authorization, for all interfaces (the Console, SDK or CLI, and REST API).

An administrator in your organization needs to set up groups , compartments , and policies  that control which users can access which services, which resources, and the type of access. For example, the policies control who can create new users, create and manage the cloud network, launch instances, create buckets, download objects, etc. For more information, see Getting Started with Policies. For specific details about writing policies for each of the different services, see Policy Reference.

If you’re a regular user (not an administrator) who needs to use the Oracle Cloud Infrastructure resources that your company owns, contact your administrator to set up a user ID for you. The administrator can confirm which compartment or compartments you should be using.