Step 1: Create an Object Storage Bucket and Construct the Storage URL

You must create an object storage bucket (if one does not exist) and construct the storage URL in the Oracle Cloud Infrastructure Console in order to export and import design-time metadata into an Oracle Integration instance. You specify this URL during object storage bucket configuration on the Instance storage page.

  1. Log in to the Oracle Cloud Infrastructure Console with the user account that your administrator added to the group for exporting design-time metadata. You must have the admin role to create an object storage bucket. See Manage Access and Assign Roles in Provisioning and Administering Oracle Integration 3.

  2. In the navigation pane, select Storage.

  3. Click Buckets.

  4. Select the compartment in which to create the storage bucket.

  5. Click Create Bucket.


    The Buckets page shows a Create Bucket link. Below this is a table with columns for Name, Default Storage Tier, Visibility, and Created.

  6. Enter the following information, then click Create.

    Element Description
    Bucket Name Enter a name.
    Storage Tier Select Standard.
    Enable Auto-Tiering Automatically move infrequently accessed objects from the Standard tier to less expensive storage. See Managing Buckets.
    Enable Object Versioning Create an object version when a new object is uploaded, an existing object is overwritten, or an object is deleted. See Using Object Versioning.
    Emit Object Events Create automation based on object state changes using the Events Service. See Overview of Events.
    Uncommitted Multipart Uploads Cleanup Create a life cycle rule to automatically delete uncommitted multipart uploads older than seven days. See Using Object Lifecycle Management.
    Encryption
    • Encrypt using Oracle managed keys Leaves all encryption-related matters to Oracle.
    • Encrypt using customer-managed keys Requires a valid key from a vault that you can access. See Overview.
    Resource logging Click to enable resource logging to allow resource tracking, troubleshooting, and data insights. By default, resource logging is disabled.
    Tags Add tags to organize your resources.

    The new bucket is displayed in the list.

  7. To view bucket details, click the name.

  8. Click Edit Visibility.

  9. Click Public and deselect the Allow users to list objects from this bucket check box. This action ensures that the storage bucket you create is publicly visible. Otherwise, the export utility cannot see the storage.


    The Edit Visibility page shows radio buttons for Private and Public. An Allow users to list objects from this bucket check box is also displayed.

  10. In the navigation pane, select Identity & Security, then Users.

  11. Select the appropriate user.

  12. Under Resources, select Auth Tokens.

  13. Click Generate Token.

  14. Provide a token description and click Generate Token.

  15. Copy and save the generated token.

    The storage payload format is as follows with object storage bucket details:
    {"storageInfo":
           {
                 "storageUrl":"https://swiftobjectstorage.region.oraclecloud.com/v1/
    namespace/bucket",
                 "storageUser":"my.email@oracle.com",
                 "storagePassword":"generated_token"
                }
    }
    For example:
    {
          "storageInfo":
                {
                      "storageUrl":"https://swiftobjectstorage.us-ashburn-1.oraclecloud.
    com/v1/paasdevoic/cloneRepo",
                      "storageUser":"my.email@oracle.com",
                      "storagePassword":"generated_token"
                }
    }
  16. Construct the storage URL using the following example. You must specify the URL later when configuring the object storage bucket. See Step 2: Configure the Instance Object Storage Bucket.
    Step Description Example
    1 Enter the Swift API as the base for the URL because you are dealing with object storage. https://swiftobjectstorage
    2 Enter a required data center. To find a data center, go to the drop-down menu in the banner (for example: us-ashburn-1). https://swiftobjectstorage.us-ashburn-1
    3 Enter the domain name. This is typically oraclecloud.com. https://swiftobjectstorage.us-ashburn-1.oraclecloud.com
    4 Enter the version: v1. https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1
    5 Enter the automatically generated object storage namespace.
    1. In the upper right, click the Profile menu.


      The Profile icon

    2. Click Tenancy: your_tenancy_name.

      The namespace string is listed under Object Storage Settings. See Understanding Object Storage Namespaces.

    paasdevoic
    6 Enter the bucket name you created in Step 6 as the last part of the URL. https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/paasdevoic/BUCKET_NAME
    Examples of the full storage URL to use later on the Instance storage page in Step 2: Configure the Instance Object Storage Bucket are as follows:
    https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/paasdevoic/cloneRepo
    https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/paasdevoic/migrationartifacts_bucket-20190717-1223