Skip to main content

Connecting Alibaba Cloud (Aliyun) Object Storage System (OSS)

This guide walks you through connecting an Alibaba Cloud OSS storage destination to Pluton.

Prerequisites​

Before connecting Alibaba Cloud OSS, you need:

  1. An Alibaba Cloud account — Sign up here
  2. An Access Key ID and Secret Access Key with permissions to manage OSS buckets

Getting Your Alibaba Cloud Credentials​

Step 1: Create an Access Key Pair​

  1. Log into the Alibaba Cloud Console
  2. Hover over your profile icon and select AccessKey Management
  3. Click Create AccessKey
  4. Copy both the Access Key ID and Access Key Secret — the secret is shown only once

Step 2: Prepare Your Bucket​

  1. Navigate to the Object Storage Service (OSS) section in the console
  2. Note the name of the bucket you want to use, or click Create Bucket to make a new one
  3. Note the Region where your bucket is located (e.g., China (Hangzhou), US (Silicon Valley))

Connecting to Pluton​

Pluton Alibaba Cloud OSS

Step 1: Add Storage​

  1. In Pluton, navigate to Storages
  2. Click Add Storage button
  3. Select Alibaba Cloud (Aliyun) Object Storage System (OSS) from the provider list

Step 2: Configure Connection​

Fill in the required fields:

  • Storage Name: A friendly name (e.g., "Alibaba OSS Backups")
  • Access Key ID: Your Alibaba Cloud Access Key ID
  • Secret Access Key: Your Alibaba Cloud Secret Access Key (password)
  • Region: Select the region matching your bucket location. Available regions include China (Hangzhou, Shanghai, Beijing, Shenzhen, Chengdu, Hong Kong), Japan (Tokyo), South Korea (Seoul), Singapore, Malaysia, Indonesia, Philippines, Thailand, Germany (Frankfurt), UK (London), US (Silicon Valley, Virginia), UAE (Dubai), and more. You can also enter a custom endpoint if needed

Step 3: Advanced Options (Optional)​

Additional settings available:

  • Access Control List (ACL): Permissions applied when creating buckets and storing objects. Options include Private, Public Read, and Public Read/Write. Defaults to Private if not set
  • Storage Class: The storage class used when storing new objects in OSS
  • Server-side Encryption: Encrypt objects at rest using AES256 or AWS KMS
  • Bucket ACL: Canned ACL applied specifically when creating buckets

Step 4: Test and Save​

  1. Click Test Connection to verify credentials
  2. If successful, click Save
  3. Your Alibaba Cloud OSS storage is now ready for backup plans

Common Issues​

Authentication Failure: Double-check that your Access Key ID and Secret Access Key are correct. Ensure the key has not been disabled in the Alibaba Cloud console.

Bucket Not Found: Verify that the selected region matches the region where your bucket was created. OSS endpoints are region-specific.

Permission Denied: Ensure your Access Key has the appropriate RAM policies assigned for OSS read/write access.

Best Practices​

  • Create a dedicated RAM user with minimal OSS permissions for Pluton
  • Use a region geographically close to your Pluton server for faster transfers
  • Enable versioning on your OSS bucket for an extra layer of data protection
  • Monitor storage usage through the Alibaba Cloud console to manage costs