Table of Contents

DigitalOcean Spaces

Active with remarks
This application needs additional settings. Please follow the documentation below to create your own connection.

DigitalOcean Spaces

The DigitalOcean Spaces modules enable you to monitor, list or create buckets and files in your DigitalOcean Spaces account.

Getting Started with DigitalOcean Spaces

Prerequisites

A DigitalOcean Spaces account

In order to use DigitalOcean Spaces with Boost.space Integrator, it is necessary to have a DigitalOcean Spaces account. If you do not have one, you can create a DigitalOcean Spaces account at DigitalOcean website.

	Note
	The module dialog fields that are displayed in bold (in the Boost.space Integrator scenario, not in this documentation article) are mandatory!

Connect DigitalOcean Spaces to Boost.space Integrator

To connect your DigitalOcean Spaces account to Boost.space Integrator you need to obtain the Access Key and Access Secret Key.

Log in to your DigitalOcean account.
Open the Manage > API section from the menu on the left.
Scroll down to the Spaces access keys section and click the grey Generate New Key button.
Enter the name for the new access key and press Enter.
Copy the provided Access Key and Access Secret Key.
Go to Boost.space Integrator and open the DigitalOcean Spaces module’s Create a connection dialog.
Enter the Access Key and Access Secret Key you have copied in step 5 to the respective fields and click the Continue button to establish the connection.

Bucket

Watch Buckets

Returns the bucket’s name and creation date when the bucket is created in your account.

Connection	Establish a connection to your DigitalOcean account.
Region	Select the region you want to retrieve buckets from.
Limit	Set the maximum number of buckets Boost.space Integrator will return during one execution cycle.

List Buckets

Retrieves all buckets in your account.

Connection	Establish a connection to your DigitalOcean account.
Region	Select the region you want to retrieve buckets from.
Limit	Set the maximum number of buckets Boost.space Integrator will return during one execution cycle.

Create Bucket

Creates a new bucket in the specified region.

Connection	Establish a connection to your DigitalOcean account.
Name	Enter the name for the new bucket.
Region	Select the region you want to create a new bucket at.

Files

Watch Files

Returns the file’s name, size, and date modified when the file is uploaded or updated in the bucket.

Connection	Establish a connection to your DigitalOcean account.
Region	Select the region that contains the bucket you want to watch for files.
Bucket	Select the bucket you want to watch for new or updated files.
Prefix	Enter the path you want to watch files at.
Limit	Set the maximum number of files Boost.space Integrator will return during one execution cycle.

List Files

Retrieves all files in the specified bucket.

Connection	Establish a connection to your DigitalOcean account.
Region	Select the region that contains the bucket you want to list files from.
Bucket	Select the bucket you want to list the files from.
Prefix	Enter the path you want to list files from. E.g. `Boost.space Integrator/work/images`
Limit	Set the maximum number of files Boost.space Integrator will return during one execution cycle.

Download a File

Downloads a file from the specified bucket.

Connection	Establish a connection to your DigitalOcean account.
Region	Select the region that contains the bucket you want to download the file from.
Bucket	Select the bucket you want to download the file from.
Path	Enter the path to the file you want to download E.g. `/work/images/digitalocean-logo.png`

Upload a File

Uploads a file to a bucket.

Connection	Establish a connection to your DigitalOcean account.
Region	Select the region that contains the bucket where you want to upload a file.
Bucket	Select the bucket you where you want to upload a file.
Folder	Enter the path of the target location. Leave empty to upload the file to the root of the bucket E.g. `/work/images`
Source File	Map the file you want to upload from the previous module (e.g. HTTP > Get a File or Dropbox > Get a file), or enter the file name and file data manually.
Headers	Insert headers if needed. See common headers or additional headers that can be used here.

Other

Make an API Call

Allows you to perform a custom API call.

Connection

Establish a connection to your DigitalOcean account.

URL

Enter a path relative to https://<selected-bucket>.<selected-region>.digitaloceanspaces.com. E.g. /2/files/list_folder

	Note
	For the list of available endpoints, refer to the DigitalOcean Spaces API Documentation.

Method

Select the HTTP method you want to use:

GET

to retrieve information for an entry.

POST

to create a new entry.

PUT

to update/replace an existing entry.

PATCH

to make a partial entry update.

DELETE

to delete an entry.

Headers

Enter the desired request headers. You don’t have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use – List Objects From the Bucket

The following API call returns all objects (files and folders) from the specified bucket:

URL:

/

Method:

GET

Matches of the search can be found in the module’s Output under Bundle > Body > Contents.

In our example, 5 objects were returned: