# UpCloud Storage API

**Canonical:** https://apis.io/apis/upcloud/upcloud-storage-api/  
**Provider:** UpCloud — https://apis.io/providers/upcloud/  
**Base URL:** https://api.upcloud.com  
**Documentation:** https://developers.upcloud.com/api/1.3

UpCloud Storage API is one of 29 APIs that [UpCloud](https://apis.io/providers/upcloud/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Storage. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Block Storage is similar to a physical hard disk. It can be used to install an operating system or hold another filesystem for a Cloud Server. Writable Block Storage and CD-ROM resources can be freely attached to any Cloud Server within the same zone and under the same account. A maximum of 16 storage devices can be attached to a Cloud Server at the same time; however, the combined limit for network interfaces and storage devices is 24. <h3>Storage resource types</h3> There are four different storage resource types: normal, CD-ROM, template, and backup. The normal type represents writable Block Storage.

## Operations (26)

| Method | Path | Summary |
|---|---|---|
| GET | `/1.3/storage` | List storage resources |
| POST | `/1.3/storage` | Create Block Storage |
| GET | `/1.3/storage/backup` | List storage backups |
| GET | `/1.3/storage/cdrom` | List CD-ROM images |
| GET | `/1.3/storage/favorite` | List favorite storage resources |
| GET | `/1.3/storage/normal` | List normal Block Storage |
| GET | `/1.3/storage/private` | List private storage resources |
| GET | `/1.3/storage/public` | List public storage resources |
| GET | `/1.3/storage/template` | List storage templates |
| GET | `/1.3/storage/{type}/{access}` | List storage resources by type and access |
| GET | `/1.3/storage/{uuid}` | Get storage resource details |
| PUT | `/1.3/storage/{uuid}` | Modify Block Storage |
| DELETE | `/1.3/storage/{uuid}` | Delete storage resource |
| POST | `/1.3/storage/{uuid}/attach` | Attach storage to a Cloud Server |
| POST | `/1.3/storage/{uuid}/backup` | Create on-demand backup |
| POST | `/1.3/storage/{uuid}/cancel` | Cancel Block Storage operation |
| POST | `/1.3/storage/{uuid}/clone` | Clone Block Storage |
| POST | `/1.3/storage/{uuid}/detach` | Detach storage from a Cloud Server |
| POST | `/1.3/storage/{uuid}/favorite` | Add storage resource to favorites |
| DELETE | `/1.3/storage/{uuid}/favorite` | Remove storage resource from favorites |
| GET | `/1.3/storage/{uuid}/import` | Get storage import details |
| POST | `/1.3/storage/{uuid}/import` | Create storage import |
| POST | `/1.3/storage/{uuid}/import/cancel` | Cancel storage import |
| POST | `/1.3/storage/{uuid}/resize` | Resize Block Storage partition and filesystem |
| POST | `/1.3/storage/{uuid}/restore` | Restore Block Storage from backup |
| POST | `/1.3/storage/{uuid}/templatize` | Create template from Block Storage |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/upcloud/openapi/upcloud-storage-api-openapi.yml
- **Documentation** — https://developers.upcloud.com/api/1.3

## Other UpCloud APIs (12)

- [UpCloud Account API](https://apis.io/apis/upcloud/upcloud-account-api/)
- [UpCloud Account Tokens API](https://apis.io/apis/upcloud/upcloud-account-tokens-api/)
- [UpCloud Audit Logs API](https://apis.io/apis/upcloud/upcloud-audit-logs-api/)
- [UpCloud Currency API](https://apis.io/apis/upcloud/upcloud-currency-api/)
- [UpCloud Database API](https://apis.io/apis/upcloud/upcloud-database-api/)
- [UpCloud Device API](https://apis.io/apis/upcloud/upcloud-device-api/)
- [UpCloud Events API](https://apis.io/apis/upcloud/upcloud-events-api/)
- [UpCloud File Storage API](https://apis.io/apis/upcloud/upcloud-file-storage-api/)
- [UpCloud Firewall Ruleset API](https://apis.io/apis/upcloud/upcloud-firewall-ruleset-api/)
- [UpCloud Gateway API](https://apis.io/apis/upcloud/upcloud-gateway-api/)
- [UpCloud Ip Address API](https://apis.io/apis/upcloud/upcloud-ip-address-api/)
- [UpCloud Kubernetes API](https://apis.io/apis/upcloud/upcloud-kubernetes-api/)

## Tags

Storage

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/upcloud/upcloud-storage-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/upcloud/.