Vultr Object Storage

Last Updated: Wed, Mar 24, 2021
FAQ Vultr Object Storage

Object Storage is Vultr's S3-compatible, web-accessible cloud object storage service for storing and retrieving file objects. Objects can be accessed privately or publicly, over the web. Use cases for cloud object storage include:

  • Static website hosting for assets such as images, JavaScript, CSS, or media files
  • Share software or business files.
  • Backup solutions

Object storage is ideal when you need to handle large quantities of file objects without managing or growing the underlying filesystem.

Getting Started

Select the Objects menu at the top of the Vultr customer portal to navigate to the object storage subscription listing, then use the Add Object Storage form to deploy. After deployment, view your access keys on the subscription listing page.

About Buckets

Objects are stored in buckets. Before you can begin uploading objects, you need to create at least one bucket. Buckets are similar to folders on a file system.

Buckets are web-accessible by name. For example, a bucket named example in the New Jersey location is available at:

https://example.ewr1.vultrobjects.com/

This bucket is also available using the alternate URL form:

https://ewr1.vultrobjects.com/example
  • Bucket names must be unique per location. For example, bucket names in the New Jersey location must be unique across all Vultr customers.
  • Bucket names must begin and end with a lowercase letter.
  • Bucket names may contain a dash (-).
  • Bucket names max length is 255 characters.
  • Bucket names longer than 63 characters cannot be accessed when using a virtual bucket host name, for example: "mylongbucketname.ewr1.vultrobjects.com". For longer bucket names, the top-level directory method must be used, such as "ewr1.vultrobjects.com/mylongbucketname".

If you delete a bucket or close a subscription, you'll need to wait up to 48 hours before you can reuse the old bucket name.

Objects transferred to object storage are private by default. You need a secret key to access them. Some tools allow you to change permissions to make objects, files, and buckets public. Be sure to check your tool's documentation and understand how it interacts with object storage.

Object Storage Billing

Please see our pricing page for up-to-date information. Data transfer between Vultr Object Storage and Vultr VPS instances traverse the public internet and incur standard bandwidth charges.

What is object storage vs. file storage?

Vultr Object Storage provides an S3-compatible REST API. Do not use object storage as a block device or mounted filesystem. The overhead of HTTPS calls severely hinders performance, and we do not support this use. Please use Block Storage for mounted filesystems.

What is the difference between object storage vs. block storage?

Block storage provides mountable disk volumes for Vultr VPS instances. Object storage offers an internet-accessible endpoint to store and retrieve files via HTTPS.

Object Storage as a Filesystem

Do not use object storage as a block device or mounted filesystem. The overhead of HTTP calls severely hinders performance, and we do not support this use. Please use Block Storage for mounted filesystems.

Is Vultr Object Storage S3-compatible?

Vultr's object storage is S3-compatible and works with most tools designed for S3.

Is there a Request Limit?

Yes, the rate limit, also known as a request limit, is 400 requests-per-second per IP address. If you exceed this limit, your requests will receive HTTP error code 429. If your application requires higher request volumes, we recommend deploying a caching proxy in front of your object storage for performance and security.

Does Object Storage have a Cache?

Yes, object storage is backed by NVMe caching for frequently accessed objects. The cache is not user-controllable.

Can I use a Custom Domain?

No, we do not support using a white-labeled domain name for object storage. You must use the name shown for your object storage in the customer portal.

Object Storage and the Cloudflare Bandwidth Alliance

The Cloudflare Bandwidth Alliance program does not include object storage traffic.

API Access

The Vultr API offers several endpoints to manage Object Storage.

s3cmd CLI tool

S3cmd is a command line S3 client for Linux and Mac. See our article How to Use s3cmd with Vultr Object Storage.

Cyberduck GUI tool

Cyberduck is a graphical file manager for Windows and Mac. It supports S3, FTP, and many popular file-sharing services. See our article How to Use Cyberduck with Vultr Object Storage.

S3-compatibility

The table below lists compatibility between Vultr object storage and the S3 protocol. Compatibility may be further limited depending on the S3 tool used to access Vultr object storage.

For download requests, the "Content-Length" header may not match the size of the file, because files are gzip compressed to improve performance. In the rare event that this is causing issues for your automation system, you can disable gzip on requests.

Bucket ACLs (Get, Put) Yes
Bucket Access Logging No
Bucket Inventory No
Bucket Lifecycle No
Bucket Location Yes
Bucket Notification No
Bucket Object Versions Yes
Bucket Replication No
Bucket Request Payment Yes
Bucket Website No
CORS Yes
Copy Object Yes
Create Bucket Yes
Delete Bucket Yes
Delete Object Yes
Get Bucket Info (HEAD) Yes
Get Object Yes
Get Object Info (HEAD) Yes
List Buckets Yes
Multipart Uploads Yes
Object ACLs (Get, Put) Yes
Object Metadata Yes
Object Tagging Yes
POST Object Yes
Policy (Buckets, Objects) Yes
Pre-Signed URLs Yes
Put Object Yes

Language Support

Python

The Boto3 SDK is compatible with Vultr Object Storage. See the documentation for Python code examples.

Go Examples

Creating Vultr Object Storage With the Vultr Go Client.

PHP Examples

How to Use Vultr Object Storage with PHP

Want to contribute?

You could earn up to $600 by adding new articles