---
title: "Storage Backend Information"
method: GET
path: "/service/storage-backends"
tags: ["Service"]
---

# Storage Backend Information

`GET /service/storage-backends`

Provide information about the storage backends available on this service instance.
These are populated on deployment of the service instance.

Storage Backends are sorted in alphabetical order of their `label` by default.
For resources where `label` is unset, `id` shall be used.
Resources using this fallback shall be sorted after those that aren't by default, and before when `reverse_order` is `true`.

## Query parameters

- `tag.{name}` string — A list of tag values, formatted for use in query string parameters
- `tag_exists.{name}` boolean
- `reverse_order` boolean
- `page` string
- `limit` integer

## Response `200`

- object[] — Information about the storage backends available on this service instance.
  - `store_type` 'http_object_store', required — The generic Storage Backend type. Used to identify the required workflow for reading and writing media. Any `store_product` should be compatible, as much is required for basic interoperability between TAMS implementations, with their associated generic `store_type`.
  - `provider` string, required — The cloud (or other) provider of the Storage Backend
  - `region` string — The region in the cloud this Storage Backend resides
  - `availability_zone` string — The availability zone in the cloud region this Storage Backend resides. Note that many cloud providers randomize availability zone identifiers such that they are consistent within a cloud account, but not necessarily between accounts. Caution should be exercised when using this parameter.
  - `store_product` string, required — The storage product name.
  - `tags` Tags — Key is a freeform string. Value is a freeform string, or an array of freeform strings.
  - `id` string, required — A Universally Unique Identifier (UUID) as defined in [RFC9562](https://www.rfc-editor.org/rfc/rfc9562)
  - `label` string — Freeform string label for a storage backend.
  - `default_storage` boolean — If set to `true`, this is the default storage backend. The default storage backend will be used if the client does not specify a storage backend id when requesting the allocation of storage. If this parameter is not set, assume `false`. Service instances may either set one storage backend as default, or none - indicating that clients must always specify a storage backend.

## Changes

- **2026-08-25** `eb3977b33601` — 3 info
  - added the new optional `query` request parameter `tag.{name}`
  - added the new optional `query` request parameter `tag_exists.{name}`
  - added the optional property `items/allOf[subschema #1: Storage Backend]/tags` to the response with the `200` status
- **2026-08-10** `73a77c2ab589` — 3 info
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `reverse_order`
- **2025-07-02** `fff531b4534a` — 1 info
  - endpoint added
- **2025-04-24** `b01aaf8cffe2` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/aws-samples/apis/time-addressable-media-store/changes/service/storage-backends/get.md)

---

[API](https://skmtc.dev/aws-samples/apis/time-addressable-media-store.md) · [All operations](https://skmtc.dev/aws-samples/apis/time-addressable-media-store/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aws-samples/time-addressable-media-store/revisions/eb3977b33601/schema)