Check Lustre File Systems for Cost Allocation Tags

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

Navigate to Lustre File Storage console available at https://cloud.oracle.com/lfs/.

In the left navigation panel, choose Lustre file systems, and select an OCI compartment from the Compartment dropdown menu, to list the Lustre file systems provisioned in that compartment.

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

Select the Tags tab to access the resource tags defined for the selected file system. 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) Lustre file systems 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 lfs lustre-file-system-collection list-lustre-file-systems command (Windows/macOS/Linux) with the ID of the OCI compartment that you want to examine as the identifier parameter, to list the ID of each Lustre file system provisioned in the selected OCI compartment:

oci lfs lustre-file-system-collection list-lustre-file-systems
	--compartment-id 'ocid1.tenancy.oc1..aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd'
	--availability-domain 'ABC1:AB-ABC123-1-BC-1'
	--all
	--query 'data[]."id"'

The command output should return the requested file system IDs:

[
	"ocid1.lustrefilesystem.oc1.ap_sydney_1.aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd",
	"ocid1.lustrefilesystem.oc1.ap_sydney_1.aaaabbbbccccddddabcdabcd1234abcd1234abcd1234abcd1234abcd1234"
]

Run lfs lustre-file-system get command (Windows/macOS/Linux) to describe the resource tags (defined tags and free-form tags) defined for the specified OCI Lustre file system:

oci lfs lustre-file-system get
	--lustre-file-system-id 'ocid1.lustrefilesystem.oc1.ap-sydney-1.aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd'
	--query 'data.["defined-tags","freeform-tags"]'

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

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

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 lfs lustre-file-system 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 Oracle Cloud Infrastructure (OCI) Lustre file system is not using cost allocation tags.

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

Navigate to Lustre File Storage console available at https://cloud.oracle.com/lfs/.

In the left navigation panel, choose Lustre file systems, and select an OCI compartment from the Compartment dropdown menu, to list the Lustre file systems provisioned in that compartment.

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

Choose Add tags from the resource top menu, and perform the following actions to create the recommended cost allocation tags for the selected Lustre file system:

1. For Namespace, select a tag namespace from the dropdown list to add a defined tag or select None 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 lfs lustre-file-system update command (Windows/macOS/Linux) to add cost allocation tags (free-form tags) to the specified Oracle Cloud Infrastructure (OCI) Lustre file system. 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 lfs lustre-file-system update
	--lustre-file-system-id 'ocid1.lustrefilesystem.oc1.ap-sydney-1.aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd'
	--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 command request ID:

{
	"opc-work-request-id": "ocid1.lustrefilesystemworkrequest.oc1.ap-sydney-1.aaaabbbbccccddddabcdabcd1234abcd1234abcd1234abcd1234abcd1234"
}

Run lfs lustre-file-system update command (Windows/macOS/Linux) to add cost allocation tags (defined tags) to the specified OCI Lustre file system. 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 lfs lustre-file-system update
	--lustre-file-system-id 'ocid1.lustrefilesystem.oc1.ap-sydney-1.aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd'
	--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

The command output should return the command request ID:

{
	"opc-work-request-id": "ocid1.lustrefilesystemworkrequest.oc1.ap-sydney-1.aaaabbbbccccddddabcdabcd1234abcd1234abcd1234abcd1234abcd1234"
}

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