Labels are key-value maps associated with a resource, such as Load Balancer, Instance Pool etc. This allows to attach additional meta information to an entity.

Adding labels

At the moment resources can be labeled only using the CLI command. Here is an example of adding env=prod label on Instance Pool creation:

$ exo instancepool create web \
    --zone ch-gva-2 \
    --size 2 \
    --description "Web servers" \
    --service-offering "Medium" \
    --ipv6 "true" \
    --label env=prod \
    --template "4635f170-4a5a-4443-8b95-006bb755060e"
 ✔ Creating Instance Pool "web"... 21s
┼──────────────────────┼──────────────────────────────────────┼
│ ID                   │ 376d45be-9afe-4c65-996a-da68d9ef618b │
│ Name                 │ web                                  │
│ Description          │ Web servers                          │
│ Service Offering     │ medium                               │
│ Template             │ TEST                                 │
│ Zone                 │ ch-gva-2                             │
│ Anti-Affinity Groups │ n/a                                  │
│ Security Groups      │ n/a                                  │
│ Private Networks     │ n/a                                  │
│ Elastic IPs          │ n/a                                  │
│ IPv6                 │ true                                 │
│ SSH Key              │ -                                    │
│ Size                 │ 2                                    │
│ Disk Size            │ 50 GiB                               │
│ Instance Prefix      │ pool                                 │
│ State                │ running                              │
│ Labels               │ env:prod                             │
│ Instances            │ pool-376d4-lwafb                     │
│                      │ pool-376d4-mylpf                     │
┼──────────────────────┼──────────────────────────────────────┼

Usage

Note

On update labels can’t be appended or changed - existing key-value map will be replaced with a new one.

Limitations

  • Label value should begin with a non-numeric character. It should contain only alphanumeric characters and/or , +, !, -, _, ?* symbols. The value is limited to 128 characters.