How to set tags in usage records

[KuasarCloud]

Hey team!

We started using the SharedFile System and from the usage point of view it's just 1 vm and 2 disks, however we would like to differentiate that specific use case, is it possible we can set tags in the usage records json response, field "tags": []. If so, where can we set it? we already created tags for the resource bit it's not there as you can see in this example

{
"description": "Volume usage for ROOT-1323 (6155ef00-b57d-4744-8356-5f9956exxxxx) and template systemvm-kvm-4.20.0-x86_64 (3c901477-c177-4d34-ae90-c8ceb6xxxxx) and size (4.88 GB) 5242880000",
"domain": "xxxxxxxx",
"domainid": "272c416e-9821-453a-a228-xxxxxxxxxx",
"domainpath": "/xxxxxxxx/",
"enddate": "2025-03-21T23:59:59-0500",
"project": "624349294c0efe30d9ec0fd6",
"projectid": "a05c87c4-fefa-4550-88fd-xxxxxxxxx",
"rawusage": "24",
"size": 5242880000,
"startdate": "2025-03-21T00:00:00-0500",
"tags": [],
"templateid": "3c901477-c177-4d34-ae90-c8ceb633f2c8",
"usage": "24 Hrs",
"usageid": "6155ef00-b57d-4744-8356-5f9956ecb746",
"usagetype": 6,
"zoneid": "6d4b1650-357e-4885-9ed3-xxxxxxxxx"
}

[winterhazel]

we would like to differentiate that specific use case, is it possible we can set tags in the usage records json response

Yes, that's a possible to differentiate it currently. You can set resource tags on the shared filesystem VM and/or its volumes and check them on the listUsageRecords response. However, keep in mind that if users have access to CloudStack, they can edit and remove these tags as long as they have permission to use the createTags and deleteTags APIs.

Another option would be to call other APIs to check if the VM or the volume (specified by usageid) is associated with a shared filesystem resource.

Ideally, though, CloudStack should be extended to add a new usage type for shared filesystem resources.

If so, where can we set it?

Via the UI, you can configure resource tags at the bottom of the VM/the volume's info card.

Via the API, you can configure them through the createTags and deleteTags APIs.

Resource tags associated with a VM will be returned in the running/allocated VM usage records of that VM, and resource tags associated with a volume will be returned in the volume usage records of that volume.

we already created tags for the resource bit it's not there as you can see in this example

Are you passing includetags=true when calling listUsageRecords? You need to pass this parameter for tags to be listed.

[KuasarCloud]

Hi @winterhazel

Thanks for taking some time to reply, in fact I was missing the includetags=true parameter.

I think we are going to do use the tag approach to know when this a sharedfs resource, at the moment as users don't interact with ACS directly so we can control which actions can they do, so deleting the tags won't happen.

Regards,