Check for Cost Allocation Tags

Sign in to your Oracle Cloud Infrastructure (OCI) account.

Navigate to Object Storage & Archive Storage console available at https://cloud.oracle.com/object-storage/.

In the left navigation panel, choose Buckets, and select an OCI compartment from the Compartment dropdown menu available next to Applied filters, to list the Object Storage buckets available within that compartment.

Click on the name (link) of the bucket that you want to examine, listed in the Name column.

Select the Tags tab to access the resource tags defined for the selected bucket. There are two types of resource tags: defined tags and free-form tags. A defined tag is a structured key-value metadata with enforced policies and namespace, that has the following format: \<tag-namespace\>.\<tag-key\>:\<tag-value\>. A free-form tag is a simple key-value metadata with no structure or namespace enforcement, with the following format: \<tag-key\>:\<tag-value\>.

Choose the Defined tags/Free-form tags tab, and search for the following combination of tag keys (\<tag-key\>): CostCenter, Project, Environment, Owner, and BillingCode. If the Defined tags/Free-form tags list does not contain the specified combination of tag keys, the selected Oracle Cloud Infrastructure (OCI) Object Storage bucket is not using cost allocation tags.

Run iam compartment list command (Windows/macOS/Linux) with output query filters to list the ID of each compartment available in your Oracle Cloud Infrastructure (OCI) account:

oci iam compartment list
	--all
	--include-root
	--query 'data[]."id"'

The command output should return the requested OCI compartment identifiers (OCIDs):

[
	"ocid1.tenancy.oc1..aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd",
	"ocid1.compartment.oc1..abcd1234abcd1234abcd1234abcd1234abcd1234abcd1234abcd1234abcd"
]

Run os bucket list command (Windows/macOS/Linux) with the ID of the OCI compartment that you want to examine as the identifier parameter, the list the name of each Object Storage bucket available in the selected OCI compartment:

oci os bucket list
	--compartment-id 'ocid1.tenancy.oc1..aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd'
	--all
	--query 'data[]."name"'

The command output should return the requested bucket names:

[
	"cc-project5-data-bucket",
	"cc-cloud-artifacts-bucket"
]

Run os bucket get command (Windows/macOS/Linux) to describe the resource tags (defined tags and free-form tags) defined for the specified OCI Object Storage bucket:

oci os bucket get
	--bucket-name 'cc-project5-data-bucket'
	--query 'data.["defined-tags","freeform-tags"]'

The command output should return the resource tags used by the selected bucket:

[
	{
		"Project": "Project5"
	},
	{
		"Oracle-Tags": {
		"CreatedBy": "Sydney Dev Team"
		}
	}
]

In Oracle Cloud Infrastructure (OCI), there are two types of resource tags: defined tags and free-form tags. A defined tag is a structured key-value metadata with enforced policies and namespace, that has the following format: "\<tag-namespace\>": {"\<tag-key\>": "\<tag-value\>"}. A free-form tag is a simple key-value metadata with no structure or namespace enforcement, with the following format: "\<tag-key\>": "\<tag-value\>". Check each tag key returned by the os bucket get command output (e.g., "Project") for the following combination of tag keys: "CostCenter", "Project", "Environment", "Owner", and "BillingCode". If the command output does not return the specified combination of tag keys, the selected OCI Object Storage bucket is not using cost allocation tags.

Sign in to your Oracle Cloud Infrastructure (OCI) account.

Navigate to Object Storage & Archive Storage console available at https://cloud.oracle.com/object-storage/.

In the left navigation panel, choose Buckets, and select an OCI compartment from the Compartment dropdown menu available next to Applied filters, to list the Object Storage buckets available within that compartment.

Click on the name (link) of the bucket that you want to configure, listed in the Name column.

Select the Tags tab, choose Add, and perform the following actions to create the recommended cost allocation tags for the selected Object Storage bucket:

