Tags - Gcore Docs

Tags are key-value pairs used to organize and identify Cloud resources. Each tag consists of a key (like env) and a value (like production). You can add tags during resource creation or to existing resources.

During resource creation

Tags can be added directly during the resource creation process.

Navigate to the resource creation page (Cloud > Virtual Instances > Create Instance).
In the Additional options section, turn on the Add tags toggle.
Enter a Key and Value for each tag.
Click Add tag to add more tags if needed.
Complete the resource creation.

Add tags toggle in the Additional options section during resource creation

On existing resources

Tags can also be added to resources that already exist.

Open the resource details page (Cloud > Networking > Load Balancers > select a load balancer).
Navigate to the Tags tab.
Turn on Add custom tags, then enter key-value pairs.
Click Save changes.

Tags tab on an existing resource showing key-value pair fields

Filter resources by tag

In the Customer Portal

Filter tagged resources directly from the resource list.

Navigate to the resource list page (Cloud > Virtual Instances).
Use the search field or available filters to search by tag key or value.

Via API

Use the tag_key_value query parameter when listing resources:

GET /cloud/v1/instances/{project_id}?tag_key_value=env:production

You can filter by multiple tags by repeating the parameter:

GET /cloud/v1/instances/{project_id}?tag_key_value=env:production&tag_key_value=team:backend

This simplifies finding resources belonging to a specific environment, team, or project.

Add tags via API

Include tags in the tags field when creating or updating resources via the Gcore API:

{
  "name": "my-instance",
  "tags": {
    "env": "production",
    "team": "backend"
  }
}

NoteThe metadata field is deprecated. Use the tags field for new implementations.

Add tags via Terraform

Specify tags in the metadata_map attribute when using the Gcore Terraform provider:

resource "gcore_instance" "example" {
  name        = "my-instance"
  flavor_id   = "g1-standard-2-4"
  
  metadata_map = {
    env  = "production"
    team = "backend"
  }
}

Add tags via SDK

Both gcore-python and gcore-go SDKs support the tags parameter when creating resources.

Python
Go

from gcore import Gcore
from gcore.types.cloud.instance_create_params import (
    InterfaceNewInterfaceExternalSerializerPydantic,
    VolumeCreateInstanceCreateVolumeFromImageSerializer,
)

client = Gcore()

instance = client.cloud.instances.create_and_poll(
    name="my-instance",
    flavor="g1-standard-1-2",
    interfaces=[
        InterfaceNewInterfaceExternalSerializerPydantic(type="external"),
    ],
    volumes=[
        VolumeCreateInstanceCreateVolumeFromImageSerializer(
            name="my-volume",
            size=10,
            type_name="standard",
            source="image",
            image_id="your-image-id",
            boot_index=0,
        ),
    ],
    tags={"env": "production", "team": "backend"},
)

package main

import (
    "context"
    "log"

    "github.com/G-Core/gcore-go"
    "github.com/G-Core/gcore-go/cloud"
    "github.com/G-Core/gcore-go/option"
    "github.com/G-Core/gcore-go/shared/constant"
)

func main() {
    client := gcore.NewClient(
        option.WithCloudProjectID(1),
        option.WithCloudRegionID(1),
    )

    params := cloud.InstanceNewParams{
        Name:   gcore.String("my-instance"),
        Flavor: "g1-standard-1-2",
        Interfaces: []cloud.InstanceNewParamsInterfaceUnion{
            {OfExternal: &cloud.InstanceNewParamsInterfaceExternal{
                Type: constant.ValueOf[constant.External](),
            }},
        },
        Volumes: []cloud.InstanceNewParamsVolumeUnion{
            {OfImage: &cloud.InstanceNewParamsVolumeImage{
                Name:      gcore.String("my-volume"),
                Size:      gcore.Int(10),
                TypeName:  "standard",
                Source:    constant.ValueOf[constant.Image](),
                ImageID:   "your-image-id",
                BootIndex: gcore.Int(0),
            }},
        },
        Tags: map[string]string{"env": "production", "team": "backend"},
    }

    instance, err := client.Cloud.Instances.NewAndPoll(context.Background(), params)
    if err != nil {
        log.Fatalf("Error creating instance: %v", err)
    }
    log.Printf("Created instance: %s", instance.ID)
}

Tag formatting rules

Tag keys and values must follow specific format requirements. Invalid tags are rejected during resource creation or update.

Parameter	Requirement
Key length	3-255 characters
Value length	3-255 characters
Forbidden characters	`=` in keys
Whitespace	Leading and trailing spaces are trimmed

WarningTag keys cannot contain the = character.

Common tagging patterns

Consistent tag naming across resources simplifies filtering and cost allocation. These patterns are widely used in production environments.

Pattern	Example tags
Environment	`env:production`, `env:staging`, `env:development`
Service	`service:authentication`, `service:payment`
Ownership	`team:backend`, `owner:devops`
Cost tracking	`cost-center:marketing`, `project:website-redesign`

Use tags in cost reports

Tags appear in the Cost Report table as a dedicated column. Filter and search resources by tag to analyze spending by environment, team, or project. The detailed CSV export includes all tag values assigned to each resource. Use this data to:

Calculate costs per environment (env:production vs env:staging)
Track spending by team or cost center
Identify untagged resources that need classification

Documentation Index

​During resource creation

​On existing resources

​Filter resources by tag

​In the Customer Portal

​Via API

​Add tags via API

​Add tags via Terraform

​Add tags via SDK

​Tag formatting rules

​Common tagging patterns

​Use tags in cost reports

During resource creation

On existing resources

Filter resources by tag

In the Customer Portal

Via API

Add tags via API

Add tags via Terraform

Add tags via SDK

Tag formatting rules

Common tagging patterns

Use tags in cost reports