Tag
User can define a set of free-form tags to group and identify a subset of their servers. Tags can be for example webserver, database, PROD, QA, DEV etc.
A server can have several tags. API can be used to return only servers matching specified tags. Note that all operations changing server's state or attributes must still be done individually for each server UUID, tags can be used only to return a list of servers.
Warning! Consider using labels instead of tags: Tags are an access control feature and only available for a limited set of resources. Use labels to describe and filter your resources. Documentation for labels can be found on the resource specific documentation pages.
Creating and modifying tags is allowed only by main account. Subaccounts have access only to listing tags and tagged servers they are granted access to.
Get tag details
Returns details for a specific tag.
path Parameters
name^[A-Za-z0-9_]{1,32}$ · requiredTag name
Short name used to identify a tag.
Get tag details › Responses
Modify existing tag
Changes attributes of an existing tag
path Parameters
name^[A-Za-z0-9_]{1,32}$ · requiredTag name
Short name used to identify a tag.
Modify existing tag › Request Body
Modify existing tag › Responses
Delete a tag
Deletes a specific tag.
path Parameters
name^[A-Za-z0-9_]{1,32}$ · requiredTag name
Short name used to identify a tag.
Delete a tag › Responses
Tag deleted successfully.