Managing Storage Buckets

Creating Storage Buckets

1. From the Storage Buckets page, click the Add button. The Add Bucket window is displayed.

2. Select the desired storage provider for this bucket.

3. Complete the required fields for your selected provider. Expand the next sections for field descriptions for each provider.

   Field descriptions for Orchestrator storage buckets:

   Field	Description
   Name	Enter a descriptive name for the new bucket.
   Description	Enter an optional description for the new bucket.
   Bucket Options	Configure the bucket options with the following two toggles: Readonly - when enabled, users have read-only access to the created bucket. Audit read access - when enabled, an audit record of all user access is maintained.
   Cancel	Close the Add Bucket window without saving.
   Add	Create the new bucket as defined.

   Note:

   Orchestrator storage buckets do not support SSE-KMS encryption.

   Field descriptions for Azure storage buckets:

   Field	Description
   Name	Enter a descriptive name for the new bucket.
   Description	Enter an optional description for the new bucket.
   Azure Storage container name	Enter the name of the Azure Storage container to be used for this bucket.
   Azure Storage endpoint suffix	Enter the endpoint suffix of your Azure Storage environment. For example, the endpoint suffix for Azure Public is core.windows.net.
   Azure Storage account name	Enter the Azure Storage account for this container.
   Azure Storage access password	Enter the access key for the Azure Storage account being used.
   Credential Store	Select which Orchestrator credential store is used to store the provided password.

   Field descriptions for Amazon S3 storage buckets:

   Field	Description
   Name	Enter a descriptive name for the new bucket.
   Description	Enter an optional description for the new bucket.
   Amazon S3 bucket name	Enter the name of the Amazon S3 bucket to be used.
   Amazon S3 region	Enter the region of your Amazon S3 account. For example us-east-1.
   Amazon S3 access key	Enter the access key for your Amazon S3 account.
   Amazon S3 access password	Enter the password for the Amazon S3 account being used.
   Orchestrator Credential Store	Select which Orchestrator credential store is used to store the provided password.

   S3 compatible storage buckets:

   

   Field	Descriptions
   Name	Enter a descriptive name for the new bucket.
   Description	Enter an optional description for the new bucket.
   Bucket name	Enter the name of the S3 compatible bucket to be used.
   Service URL	Enter the service HTTP URL without the bucket name in the subdomain. For example, https://storage.mycompany.example.com.
   Access key	Enter the access key for your storage system.
   Force path style	Enable to force the use of Path-Style requests. Disable to use Virtual Hosted-Style requests. See details about virtual hosting of buckets.
   Advanced signature options	Enable this option to provide advanced signature authentication options. When enabled, the Signature version and the Signature method fields are displayed.
   ? ? Signature version	Select the signing protocol. The following options are available: V2 and V4. The default is V4. Most storage systems use this.
   ? ? Signature method	Select the type of hash algorithm used to encrypt the signature. The following options are available: HmacSHA1 and HmacSHA256. The default is HmacSHA256. Most storage systems use this.
   Secret key	Enter the secret key for your storage system.
   Orchestrator credential store for safekeeping the provided password	Select which Orchestrator credential store is used to store the provided password.

   4. Configure the Bucket Options:
   • Readonly - use the toggle to make this bucket read-only for users.
   • Audit read access - use the toggle to enable auditing of user read access.

4. Click Add. Your bucket is created and available for use.

Editing Storage Buckets

1. From the Storage Buckets page, click the Edit button corresponding to the desired bucket. The bucket is opened for editing.
2. Change the desired fields.

Note:

The editable fields vary depending upon the storage provider used.

1. Click Update. The bucket is updated and you are returned to the Storage Buckets page.

Deleting Storage Buckets

1. From the Storage Buckets page, click the Delete button corresponding to the desired bucket.
2. You are prompted Are you sure you want to delete the selected items?
3. Select No to cancel or Yes to confirm and delete the selected bucket.

Uploading a File to a Storage Bucket

1. From the Storage Buckets page, click the name of the desired bucket. The bucket is opened for viewing.

2. Click the Upload button. The Upload new file window is displayed.

   

3. Click the Browse button. Your file explorer is displayed, navigate to and select the desired file. Once selected, the File full path is automatically filled-in. The File full path can be edited, and the file uploaded to a virtual directory.

4. Click Upload. The file is uploaded and available in the storage bucket.

Downloading a File From a Storage Bucket

1. From the Storage Buckets page, click the name of the desired bucket. The bucket is opened for viewing.
2. Click the Download button corresponding to the desired file. The download dialog is displayed prompting you to either open or save the selected file.

Searching for Files Within a Storage Bucket

The file search option within storage buckets is based on file globbing, which means that you need to use wildcards to find a desired file. This is detailed in the topic dedicated to the List Storage Files activity, but you can also check out the example below for some common use cases.

Example

Suppose you have a storage bucket containing the following files:

• If you want to search for all files with a certain extension, such as .jpg files, you need to enter the following in the Search field: *.jpg.

  The search results will be doc1.jpg and doc2.jpg.

• If you want to search for a file whose name contains a certain character or character sequence, such as voi, you need to enter the following in the Search field: *voi*.

  The search result will be invoice1.pdf.

• If you want to search for a file whose name begins with a certain character or character sequence, such as u, you need to enter the following in the Search field: u*.

  The search result will be uipath.png.