sakura_cloud_object_storage

Author: r3-yamauchi
Version: 0.0.1
Type: tool

English | Japanese

Description

This plugin provides tools for interacting with Sakura Cloud Object Storage from Dify workflows and agents. Sakura Cloud Object Storage is an S3-compatible object storage service that allows you to store and serve large amounts of unstructured data.

The source code of this plugin is available in the GitHub repository.

Overview

The Sakura Cloud Object Storage Tools plugin bundles multiple tools so that Dify applications can upload, download, and manage files directly inside the platform.

Included tools:

• Upload File – Upload files from workflow nodes to buckets
• Download File – Download files from buckets to workflow nodes
• S3 Operator – Read and write text content to/from objects
• List Buckets – List all buckets in your account
• Create Bucket – Create a new bucket in your account
• List Objects – List objects in a bucket with optional filtering
• Delete Object – Delete an object from a bucket
• Get Object Metadata – Get object metadata

Features

Upload File

Upload files received from prior workflow nodes to Sakura Cloud Object Storage buckets. Supports:

• Custom object keys
• Automatic content type detection

Download File

Download files from buckets and make them available as binary data in workflows. Returns:

• File binary data
• File metadata

S3 Operator

Read and write text content to/from objects. Supports:

• Read operations (returns text content or presigned URL)
• Write operations (uploads UTF-8 text)
• Optional presigned URL generation for both operations

List Buckets

List all buckets in your account. Returns:

• Bucket names

Create Bucket

Create a new bucket in your account.

List Objects

List objects in a bucket. Supports:

• Prefix filtering

Delete Object

Delete an object from a bucket.

Get Object Metadata

Get object metadata. Returns:

• Content type, size, last modified date, ETag, etc.

Setup

Prerequisites

• A Sakura Cloud account
• Sakura Cloud Object Storage API keys (Access Key ID and Secret Access Key)
• Endpoint URL (default: https://s3.isk01.sakurastorage.jp)
• Region Name (default: jp-north-1)

Installation

1. Install the plugin in your Dify instance
2. (Optional) Configure the provider with your credentials:
   • Access Key ID (optional)
   • Secret Access Key (optional)
   • Endpoint URL (optional, defaults to https://s3.isk01.sakurastorage.jp)
   • Region Name (optional, defaults to jp-north-1)

Note: All provider credentials are optional. Each tool also exposes optional access_key_id, secret_access_key, endpoint_url, and region_name parameters so you can override the provider defaults per invocation.

Getting Credentials

1. Log in to the Sakura Cloud Control Panel.
2. Navigate to Object Storage.
3. Create a new API Key (Access Key ID and Secret Access Key).
4. Note the Endpoint URL (usually s3.isk01.sakurastorage.jp) and Region (jp-north-1).

Configure in Dify

1. In Dify, go to Settings → Plugins → Tool Providers
2. Find Sakura Cloud Object Storage Tools and click Configure (or Add)
3. Enter the following credentials:
   • Access Key ID
   • Secret Access Key
   • Endpoint URL
   • Region Name
4. Click Save to verify the credentials work

Credential Overrides & Order of Precedence

When a tool runs, credentials are resolved in the following order:

1. Tool parameters (access_key_id, secret_access_key, endpoint_url, region_name) provided in the workflow/agent step
2. Provider-level configuration (if set)
3. Built-in defaults (endpoint_url = https://s3.isk01.sakurastorage.jp, region_name = jp-north-1)

At least an Access Key ID and Secret Access Key must be supplied via option 1 or 2. Endpoint URL and Region Name fall back to the defaults if neither 1 nor 2 specify them.

Usage

Upload File (file_uploader)

Upload a file:

• bucket_name: The bucket name
• file: The file to upload (from a workflow node)
• object_key (optional): Custom object key

Download File (file_download)

Download a file:

• bucket_name: The bucket name
• object_key: The object key to download

S3 Operator (operator)

Read or write text:

• s3_uri: The S3 URI in s3://bucket/key format
• operation_type: read or write
• text_content (for write): The text content to write
• generate_presign_url (optional): Generate a presigned URL
• presign_expiry (optional): Presigned URL expiration time in seconds

List Buckets (bucket_list)

List all buckets:

• No parameters required

Create Bucket (bucket_create)

Create a new bucket:

• bucket_name: Name for the new bucket

List Objects (object_list)

List objects in a bucket:

• bucket_name: The bucket name
• prefix (optional): Filter objects by prefix

Delete Object (object_delete)

Delete an object:

• bucket_name: The bucket name
• object_key: The object key to delete

Get Object Metadata (object_metadata)

Get object metadata:

• bucket_name: The bucket name
• object_key: The object key

URI Format

The operator tool accepts s3://bucket/key URI format.

Privacy Policy

See PRIVACY.md for information about how this plugin handles your data.