Uploading an Object to an Object Storage Bucket on a Device

• Console
• CLI
• API

• The Device Console uses multipart uploads to upload objects larger than 64 MiB.

  1. In the Device Console, open the navigation menu and select Storage > Object Storage & Archive Storage. The Buckets page is displayed. All buckets are listed in tabular form.

  2. Click the bucket to which you want to upload objects. The bucket's Details page appears. All objects are listed in tabular form.

  3. Click Upload. The Upload Objects dialog box appears.

     Note
     
     

     Checking objects in the Objects list and then clicking Upload does not automatically upload those files. Select files you want to upload in the Upload Objects dialog box.

  4. Specify an Object Name Prefix value. This prefix value is prepended to each one of the files you upload. You can specify the following prefix strings:

     • Prefix strings without a delimiter for matching purposes to perform allowed bulk operations

  5. Select the group of objects you want to upload using any combination of the following methods:

     • Drag and drop one or more files from your computer.

     • Click the select files link and select the files you want to upload.

     The files you select to upload are displayed in a list. If you decide that you do not want to upload a particular file, click the X to the right of the file name.

     If the files you select to upload are already stored in the bucket or folder with the same name, the Console displays messages warning you of an overwrite.

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

  7. Click Close to return to the bucket's Details page.

• Use the oci os object put command and required parameters to upload an Object Storage object to a bucket on your Roving Edge Infrastructure devices:

  oci os object put --bucket-name bucket_name --file file_name [OPTIONS]

  Example:

  oci os object put --bucket-name my_bucket --file file1.txt --name file_with_new_name.txt
  Uploading object  [####################################]  100%
  {
    "etag": "6e3fc5a09cf1f4912946fee5f8251a99",
    "opc-content-md5": "bj/FoJzx9JEpRv7l+CUamQ=="
  }

  Multipart Uploads

  Use the oci os object put command with the following parameters to perform a multipart upload:

  • part-size part_size

    Specify the part_size in MiB to use when the file is split into multiple parts and then combined. Part size must be greater than 10 MiB and defaults to 128 MiB.

  • --parallel-upload-count number_of_parallel_operations

    Specify the number_of_parallel_operations as an integer range for the number of parallel operations to perform. Decreasing this value makes the process less resource intensive but it might take longer. Increasing this value might decrease the time taken, but the process consumes more system resources and network bandwidth. The maximum is 1000.

  oci os object put --bucket-name bucket_name --file file_location --part-size part_size --parallel-upload-count <maximum_number_parallel_uploads> [OPTIONS]

  Example:

  oci os object put --bucket-name MyBucket --file ~/path/to/file --part-size 500 --parallel-upload-count 10 
  Upload ID: 12345678-1234-1234-5678-c374a8f33998
  Split file into 12 parts for upload.
  Uploading object ################################### 100%
  { "etag": "861c8341-74d8-4142-8da4-28e1ce7783ba", "last-modified": "Wed, 24 Apr 2024 19:59:15 GMT", "opc-multipart-md5": "9Qn1eyou2yMiyOO9Bc7o1A==-12" }

  Refer to your Roving Edge Infrastructure device's CLI help for a list of parameters available for this command. See Accessing Command Line Interface Help.

  For CLI setup information on your Roving Edge Infrastructure device, see Using the Command Line Interface.

• Run the PutObject operation to upload an Object Storage object to a bucket on your Roving Edge Infrastructure devices.