Skip to navigation
API Referenceobject-storage

Create a new storage unit

Creates a new object storage unit for the authenticated account and returns it. The returned storageUnitId identifies the unit in all other object storage requests. To preview pricing without creating anything, use POST /object-storage/units/cost-estimate.

Authentication

X-API-Client-IDstring
API Client ID
X-API-Client-Secretstring
API Client Secret

Request

This endpoint expects an object.
namestringRequired

Storage unit name. Letters, numbers, hyphens, and underscores, up to 100 characters; must start and end with a letter or number. It cannot be changed later.

Response

The created storage unit
storageUnitIdstring
Unique identifier for the storage unit.
createdAtdatetime
When the storage unit was created.
maxBucketsdouble or nullOptional

Maximum number of buckets the storage unit may hold. Null means no limit (unlimited).

sizeKbdoubleOptional
Current usage of the storage unit, in kilobytes.
limitKbdouble or nullOptional

Total storage allowed on the storage unit, in kilobytes. Null means no limit (unlimited).

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
500
Internal Server Error