Tags - San Francisco Compute Docs

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 pools create --name root --tag model=cuda-crunch

sf instances set 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 instances set 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 pools set dev --tag null

List resources by tags

You can filter resources that match your provided tags.

sf instances list --tag model=cuda-crunch

NAME          STATUS              POOL       CREATED     TAGS
prod          running             root       2025-03-01  model=cuda-crunch, env=prod

Providing a tag key returns all resources that have tags with the specified key

sf instances list --tag-key env

NAME        STATUS               POOL           INSTANCE SKU  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

​Syntax

​Create tags

​Edit tags

​Delete tags

​List resources by tags

​Limits

Syntax

Create tags

Edit tags

Delete tags

List resources by tags

Limits