Source—OCI Storage Cloud Service

Use the Source tab to configure a new source or edit an existing source. The tab content depends on the source type. Settings for sources of type OCI Storage Cloud Service are listed here.

Note:

Before you can use the OCI Storage Cloud Service source type, you must import a private RSA key of PEM format to connect to Oracle Cloud Infrastructure. See Importing a Key in Using Oracle Managed File Transfer.

The OCI Storage Cloud Service Source tab is arranged in the following sections:

General Information and Actions

Element Description

Save

Saves the source without deploying it. Remember to save before closing this tab.

Revert

Reverts all changes since the last save.

Deploy/Deployed

Deploys and activates the source. You must save the source before you can deploy it. You must re-save before you can redeploy. The configuration must be valid or deployment fails.

The Deploy Source dialog appears, prompting you for an optional comment. Impacted transfers are listed. Click the Deploy or Cancel button in the dialog.

The Deploy action in the tab is grayed with a green check to show successful deployment.

To view information about deployed artifacts, click the Show Deployment Details button on the Artifacts Search tab, or view the Deployments tab on the Monitoring page.

General Information

Displays read-only source information, including name, last user to update, last update date and time, and last deployment date and time.

Description

Allows you to add or edit the artifact description. This description is for all deployments of the artifact and is visible in the Artifacts Search tab.

The Deploy dialog also allows you to enter a description, which is specific to a particular deployment label and is visible in the Deployments tab on the Monitoring page.

Location

Displays information about the location of files to be transferred.

Element Description

Content Folder

Specifies the directory from which files are transferred.

Include Content in subfolder

Specifies that files in subfolders are also transferred if checked.

Source Properties

Displays initial settings in the Create Source dialog for the OCI Storage Cloud Service source type.

Element Description

Endpoint URL

Specifies the REST endpoint URL of the Oracle Cloud Infrastructure Object Storage.

Region

Specifies the identifier of the Oracle Cloud Infrastructure region.

Namespace

Specifies the Object Storage namespace of the bucket. This is a logical entity that serves as a top-level container for all buckets and objects, allowing for control of bucket naming within your tenancy. The namespace is a unique and uneditable system-generated string assigned during account creation and applies to all regions.

Bucket Name

Specifies the name of the bucket. A bucket is a logical container for storing objects. Users or systems create buckets as needed within a region. A bucket is associated with a single compartment that has policies that determine what actions a user can perform on a bucket and on all the objects in the bucket.

Fingerprint

Specifies the fingerprint of the public API key value that you uploaded in the Oracle Cloud Infrastructure Console.

Tenant ID

Specifies the OCID of the tenancy you are using.

OCID

Specifies the OCID of the Oracle Cloud Infrastructure user account you will be using to connect to Oracle Cloud Infrastructure.

Compartment ID

Specifies the Oracle Cloud Identifier (OCID) of the compartment.

Every Oracle Cloud Infrastructure resource has an Oracle-assigned unique ID called an Oracle Cloud Identifier (OCID). This is the primary building block used to organize your cloud resources. When your tenancy is provisioned, a root compartment is created for you. You can then create compartments under your root compartment to organize your resources. An Object Storage bucket can only exist in one compartment.

Private Key

Specifies the private key, which is generated using an RSA key pair of PEM format.

Passphrase

Specifies the passphrase used to encrypt the private key.

Confirm Passphrase

Confirms the passphrase used to encrypt the private key.

Test Connection

Tests the connection to OCI Storage Cloud Service with the provided parameters.

Note: Test Connection returns a successful connection even if invalid values are specified for Endpoint URL or Compartment ID.

Source Schedule

Displays information about when the source is checked for files to be selected. Source schedule settings affect all transfers that use the source. Applies only to simple schedule.

Element Description

Event

Specifies the Event check box, if enabled, allows you to execute transfers through a Web/REST service.

Security

Security enabled implies that protection is valid for Administrators and any other users selected.

Add Users, Groups, and Roles

Adds users, groups, and roles to the list of who can access SOAP/REST service only. For more information, see Add Users, Groups, and Roles.

Add schedule

Allows you to schedule transfers that use this source. For more information, see Scheduler. Applies only to simple schedule.

Actions

Displays source processing actions, which affect all transfers that use the source.

Element Description

Add processing actions

Allows you to compress, decompress, PGP Encryption, PGP Decryption, callouts (custom action) or new line conversion transferred files. For more information, see Pre-Processing Actions.

Advanced Properties

The Advanced Properties section of the OCI Source tab allows you change advanced source properties.

Element Description

Content

Click the Content tab to display advanced properties related to source content.

Optional filtering of source content specified as

Specifies file name and extension pattern criteria for the source. If no content filters are defined, all files at the source endpoint are transferred.

Filtering supports only file names, not directory names.

Select Wildcard or Regular Expression to determine how the filter string is interpreted.

Include Files

Specifies the pattern for including files. For example, *.txt includes all files with extension txt.

Exclude Files

Specifies the pattern for excluding files. For example, *.pdf excludes all files with extension pdf.

Performance Attributes

Click the Performance Attributes tab to display advanced properties related to performance.

Max Raise Size

Specifies the maximum number of files that MFT transfers from Oracle Cloud Infrastructure for processing on each polling cycle. For example, if your inbound directory has 1000 files and this value is set to 100, MFT can transfer up to 100 files on each polling cycle.

Operations

Click the Operations tab to display advanced properties related to file operations.

Action Type

Specifies the action to take after files from this source are transferred: None or Delete.

Related Topics

Creating a Source in Using Oracle Managed File Transfer