Oracle Cloud Infrastructure Documentation

Putting Data into Object Storage

The Object Storage service provides reliable, secure, and scalable object storage. Object storage is a storage architecture that stores and manages data as objects. Some typical use cases include data backup, file sharing, and storing unstructured data like logs and sensor-generated data.

Object Storage uses buckets to organize your files. To use Object Storage, first create a bucket and then begin adding data files.

Use this procedure to quickly get started. For more details about the features of the service, see Overview of Object Storage.

Creating a Bucket

To create a bucket to store objects:

  1. Open the navigation menu. Under Core Infrastructure, click Object Storage.

    A list of the buckets in the compartment you're viewing is displayed. If you don’t see the one you're looking for, verify that you’re viewing the correct compartment (select from the list on the left side of the page).

  2. Choose the compartment for your new bucket.

    A list of existing buckets is displayed.

  3. Click Create Bucket.
  4. In the Create Bucket dialog, enter the following:
    • Name: Required. A user-friendly name or description. The name cannot be changed from the Console. The name can contain letters, numbers, dashes, underscores, and periods, but should not contain confidential information.
    • Storage Tier: Select the tier in which you want to store your data. Available tiers include:

      • Standard is the primary, default Object Storage tier for storing frequently accessed data that requires fast and immediate access.
      • Archive is a special tier for storing infrequently accessed data that requires long retention periods. Access to data in the Archive tier is not immediate. You must restore archived data before it’s accessible. For more information, see Overview of Archive Storage. 
    • Encryption: Optionally, you can encrypt the data in this bucket using your own Key Management encryption key. To use Key Management for your encryption needs, select the Encrypt using Key Management check box. Then, select the Vault Compartment and Vault that contain the master encryption key you want to use. Also select the Master Encryption Key Compartment and Master Encryption Key. For more information about encryption, see Overview of Key Management.
    • Tags:Optionally, you can apply tags. If you have permissions to create a resource, you also have permissions to apply free-form tags to that resource. To apply a defined tag, you must have permissions to use the tag namespace. For more information about tagging, see Resource Tags. If you are not sure if you should apply tags, skip this option (you can apply tags later) or ask your administrator.
  5. Click Create Bucket.

The bucket is created immediately and you can add objects to it. Objects added to archive buckets are immediately archived and must be restored before they are available for download.

Uploading Files to a Bucket

Object Storage supports individual files up to 50 GiB. You can use the Console to upload files 2 GiB or smaller. For larger files, use the SDK or API. See Developer Tools.

To upload files to your bucket using the Console:

  1. From the Object Storage Details screen, click the bucket name to view its details.
  2. Click Upload Objects.
  3. Select the object or objects to upload in one of two ways:
    • Drag files from your computer into the Drop files here ... section.
    • Click the select files link to display a file selection dialog box.

    As you select files to upload, they are displayed in a scrolling list. If you decide that you do not want to upload a file that you have selected, click the X icon to the right of the file name.

    If selected files to upload and files already stored in the bucket have the same name, messages warning you of an overwrite are displayed.

  4. In the Object name prefix field, optionally specify a file name prefix for the file that you have selected to upload.
  5. Click Upload Objects.

    The selected objects are uploaded and displayed in the list of objects in the bucket.

What's Next

For information on managing and accessing your object files, see Overview of Object Storage.