Contents

Orbit Object Storage

Orbit is Brightbox’s durable and highly available data storage system, based on OpenStack Swift.

Every object is replicated to three distinct physical storage servers, which are distributed across two geographically distinct availability zones (data centres).

Objects are usually files you want to store, and have associated metadata that describe the data and can change the way it is handled.

Objects are stored within containers, which are basically like directories.

Containers can have any name that you choose and are stored within your account. Accounts are named after your Brightbox account identifier (e.g: acc-xxxxx).

Orbit urls look like this:

https://orbit.brightbox.com/{api-version}/{account-identifier}/{container-name}/{object-name}

You can store and retrieve data using the OpenStack Swift compatible HTTP API, or using our SFTP service.

Our Image Library uses Orbit to store Cloud Server and Cloud SQL instance snapshots. They’re available from the special images container in each account.

Authentication

You can authenticate with Orbit using your Brightbox username and password, or an API Client identifier and secret. If you’re integrating another system with Orbit it’s recommended to use an API Client, rather than have your system be authenticating as you.

API Clients in Orbit Storage Only privilege mode can only be used with the Orbit API and will be denied access to other resources (such as Cloud Servers, Load Balancers etc). Orbit-only API Clients can access no Orbit containers by default and must be explicitly granted read or write access.

Orbit-only API Clients can only manage objects and cannot list, create or modify containers themselves.

API

Orbit provides an OpenStack Swift API, for which there are many compatible libraries and tools such as:

SSH File Transfer Protocol

We provide an SFTP service for use with Orbit. You can read and write objects using any SFTP-compatible client, such as Cyberduck, WinSCP, or just the standard sftp command line tool.

Just connect to sftp.orbit.brightbox.com using your Brightbox email address and password, or your API client and secret.

$ sftp john@example.com@sftp.orbit.brightbox.com
john@example.com@sftp.orbit.brightbox.com's password: 
Connected to sftp.orbit.brightbox.com.
sftp> ls
container1
container2
images

If you are a collaborator on multiple accounts, then you can specify the account by adding the account identifier to the end of the username, separated with a colon:

$ sftp john@example.com:acc-xxxxx@sftp.orbit.brightbox.com

Guides

Billing

Orbit is charged per gigabyte of storage used per month, and per gigabyte of data transferred out to the Internet. Incoming data and incoming or outgoing data from/to Brightbox Cloud servers is free

Last updated: 28 Apr 2016 at 00:39 UTC

Try Brightbox risk-free with £20 free credit Sign up takes just two minutes...