Storage classes

A storage class is the performance tier of a volume, chosen when you create or import it. gp1 (general purpose, SSD-backed) is the only class you can select, and it’s the class a volume gets when you don’t name one.

Published classes

The platform publishes three classes. Only those with available: true in the catalog can be selected.

Class	Display name	Media	Available
`gp1`	General Purpose	`SSD`	Yes (default)
`st1`	Throughput Optimized	`HDD`	No
`io1`	I/O Intensive	`SSD`	No

Read the catalog rather than relying on this table. The pvs.storageClasses query and the origin storage list-storage-classes command return every published class with its display name, backing media, whether it’s the default, and its available flag. The catalog is platform-wide and needs no permission.

query {
  pvs {
    storageClasses {
      storageClass
      displayName
      media
      isDefault
      available
    }
  }
}

Choosing a class

Pass the class identifier as storageClass on the createVolume or importVolume mutation, or as --storage-class on origin storage create-volume and origin storage import-volume. Omit it to get the default.

The platform answers two kinds of wrong values differently:

A published class that isn’t available
For example, st1 or io1. The request is refused with PRODUCT_UNAVAILABLE, and the message lists the classes you can use. Nothing is created.

A class that doesn’t exist
For example, a typo such as gp2. The request is refused with BAD_REQUEST and the message invalid storage_class. Nothing is created.

Existing volumes

A volume keeps the class it was created with. A volume that was created in a class that isn’t selectable now keeps working and stays on its own media. The available flag only governs new volumes.

Volume storage classes on origincloud.eu describes what each tier is for.

Published classes

Choosing a class

Existing volumes

Related