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.

  2. Select a compartment from the Compartment list on the left side of the page.

    A list of existing buckets is displayed.

  3. Click Create Bucket.
  4. In the Create Bucket dialog box, specify the attributes of the bucket:

    • Bucket Name: The system generates a default bucket name that reflects the current year, month, day, and time, for example bucket-20190306-1359. If you change this default to any other bucket name, use letters, numbers, dashes, underscores, and periods. Do not include any 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.
    • Object Events: Select Emit Object Events if you want to enable the bucket to emit events for object state changes. For more information about events, see Overview of Events.
    • Encryption: Buckets are encrypted with keys managed by Oracle by default, but you can optionally encrypt the data in this bucket using your own Key Management encryption key. To use Key Management for your encryption needs, select Encrypt Using Customer-Managed Keys. 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. For details on how to create a vault, see Managing Vaults.
    • 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. Click Close to return to the bucket.

What's Next

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