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 and click Storage. Under Object Storage, click Buckets.

    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. Avoid entering confidential information.

    • Default Storage Tier: Select the default tier in which you want to store your data. Once set, you cannot change the default storage tier of a bucket. When you upload objects, this tier will be selected by default. You can, however, select a different tier. Available default tiers include:

      • Standard is the primary, default storage tier used for Object Storage service data. Use the Standard tier for storing frequently accessed data that requires fast and immediate access.
      • Archive is the default storage tier used for Archive Storage service data. Use the Archive tier for storing rarely accessed data that requires long retention periods. Access to data in the Archive tier is not immediate. Archived data must be restored before the data is accessible.
    • 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 Vault encryption key. To use Vault 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 Vault. For details on how to create a vault, see Managing Vaults.
    • Tags: If you have permissions to create a resource, then 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 whether to 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 uploading individual files up to 10 TiB. Because memory capacity and browser capability can impact uploading objects using the Console, use the CLI, SDK, or API for larger files. See Developer Tools and Resources.

To upload files to your bucket using the Console:

  1. From the Object Storage Buckets screen, click the bucket name to view its details.
  2. Click Upload.
  3. In the Object Name Prefix field, optionally specify a file name prefix for the files that you plan to upload.
  4. If the Storage Tier field displays Standard, you can optionally change the storage tier to upload objects to.
  5. 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.

  6. Click Upload.

    The selected objects are uploaded. Click Close to return to the bucket.