> For the complete documentation index, see [llms.txt](https://docs.glesys.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.glesys.com/products/storage/object-storage/how-tos/manage-and-monitor-instances.md).

# Manage and monitor instances

***

## Manage instances using the control panel

On the Object Storage overview, you'll see all your instances, their descriptions, the data center they are in, how much storage they use, and their estimated cost.

At the top of the overview page, just below the **Filter** field, is a summary of all instances. In this case, 4 instances are using 12 GiB. The total cost is 7.44 SEK/mo.

Below this, there's a summary of each Object Storage instance.

<figure><img src="/files/zE5iZdkFXfeQNH8ryXhk" alt=""><figcaption></figcaption></figure>

### Sorting and filtering

When using the **Filter** field, the total count below the field reflects the filter. In the example below, we filter all instances containing the word "My". There are two such instances, totalling 2 GiB with a cost of 1.24 SEK.

<figure><img src="/files/hRT6qpNoXz7WpE3bhnrn" alt=""><figcaption></figcaption></figure>

It's also possible to combine the **Sort by** drop-down menu with the **filter**. To sort the above list of instances containing the word "My" from oldest to newest, select **Sort by Date (oldest first)**.

<figure><img src="/files/HcX0DjaIhV4fUiKzNVn1" alt=""><figcaption></figcaption></figure>

To only use **Sort by**, make sure the **Filter** field is empty. In the example below, we sort the instances by size, with the smallest first.

<figure><img src="/files/VIp9YUuT3HKzF4GqSjs0" alt=""><figcaption></figcaption></figure>

### Change an instance description

Click the three dots next to the instance and select **Edit description**.

<figure><img src="/files/CYd900pveo66Us0opQjI" alt=""><figcaption></figcaption></figure>

Type the new name into the field and click **Update instance**.

<figure><img src="/files/U1I8tGuCIMa7QRULmY9H" alt=""><figcaption></figcaption></figure>

## Manage instances using the API

For an overview of how the API works, see the [general API documentation](/platform/control-panel/api.md).

* To view all instances in the project, including their used storage, their initial bucket, access keys, etc, use the [objectstorage/listinstances](https://github.com/GleSYS/API-docs/wiki/API-Documentation#objectstoragelistinstances) endpoint.
* To get detailed information about a specific instance, use the [objectstorage/instancedetails ](https://github.com/GleSYS/API-docs/wiki/API-Documentation#objectstorageinstancedetails)endpoint.
* To view the current monthly cost per instance, use the [objectstorage/costs](https://github.com/GleSYS/API-docs/wiki/API-Documentation#objectstoragecosts) endpoint.
* To change an instance's description, use the [objectstorage/editinstance](https://github.com/GleSYS/API-docs/wiki/API-Documentation#objectstorageeditinstance) endpoint.

### Example responses

Remember that it's possible to change to JSON responses using the header `Content-Type: application/json` if you prefer that.

#### List all instances

Calling <https://api.glesys.com/objectstorage/listinstances> will provide the following response:

{% code title="API response" %}

```xml
<?xml version="1.0" encoding="utf-8"?>
<response>
    <status>
        <code>200</code>
        <timestamp>2026-07-11T19:52:25+02:00</timestamp>
        <text>OK</text>
    </status>
    <instances>
        <item>
            <id>os-423aa</id>
            <description>My-2nd-test</description>
            <datacenter>dc-fbg1</datacenter>
            <created>2025-08-11T09:46:30+00:00</created>
            <initialbucket>broken-fog</initialbucket>
            <credentials>
                <item>
                    <id>5f1cedd3-0dea-4c07-XXXX-ed01c63ebf9b</id>
                    <accesskey>SDNKMNYJ2R5MCXXXXXX</accesskey>
                    <description/>
                    <created>2025-08-11T09:46:30+00:00</created>
                </item>
            </credentials>
            <usage>
                <size>1</size>
                <unit>GiB</unit>
            </usage>
        </item>
        <item>
            <id>os-324a2</id>
            <description>The first test</description>
            <datacenter>dc-fbg1</datacenter>
            <created>2025-08-13T07:16:06+00:00</created>
            <initialbucket>small-art</initialbucket>
            <credentials>
                <item>
                    <id>3bd150b1-37c5-4bd2-XXXX-5f15fb538cd3</id>
                    <accesskey>YXWZD6YB8DR9OXXXXXXX</accesskey>
                    <description/>
                    <created>2025-08-13T07:16:06+00:00</created>
                </item>
                <item>
                    <id>4efe2d5f-6b9e-4e82-XXXX-951e830591a3</id>
                    <accesskey>TPBCFHJV4E6OCXXXXXXXX</accesskey>
                    <description>Test</description>
                    <created>2025-08-14T14:07:22+00:00</created>
                </item>
            </credentials>
            <usage>
                <size>0</size>
                <unit>GiB</unit>
            </usage>
        </item>
        <item>
            <id>os-a28ed</id>
            <description>My-3rd-test</description>
            <datacenter>dc-fbg1</datacenter>
            <created>2025-08-13T16:01:06+00:00</created>
            <initialbucket>broken-fire</initialbucket>
            <credentials>
                <item>
                    <id>60d067ad-b3c4-4499-XXXX-4d585f4f6c4c</id>
                    <accesskey>MOGFTY1OOSEHMMXXXXXXX</accesskey>
                    <description/>
                    <created>2025-08-13T16:01:06+00:00</created>
                </item>
            </credentials>
            <usage>
                <size>1</size>
                <unit>GiB</unit>
            </usage>
        </item>
        <item>
            <id>os-775b4</id>
            <description>Backup test</description>
            <datacenter>dc-fbg1</datacenter>
            <created>2026-07-11T12:08:08+00:00</created>
            <initialbucket>royal-cloud</initialbucket>
            <credentials>
                <item>
                    <id>9323c13d-18e5-45fc-XXXX-5338e5febf45</id>
                    <accesskey>BXJOVTCHTTHB9XXXXXX</accesskey>
                    <description/>
                    <created>2026-07-11T12:08:08+00:00</created>
                </item>
            </credentials>
            <usage>
                <size>10</size>
                <unit>GiB</unit>
            </usage>
        </item>
    </instances>
    <debug>
        <input>
            <projectkey>cl43212</projectkey>
            <organizationnumber>31704</organizationnumber>
        </input>
    </debug>
</response>
```

{% endcode %}

#### Viewing the costs

Calling <https://api.glesys.com/objectstorage/costs> will provide the following response:

{% code title="API response" %}

```xml
<?xml version="1.0" encoding="utf-8"?>
<response>
    <status>
        <code>200</code>
        <timestamp>2026-07-11T19:54:12+02:00</timestamp>
        <text>OK</text>
    </status>
    <costs>
        <item>
            <key>os-324a2</key>
            <currency>SEK</currency>
            <price>0</price>
            <discount>0</discount>
            <total>0</total>
        </item>
        <item>
            <key>os-423aa</key>
            <currency>SEK</currency>
            <price>0.62</price>
            <discount>0</discount>
            <total>0.62</total>
        </item>
        <item>
            <key>os-775b4</key>
            <currency>SEK</currency>
            <price>6.2</price>
            <discount>0</discount>
            <total>6.2</total>
        </item>
        <item>
            <key>os-a28ed</key>
            <currency>SEK</currency>
            <price>0.62</price>
            <discount>0</discount>
            <total>0.62</total>
        </item>
    </costs>
    <debug>
        <input>
            <projectkey>cl43212</projectkey>
            <organizationnumber>31704</organizationnumber>
        </input>
    </debug>
</response>
```

{% endcode %}

It's also possible to add detailed lines to the response by adding the parameter `includelines=yes`. For example, <https://api.glesys.com/objectstorage/costs?includelines=yes>. The detailed lines will look like this (inside the `<lines>` tag):

{% code title="Sample lines from a detailed API reponse" %}

```xml
<!-- more data above -->
        <item>
            <key>os-775b4</key>
            <currency>SEK</currency>
            <price>6.2</price>
            <discount>0</discount>
            <total>6.2</total>
            <lines>
                <item>
                    <text>Objektlagringsinstans</text>
                    <quantity>1</quantity>
                    <unit>st</unit>
                    <priceperunit>0</priceperunit>
                    <discountinpercentage>0</discountinpercentage>
                    <price>0</price>
                    <discount>0</discount>
                    <total>0</total>
                </item>
                <item>
                    <text>Objektlagringsutrymme</text>
                    <quantity>10</quantity>
                    <unit>GB</unit>
                    <priceperunit>0.62</priceperunit>
                    <discountinpercentage>0</discountinpercentage>
                    <price>6.2</price>
                    <discount>0</discount>
                    <total>6.2</total>
                </item>
            </lines>
        </item>
<!-- more data below -->
```

{% endcode %}