Object Storage Quickstart


Prerequisites

You’ll need to already have created a SpinUp account. If you haven’t created one yet, you can register for an account via our sign-up page.

Create your first bucket

Buckets are the first level of organization for your content in SpinUp Object Storage. Each bucket can be assigned its own CDN TTL (Time to Live) and other special properties for use with your applications and other external services. Use the following steps to create a bucket, create virtual folders inside that bucket, and upload your content.

Create the bucket

  • Navigate to the Object Storage section of your SpinUp Control Panel.
  • Confirm you have the desired region selected in the top dropdown menu.
  • Click the +CREATE button and fill out a name for your container when prompted. We recommend that you stick to basic alphanumeric characters and no spaces if you’re going to use this bucket with code or any automation.

Upload your first file

  • On the Object Storage screen, click on the bucket that you wish to upload to. The currently selected bucket is highlighted and has the opened box icon by the name.
  • Click the Upload File icon (the up arrow) and either browse files or drag and drop files to the pop-up box area.
  • Once completed, the file will appear in the bucket.

Create a virtual folder

In addition to uploading directly to the bucket, you can also create virtual folders inside of it. These do not create a true nested file system since Object Storage uses a flat file structure for performance and scalability purposes, but it can help to keep things organized, both in your Control Panel and when writing code that interacts with a lot of objects. To create a virtual folder, do the following steps:

  • In the desired bucket, click on the Add Folder icon.
  • Provide a name for the virtual folder. For ease of use, again consider sticking to basic characters and no spaces.
  • You can now click on the Upload File icon next to the virtual folder to have objects uploaded into it as needed.

As the number of objects inside a bucket grows, you can navigate more easily through content by either using the virtual folders to browse as you would on your home PC, or you can use the search bar to look for any part of the object name. Again, since the virtual folders are really just prefixes that are part of the object’s names, you can search for objects using all or part of a virtual folder name. Perform the following steps to add then remove a search from the currently selected bucket:

  • In the search bar below the bucket name, enter in your desired search text.
  • Click on the spyglass or hit enter to view the search results.
  • When you’re finished, click the RESET button to go back to full view of the bucket content.

Next Steps

Now that you’re familiar with adding files and virtual folders to Object Storage, check out the Best Practices articles for additional information on how to use Object Storage effectively and with optimal performance.

If you need more information on some common ways to integrate Object Storage with your code, check out our How-To Articles.


Related Content