1. For Namespace, select a tag namespace from the dropdown list to add a defined tag or select None (freeform tag) to add a free-form tag. A defined tag is a structured key-value metadata with enforced policies and namespace. A free-form tag is a simple key-value metadata with no structure or namespace enforcement.
2. For Key, choose a cost allocation tag key that's associated with the selected tag namespace if you are adding a defined tag, or type CostCenter, Project, Environment, Owner, or BillingCode in the tag key box if you're adding a free-form tag.
3. For Value, enter the tag value for the chosen cost allocation tag key.
4. Choose Add tag and make sure that each cost allocation tag (i.e., CostCenter, Project, Environment, Owner, and BillingCode) is defined.
5. Choose Add tags to apply the recommended cost allocation tags to your OCI resource.

Run os bucket update command (Windows/macOS/Linux) to add cost allocation tags (free-form tags) to the specified OCI Object Storage bucket. A free-form tag is a simple key-value metadata with no structure or namespace enforcement. Make sure that you include any existing free-form tags to the --freeform-tags parameter value:

oci os bucket update
	--bucket-name 'cc-project5-data-bucket'
	--freeform-tags '{"BillingCode":"P5009","Project":"Project5"}'

Type Y and press Enter for confirmation:

WARNING: Updates to defined-tags and freeform-tags will replace any existing values. Are you sure you want to continue? [y/N]: Y

The command output should return the configuration information (including tags) available for the modified bucket:

{
	"data": {
		"approximate-count": null,
		"approximate-size": null,
		"auto-tiering": "Disabled",
		"compartment-id": "ocid1.tenancy.oc1..aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd",
		"created-by": "ocid1.user.oc1..aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd",
		"defined-tags": {},
		"etag": "abcd1234abcd1234abcd1234abcd1234",
		"freeform-tags": {
			"BillingCode": "P5009",
			"Project": "Project5"
		},
		"id": "ocid1.bucket.oc1.ap-sydney-1.aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd",
		"is-read-only": false,
		"kms-key-id": null,
		"metadata": {},
		"name": "cc-project5-bucket",
		"namespace": "abcd1234abcd",
		"object-events-enabled": false,
		"object-lifecycle-policy-etag": null,
		"public-access-type": "NoPublicAccess",
		"replication-enabled": false,
		"storage-tier": "Standard",
		"time-created": "2025-12-01T17:41:13.541000+00:00",
		"versioning": "Disabled"
	},
	"etag": "abcd1234abcd1234abcd1234abcd1234"
}

Run os bucket update command (Windows/macOS/Linux) to add cost allocation tags (defined tags) to the specified OCI Object Storage bucket. A defined tag is a structured key-value metadata with enforced policies and namespace. Make sure that you include any existing defined tags to the --defined-tags parameter value:

oci os bucket update
	--bucket-name 'cc-project5-data-bucket'
	--defined-tags '{"Cost":{"BillingCode":"P5009"}}'

Type Y and press Enter for confirmation:

WARNING: Updates to defined-tags and freeform-tags will replace any existing values. Are you sure you want to continue? [y/N]: Y

he command output should return the configuration information (including tags) available for the modified bucket:

{
	"data": {
		"approximate-count": null,
		"approximate-size": null,
		"auto-tiering": "Disabled",
		"compartment-id": "ocid1.tenancy.oc1..aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd",
		"created-by": "ocid1.user.oc1..aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd",
		"defined-tags": {},
		"etag": "abcd1234abcd1234abcd1234abcd1234",
		"defined-tags": {
			"Cost": {
				"BillingCode": "P5009"
			}
		},
		"id": "ocid1.bucket.oc1.ap-sydney-1.aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd",
		"is-read-only": false,
		"kms-key-id": null,
		"metadata": {},
		"name": "cc-project5-bucket",
		"namespace": "abcd1234abcd",
		"object-events-enabled": false,
		"object-lifecycle-policy-etag": null,
		"public-access-type": "NoPublicAccess",
		"replication-enabled": false,
		"storage-tier": "Standard",
		"time-created": "2025-12-01T17:41:13.541000+00:00",
		"versioning": "Disabled"
	},
	"etag": "abcd1234abcd1234abcd1234abcd1234"
}

Repeat steps no. 1 - 6 for each recommended cost allocation tag, i.e., CostCenter, Project, Environment, Owner, and BillingCode.