Skip to main content
Tags are in early access. Email support@sfcompute.com to request access.
Tags are key=value pairs that help you track and organize resources on SF Compute.

​
Syntax

Tag keys must not contain any space, comma, or equals sign Tag values must not contain any comma or equals sign. spaces are accepted inside tag values Tags are case sensitive.

​
Create tags

You can set tags while creating a resource or by editing an existing one. 
sf capacity create --name root --tag model=cuda-crunch

sf nodes set --name training-12 --tag model=cuda-crunch --tag optimizer=adam

​
Edit tags

You can overwrite all existing tags with the set command for any resource. 
sf nodes set --name prod --tag model=cuda-crunch --tag env=prod

​
Delete tags

Setting tags to null will delete any existing tags attached to a resource. Once deleted, tags cannot be recovered. 
sf capacity set --name dev --tag null

​
List resources by tags

You can filter resources that match your provided tags. 
sf nodes list --tag model=cuda-crunch

NAME          STATUS              CAPACITY   CREATED     TAGS
prod          running             root       2025-03-01  model=cuda-crunch, env=prod
Providing a tag key return all resources that have tags with the specified key 
sf node list --tag-key env

NAME        STATUS               CAPACITY       ZONE  CREATED         TAGS
prod        awaiting_allocation  prod           -     Mar 31, 9:19pm  env=prod, model=cuda-crunch

​
Limits

Tags have the following limits:
  • Max limit of 50 tags per resource
  • Tag keys cannot be more than 128 characters
  • Tag values cannot be more than 256 characters