UpCloud

File Storage Labels

Labels are key-value pairs that help you organize and categorize file storage services. Use labels to filter services, apply policies, or track resources across your infrastructure.

GET/1.3/file-storage/{service_uuid}/labels

List labels

Returns a list of all labels for a file storage service.

Request

GET
/1.3/file-storage/{service_uuid}/labels
curl -X GET https://api.upcloud.com/1.3/file-storage/0ad24fe5-d08a-44ea-a0a8-169a46e0cc90/labels \
  -u your_username:your_password
GET/1.3/file-storage/{service_uuid}/labels/{key}

Get label details

Returns details of a specific label.

Request

GET
/1.3/file-storage/{service_uuid}/labels/{key}
curl -X GET https://api.upcloud.com/1.3/file-storage/0ad24fe5-d08a-44ea-a0a8-169a46e0cc90/labels/environment \
  -u your_username:your_password
POST/1.3/file-storage/{service_uuid}/labels

Create label

Creates a new label for a file storage service.

Attributes

  • Name
    key
    Type
    string
    Description

    Label key (1-255 chars, alphanumeric with - and _).

  • Name
    value
    Type
    string
    Description

    Label value (1-255 chars).

Request

POST
/1.3/file-storage/{service_uuid}/labels
curl -X POST https://api.upcloud.com/1.3/file-storage/0ad24fe5-d08a-44ea-a0a8-169a46e0cc90/labels \
  -u your_username:your_password \
  -H "Content-Type: application/json" \
  -d '{
    "key": "project",
    "value": "web-app"
  }'
PATCH/1.3/file-storage/{service_uuid}/labels/{key}

Modify label

Modifies an existing label's value.

Attributes

  • Name
    value
    Type
    string
    Description

    Updated label value.

Request

PATCH
/1.3/file-storage/{service_uuid}/labels/{key}
curl -X PATCH https://api.upcloud.com/1.3/file-storage/0ad24fe5-d08a-44ea-a0a8-169a46e0cc90/labels/environment \
  -u your_username:your_password \
  -H "Content-Type: application/json" \
  -d '{
    "value": "staging"
  }'
DELETE/1.3/file-storage/{service_uuid}/labels/{key}

Delete label

Deletes a label from a file storage service.

Request

DELETE
/1.3/file-storage/{service_uuid}/labels/{key}
curl -X DELETE https://api.upcloud.com/1.3/file-storage/0ad24fe5-d08a-44ea-a0a8-169a46e0cc90/labels/project \
  -u your_username:your_password