UpCloud

Managed Object Storage

Managed Object Storage provides S3-compatible object storage for storing and retrieving any amount of data. Access your storage via the S3 API or web console.

GET/1.3/object-storage-2/regions

List regions

Returns a list of available object storage regions.

Request

GET
/1.3/object-storage-2/regions
curl -X GET https://api.upcloud.com/1.3/object-storage-2/regions \
  -u your_username:your_password
GET/1.3/object-storage-2/regions/{name}

Get region details

Returns details of a specific object storage region including available zones.

Request

GET
/1.3/object-storage-2/regions/{name}
curl -X GET https://api.upcloud.com/1.3/object-storage-2/regions/europe-1 \
  -u your_username:your_password
GET/1.3/object-storage-2

List services

Returns a list of all object storage services in the account.

Request

GET
/1.3/object-storage-2
curl -X GET https://api.upcloud.com/1.3/object-storage-2 \
  -u your_username:your_password
GET/1.3/object-storage-2/{uuid}

Get service details

Returns detailed information about a specific object storage service.

Request

GET
/1.3/object-storage-2/{uuid}
curl -X GET https://api.upcloud.com/1.3/object-storage-2/06e1bf60-2a3b-4c5d-9e7f-8a1b2c3d4e5f \
  -u your_username:your_password
POST/1.3/object-storage-2

Create service

Creates a new object storage service.

Attributes

  • Name
    name
    Type
    string
    Description

    Service name. Required.

  • Name
    region
    Type
    string
    Description

    Region identifier. Required.

  • Name
    configured_status
    Type
    string
    Description

    Initial status: "started" or "stopped".

  • Name
    networks
    Type
    array
    Description

    Network configurations for private access.

  • Name
    labels
    Type
    array
    Description

    Labels for classification.

Request

POST
/1.3/object-storage-2
curl -X POST https://api.upcloud.com/1.3/object-storage-2 \
  -u your_username:your_password \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-object-storage",
    "region": "europe-1",
    "configured_status": "started"
  }'
PATCH/1.3/object-storage-2/{uuid}

Modify service

Modifies an existing object storage service.

Request

PATCH
/1.3/object-storage-2/{uuid}
curl -X PATCH https://api.upcloud.com/1.3/object-storage-2/06e1bf60-2a3b-4c5d-9e7f-8a1b2c3d4e5f \
  -u your_username:your_password \
  -H "Content-Type: application/json" \
  -d '{
    "configured_status": "stopped"
  }'
DELETE/1.3/object-storage-2/{uuid}

Delete service

Deletes an object storage service. All buckets must be empty before deletion.

Request

DELETE
/1.3/object-storage-2/{uuid}
curl -X DELETE https://api.upcloud.com/1.3/object-storage-2/06e1bf60-2a3b-4c5d-9e7f-8a1b2c3d4e5f \
  -u your_username:your_password
POST/1.3/object-storage-2/{uuid}/buckets

Create bucket

Creates a new bucket in the object storage service.

Attributes

  • Name
    name
    Type
    string
    Description

    Bucket name (DNS-compatible, lowercase). Required.

Request

POST
/1.3/object-storage-2/{uuid}/buckets
curl -X POST https://api.upcloud.com/1.3/object-storage-2/06e1bf60-2a3b-4c5d-9e7f-8a1b2c3d4e5f/buckets \
  -u your_username:your_password \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-new-bucket"
  }'
DELETE/1.3/object-storage-2/{uuid}/buckets/{name}

Delete bucket

Deletes a bucket. The bucket must be empty.

Request

DELETE
/1.3/object-storage-2/{uuid}/buckets/{name}
curl -X DELETE https://api.upcloud.com/1.3/object-storage-2/06e1bf60-2a3b-4c5d-9e7f-8a1b2c3d4e5f/buckets/my-new-bucket \
  -u your_username:your_password